Installer MariaDB (MySQL) et phpMyAdmin sur Kali Linux

Objectifs et architecture

Objectifs du TP

• Mettre à jour Kali Linux.
• Installer un serveur de base de données MariaDB, compatible MySQL.
• Installer phpMyAdmin.
• Configurer l’accès web à phpMyAdmin.
• Créer un utilisateur MySQL/MariaDB capable de se connecter via phpMyAdmin.
• Vérifier les services et diagnostiquer les erreurs courantes.

Architecture logique

Navigateur web
      ↓
Apache2
      ↓
phpMyAdmin
      ↓
MariaDB / MySQL

En résumé : Apache sert les pages, PHP (déjà installé) exécute phpMyAdmin, phpMyAdmin interroge MariaDB/MySQL, et MariaDB/MySQL stocke les bases de données.

1Mettre à jour le système

On actualise d’abord la liste des paquets disponibles, puis on installe les mises à jour. Faire les deux évite des erreurs de dépendances.

# Actualise la liste des paquets disponibles
$ apt update

# Applique les mises à jour complètes du système
$ apt full-upgrade -y

2Installer le serveur de base de données

Sur Kali/Debian, le serveur de base de données fourni par défaut est MariaDB. MariaDB est un fork compatible avec MySQL. Dans la suite du TP, on parlera donc de MySQL/MariaDB.

# Installe le serveur MariaDB
$ apt install mariadb-server -y

# Démarre MariaDB et l'active au démarrage du système
$ systemctl enable --now mariadb

# Vérifie l'état du service
$ systemctl status mariadb --no-pager

# Vérifie que MariaDB écoute bien sur le port 3306
$ ss -ltnp | grep 3306

# Se connecte à la console SQL en tant que root MariaDB
$ mysql

Dans la console, le prompt devient généralement :

MariaDB [(none)]>

Pour vérifier la version et quitter :

MariaDB [(none)]> SELECT VERSION();
MariaDB [(none)]> QUIT;

$ mysql

3Installer phpMyAdmin

phpMyAdmin est une application web écrite en PHP. Elle s’appuie donc sur :

• Apache2 pour servir les pages web ;
• PHP pour exécuter l’application ;
• php-mysql pour communiquer avec MariaDB/MySQL ;
• le serveur MariaDB/MySQL installé à l’étape précédente.

# Installe phpMyAdmin
$ apt install phpmyadmin -y

# Relance l'assistant de configuration si nécessaire
$ dpkg-reconfigure phpmyadmin

$ dpkg-reconfigure phpmyadmin

Réponses conseillées à l’assistant

Navigation : flèches pour se déplacer, Espace pour cocher, Entrée pour valider.

$ ls -l /etc/phpmyadmin/config-db.php

4Accéder à phpMyAdmin

Avant d’accéder à phpMyAdmin, on vérifie qu’Apache tourne et que la configuration phpMyAdmin est activée.

# Vérifie qu'Apache est actif
$ systemctl status apache2 --no-pager

# Active la configuration phpMyAdmin dans Apache
$ a2enconf phpmyadmin

# Recharge Apache sans couper les connexions en cours
$ systemctl reload apache2

# Vérifie que la configuration phpMyAdmin est bien activée
$ ls -l /etc/apache2/conf-enabled/ | grep phpmyadmin

Dans le navigateur de Kali, ouvrir :

http://localhost/phpmyadmin

On doit voir la page de connexion de phpMyAdmin. Si c’est le cas, passer directement à l’étape 6 pour créer un utilisateur utilisable.

$ ip a

ssh -L 8080:localhost:80 utilisateur@IP_DE_KALI

http://localhost:8080/phpmyadmin

5Dépannage : la page ne s’affiche pas

Cette section traite principalement des erreurs 404, 403, 500, et des problèmes de connexion à la base de données.

Erreur 404 sur /phpmyadmin

Une erreur 404 signifie souvent que la configuration Apache de phpMyAdmin n’est pas activée.

# 1) Les fichiers de phpMyAdmin existent-ils ?
$ ls /usr/share/phpmyadmin

# 2) La configuration est-elle disponible dans Apache ?
$ ls /etc/apache2/conf-available/ | grep phpmyadmin

