Générer une clé SSH sur Mac, Linux ou Windows

La procédure suit le manuel de ssh-keygen d'OpenSSH, relu le 14 octobre 2026. Elle est la même sur macOS, sur Linux et sur Windows 10 (version 1809 et suivantes) ou Windows 11, qui fournissent tous le client OpenSSH.

Ce qu'est une clé SSH

Une clé SSH remplace le mot de passe pour se connecter à un serveur. Elle se compose de deux parties liées :

• la clé privée, un fichier secret qui reste sur votre ordinateur ;
• la clé publique, une ligne de texte que vous déposez sur le serveur, dans le fichier ~/.ssh/authorized_keys du compte.

À la connexion, le serveur vérifie que vous détenez la clé privée qui correspond à la clé publique, sans que celle-ci circule. Un robot qui essaie des mots de passe n'a rien à deviner : c'est pourquoi beaucoup de serveurs refusent toute connexion par mot de passe.

Créer la clé

1. Ouvrir un terminal. Sur Mac, l'application Terminal. Sur Linux, celui de votre bureau. Sur Windows, PowerShell ou le Terminal Windows.
2. Lancer ssh-keygen avec le type ed25519, le plus récent et le plus court, et un commentaire qui vous aidera à reconnaître la clé : ssh-keygen -t ed25519 -C "prenom@ordinateur"
3. Choisir l'emplacement. Appuyez sur Entrée pour garder l'emplacement proposé, ~/.ssh/id_ed25519 (sur Windows, C:\Users\votre-nom\.ssh\id_ed25519). Si une clé existe déjà à cet endroit, ssh-keygen demande s'il faut l'écraser : répondez non, et donnez un autre nom de fichier, sans quoi l'ancienne clé est perdue.
4. Choisir une phrase de passe. Elle chiffre la clé privée sur votre disque : un ordinateur volé ne livre pas l'accès à vos serveurs. Rien ne s'affiche pendant la saisie, c'est normal.
5. Afficher la clé publique, pour la copier : cat ~/.ssh/id_ed25519.pub sur Mac et Linux, Get-Content $env:USERPROFILE\.ssh\id_ed25519.pub dans PowerShell.

La ligne affichée commence par ssh-ed25519 et se termine par votre commentaire. C'est elle, et elle seule, que vous copiez.

Donner la clé publique au serveur

Si le serveur accepte encore les mots de passe, la commande ssh-copy-id (macOS et Linux) dépose la clé pour vous :

ssh-copy-id -i ~/.ssh/id_ed25519.pub utilisateur@adresse-du-serveur

Si le serveur n'accepte que les clés, ajoutez la ligne de la clé publique à la fin du fichier ~/.ssh/authorized_keys du compte, depuis une session déjà ouverte, ou donnez-la à votre hébergeur au moment de la commande. Le fichier doit appartenir au compte et n'être lisible que par lui :

chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys

Vous pouvez ensuite vous connecter : voir Se connecter en SSH à un serveur.

Ne pas retaper la phrase de passe

L'agent SSH garde la clé déverrouillée le temps de votre session. Sur Linux et macOS :

ssh-add ~/.ssh/id_ed25519

La phrase de passe est demandée une fois, puis l'agent la garde jusqu'à la fin de la session. Voir le manuel de ssh-add.

Les erreurs à éviter

• Envoyer la clé privée. Le fichier sans extension .pub ne se copie jamais sur un serveur, dans un courriel ou dans un outil de discussion. Si cela arrive, retirez la clé publique correspondante de tous les serveurs et créez-en une nouvelle.
• Une clé sans phrase de passe sur un portable. Elle se justifie pour un robot de déploiement, rangée dans un coffre à secrets, jamais sur un ordinateur qui voyage.
• Coller la clé sur plusieurs lignes. La clé publique tient sur une seule ligne. Un retour à la ligne ajouté par un éditeur de texte la rend invalide.

Sur un VPS Hubspace

La connexion se fait par clé uniquement : aucun mot de passe n'est accepté. Vous donnez votre clé publique au moment de la commande, dans le champ « Votre clé SSH publique », et elle est posée sur le compte admin à la livraison. Pour ajouter la clé d'un autre ordinateur ou d'un collègue, ajoutez sa ligne au fichier ~/.ssh/authorized_keys du compte admin, depuis une session ouverte avec votre propre clé. Si vous perdez votre clé, nous pouvons vous rendre l'accès depuis votre espace client.

Questions fréquentes