Mémo : clé SSH pour GitHub, sur Windows, macOS et Linux

Pense-bête de la manip que j’oublie à chaque fois : créer une clé SSH ed25519 au bon format et la passer à l’agent, la déclarer sur GitHub, puis vérifier que ça marche.

ssh-keygen -t ed25519 -C "vous@exemple.com"   # 2. générer
ssh-add ~/.ssh/id_ed25519                      # 3. charger (macOS : --apple-use-keychain)
cat ~/.ssh/id_ed25519.pub                      # 4. copier
                                               # 5. GitHub > Settings > SSH and GPG keys
ssh -T git@github.com                          # 6. tester
git remote set-url origin git@github.com:utilisateur/depot.git   # 7. basculer un dépôt

1. Ouvrir un terminal

Vérifiez au passage que ssh répond :

ssh -V

2. Générer la clé

La commande est la même sur les trois systèmes :

ssh-keygen -t ed25519 -C "vous@exemple.com"

• Le -C n’est qu’un commentaire, qui sert à reconnaître la clé. Une adresse e-mail ou un libellé comme "portable-perso" conviennent tous les deux.
• Appuyez sur Entrée pour garder l’emplacement par défaut :
  • Windows : C:\Users\<vous>\.ssh\id_ed25519 ;
  • macOS / Linux : ~/.ssh/id_ed25519.
• Choisissez une passphrase. Ce n’est pas obligatoire, mais c’est recommandé : l’agent SSH (étape suivante) évite de la retaper sans arrêt.

On obtient deux fichiers :

• id_ed25519 : la clé privée. Elle ne quitte jamais la machine.
• id_ed25519.pub : la clé publique. C’est elle qu’on donne à GitHub.

3. Charger la clé dans l’agent SSH

L’agent garde la clé déverrouillée en mémoire : on saisit la passphrase une seule fois.

Windows (PowerShell en administrateur)

Le service ssh-agent est désactivé par défaut sur Windows. Il faut l’activer une fois pour toutes :

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

Puis, dans un PowerShell normal :

ssh-add $env:USERPROFILE\.ssh\id_ed25519

Piège classique sur Windows : Git for Windows embarque son propre ssh, qui ne connaît pas l’agent Windows. Pour que Git utilise l’OpenSSH de Windows (et donc l’agent ci-dessus) :

git config --global core.sshCommand "C:/Windows/System32/OpenSSH/ssh.exe"

macOS

Créez (ou ouvrez) le fichier de configuration SSH :

touch ~/.ssh/config
open -e ~/.ssh/config

Ajoutez-y ce bloc, puis enregistrez :

Host github.com
  AddKeysToAgent yes
  UseKeychain yes
  IdentityFile ~/.ssh/id_ed25519

Ajoutez ensuite la clé à l’agent. La passphrase est alors enregistrée dans le Trousseau et ne vous sera plus demandée :

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

Linux

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

Sur la plupart des bureaux (GNOME, KDE), un agent tourne déjà avec la session et ssh-add suffit. Pour charger la clé automatiquement à la première connexion, ajoutez dans ~/.ssh/config :

Host github.com
  AddKeysToAgent yes
  IdentityFile ~/.ssh/id_ed25519

UseKeychain n’existe que sur macOS. Si vous partagez le même ~/.ssh/config entre plusieurs systèmes, ajoutez IgnoreUnknown UseKeychain en tête du fichier pour éviter l’erreur Bad configuration option.

4. Copier la clé publique

Attention à bien copier le fichier .pub.

# Windows (PowerShell)
Get-Content $env:USERPROFILE\.ssh\id_ed25519.pub | Set-Clipboard

# macOS
pbcopy < ~/.ssh/id_ed25519.pub

# Linux (Wayland / X11)
wl-copy < ~/.ssh/id_ed25519.pub
xclip -selection clipboard < ~/.ssh/id_ed25519.pub

# N'importe où : afficher la clé et copier la ligne à la main
cat ~/.ssh/id_ed25519.pub

La clé tient sur une seule ligne qui commence par ssh-ed25519 AAAA….

5. La déclarer sur GitHub

1. GitHub → photo de profil → Settings → SSH and GPG keys → New SSH key.
2. Title : le nom de la machine (par exemple « Portable perso » ou « PC bureau »). Il vous servira plus tard à savoir quelle clé révoquer.
3. Key type : Authentication Key.
4. Collez la clé, puis cliquez sur Add SSH key.

6. Tester

ssh -T git@github.com

À la première connexion, SSH demande de confirmer l’empreinte du serveur. Pour une clé ed25519, celle de GitHub est :

SHA256:+DiY3wvvV6TuJJhbpZisF/zLDA0zPMSvHdkr4UvCOqU

Si elle correspond, répondez yes. Vous pouvez la vérifier sur la page officielle de GitHub.

Résultat attendu :

Hi utilisateur! You've successfully authenticated, but GitHub does not provide shell access.

7. Utiliser SSH dans ses dépôts

Pour cloner un dépôt en SSH, utilisez l’URL qui commence par git@ :

git clone git@github.com:utilisateur/depot.git

Pour un dépôt déjà cloné en HTTPS, vérifiez d’abord l’URL actuelle, puis basculez-le en SSH :

git remote -v
git remote set-url origin git@github.com:utilisateur/depot.git