Introduction
Pour renforcer la sécurité et simplifier la connexion à GitHub, il est recommandé d’utiliser une authentification via clef SSH plutôt que par mot de passe ou une authentification OAuth 2.
Dans ce tutoriel, nous allons voir pas à pas comment :
- générer une clef SSH,
- l’ajouter à votre compte GitHub,
- convertir la clef privée avec Puttygen
- l’utilisation de l’agent de clefs SSH Pageant
- et la configurer dans le client git Sourcetree
Génération de la clef SSH
Téléchargez l’installer MSI : https://github.com/PowerShell/Win32-OpenSSH
Lancer Powershell : Windows + R > powershell
Générer une une clef avec l’algorithme ed25519. La courbe Ed25519 est l’algorithme de signature rapide et performant utilisé en standard sur SSH.
Tapez : ssh-keygen -t ed25519 -C « votre@email.com » et ajouter une passphrase solide.
PS C:\Users\utilisateur> ssh-keygen -t ed25519 -C "votre@email.com"
Generating public/private ed25519 key pair.
Enter file in which to save the key (C:\Users\utilisateur/.ssh/id_ed25519):
Enter passphrase (empty for no passphrase):
Enter same passphrase again:Deux fichiers sont créés dans le répertoire C:\Users\[utilisateur]\.ssh\ : id_ed25519 votre clef privée et id_ed25519.pub votre clef publique.
Configuration GitHub
Connectez-vous sur votre compte GitHub est allez dans Settings > SSH and GPG keys.
Dans la rubrique SSH keys cliquer sur ‘New SSH key‘:
- Saisissez un titre
- Laissez Key type : Authentification Key
- Key : copiez-collez le contenu de votre fichier de clef publique id_ed25519.pub
Validez ensuite en cliquant sur Add SSH key.
Conversion de la clef avec Puttygen
Allez sur https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html pour télécharger la dernière version de Putty. Avec Putty il y a deux utilitaires qui vont nous intéresser : puttygen.exe et pageant.exe
Tapez Windows + R > puttygen.exe
Puttygen va nous permettre de convertir notre clef privée SSH dans un format utilisable par pageant.exe.
Aller dans Conversions > Import. Sélectionnez votre clef privée id_ed25519 et saisir votre passphrase.
Enregistrer la clef privée dans un fichier que vous nommerez id_ed25519.ppk
Configuration de Pageant
Pageant va mettre à disposition votre clé privée en mémoire pour que les clients SSH comme Sourcetree puissent s’en servir pour s’authentifier sans que vous ayez à retaper la passphrase à chaque connexion.
Ouvrir Pageant : Windows + R > pageant.exe
Cliquer sur Add Key, sélectionner le fichier id_ed25519.ppk et saisir la passphrase.
Configuration de Sourcetree
Pour tester la connexion avec git tapez : Windows + R puis : ssh -T git@github.com
Saisissez votre passphrase.
PS C:\Users\embarquech> ssh -T git@github.com
Enter passphrase for key 'C:\Users\embarquech/.ssh/id_ed25519':
Hi embarquech! You've successfully authenticated, but GitHub does not provide shell access.Si tout est bon démarrez Sourcetree, vous devez pouvoir maintenant cloner votre dépôt en passant par git de manière automatique :
