Comment installer l'outil d'administration de base de données Adminer sur Debian 12

Adminer (anciennement phpMinAdmin) est un outil d’administration de base de données complet écrit en PHP qui prend en charge à la fois les SGBDR (systèmes de gestion de bases de données relationnelles) tels que MySQL/MariaDB, PostgreSQL, SQLite, MS SQL et Oracle, ainsi que les NoSQL comme MongoDB et d’autres (via plugin).

Adminer est une alternative à phpMyAdmin. C’est un outil de gestion de base de données léger, convivial et performant qui peut être utilisé facilement pour gérer vos bases de données.

Dans ce guide, nous allons vous montrer comment installer l’outil d’administration de base de données Adminer sur le serveur Debian 12. Vous sécuriserez également Adminer via le module basic_auth d’Apache.

Prérequis

Avant de commencer, assurez-vous d’avoir les éléments suivants :

• Un serveur Debian 12.
• Un utilisateur non-root avec des privilèges d’administrateur.
• Une base de données MySQL/MariaDB installée.

Installation d’Adminer sur Debian

Adminer est une alternative à phpMyAdmin mais prend également en charge la base de données PostgreSQL. Il est également écrit en PHP et peut fonctionner sur presque tous les systèmes d’exploitation avec un serveur web Apache ou Nginx.

Sur Debian, le paquet adminer est disponible par défaut, et vous pouvez facilement l’installer via le dépôt. Nous vous recommandons d’installer adminer sur un serveur frais car il installera automatiquement les paquets PHP et le serveur web Apache.

Avant d’installer adminer, mettez à jour l’index des paquets Debian avec la commande suivante.

sudo apt update

Trouvez le paquet adminer dans le dépôt Debian par défaut avec la commande ci-dessous.

sudo apt info adminer

Vous pouvez voir ci-dessous que le paquet adminer est disponible dans la section web du dépôt Debian et nécessite au moins PHP 8.2 et un serveur web Apache.

Maintenant, installez adminer avec la commande suivante. Cela installe également les paquets requis tels que PHP et Apache automatiquement. Tapez y pour confirmer l’installation.

sudo apt install adminer

Après l’installation, vérifiez le service Apache avec la commande ci-dessous. Assurez-vous que le service Apache est en cours d’exécution.

sudo systemctl status apache2

Sécurisation de l’installation d’Adminer

Maintenant que vous avez installé adminer, l’étape suivante consiste à configurer votre installation d’adminer. Dans cet exemple, vous allez changer le chemin URL par défaut pour Adminer et ajouter une authentification supplémentaire via basic_auth. De cette façon, vous aurez deux couches d’authentification.

De plus, vous devez savoir qu’adminer génère de nouveaux fichiers de configuration Apache à /etc/apache2/conf-available/adminer.conf. Vous allez modifier ce fichier pour configurer l’installation d’adminer.

Avant de modifier la configuration, exécutez la commande ci-dessous pour générer le fichier de mot de passe /etc/adminer/.htpasswd. Assurez-vous également de changer le nom d’utilisateur dbmanager avec votre utilisateur.

Le /etc/adminer/.htpasswd sera utilisé comme authentification supplémentaire via le module basic_auth d’Apache pour Adminer.

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

Tapez votre mot de passe lorsqu’on vous le demande et répétez.

Maintenant, ouvrez la configuration Apache générée pour adminer /etc/apache2/conf-available/adminer.conf en utilisant l’éditeur nano.

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

À la première ligne, changez l’URL par défaut pour ‘/adminer ‘ au nouveau chemin URL. Dans cet exemple, adminer sera accessible via le chemin URL ‘ /dbmanager ‘.

Alias /dbmanager /etc/adminer  
  
  
Require all granted  
DirectoryIndex conf.php  

Insérez la configuration ci-dessous pour activer le basic_auth d’Apache pour le chemin ‘ /dbmanager ‘. Avec cela, chaque fois que vous accédez au chemin ‘ /dbmanager ‘, vous serez invité à une authentification supplémentaire basic_auth d’Apache.

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

Enregistrez et fermez le fichier lorsque vous avez terminé.

Ensuite, exécutez la commande ci-dessous pour activer la configuration supplémentaire ‘adminer.conf’ sur Apache et vérifier la syntaxe globale de votre Apache.

