FR

Linux et réseau

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.

8 min de lecture, mis à jour le 18 novembre 2026

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 :

Terminal
ssh-keygen -t ed25519 -C "mon-ordinateur"

Le texte après -C est un simple commentaire qui vous aide à reconnaître la clé.

  1. Appuyez sur Entrée pour accepter l'emplacement proposé.
  2. 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

Terminal
ssh-copy-id -i ~/.ssh/id_ed25519.pub VOTRE_USER@VOTRE_IP_SERVEUR

Saisissez 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 :

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 :

Terminal
ssh-keygen -lf ~/.ssh/id_ed25519.pub

Sous Windows :

PowerShell
ssh-keygen -lf "$env:USERPROFILE\.ssh\id_ed25519.pub"

Puis, dans votre session sur le serveur :

Terminal
ssh-keygen -lf ~/.ssh/authorized_keys

La 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 :

Terminal
ssh -o PreferredAuthentications=publickey -o PasswordAuthentication=no VOTRE_USER@VOTRE_IP_SERVEUR
  • Le message Enter passphrase for key est 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 :

Terminal
ssh-add --apple-use-keychain ~/.ssh/id_ed25519

Sur Linux :

Terminal
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519

Sous Windows, dans un PowerShell ouvert en administrateur :

PowerShell
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 :

Terminal
sudo -i

Vérifier le dossier de configuration

Terminal
grep -i '^Include' /etc/ssh/sshd_config

Le 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

Terminal
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.conf

Contrôler avant d'appliquer

Vérifiez d'abord la syntaxe. La commande ne doit rien afficher :

Terminal
sshd -t

Affichez ensuite la configuration réellement appliquée :

Terminal
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 :

Terminal
systemctl restart ssh

Sur AlmaLinux, Rocky Linux, CentOS et Fedora :

Terminal
systemctl restart sshd

Votre session ouverte reste normalement active.

Variante sans dossier de configuration

Si sshd_config ne contient pas de ligne Include, ouvrez-le :

Terminal
nano /etc/ssh/sshd_config

Ajoutez ces lignes tout en haut du fichier, puis enregistrez. Lancez ensuite sshd -t, sshd -T et le redémarrage comme ci-dessus.

Texte
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 :

Terminal
ssh VOTRE_USER@VOTRE_IP_SERVEUR

La connexion par mot de passe doit échouer :

Terminal
ssh -o PubkeyAuthentication=no -o PreferredAuthentications=password VOTRE_USER@VOTRE_IP_SERVEUR

Le résultat attendu est :

Texte
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.

Terminal
rm /etc/ssh/sshd_config.d/00-key-only.conf
sshd -t
systemctl restart ssh

Pour 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 :

  1. Le nom d'utilisateur : la clé doit être installée sur ce compte.
  2. La clé proposée par votre ordinateur :
Terminal
ssh -v VOTRE_USER@VOTRE_IP_SERVEUR

Cherchez les lignes Offering public key et Server accepts key.

  1. Les droits sur le serveur, depuis une session ouverte avec le compte concerné :
Terminal
chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys
chown -R "$(id -un):$(id -gn)" ~/.ssh
chmod go-w ~
  1. Sur AlmaLinux, Rocky Linux, CentOS et Fedora, le contexte SELinux :
Terminal
restorecon -Rv ~/.ssh
  1. Les journaux du serveur, avec sshd à la place de ssh selon le système :
Terminal
journalctl -u ssh -n 50 --no-pager

Un 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 :

Terminal
chmod 600 ~/.ssh/id_ed25519

Sous Windows :

PowerShell
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 :

Terminal
ssh -o IdentitiesOnly=yes -i ~/.ssh/id_ed25519 VOTRE_USER@VOTRE_IP_SERVEUR

Could 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.