À propos de l’ajout de clés SSH à votre compte
Vous pouvez accéder et écrire des données dans des référentiels sur GitHub à l’aide de SSH (protocole Secure Shell). Quand vous vous connectez via SSH, vous vous authentifiez avec un fichier de clé privée sur votre ordinateur local. Pour plus d’informations, consultez À propos de SSH.
Vous pouvez également utiliser SSH pour signer des commits et des étiquettes. Pour plus d’informations sur la signature de commit, consultez À propos de la vérification des signatures de commit.
Après avoir généré une paire de clés SSH, vous devez ajouter la clé publique à votre instance GitHub Enterprise Server afin d'activer l’accès SSH pour votre compte.
Prérequis
Avant d’ajouter une nouvelle clé SSH à votre compte sur votre instance GitHub Enterprise Server, procédez comme suit.
- Recherchez les clés SSH existantes. Pour plus d’informations, consultez « Vérification des clés SSH existantes ».
- Générez une nouvelle clé SSH et ajoutez-la à l’agent SSH de votre ordinateur. Pour plus d’informations, consultez « Génération d’une nouvelle clé SSH et ajout de celle-ci à ssh-agent ».
Ajout d’une nouvelle clé SSH à votre compte
Vous pouvez ajouter une clé SSH et l’utiliser pour l’authentification, la signature de commit, ou les deux. Si vous souhaitez utiliser la même clé SSH pour l’authentification et la signature, vous devez le télécharger deux fois.
Après avoir ajouté une nouvelle clé d’authentification SSH à votre compte sur votre instance GitHub Enterprise Server, vous pouvez reconfigurer n’importe quel référentiel local pour utiliser SSH. Pour plus d’informations, consultez « Création de dépôt distants ».
Note
Pour plus d’informations sur GitHub CLI, consultez À propos de GitHub CLI.
Pour pouvoir utiliser GitHub CLI afin d’ajouter une clé SSH à votre compte, vous devez vous authentifier auprès de GitHub CLI. Pour plus d’informations, consultez gh auth login dans la documentation GitHub CLI.
Pour ajouter une clé SSH à votre compte GitHub, utilisez la sous-commande ssh-key add en spécifiant votre clé publique. Pour les clés d’authentification, si vous êtes invité à demander des étendues supplémentaires, suivez les instructions de la ligne de commande.
gh ssh-key add KEY-FILE --type {authentication|signing}
Pour inclure un titre pour la nouvelle clé, utilisez l’indicateur -t ou --title.
gh ssh-key add KEY-FILE --title "personal laptop"
Si vous avez généré votre clé SSH en suivant les instructions fournies dans Génération d’une nouvelle clé SSH et ajout de celle-ci à ssh-agent, vous pouvez ajouter la clé à votre compte avec cette commande.
gh ssh-key add ~/.ssh/id_ed25519.pub --type signing