# 3) La configuration est-elle activée ?
$ ls /etc/apache2/conf-enabled/ | grep phpmyadmin

# 4) Active proprement la configuration phpMyAdmin
$ a2enconf phpmyadmin

# 5) Recharge Apache
$ systemctl reload apache2

# 6) Teste la syntaxe de la configuration Apache
$ apache2ctl configtest

Si a2enconf phpmyadmin échoue parce que le fichier n’est pas présent dans conf-available, on peut créer manuellement le lien symbolique vers conf-available, puis activer la configuration :

# Crée le lien symbolique vers la configuration fournie par le paquet
$ ln -s /etc/phpmyadmin/apache.conf /etc/apache2/conf-available/phpmyadmin.conf

# Active la configuration
$ a2enconf phpmyadmin

# Recharge Apache
$ systemctl reload apache2

Consulter les logs Apache

En cas d’erreur 404, 403 ou 500, les logs Apache sont indispensables :

# Affiche les dernières erreurs Apache
$ tail -n 50 /var/log/apache2/error.log

# Affiche les dernières accès Apache
$ tail -n 50 /var/log/apache2/access.log

# Alternative avec journalctl
$ journalctl -u apache2 --no-pager -n 50

Erreur 403 Forbidden

Une erreur 403 peut signifier qu’Apache autorise uniquement l’accès local. Sous Debian/Kali, la configuration de phpMyAdmin peut contenir une directive du type :

Require local

Dans ce cas, http://localhost/phpmyadmin fonctionne sur la VM Kali, mais l’accès depuis une autre machine peut être refusé.

Solutions :

• Préférer un tunnel SSH, plus sécurisé.
• Modifier temporairement la configuration pour autoriser une IP précise, uniquement en TP.

Pour chercher une restriction d’accès :

$ grep -R "Require" /etc/phpmyadmin/apache.conf
$ grep -R "Require" /etc/apache2/conf-enabled/phpmyadmin.conf

Erreur 500 Internal Server Error

Une erreur 500 vient souvent de PHP, d’une extension manquante ou d’une mauvaise configuration.

# Vérifie que PHP est chargé par Apache
$ apache2ctl -M | grep php

# Vérifie les extensions PHP utiles
$ php -m | grep -E 'mysqli|pdo_mysql|mbstring|xml|zip'

# Consulte les logs Apache
$ tail -n 50 /var/log/apache2/error.log

Message : impossible de se connecter au serveur de base de données

Si phpMyAdmin affiche une erreur de connexion à MariaDB/MySQL, vérifier que le service tourne :

# Vérifie l'état de MariaDB
$ systemctl status mariadb --no-pager

# Démarre MariaDB si nécessaire
$ systemctl start mariadb

# Vérifie que le port 3306 est écouté
$ ss -ltnp | grep 3306

# Consulte les logs MariaDB
$ tail -n 50 /var/log/mysql/error.log
$ journalctl -u mariadb --no-pager -n 50

6Créer un utilisateur MySQL/MariaDB

Si la connexion à phpMyAdmin est refusée avec root, c’est normal sous Kali/Debian à cause de l’authentification unix_socket. On crée donc un utilisateur MariaDB/MySQL avec un mot de passe, dédié à l’administration du TP.

Méthode rapide depuis la console MariaDB

# Ouvre la console SQL en root MariaDB
$ mysql

Puis, dans la console MariaDB, exécuter une instruction par ligne, chacune terminée par ; :

CREATE USER IF NOT EXISTS 'etudiant'@'localhost' IDENTIFIED BY 'MotDePasseSolide1!';
ALTER USER 'etudiant'@'localhost' IDENTIFIED BY 'MotDePasseSolide1!';
GRANT ALL PRIVILEGES ON *.* TO 'etudiant'@'localhost' WITH GRANT OPTION;
FLUSH PRIVILEGES;
QUIT;

Tester la connexion

# Teste la connexion avec le nouvel utilisateur
$ mysql -u etudiant -p -e "SELECT CURRENT_USER();"

On doit saisir le mot de passe, puis obtenir une sortie du type :

