À propos de l’ajout de clés SSH à votre compte
Vous pouvez consulter et écrire des données dans des référentiels sur votre instance GitHub Enterprise Server en utilisant 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 ».
Après avoir généré une paire de clés SSH, vous devez ajouter la clé publique dans 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 dans votre instance GitHub Enterprise Server, effectuez les étapes suivantes.
- 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
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 ».
-
Copiez la clé publique SSH dans votre Presse-papiers.
Si votre fichier de clé publique a un nom différent de celui de l’exemple de code, modifiez-le pour qu’il corresponde à votre configuration actuelle. Quand vous copiez votre clé, n’ajoutez pas de lignes ou d’espaces blancs.
$ pbcopy < ~/.ssh/id_ed25519.pub # Copies the contents of the id_ed25519.pub file to your clipboard
Conseil : Si
pbcopy
ne fonctionne pas, vous pouvez localiser le dossier masqué.ssh
, ouvrir le fichier dans votre éditeur de texte favori et le copier dans le Presse-papiers.$ clip < ~/.ssh/id_ed25519.pub # Copies the contents of the id_ed25519.pub file to your clipboard
Conseil : Avec le Sous-système Windows pour Linux (WSL), vous pouvez utiliser
clip.exe
. Siclip
ne fonctionne pas, vous pouvez localiser le dossier.ssh
masqué, ouvrir le fichier dans votre éditeur de texte favori et le copier dans le Presse-papiers.$ cat ~/.ssh/id_ed25519.pub # Then select and copy the contents of the id_ed25519.pub file # displayed in the terminal to your clipboard
Conseil : Vous pouvez également localiser le dossier masqué
.ssh
, ouvrir le fichier dans votre éditeur de texte favori et le copier dans le Presse-papiers. -
Dans la barre latérale des paramètres utilisateur, cliquez sur Clés SSH et GPG.
-
Cliquez sur Nouvelle clé SSH ou Ajouter une clé SSH.
-
Dans le champ « Titre », ajoutez une étiquette descriptive pour la nouvelle clé. Par exemple, si vous utilisez un ordinateur portable personnel, vous pouvez nommer cette clé « Ordinateur portable personnel ».
-
Dans le champ « Clé », collez votre clé publique.
-
Cliquez sur Ajouter une clé SSH.
-
Si vous y êtes invité, confirmez l’accès à votre compte dans GitHub Enterprise Server. Pour plus d’informations, consultez « Mode sudo ».
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é d’authentification SSH à votre compte GitHub, utilisez la sous-commande ssh-key add
en spécifiant votre clé publique.
gh ssh-key add KEY-FILE
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