Se connecter en SSH avec une clé Ed25519
Créez une clé SSH Ed25519, installez-la sur votre serveur Linux, testez-la, puis désactivez la connexion par mot de passe sans perdre l'accès.
Sur cette page
Vos valeurs
Renseignez-les une fois, les commandes du guide se mettent à jour.
Une clé SSH remplace le mot de passe par une paire de fichiers : une clé privée, qui reste sur votre ordinateur, et une clé publique, que vous déposez sur le serveur. Une fois les mots de passe désactivés, les robots qui essaient des combinaisons sur le port SSH n'ont plus rien à deviner.
Ce guide suit un ordre précis pour ne pas vous couper l'accès : créer la clé, l'installer, la tester, et seulement ensuite désactiver le mot de passe.
Prérequis
- Un serveur Linux accessible en SSH avec un mot de passe. Si ce n'est pas encore le cas, suivez Se connecter à son serveur Linux en SSH
- Le mot de passe du compte, qui reste nécessaire pour la console de secours
- Un accès de secours : sur un VPS, la console NoVNC de votre espace client. Si votre offre n'en propose pas, demandez au support comment accéder au serveur en cas de blocage avant de désactiver le mot de passe
- Un terminal sur votre ordinateur : PowerShell sous Windows, Terminal sous macOS ou Linux
Dans les commandes, remplacez VOTRE_USER par votre nom d'utilisateur et VOTRE_IP_SERVEUR par l'adresse IP du serveur. Si votre port SSH n'est pas 22, ajoutez -p suivi du port aux commandes ssh et ssh-copy-id.
Étape 1 : créer la clé sur votre ordinateur
Lancez cette commande sur votre ordinateur, pas sur le serveur. Elle est identique sous Windows, macOS et Linux :
ssh-keygen -t ed25519 -C "mon-ordinateur"Le texte après -C est un simple commentaire qui vous aide à reconnaître la clé.
- Appuyez sur Entrée pour accepter l'emplacement proposé.
- Choisissez une phrase de passe. Elle chiffre la clé privée : si quelqu'un copie le fichier, il ne pourra pas s'en servir sans elle.
Deux fichiers sont créés dans le dossier .ssh de votre compte, ~/.ssh sur macOS et Linux, C:\Users\VotreNom\.ssh sous Windows :
| Fichier | Rôle | À partager ? |
|---|---|---|
id_ed25519 |
Clé privée | Jamais, ni par e-mail ni dans un ticket |
id_ed25519.pub |
Clé publique | Oui, c'est elle qui va sur le serveur |
Étape 2 : installer la clé publique sur le serveur
Connectez-vous avec le compte que vous utiliserez ensuite : la clé ne vaut que pour celui-ci.
Depuis macOS ou Linux
ssh-copy-id -i ~/.ssh/id_ed25519.pub VOTRE_USER@VOTRE_IP_SERVEURSaisissez votre mot de passe. Le message Number of key(s) added: 1 confirme l'ajout.
Depuis Windows
ssh-copy-id n'est pas fourni avec Windows. Lancez cette commande dans PowerShell :
Get-Content "$env:USERPROFILE\.ssh\id_ed25519.pub" | ssh VOTRE_USER@VOTRE_IP_SERVEUR "umask 077; mkdir -p ~/.ssh; tr -d '\r' >> ~/.ssh/authorized_keys; chmod 700 ~/.ssh; chmod 600 ~/.ssh/authorized_keys"Elle ajoute la clé à la fin du fichier authorized_keys, retire les fins de ligne propres à Windows et applique les bons droits.
Vérifier l'installation
Comparez l'empreinte de votre clé avec celles présentes sur le serveur. Sur votre ordinateur :
ssh-keygen -lf ~/.ssh/id_ed25519.pubSous Windows :
ssh-keygen -lf "$env:USERPROFILE\.ssh\id_ed25519.pub"Puis, dans votre session sur le serveur :
ssh-keygen -lf ~/.ssh/authorized_keysLa même empreinte SHA256:... doit apparaître des deux côtés.
Étape 3 : tester la connexion par clé
Dans une nouvelle fenêtre, connectez-vous en interdisant le mot de passe :
ssh -o PreferredAuthentications=publickey -o PasswordAuthentication=no VOTRE_USER@VOTRE_IP_SERVEUR- Le message
Enter passphrase for keyest normal : saisissez la phrase de passe de la clé. - Si vous arrivez sur le serveur, la clé fonctionne.
- Si vous obtenez
Permission denied (publickey), arrêtez-vous là et consultez le dépannage. Ne désactivez pas le mot de passe.
Éviter de retaper la phrase de passe
L'agent SSH garde la clé déverrouillée pendant votre session.
Sur macOS, la phrase de passe est enregistrée dans le trousseau :
ssh-add --apple-use-keychain ~/.ssh/id_ed25519Sur Linux :
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519Sous Windows, dans un PowerShell ouvert en administrateur :
Get-Service ssh-agent | Set-Service -StartupType Automatic
Start-Service ssh-agent
ssh-add "$env:USERPROFILE\.ssh\id_ed25519"Étape 4 : désactiver la connexion par mot de passe
Avant de continuer, vérifiez ces trois points :
- La connexion par clé a fonctionné dans une nouvelle fenêtre
- Votre première session SSH est toujours ouverte
- Vous disposez de votre accès de secours et du mot de passe du compte
Les commandes suivantes se lancent sur le serveur, en root. Avec un autre compte, passez d'abord en root :
sudo -iVérifier le dossier de configuration
grep -i '^Include' /etc/ssh/sshd_configLe résultat attendu est Include /etc/ssh/sshd_config.d/*.conf. Si rien ne s'affiche, passez à la variante sans dossier de configuration.
Créer le fichier de configuration
cat > /etc/ssh/sshd_config.d/00-key-only.conf <<'EOF'
PasswordAuthentication no
KbdInteractiveAuthentication no
EOF
chmod 644 /etc/ssh/sshd_config.d/00-key-only.confContrôler avant d'appliquer
Vérifiez d'abord la syntaxe. La commande ne doit rien afficher :
sshd -tAffichez ensuite la configuration réellement appliquée :
sshd -T | grep -Ei '^(passwordauthentication|kbdinteractiveauthentication|pubkeyauthentication|permitrootlogin)'Vous devez obtenir passwordauthentication no, kbdinteractiveauthentication no et pubkeyauthentication yes. Si vous vous connectez en root, permitrootlogin ne doit pas valoir no.
Appliquer le changement
Sur Debian et Ubuntu :
systemctl restart sshSur AlmaLinux, Rocky Linux, CentOS et Fedora :
systemctl restart sshdVotre session ouverte reste normalement active.
Variante sans dossier de configuration
Si sshd_config ne contient pas de ligne Include, ouvrez-le :
nano /etc/ssh/sshd_configAjoutez ces lignes tout en haut du fichier, puis enregistrez. Lancez ensuite sshd -t, sshd -T et le redémarrage comme ci-dessus.
PasswordAuthentication no
KbdInteractiveAuthentication noÉtape 5 : vérifier le résultat
Gardez toujours votre première session ouverte et faites ces deux tests dans une nouvelle fenêtre.
La connexion par clé doit réussir :
ssh VOTRE_USER@VOTRE_IP_SERVEURLa connexion par mot de passe doit échouer :
ssh -o PubkeyAuthentication=no -o PreferredAuthentications=password VOTRE_USER@VOTRE_IP_SERVEURLe résultat attendu est :
VOTRE_USER@VOTRE_IP_SERVEUR: Permission denied (publickey).Si les deux tests sont bons, vous pouvez fermer votre première session. Pour aller plus loin, consultez Sécuriser son serveur.
Revenir en arrière
Depuis la session encore ouverte, ou depuis la console NoVNC, supprimez le fichier créé puis redémarrez le service. Remplacez ssh par sshd selon votre système.
rm /etc/ssh/sshd_config.d/00-key-only.conf
sshd -t
systemctl restart sshPour ouvrir la console : dans votre espace client, ouvrez la page de votre service, cliquez sur l'icône en forme de terminal en haut à droite, choisissez NoVNC Console graphique, validez avec Ok, puis cliquez sur Connecter. Identifiez-vous avec le mot de passe du compte. Le clavier de la console peut être configuré différemment du vôtre.
Si vous aviez modifié sshd_config directement, retirez-y les deux lignes ajoutées.
Gérer vos clés
- Plusieurs ordinateurs : créez une clé par appareil et ajoutez chaque clé publique sur le serveur. Vous pourrez en retirer une sans toucher aux autres.
- Retirer un accès : supprimez la ligne correspondante dans
~/.ssh/authorized_keys, par exemple après la perte d'un ordinateur. - Sauvegarde : conservez une copie de la clé privée dans un endroit sûr, comme un gestionnaire de mots de passe. Une phrase de passe oubliée ne se récupère pas : il faut alors créer une nouvelle clé.
Dépannage
Permission denied (publickey)
Le serveur refuse votre clé. Vérifiez dans cet ordre :
- Le nom d'utilisateur : la clé doit être installée sur ce compte.
- La clé proposée par votre ordinateur :
ssh -v VOTRE_USER@VOTRE_IP_SERVEURCherchez les lignes Offering public key et Server accepts key.
- Les droits sur le serveur, depuis une session ouverte avec le compte concerné :
chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys
chown -R "$(id -un):$(id -gn)" ~/.ssh
chmod go-w ~- Sur AlmaLinux, Rocky Linux, CentOS et Fedora, le contexte SELinux :
restorecon -Rv ~/.ssh- Les journaux du serveur, avec
sshdà la place desshselon le système :
journalctl -u ssh -n 50 --no-pagerUn message Authentication refused: bad ownership or modes indique un problème de droits.
Le serveur demande encore un mot de passe
Si le message est VOTRE_USER@VOTRE_IP_SERVEUR's password:, la clé n'a pas été acceptée et le mot de passe est encore actif. Contrôlez la clé comme ci-dessus, puis relancez la commande sshd -T de l'étape 4. Si passwordauthentication yes persiste, vérifiez que votre fichier se termine bien par .conf, que le service a redémarré et qu'aucun autre fichier ne commence par un préfixe placé avant 00-.
À ne pas confondre avec Enter passphrase for key, qui demande la phrase de passe de votre clé locale.
UNPROTECTED PRIVATE KEY FILE!
Votre clé privée est lisible par d'autres comptes, et le client refuse de l'utiliser. Sur macOS et Linux :
chmod 600 ~/.ssh/id_ed25519Sous Windows :
icacls "$env:USERPROFILE\.ssh\id_ed25519" /inheritance:r /grant:r "${env:USERNAME}:F"Too many authentication failures
Votre agent propose trop de clés. Indiquez celle à utiliser :
ssh -o IdentitiesOnly=yes -i ~/.ssh/id_ed25519 VOTRE_USER@VOTRE_IP_SERVEURCould not open a connection to your authentication agent
L'agent SSH n'est pas démarré. Reprenez les commandes de la section Éviter de retaper la phrase de passe.
sshd: command not found
Le dossier /usr/sbin n'est pas dans votre chemin. Passez en root avec sudo -i, ou utilisez le chemin complet /usr/sbin/sshd.
Vous n'avez plus accès au serveur
Ouvrez la console NoVNC et suivez Revenir en arrière. Si vous ne pouvez pas vous y identifier, ouvrez un ticket depuis votre espace client. Ne transmettez jamais votre clé privée ni votre mot de passe.