+----------------+
| CURRENT_USER() |
+----------------+
| etudiant@localhost |
+----------------+

Retourner ensuite sur :

http://localhost/phpmyadmin

et se connecter avec etudiant et le mot de passe choisi.

GRANT ALL PRIVILEGES ON ma_base.* TO 'app'@'localhost';

7Méthode sécurisée avec fichier SQL

Quand on tape directement une commande SQL contenant un mot de passe dans la console MariaDB, le client MySQL/MariaDB peut enregistrer la commande dans un fichier d’historique, souvent :

~/.mysql_history

Le mot de passe peut alors se retrouver en clair dans ce fichier. Pour un TP, il est préférable de préparer les commandes dans un fichier SQL temporaire, de protéger ce fichier, de l’exécuter, puis de le supprimer.

Créer un fichier SQL

# Ouvre un fichier de préparation dans nano
$ nano ~/creer_user.sql

Contenu à adapter, en remplaçant etudiant et le mot de passe :

CREATE USER IF NOT EXISTS 'etudiant'@'localhost' IDENTIFIED BY 'MotDePasseSolide1!';
ALTER USER 'etudiant'@'localhost' IDENTIFIED BY 'MotDePasseSolide1!';
GRANT ALL PRIVILEGES ON *.* TO 'etudiant'@'localhost' WITH GRANT OPTION;
FLUSH PRIVILEGES;

Sous nano : Ctrl+O puis Entrée pour enregistrer, Ctrl+X pour quitter.

Protéger, exécuter puis supprimer le fichier

# Protège le fichier contre la lecture par les autres utilisateurs
$ chmod 600 ~/creer_user.sql

# Exécute le fichier SQL sans ouvrir la console interactive
$ mysql < ~/creer_user.sql

# Supprime le fichier contenant le mot de passe en clair
$ rm ~/creer_user.sql

Vérifications

# Vérifie que l'utilisateur peut se connecter
$ mysql -u etudiant -p -e "SELECT CURRENT_USER();"

# Vérifie la présence de l'utilisateur dans la table mysql.user
$ mysql -e "SELECT User, Host FROM mysql.user WHERE User='etudiant';"

8Récapitulatif et pièges classiques

Commandes de service à retenir

# Apache
$ systemctl status apache2 --no-pager
$ systemctl start apache2
$ systemctl restart apache2
$ systemctl reload apache2

# MariaDB
$ systemctl status mariadb --no-pager
$ systemctl start mariadb
$ systemctl restart mariadb
$ systemctl enable --now mariadb

# phpMyAdmin / Apache
$ a2enconf phpmyadmin
$ apache2ctl configtest
$ apache2ctl -M | grep php

L’ancienne commande service fonctionne encore, mais systemctl est la commande moderne sous les systèmes utilisant systemd.

# Ancienne méthode, encore fonctionnelle
$ service apache2 status
$ service mariadb status

Logs utiles

# Logs Apache
$ tail -n 50 /var/log/apache2/error.log
$ tail -n 50 /var/log/apache2/access.log

# Logs MariaDB
$ tail -n 50 /var/log/mysql/error.log

# Logs système via journalctl
$ journalctl -u apache2 --no-pager -n 50
$ journalctl -u mariadb --no-pager -n 50

Checklist de validation

Cocher chaque élément après vérification.

• ☐ apache2 est actif.
• ☐ http://localhost affiche la page Apache.
• ☐ mariadb est actif.
• ☐ MariaDB écoute sur le port 3306 : ss -ltnp | grep 3306.
• ☐ La commande mysql permet de se connecter en root via unix_socket.
• ☐ phpmyadmin est installé.
• ☐ L’assistant phpMyAdmin a été configuré, ou relancé avec dpkg-reconfigure phpmyadmin.
• ☐ La configuration phpMyAdmin est activée dans Apache : a2enconf phpmyadmin.
• ☐ http://localhost/phpmyadmin affiche l’écran de connexion.
• ☐ Un utilisateur MariaDB/MySQL a été créé.
• ☐ Cet utilisateur peut se connecter à phpMyAdmin.
• ☐ Les fichiers temporaires contenant des mots de passe ont été supprimés.