Debian 13 : tutoriel / Configurer les clés SSH sans perdre l’accès au serveur
Pour configurer l'authentification par clé Secure Shell (SSH) sur Debian 13, vérifiez l'empreinte de la clé hôte du serveur, enregistrez votre clé publique et testez une connexion distincte authentifiée par clé. Restreignez les connexions par mot de passe et les connexions directes en tant que root uniquement après que ce test réussisse. Conservez une session dont le fonctionnement est vérifié et gardez la console de la VM disponible tout en vérifiant la syntaxe de sshd, la politique effective et les nouvelles connexions.
Préparez le chemin de connexion et la console de récupération
Utilisez la VM Debian minimale installée avec la tâche serveur SSH. L'exemple suppose que lfstudent est votre administrateur sudo existant. Si votre nom d'utilisateur est différent, remplacez-le de manière cohérente dans chaque commande. Passez en revue l’exercice sur les utilisateurs, les groupes et les permissions si vous avez besoin de vérifier l'accès sudo du compte.
Pour le NAT de VirtualBox, redirigez l'adresse de l'hôte 127.0.0.1:22213 vers le port TCP 22 de l'invité. Avec la VM éteinte, sélectionnez-la dans VirtualBox Manager, ouvrez Paramètres → Réseau → Adaptateur 1, confirmez NAT, puis ouvrez Avancé → Redirection de port. Ajoutez une règle TCP avec IP de l'hôte 127.0.0.1, Port de l'hôte 22213, IP de l'invité vide et Port de l'invité 22. Réutilisez une règle existante correspondante et vérifiez les conflits de port de l'hôte. Cette règle liée à la boucle locale permet l'accès depuis l'hôte actuel ; 127.0.0.1 sur un autre ordinateur fait référence à cet ordinateur, pas à cette VM.
Tout d'abord, vérifiez sur la console Debian. Si vous n'avez pas installé openssh-server, exécutez sudo apt update et sudo apt install openssh-server sur la console et préparez le service.
systemctl is-active ssh
systemctl is-enabled ssh
ss -lnt | grep ':22 '
sudo /usr/sbin/sshd -t
sudo ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub
Assurez-vous que le service est actif et activé au démarrage. sshd -t ne renvoie généralement rien si cela réussit. S'il y a une erreur, ne commencez pas à changer la politique de connexion. Le relevé du cours d’origine porte sur une VM Debian 13.7 et un client Windows OpenSSH.
Distinguer les clés d'hôte du serveur des clés d'utilisateur
| Distinction | Cible à vérifier | Emplacement de stockage et rôle |
|---|---|---|
| Clé d'hôte du serveur | Si c'est le serveur auquel vous êtes connecté | L'identité est vérifiée à l'aide des fichiers /etc/ssh/ssh_host_* du serveur et du known_hosts du client. |
| Clé privée de l'utilisateur | Vérifiez si l'utilisateur connecté possède la clé | Stockée sur le client. Ne pas copier sur le serveur ni partager avec d'autres. |
| Clé publique de l'utilisateur | La moitié publique correspondant à la clé privée autorisée | Enregistrée dans .ssh/authorized_keys dans le répertoire personnel de l'utilisateur du serveur. |
Connectez-vous initialement depuis Windows PowerShell en utilisant ce qui suit. Comme la clé n'a pas encore été enregistrée, le mot de passe de l'utilisateur du serveur peut être requis.
ssh -o HostKeyAlgorithms=ssh-ed25519 -p 22213 lfstudent@127.0.0.1
Comparez l'empreinte SHA256 affichée initialement avec l'empreinte de la clé hôte ED25519 vérifiée précédemment dans la console de la VM avant de l'approuver. Ne tapez pas 'yes' simplement parce qu'une empreinte apparaît à l'écran. ssh-keyscan est un outil pour récupérer les clés depuis le réseau, ce n'est pas un moyen de vérifier indépendamment l'identité du serveur.
Si vous réinstallez le serveur ou changez la cible NAT, la clé hôte peut être différente. Si vous voyez un avertissement REMOTE HOST IDENTIFICATION HAS CHANGED, vérifiez d'abord la console et la cible de connexion. Ne retirez l'entrée dans PowerShell en utilisant ssh-keygen -R "[127.0.0.1]:22213" et ne revérifiez l'empreinte que si vous avez confirmé que le changement est légitime. Ne supprimez pas l'intégralité de known_hosts sans vérification.
Créer une clé utilisateur Ed25519 sur Windows
Exécutez la commande suivante sur Windows. Assurez-vous qu'il n'y a pas de fichier portant le même nom avant de le créer. Si vous avez déjà une clé privée en cours d'utilisation, ne l'écrasez pas et choisissez un nouveau nom de fichier approprié. Si vous ne trouvez pas la commande OpenSSH, vérifiez si le client OpenSSH est installé dans les fonctionnalités optionnelles de Windows.
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.ssh" | Out-Null
Test-Path "$env:USERPROFILE\.ssh\debian13_lab"
Test-Path "$env:USERPROFILE\.ssh\debian13_lab.pub"
Créez la paire de clés uniquement si les deux résultats sont False. La phrase de passe est une phrase qui protège l'utilisation du fichier de clé privée et est différente du mot de passe du compte serveur. Pour les clés utilisées lors de connexions interactives, définissez une phrase unique difficile à deviner et établissez une politique de récupération et de stockage.
ssh-keygen -t ed25519 -f "$env:USERPROFILE\.ssh\debian13_lab" -C "debian13-lab-admin"
Get-Content "$env:USERPROFILE\.ssh\debian13_lab.pub"
Le fichier debian13_lab généré sans extension est la clé privée ; debian13_lab.pub est la clé publique. Copiez uniquement la ligne unique de la clé publique commençant par ssh-ed25519 sur le serveur. Le manuel ssh-keygen documente la création de clés et les options d'empreinte. Debian 13 ne prend plus en charge les clés Digital Signature Algorithm (DSA), comme expliqué dans les changements OpenSSH des notes de version de Debian 13 ; ne tentez pas de restaurer l'accès en réactivant les clés ssh-dss obsolètes.
Enregistrez la clé publique et testez une nouvelle connexion
Exécutez ce qui suit à l'intérieur de Debian en tant que lfstudent depuis la session SSH existante ou la console. Vérifiez que les autres utilisateurs ne peuvent pas écrire dans votre répertoire personnel. Avant d'exécuter la commande de sauvegarde, vérifiez que le fichier ~/.ssh/authorized_keys.before-course07 n'existe pas déjà ; s'il existe, choisissez un nouveau nom de fichier de sauvegarde et utilisez-le de manière cohérente. Conservez les clés existantes tout en préparant .ssh.
whoami
ls -ld ~
mkdir -p ~/.ssh
chmod 700 ~/.ssh
touch ~/.ssh/authorized_keys
chmod 600 ~/.ssh/authorized_keys
cp -a ~/.ssh/authorized_keys ~/.ssh/authorized_keys.before-course07
nano ~/.ssh/authorized_keys
Si un fichier de sauvegarde existe déjà, conservez-le en utilisant un nouveau nom. Dans l'éditeur, conservez les clés publiques existantes encore valides et ajoutez la nouvelle clé publique sur une nouvelle ligne. Le fait que le contenu de la clé publique apparaisse à l'écran en étant renvoyé à la ligne à cause de la largeur est différent des véritables sauts de ligne dans le fichier. Une clé doit être sur une seule ligne. Après l'enregistrement, vérifiez le propriétaire et les permissions.
stat -c '%a %U %G %n' ~ ~/.ssh ~/.ssh/authorized_keys
Vérifiez que le propriétaire de .ssh et de authorized_keys est lfstudent, et que les modes sont respectivement 700 et 600. Si un administrateur les a créés pour le compte de l'utilisateur, assurez-vous qu'aucun fichier appartenant à root n'est resté par erreur. Ne rendez pas le répertoire personnel du serveur accessible en écriture par tous et ne mettez pas de clés privées dans authorized_keys.
Exécutez une connexion dans une nouvelle fenêtre PowerShell en autorisant uniquement l'authentification par clé, en laissant la session existante telle quelle. Ici, c'est limité pour éviter de confondre un succès qui bascule automatiquement vers l'authentification par mot de passe avec un succès de l'authentification par clé.
ssh -i "$env:USERPROFILE\.ssh\debian13_lab" -o IdentitiesOnly=yes -o PreferredAuthentications=publickey -o PasswordAuthentication=no -p 22213 lfstudent@127.0.0.1
Une invite pour la phrase de passe de la clé privée peut apparaître, mais elle ne basculera pas vers l'authentification par mot de passe du compte serveur. Après connexion, vérifiez id -un et sudo -v sur Debian. Étant donné que les connexions par authentification de clé et l'authentification sudo sont séparées, même si SSH est uniquement par clé, sudo peut nécessiter le mot de passe de l'utilisateur. Ne désactivez pas la connexion par mot de passe avant que la connexion de la nouvelle session et les opérations administratives ne soient vérifiées.
Restreignez les connexions par mot de passe et root et vérifiez la politique effective
Gardez la console et la session SSH en cours disponibles. Exécutez séparément la première commande, qui crée le répertoire de sauvegarde et continuez seulement si elle réussit. Arrêtez-vous si la vérification de l'un des chemins cibles échoue : ne remplacez pas une sauvegarde précédente ni un fichier existant /etc/ssh/sshd_config.d/00-lf-course.conf. Cet exemple ajoute uniquement un nouveau fragment de configuration.
sudo test ! -e /var/backups/lf-debian13-07 && sudo install -d -m 700 /var/backups/lf-debian13-07
sudo cp -a /etc/ssh/sshd_config /etc/ssh/sshd_config.d /var/backups/lf-debian13-07/
sudo test ! -e /etc/ssh/sshd_config.d/00-lf-course.conf
sudo nano /etc/ssh/sshd_config.d/00-lf-course.conf
Mettez les quatre lignes suivantes dans le nouveau fichier. Ce sont des directives sshd_config, présentées en texte brut plutôt qu'en commandes shell.
PubkeyAuthentication yes
PasswordAuthentication no
KbdInteractiveAuthentication no
PermitRootLogin no
PasswordAuthentication contrôle l'authentification par mot de passe, et KbdInteractiveAuthentication contrôle le chemin d'authentification interactif. N'appliquez pas ces quatre lignes telles quelles à un serveur opérationnel utilisant l'authentification interactive dans le cadre de l'authentification multifacteur (MFA) ; vérifiez d'abord la politique de votre organisation. PermitRootLogin no empêche la connexion SSH directe en tant que root et est distinct d'un administrateur ordinaire utilisant sudo.
sudo chmod 600 /etc/ssh/sshd_config.d/00-lf-course.conf
sudo /usr/sbin/sshd -t
sudo /usr/sbin/sshd -T -C user=lfstudent,host=localhost,addr=10.0.2.2 | grep -E '^(pubkeyauthentication|passwordauthentication|kbdinteractiveauthentication|permitrootlogin) '
Si -t échoue, corrigez l'erreur avant de recharger. L'option -T affiche les paramètres effectifs, tandis que -C fournit les conditions de connexion. Dans ce laboratoire NAT VirtualBox, l'invité voit 10.0.2.2 comme l'adresse côté client. Remplacez l'adresse d'exemple et les conditions Match par celles de votre session réelle, en utilisant la sortie de printf '%s\n' "$SSH_CONNECTION". Si vous utilisez la correspondance de nom d'hôte, fournissez également la condition de nom d'hôte réelle du client.
permitrootlogin no
pubkeyauthentication yes
passwordauthentication no
kbdinteractiveauthentication no
manuel sshd_config explique que la plupart des paramètres utilisent la valeur obtenue en premier. Un nom de fichier qui se classe plus tard, ou une directive placée en dernier, ne prend pas automatiquement le dessus. Le résultat peut varier en fonction de l'emplacement d'Include dans le fichier Debian par défaut, des autres fragments de configuration et des conditions Match, donc vérifiez que le résultat -T correspond à votre intention.
Recharger et vérifier une autre nouvelle connexion
Si la syntaxe est valide et les paramètres effectifs correspondent à la politique souhaitée, rechargez la configuration sans arrêter le service.
sudo systemctl reload ssh
systemctl is-active ssh
Une fois que le service indique qu'il est actif, ouvrez une autre nouvelle connexion avec la commande PowerShell précédente ne nécessitant qu’une clé. Une session en cours n’atteste pas que de nouvelles tentatives d’authentification fonctionnent. Le manuel sshd documente les tests de configuration ; une connexion réelle réussie vérifie une partie distincte de la configuration.
Dans le cours d’origine, une nouvelle clé de test Ed25519 a été créée et enregistrée dans une VM dédiée ; de nouvelles connexions ont été vérifiées avant et après le changement de politique. Un fichier de configuration incorrect, préparé séparément, a été rejeté par -t sans être appliqué au service. Les clés d’automatisation ont des contraintes de gestion différentes des clés protégées par une phrase de passe pour les connexions interactives. À la fin du test d’origine, le retrait de la clé publique a été suivi d’une vérification du refus de reconnexion avec cette clé.
Si la connexion échoue, vérifiez sudo journalctl -u ssh -b --no-pager -n 50 sur le serveur. Le message Permission denied (publickey) invite à vérifier le compte, la clé, les permissions et la politique d’authentification. Pour Connection refused, commencez par le service à l’écoute et la cible de redirection de port ; en cas de délai dépassé, vérifiez d’abord le chemin réseau et le pare-feu. La sortie détaillée ssh -v du client est utile pour le diagnostic, mais examinez le nom d'utilisateur, le chemin et les informations du serveur avant de les partager avec d'autres.
Récupérer l'accès et révoquer les clés inutiles
Si seuls les fichiers nouvellement ajoutés dans cet exercice sont la cause, retirez uniquement la configuration ajoutée ici, depuis la session fonctionnelle conservée ou la console de la VM. Vérifiez avec précision la cible de suppression et ne l'appliquez pas aux fichiers créés par d'autres administrateurs.
sudo rm -- /etc/ssh/sshd_config.d/00-lf-course.conf
sudo /usr/sbin/sshd -t && sudo systemctl reload ssh
sudo /usr/sbin/sshd -T | grep -E '^(pubkeyauthentication|passwordauthentication|kbdinteractiveauthentication|permitrootlogin) '
Si vous avez également modifié /etc/ssh/sshd_config ou d'autres fragments de configuration, restaurez les modifications en les comparant avec la sauvegarde puis exécutez de nouveau sshd -t avant tout rechargement. Si la connexion SSH est complètement interrompue, ne tentez pas de la réparer de manière répétée via le réseau ; connectez-vous via la console de la VM. Vous devriez également vérifier avant de commencer le travail si vous pouvez utiliser l'authentification par console et sudo.
Lors de la révocation d'une clé de test, ne retirez que cette ligne de clé publique spécifique du fichier authorized_keys. Ne supprimez pas les clés existantes que plusieurs personnes utilisent ensemble. Vous ne pouvez restaurer la sauvegarde originale de authorized_keys que si aucune autre clé valide n'a été ajoutée depuis la sauvegarde. Si vous perdez une clé privée, simplement changer le mot de passe ne supprime pas l'accès associé à cette clé, elle doit donc également être révoquée de la liste des clés autorisées du serveur.




