Configurer des clés SSH et se connecter à un serveur sans mot de passe

Générez une clé ed25519, copiez-la sur votre serveur et connectez-vous sans mot de passe. Pas à pas pour macOS, Linux et Windows, avec sécurisation et configuration git.

Flat illustration of a key and a terminal window linking two computers with a secure connection line

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.

Vidéo : « How SSH password-less key based authentication work in 4 minutes » (L’authentification SSH par clé, sans mot de passe, expliquée en 4 minutes) par Hussein Nasser.

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

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

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

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

Code
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é :

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

Code
Get-Service ssh-agent | Set-Service -StartupType Automatic
Start-Service ssh-agent

Puis, dans une fenêtre PowerShell normale :

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

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

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

Terminal
ssh alice@server.example.com

La première fois que vous joignez un nouveau serveur, SSH affiche son empreinte et vous demande de confirmer :

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

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

Code
Host myserver
  HostName server.example.com
  User alice
  Port 22
  IdentityFile ~/.ssh/id_ed25519
  IdentitiesOnly yes

Désormais, il suffit de taper :

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

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

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

Terminal
sudo nano /etc/ssh/sshd_config.d/00-no-passwords.conf

Ajoutez ces deux lignes :

Code
PasswordAuthentication no
KbdInteractiveAuthentication no

Vérifiez que la configuration ne contient pas d’erreur, puis redémarrez le service :

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

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

Terminal
ssh -T git@github.com

Un test réussi ressemble à ceci :

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

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

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

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

Écrit par Mindloop Editorial

The Mindloop Experience editorial team writes clear, carefully sourced explainers and how-tos on tech, science, money and culture, for anyone who likes to know how things actually work.

À propos de Mindloop Experience

Réponses

Écrire une réponse

Plus d’articles de Mindloop Experience

Tout voir de Mindloop Experience

Vous pouvez applaudir jusqu’à 50 fois.