Come installare lo strumento di amministrazione del database Adminer su Debian 12

Adminer (precedentemente phpMinAdmin) è uno strumento di amministrazione del database completo scritto in PHP che supporta sia RDBMS (Relational Database Management System) come MySQL/MariaDB, PostgreSQL, SQLite, MS SQL e Oracle, sia NoSQL come MongoDB e altri (tramite plugin).

Adminer è un’alternativa a phpMyAdmin. È uno strumento di gestione del database leggero, facile da usare e ad alte prestazioni che può essere utilizzato facilmente per gestire i tuoi database.

In questa guida, ti mostreremo come installare lo strumento di amministrazione del database Adminer sul server Debian 12. Inoltre, proteggerai Adminer tramite il modulo basic_auth di Apache.

Prerequisiti

Prima di iniziare, assicurati di avere i seguenti requisiti:

• Un server Debian 12.
• Un utente non root con privilegi di amministratore.
• Un database MySQL/MariaDB installato.

Installazione di Adminer su Debian

Adminer è un’alternativa a phpMyAdmin ma supporta anche il database PostgreSQL. È scritto in PHP e può funzionare su quasi qualsiasi sistema operativo con server web Apache o Nginx.

Su Debian, il pacchetto adminer è disponibile per impostazione predefinita e puoi facilmente installarlo tramite il repository. Ti consigliamo di installare adminer su un server fresco perché installerà automaticamente i pacchetti PHP e il server web Apache.

Prima di installare adminer, aggiorna l’indice dei pacchetti di Debian con il seguente comando.

sudo apt update

Trova il pacchetto adminer nel repository Debian predefinito con il comando qui sotto.

sudo apt info adminer

Puoi vedere qui sotto che il pacchetto adminer è disponibile nella sezione web del repository Debian e richiede almeno PHP 8.2 e un server web Apache.

Ora installa adminer con il seguente comando. Questo installerà anche i pacchetti richiesti come PHP e Apache automaticamente. Digita y per confermare l’installazione.

sudo apt install adminer

Dopo che l’installazione è completata, verifica il servizio Apache con il comando qui sotto. Assicurati che il servizio Apache sia in esecuzione.

sudo systemctl status apache2

Proteggere l’installazione di Adminer

Ora che hai installato adminer, il passo successivo è configurare la tua installazione di adminer. In questo esempio, cambierai il percorso URL predefinito per Adminer e aggiungerai un’autenticazione aggiuntiva tramite basic_auth. In questo modo, avrai due livelli di autenticazione.

Inoltre, devi sapere che adminer genera nuovi file di configurazione di Apache in /etc/apache2/conf-available/adminer.conf. Modificherai questo file per configurare l’installazione di adminer.

Prima di modificare la configurazione, esegui il comando qui sotto per generare il file di password /etc/adminer/.htpasswd. Assicurati anche di cambiare il nome utente dbmanager con il tuo utente.

Il file /etc/adminer/.htpasswd sarà utilizzato come autenticazione aggiuntiva tramite il modulo basic_auth di Apache per Adminer.

sudo htpasswd -B -c /etc/adminer/.htpasswd dbmanager

Digita la tua password quando richiesto e ripetila.

Ora apri la configurazione Apache generata per adminer /etc/apache2/conf-available/adminer.conf utilizzando l’editor nano.

sudo nano /etc/apache2/conf-available/adminer.conf

Nella prima riga, cambia l’URL predefinito per ‘/adminer ‘ nel nuovo percorso URL. In questo esempio, adminer sarà accessibile tramite il percorso URL ‘/dbmanager‘.

Alias /dbmanager /etc/adminer  

  
Require all granted  
DirectoryIndex conf.php  

Inserisci la configurazione qui sotto per abilitare il basic_auth di Apache per il percorso ‘/dbmanager‘. Con questo, ogni volta che accedi al percorso ‘/dbmanager‘, ti verrà richiesta un’autenticazione aggiuntiva di Apache basic_auth.

  
 AuthType Basic  
 AuthName "Risorsa riservata"  
 AuthBasicProvider file  
 AuthUserFile /etc/adminer/.htpasswd  
 Require valid-user  