sudo a2enconf adminer.conf  
sudo apachectl configtest

Assurez-vous d’avoir une syntaxe correcte et obtenez une sortie telle que Syntax OK.

Enfin, exécutez la commande ci-dessous pour redémarrer le service Apache et appliquer la nouvelle configuration pour Adminer. Après avoir exécuté la commande, votre installation d’Adminer devrait être prête.

sudo systemctl restart apache2

Configuration du serveur MySQL/MariaDB

À ce stade, votre Adminer est prêt, mais vous devez encore préparer votre serveur MySQL en créant un nouvel utilisateur spécifié pour la connexion Adminer. Il n’est pas recommandé d’utiliser directement l’utilisateur root.

Remarque : Si vous vous connectez via un hôte distant, assurez-vous de le faire via un tunnel SSH pour chiffrer votre connexion. Si vous utilisez un seul serveur (MySQL + Adminer sur le même serveur), vous êtes prêt à partir.

Connectez-vous au serveur MySQL/MariaDB avec la commande ci-dessous. Entrez votre mot de passe root MySQL lorsqu’on vous le demande.

sudo mysql -u root -p

Exécutez les requêtes suivantes pour créer un nouvel utilisateur dbmanager pour votre serveur MySQL. Dans cet exemple, cet utilisateur sera utilisé pour se connecter au serveur MySQL via Adminer. Assurez-vous donc de changer le mot de passe suivant par un nouveau mot de passe.

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;

Maintenant, exécutez la requête suivante pour vérifier la liste des utilisateurs dans votre serveur MySQL. Vous devriez voir l’utilisateur dbmanager avec l’hôte par défaut 127.0.0.1.

SELECT user,host FROM mysql.user;

Enfin, tapez quit pour quitter le serveur MySQL.

Connexion au serveur MySQL via Adminer

Ouvrez votre navigateur web et visitez l’URL d’installation d’Adminer http://192.168.5.15/dbmanager. Si votre installation est réussie, vous devriez être invité à l’authentification basic_auth. Entrez votre nom d’utilisateur et le mot de passe que vous avez créés et cliquez sur Se connecter.

Une fois connecté avec succès, vous devriez obtenir la page de connexion d’Adminer. Maintenant, sélectionnez le système de base de données comme MySQL, puis saisissez les détails de l’hôte et du port, le nom d’utilisateur et le mot de passe de votre serveur MySQL. Cliquez sur Connexion pour confirmer.

Si vous avez les bonnes informations d’identification de base de données, vous devriez être connecté à MySQL via Adminer.

Création d’une nouvelle base de données et d’un utilisateur via Adminer

Dans cette section, vous apprendrez comment créer une nouvelle base de données et un utilisateur sur MySQL/MariaDB via Adminer. Ensuite, vous vous connecterez également à la nouvelle base de données via le nouvel utilisateur.

Sur le tableau de bord d’Adminer, cliquez sur le lien Créer une base de données. Vous serez présenté avec la page suivante.

Entrez le nom de votre nouvelle base de données et cliquez sur Enregistrer. Dans cet exemple, vous allez créer une nouvelle base de données testdb.

Ensuite, pour créer un nouvel utilisateur MySQL/MariaDB, cliquez sur Privilèges sur le tableau de bord, puis cliquez sur Créer un utilisateur.

Entrez le nom d’utilisateur et le mot de passe de la base de données, puis entrez le nom de votre base de données dans la section des privilèges. Faites défiler vers le bas et cliquez sur Enregistrer.

Dans l’exemple suivant, vous allez créer un nouvel utilisateur testuser et donner à l’utilisateur des privilèges sur la base de données testdb.

Enfin, connectez-vous à Adminer avec l’utilisateur testuser à la base de données testdb.

Si cela réussit, vous devriez être connecté à testdb via Adminer.

Conclusion

Félicitations ! Vous avez maintenant installé avec succès Adminer en tant qu’outil de gestion de base de données pour MySQL/MariaDB et PostgreSQL sur le serveur Debian 12. Vous avez également sécurisé Adminer en changeant le chemin URL par défaut et en activant une couche d’authentification supplémentaire via le module basic_auth d’Apache. À la fin, vous vous êtes connecté au serveur MySQL via l’outil Adminer.