Guide complet, pas à pas, pour les débutants.
SSH (Secure Shell) est un protocole qui permet de communiquer de façon sécurisée avec un serveur, ici GitHub, sans taper votre mot de passe à chaque fois.
Il repose sur une paire de clés :
| Clé | Fichier (par défaut) | Rôle | À partager ? |
|---|---|---|---|
| Clé privée | id_ed25519 | Votre « clé de maison » secrète. Elle reste sur votre PC. | JAMAIS |
| Clé publique | id_ed25519.pub | Le « cadenas » que vous donnez à GitHub. | Oui, c'est fait pour ça |
Principe : vous placez le cadenas (clé publique) sur GitHub. Quand vous vous connectez, votre PC prouve qu'il possède la clé correspondante (clé privée), sans jamais l'envoyer.
| SSH | HTTPS | |
|---|---|---|
| URL de clonage | git@github.com:user/repo.git | https://github.com/user/repo.git |
| Authentification | Clé SSH | Jeton d'accès personnel (token) |
| Configuration initiale | Une seule fois | Gestionnaire d'identifiants |
| Pratique au quotidien | Très pratique | Pratique aussi |
Note : GitHub n'accepte plus les mots de passe de compte pour Git en HTTPS. Il faut un jeton ou une clé SSH. SSH est donc un excellent choix.
Ouvrez PowerShell (touche Windows, tapez PowerShell, Entrée) et saisissez :
git --versiongit version 2.xx.x... : Git est installé, passez à l'étape 4.main.git --version
ssh -VLes deux commandes doivent afficher un numéro de version.
Astuce : Windows 10/11 inclut aussi son propre client OpenSSH. Les commandes de ce guide fonctionnent avec les deux.
Git signe chaque commit avec un nom et un e-mail. Configurez-les une seule fois :
git config --global user.name "Votre Nom"
git config --Conseil : utilisez l'e-mail associé à votre compte GitHub (ou l'adresse
noreplyfournie par GitHub dans Settings > Emails) pour que vos commits soient liés à votre profil.
Vérification :
git config --global --listDans PowerShell :
dir $env:USERPROFILE\.sshid_ed25519 et id_ed25519.pub (ou id_rsa et id_rsa.pub) : vous avez déjà une clé. Vous pouvez la réutiliser et passer à l'étape 7.Attention : ne générez pas une nouvelle clé du même nom si vous en avez déjà une, car elle écraserait l'ancienne.
Dans PowerShell, remplacez l'e-mail par le vôtre :
ssh-keygen -t ed25519 -C "votre.email@exemple.com"
ed25519est l'algorithme recommandé : moderne, rapide et sûr. Si votre système est très ancien et ne le supporte pas :ssh-keygen -t rsa -b 4096 -C "votre.email@exemple.com"
Question 1 : l'emplacement du fichier
Enter file in which to save the key (C:\Users\VotreNom/.ssh/id_ed25519):Appuyez simplement sur Entrée pour accepter l'emplacement par défaut.
Question 2 : la phrase secrète (passphrase)
Enter passphrase (empty for no passphrase):Une passphrase protège votre clé privée : si quelqu'un copie votre fichier, il ne pourra pas l'utiliser sans elle.
Your identification has been saved in C:\Users\VotreNom/.ssh/id_ed25519
Your public key has been saved in C:\Users\VotreNom/.ssh/id_ed25519.pub
The key fingerprint is:
SHA256:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx votre.email@exemple.comDeux fichiers sont créés dans C:\Users\VotreNom\.ssh\ :
id_ed25519 : clé privée (secrète)id_ed25519.pub : clé publique (à donner à GitHub)L'agent SSH garde votre clé en mémoire pour que vous ne retapiez pas la passphrase à chaque opération.
Windows, tapez PowerShell, clic droit sur Windows PowerShell, puis Exécuter en tant qu'administrateur.La colonne Status doit afficher Running.
Si la commande échoue avec une erreur « service introuvable », installez le client OpenSSH via Paramètres > Applications > Fonctionnalités facultatives > Ajouter une fonctionnalité > Client OpenSSH.
Dans un PowerShell normal :
ssh-add $env:USERPROFILE\.ssh\id_ed25519Saisissez votre passphrase si demandé. Résultat attendu :
Identity added: C:\Users\VotreNom\.ssh\id_ed25519 (votre.email@exemple.com)Pour vérifier les clés chargées :
ssh-add -lDans PowerShell, cette commande copie directement la clé publique dans le presse-papiers :
Get-Content $env:USERPROFILE\.ssh\id_ed25519.pub | Set-ClipboardVous pouvez aussi l'afficher pour la copier à la main :
Get-Content $env:USERPROFILE\.ssh\id_ed25519.pubElle ressemble à ceci (une seule ligne) :
ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAA... votre.email@exemple.comImportant : copiez bien le contenu du fichier
.pub, jamais celui du fichier sans extension (clé privée).
PC Windows - MaisonAuthentication KeyCtrl + V)La clé apparaît maintenant dans votre liste.
ssh -T git@github.comAu premier lancement, SSH affiche :
The authenticity of host 'github.com (140.82.x.x)' can't be established.
ED25519 key fingerprint is SHA256:+DiY3wvvV6TuJJhbpZisF/zLDA0zPMSvHdkr4UvCOqU.
This key is not known by any other names.
Are you sure you want to continue connecting (yes/no/[fingerprint])?yes puis Entrée.Cette vérification garantit que vous parlez bien au vrai GitHub. Si l'empreinte est différente, tapez
noet ne continuez pas.
Hi VotreNomGitHub! You've successfully authenticated, but GitHub does not provide shell access.Ce message signifie que tout fonctionne. Le « no shell access » est normal : GitHub ne vous ouvre pas de terminal, il sert uniquement Git.
L'URL ressemble à : git@github.com:nom-utilisateur/nom-du-projet.git
Placez-vous dans le dossier qui contiendra votre projet, par exemple :
mkdir $env:USERPROFILE\Projets
cd $env:USERPROFILE\Projetsgit clone git@github.com:nom-utilisateur/nom-Résultat attendu :
Cloning into 'nom-du-projet'...
remote: Enumerating objects: 120, done.
remote: Counting objects: 100% (120/120), done.
Receiving objects: 100% (120/120), 45.20 KiB | 1.20 MiB/s, done.
Resolving deltas: 100% (50/50), done.Pour cloner dans un dossier au nom différent :
git clone git@github.com:nomcd nom-
git remote -v doit afficher des URL commençant par git@github.com:, ce qui confirme l'usage de SSH.
Pour ouvrir le dossier dans l'Explorateur Windows :
explorer .| Action | Commande |
|---|---|
| Voir l'état des fichiers | git status |
| Récupérer les nouveautés | git pull |
| Ajouter vos modifications | git add . |
| Enregistrer un commit | git commit -m "Description du changement" |
| Envoyer vers GitHub | git push |
| Voir l'historique | git log --oneline |
| Créer une branche | git switch -c nom-branche |
Exemple de cycle complet :
Si vous avez déjà cloné un projet en HTTPS, inutile de le recloner :
Permission denied (publickey)La clé n'est pas reconnue par GitHub. Vérifiez dans l'ordre :
.pub).ssh-add -l. Sinon, relancez ssh-add $env:USERPROFILE\.ssh\id_ed25519.ssh -vT git@github.com (cherchez les lignes Offering public key et Authentication succeeded).Could not open a connection to your authentication agentL'agent SSH n'est pas démarré. Voir l'étape 7.1 (PowerShell en administrateur).
Host key verification failedL'empreinte de GitHub a changé ou est corrompue dans votre fichier known_hosts. Si vous avez vérifié que l'empreinte officielle est correcte, supprimez l'ancienne entrée :
ssh-keygen -R github.comPuis relancez ssh -T git@github.com.
Repository not found ou fatal: Could not read from remote repositoryBad owner or permissions on ...\.ssh\configLes droits du fichier sont trop ouverts. Dans PowerShell :
Le port 22 est parfois bloqué. GitHub propose SSH sur le port 443 :
ssh -T -p 443 git@ssh.github.comPour le rendre permanent, créez ou éditez le fichier C:\Users\VotreNom\.ssh\config :
Host github.com
Hostname ssh.github.com
Port 443
User gitL'agent ne conserve pas la clé. Vérifiez que le service ssh-agent est en Running et relancez ssh-add.
Créez une clé par compte, puis déclarez-les dans C:\Users\VotreNom\.ssh\config :
Clonez ensuite avec l'alias : git clone git@github-travail:entreprise/projet.git
id_ed25519) : ni par e-mail, ni sur GitHub, ni dans un dépôt, ni dans un chat..ssh ou vos clés dans un dépôt Git.| Terme | Définition |
|---|---|
| SSH | Protocole de communication sécurisée avec un serveur distant. |
| Clé privée | Fichier secret qui prouve votre identité. Ne jamais partager. |
| Clé publique | Fichier partageable, vérifié par GitHub à partir de votre clé privée. |
| Passphrase | Mot de passe qui protège votre clé privée. |
| Agent SSH | Programme qui garde vos clés déverrouillées en mémoire. |
| Empreinte (fingerprint) | Identifiant unique d'une clé, utilisé pour la vérifier. |
| Cloner | Copier un dépôt distant sur votre ordinateur, historique compris. |
| Dépôt (repository) | Projet suivi par Git. |
| Remote / origin | Adresse du dépôt distant (GitHub). origin est son nom par défaut. |
| Commit | Enregistrement d'un ensemble de modifications. |
Guide rédigé pour Windows 10/11. Documentation officielle : https://docs.github.com/fr/authentication/connecting-to-github-with-ssh
Get-Service ssh-agent | Set-Service -StartupType Automatic
Start-Service ssh-agent
Get-Service ssh-agentcd chemin\vers\le\projet
git remote set-url origin git@github.com:nom-utilisateur/nom-du-projet.git
git remote -vicacls $env:USERPROFILE\.ssh\config /inheritance:r /grant:r "$($env:USERNAME):F"Host github-perso
Hostname github.com
User git
IdentityFile ~/.ssh/id_ed25519
IdentitiesOnly yes
Host github-travail
Hostname github.com
User git
IdentityFile ~/.ssh/id_ed25519_travail
IdentitiesOnly yes# Vérifier les outils
git --version
ssh -V
# Identité Git (une fois)
git config --global user.name "Votre Nom"
git config --global user.email "votre.email@exemple.com"
# Générer une clé
ssh-keygen -t ed25519 -C "votre.email@exemple.com"
# Agent SSH (PowerShell administrateur, une fois)
Get-Service ssh-agent | Set-Service -StartupType Automatic
Start-Service ssh-agent
# Charger la clé
ssh-add $env:USERPROFILE\.ssh\id_ed25519
# Copier la clé publique
Get-Content $env:USERPROFILE\.ssh\id_ed25519.pub | Set-Clipboard
# Tester GitHub
ssh -T git@github.com
# Cloner
git clone git@github.com:utilisateur/depot.git