GitLab - 8.2 Configurer une clé SSH sous Windows
Une clé SSH permet de prouver votre identité à GitLab sans saisir votre mot de passe à chaque opération. Elle se compose de deux fichiers : une clé privée, que vous gardez secrète, et une clé publique, que vous ajoutez à votre compte GitLab. Cette leçon montre comment les créer sous Windows.
Générer la paire de clés
Ouvrez un terminal et lancez la commande ssh-keygen. Elle crée par défaut une clé de type RSA, enregistrée dans le dossier .ssh de votre dossier utilisateur. Acceptez le chemin proposé par défaut.
La commande demande ensuite une phrase de passe. La vidéo passe cette étape pour simplifier la démonstration sous Windows. Une phrase de passe protège pourtant la clé privée : sans elle, toute personne qui accède à votre fichier peut l'utiliser.
ssh-keygenAjouter la clé publique à GitLab
Affichez le contenu de la clé publique, dont le nom se termine par .pub, avec la commande cat. Copiez l'intégralité du texte affiché.
Dans GitLab, ouvrez votre profil, puis les paramètres, puis la section des clés SSH. Collez la clé, donnez-lui un titre qui identifie votre machine, puis ajoutez-la. Vous pouvez aussi définir une date d'expiration.
cat ~/.ssh/id_rsa.pub- Ne partagez jamais la clé privée, c'est-à-dire le fichier sans extension .pub
- Supprimez une clé depuis la même page si elle est compromise
- Changer de clé ne modifie ni votre nom d'utilisateur ni votre mot de passe GitLab
En résumé
Une paire de clés SSH comprend une clé privée secrète et une clé publique partageable. Vous ajoutez la clé publique à GitLab pour authentifier votre machine. Protégez aussi votre clé privée par une phrase de passe.
Points clés
- La clé privée reste sur votre ordinateur et ne doit jamais être partagée.
- La clé publique est ajoutée à votre profil GitLab.
- La commande ssh-keygen crée la paire de clés dans le dossier .ssh.
- Une phrase de passe protège la clé privée si quelqu'un accède à vos fichiers.
- Une clé compromise se supprime depuis les paramètres GitLab.
Questions fréquentes
Quelle différence entre clé privée et clé publique ?
La clé publique peut être partagée, par exemple avec GitLab. La clé privée doit rester secrète, car elle prouve votre identité.
Faut-il absolument définir une phrase de passe ?
La vidéo la saute pour simplifier. Une phrase de passe reste recommandée, car elle protège la clé privée si quelqu'un accède à vos fichiers.
Que faire si ma clé SSH ne fonctionne pas ?
Redémarrez l'ordinateur ou le terminal, puis vérifiez que la clé publique a bien été ajoutée à votre profil GitLab.