Taper un mot de passe à chaque connexion à un serveur devient vite pénible, et un mot de passe peut se deviner. Les clés SSH règlent ces deux problèmes. À la fin de ce guide, vous aurez une clé ed25519 protégée par une phrase secrète, un serveur qui l’accepte, un alias court pour taper simplement ssh myserver, et la même configuration qui fonctionne avec votre hébergeur git.
Ce qu’il vous faut
- Un ordinateur sous macOS, Linux ou Windows 10/11 avec le client OpenSSH intégré.
- Un serveur ou un second ordinateur auquel vous accédez déjà avec un nom d’utilisateur et un mot de passe.
- Un terminal (Terminal sur macOS, n’importe quel shell sur Linux, PowerShell sur Windows).
- Environ 15 minutes.
Les exemples utilisent alice comme nom d’utilisateur, server.example.com comme serveur et 203.0.113.10 comme adresse. Remplacez-les par les vôtres.
Étape 1 : générer une clé ed25519
Exécutez ceci sur l’ordinateur depuis lequel vous vous connecterez. L’option -C ajoute un commentaire, généralement votre adresse e-mail, pour distinguer vos clés plus tard.
ssh-keygen -t ed25519 -C "alice@example.com"
Les versions récentes d’OpenSSH utilisent déjà ed25519 par défaut, mais préciser le type rend la commande portable. Appuyez sur Entrée pour accepter l’emplacement par défaut. Vous verrez quelque chose comme ceci :
Generating public/private ed25519 key pair.
Enter file in which to save the key (/home/alice/.ssh/id_ed25519):
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in /home/alice/.ssh/id_ed25519
Your public key has been saved in /home/alice/.ssh/id_ed25519.pub
Vous avez maintenant deux fichiers. id_ed25519 est la clé privée : traitez-la comme un mot de passe et ne la partagez jamais. id_ed25519.pub est la clé publique, que vous pouvez copier n’importe où sans risque.
Étape 2 : ajouter une phrase secrète et charger la clé dans ssh-agent
Quand une phrase secrète (passphrase) vous est demandée, choisissez-en une. Si quelqu’un copie un jour votre clé privée, la phrase secrète lui barrera encore la route. Si vous l’avez sautée, ajoutez-la plus tard avec ssh-keygen -p -f ~/.ssh/id_ed25519.
ssh-agent garde en mémoire la clé déverrouillée, ce qui vous évite de retaper la phrase secrète plus d’une fois par session.
macOS
Lancez l’agent et ajoutez votre clé au trousseau macOS :
eval "$(ssh-agent -s)"
ssh-add --apple-use-keychain ~/.ssh/id_ed25519
Ajoutez ensuite ces lignes à ~/.ssh/config (créez le fichier s’il n’existe pas) pour que la clé se charge automatiquement :
Host *
AddKeysToAgent yes
UseKeychain yes
IdentityFile ~/.ssh/id_ed25519
UseKeychain est un ajout d’Apple, il ne fonctionne donc que sur macOS.
Linux
Beaucoup de sessions de bureau lancent déjà un agent. Si ce n’est pas le cas de la vôtre, démarrez-en un et ajoutez la clé :
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519
Windows
Le service ssh-agent est désactivé par défaut. Ouvrez PowerShell en tant qu’administrateur et exécutez :
Get-Service ssh-agent | Set-Service -StartupType Automatic
Start-Service ssh-agent
Puis, dans une fenêtre PowerShell normale :
ssh-add $env:USERPROFILE\.ssh\id_ed25519
Étape 3 : copier votre clé publique sur le serveur
Le serveur conserve une liste de clés publiques de confiance dans ~/.ssh/authorized_keys. Le plus simple pour y ajouter la vôtre est ssh-copy-id, disponible sur macOS et la plupart des systèmes Linux :
ssh-copy-id -i ~/.ssh/id_ed25519.pub alice@server.example.com
Il vous demande une dernière fois le mot de passe du serveur, crée le fichier si nécessaire et ignore les clés déjà installées.
Si vous n’avez pas ssh-copy-id, par exemple dans Windows PowerShell, copiez le fichier de clé avec scp, puis ajoutez-le à la liste sur le serveur :
scp $env:USERPROFILE\.ssh\id_ed25519.pub alice@server.example.com:key.pub
ssh alice@server.example.com "mkdir -p ~/.ssh && chmod 700 ~/.ssh && cat ~/key.pub >> ~/.ssh/authorized_keys && chmod 600 ~/.ssh/authorized_keys && rm ~/key.pub"
Ces commandes concernent un serveur Linux ou macOS. Chacune vous demande le mot de passe du serveur. Un serveur Windows stocke les clés ailleurs, et les comptes administrateur utilisent C:\ProgramData\ssh\administrators_authorized_keys. Dans ce cas, suivez le guide de Microsoft indiqué plus bas.
Étape 4 : se connecter et vérifier l’empreinte de l’hôte
Connectez-vous maintenant :
ssh alice@server.example.com
La première fois que vous joignez un nouveau serveur, SSH affiche son empreinte et vous demande de confirmer :
The authenticity of host 'server.example.com (203.0.113.10)' can't be established.
ED25519 key fingerprint is SHA256:4fXk2...Q9wE.
Are you sure you want to continue connecting (yes/no/[fingerprint])?
Ne tapez pas yes machinalement. Si possible, vérifiez l’empreinte sur le serveur lui-même, depuis une console ou une session déjà ouverte :
ssh-keygen -l -f /etc/ssh/ssh_host_ed25519_key.pub
Si les deux correspondent, tapez yes. SSH enregistre la clé dans ~/.ssh/known_hosts et vous avertira si elle change un jour. Vous devriez maintenant arriver dans un shell sans qu’on vous demande le mot de passe du serveur. La phrase secrète de votre clé peut vous être demandée une fois si l’agent ne la détient pas encore.
Étape 5 : créer un alias Host dans ~/.ssh/config
Ajoutez une entrée à ~/.ssh/config sur votre propre ordinateur :
Host myserver
HostName server.example.com
User alice
Port 22
IdentityFile ~/.ssh/id_ed25519
IdentitiesOnly yes
Désormais, il suffit de taper :
ssh myserver
IdentitiesOnly yes indique à SSH de ne proposer que la clé que vous avez indiquée.
Étape 6 : SSH entre deux de vos machines à la maison
Les mêmes étapes fonctionnent entre deux ordinateurs de votre réseau domestique. La machine à laquelle vous vous connectez doit simplement faire tourner un serveur SSH.
Sur un Mac, ouvrez Réglages Système, allez dans Général, puis Partage, et activez Remote Login (Session à distance). Cliquez sur le bouton d’information à côté pour voir la commande ssh exacte pour ce Mac.
Sur Ubuntu, installez le paquet serveur :
sudo apt install openssh-server
Trouvez l’adresse locale de la machine cible dans ses réglages réseau. Ensuite, depuis l’autre ordinateur, copiez votre clé et connectez-vous comme avant en utilisant cette adresse. Dans cet exemple, c’est une valeur fictive :
ssh-copy-id alice@192.168.1.50
ssh alice@192.168.1.50
Étape 7 (facultative) : désactiver les connexions par mot de passe
Une fois la connexion par clé fonctionnelle, vous pouvez empêcher le serveur d’accepter le moindre mot de passe. Les robots qui devinent les mots de passe n’ont alors plus rien à deviner.
Gardez votre session SSH actuelle ouverte pendant l’opération. En cas de problème, c’est grâce à cette session ouverte que vous pourrez corriger. Testez depuis un second terminal avant de fermer quoi que ce soit.
Sur Ubuntu, les réglages placés dans /etc/ssh/sshd_config.d/ priment sur le fichier principal, et c’est la première valeur lue qui l’emporte. Les fichiers sont chargés par ordre alphabétique, donc un nom commençant par 00- est lu en premier :
sudo nano /etc/ssh/sshd_config.d/00-no-passwords.conf
Ajoutez ces deux lignes :
PasswordAuthentication no
KbdInteractiveAuthentication no
Vérifiez que la configuration ne contient pas d’erreur, puis redémarrez le service :
sudo sshd -t
sudo systemctl restart ssh.service
Depuis un nouveau terminal, lancez ssh myserver pour confirmer que vous pouvez toujours entrer. Essayez ensuite ssh -o PubkeyAuthentication=no myserver : la connexion doit être refusée. Maintenir à jour les logiciels du serveur compte tout autant.
Étape 8 : connecter un hébergeur git
Les hébergeurs git comme GitHub acceptent la même clé. Affichez votre clé publique et copiez-la :
cat ~/.ssh/id_ed25519.pub
Collez-la dans la section des clés SSH des réglages de votre compte, en suivant le guide de votre hébergeur git (celui de GitHub est indiqué plus bas). Puis testez :
ssh -T git@github.com
Un test réussi ressemble à ceci :
Hi alice! You've successfully authenticated, but GitHub does not provide shell access.
Votre compte git est un élément clé de votre identité en ligne, il vaut donc la peine de vérifier aussi vos autres comptes.
Erreurs fréquentes et solutions
Permission denied (publickey)
Le serveur n’a accepté aucune des clés proposées. Vérifiez que la clé publique figure dans ~/.ssh/authorized_keys sur le serveur, que vous utilisez le bon nom d’utilisateur et que l’agent détient votre clé. Lancez ssh -v myserver pour voir quelles clés sont essayées.
Mauvaises permissions sur ~/.ssh
Par défaut, le serveur SSH ignore vos clés si vos fichiers sont trop ouverts. Sur le serveur, corrigez-les avec :
chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys
WARNING: UNPROTECTED PRIVATE KEY FILE!
Votre clé privée est lisible par d’autres utilisateurs, donc SSH refuse de l’utiliser. Sur votre propre ordinateur, exécutez :
chmod 600 ~/.ssh/id_ed25519
WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED!
La clé du serveur ne correspond plus à celle de known_hosts. Cela arrive après la réinstallation d’un serveur, mais peut aussi signaler une attaque. Vérifiez que le changement est normal, puis supprimez l’ancienne entrée et reconnectez-vous :
ssh-keygen -R server.example.com
The agent has no identities
ssh-add -l affiche ce message quand l’agent tourne mais ne détient aucune clé. Ajoutez de nouveau la vôtre avec ssh-add ~/.ssh/id_ed25519. Si vous voyez « Could not open a connection to your authentication agent », démarrez d’abord l’agent, comme indiqué à l’étape 2.
En résumé
Vous vous connectez désormais avec une clé au lieu d’un mot de passe, votre clé est protégée par une phrase secrète et un alias garde les commandes courtes. Utilisez une clé par ordinateur plutôt que de copier une clé privée partout. Si vous perdez un appareil, supprimez la ligne de sa clé publique dans authorized_keys et chez votre hébergeur git.
Une fois la connexion par clé devenue une routine, les mêmes réflexes de terminal vous serviront dans des environnements de développement plus récents. Notre guide sur Chrome DevTools MCP montre comment donner un vrai navigateur à un agent de programmation.
Sources et documentation officielle
Liens vérifiés pour la dernière fois le 15 novembre 2026.
- OpenSSH ssh-keygen manual
- OpenSSH ssh manual
- OpenSSH ssh_config manual
- OpenSSH sshd_config manual
- ssh-copy-id manual page
- GitHub Docs: Generating a new SSH key and adding it to the ssh-agent
- GitHub Docs: Testing your SSH connection
- Microsoft Learn: Key-based authentication in OpenSSH for Windows
- Ubuntu Server docs: OpenSSH server
- Apple Support: Allow a remote computer to access your Mac





Écrire une réponse