Salva e chiudi il file quando hai finito.

Successivamente, esegui il comando qui sotto per attivare la configurazione aggiuntiva ‘adminer.conf’ su Apache e verifica la sintassi complessiva di Apache.

sudo a2enconf adminer.conf  
sudo apachectl configtest

Assicurati di avere una sintassi corretta e ottieni un output come Syntax OK.

Infine, esegui il comando qui sotto per riavviare il servizio Apache e applicare la nuova configurazione per Adminer. Dopo aver eseguito il comando, la tua installazione di Adminer dovrebbe essere pronta.

sudo systemctl restart apache2

Impostare il server MySQL/MariaDB

A questo punto, il tuo Adminer è pronto, ma devi ancora preparare il tuo server MySQL creando un nuovo utente specificato per il login di Adminer. Non è consigliabile utilizzare direttamente l’utente root.

Nota: Se ti connetti tramite un host remoto, assicurati di farlo tramite SSH tunneling per crittografare la tua connessione. Se stai utilizzando un singolo server (MySQL + Adminer sullo stesso server), sei pronto per partire.

Accedi al server MySQL/MariaDB con il comando qui sotto. Inserisci la tua password di root MySQL quando richiesto.

sudo mysql -u root -p

Esegui le seguenti query per creare un nuovo utente dbmanager per il tuo server MySQL. In questo esempio, questo utente sarà utilizzato per accedere al server MySQL tramite Adminer. Assicurati di cambiare la seguente password con una nuova password.

CREATE USER 'dbmanager'@'127.0.0.1' IDENTIFIED BY 'dbpassword';  
GRANT ALL PRIVILEGES ON *.* TO 'dbmanager'@'127.0.0.1' WITH GRANT OPTION;  
FLUSH PRIVILEGES;

Ora, esegui la seguente query per verificare l’elenco degli utenti nel tuo server MySQL. Dovresti vedere l’utente dbmanager con l’host predefinito 127.0.0.1.

SELECT user,host FROM mysql.user;

Infine, digita quit per uscire dal server MySQL.

Accesso al server MySQL tramite Adminer

Apri il tuo browser web e visita l’URL di installazione di Adminer http://192.168.5.15/dbmanager. Se la tua installazione è riuscita, dovresti essere invitato con l’autenticazione basic_auth. Inserisci il tuo nome utente e la password che hai creato e fai clic su Accedi.

Una volta effettuato l’accesso con successo, dovresti vedere la pagina di accesso di Adminer. Ora seleziona il sistema di database come MySQL, quindi inserisci i dettagli dell’host e della porta, il nome utente e la password del tuo server MySQL. Fai clic su Login per confermare.

Se hai le credenziali corrette del database, dovresti essere connesso a MySQL tramite Adminer.

Creare un nuovo database e utente tramite Adminer

In questa sezione, imparerai come creare un nuovo database e un nuovo utente su MySQL/MariaDB tramite Adminer. Poi, accederai anche al nuovo database tramite il nuovo utente.

Nella dashboard di Adminer, fai clic sul link Crea Database. Ti verrà presentata la seguente pagina.

Inserisci il nome del tuo nuovo database e fai clic su Salva. In questo esempio, creerai un nuovo database testdb.

Successivamente, per creare un nuovo utente MySQL/MariaDB, fai clic su Privilegi nella dashboard, quindi fai clic su Crea utente.

Inserisci il nome utente e la password del database, quindi inserisci il nome del tuo database nella sezione dei privilegi. Scorri verso il basso e fai clic su Salva.

Nell’esempio seguente, creerai un nuovo utente testuser e darai all’utente privilegi sul database testdb.

Infine, accedi a Adminer con l’utente testuser al database testdb.

Se hai successo, dovresti essere connesso a testdb tramite Adminer.

Conclusione

Congratulazioni! Hai ora installato con successo Adminer come strumento di gestione del database per MySQL/MariaDB e PostgreSQL sul server Debian 12. Hai anche protetto Adminer cambiando il percorso URL predefinito e abilitando un ulteriore livello di autenticazione tramite il modulo basic_auth di Apache. Alla fine, hai effettuato l’accesso al server MySQL tramite lo strumento Adminer.