Skip to main content

Ajout d’une nouvelle clé SSH à votre compte GitHub

Pour configurer votre compte sur GitHub.com de façon à utiliser votre clé SSH nouvelle (ou existante), vous devez aussi ajouter cette dernière à votre compte.

À propos de l’ajout de clés SSH à votre compte

Vous pouvez consulter et écrire des données dans des référentiels sur GitHub.com 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 ».

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 dans GitHub.com afin d’activer l’accès SSH pour votre compte.

Prérequis

Avant d’ajouter une nouvelle clé SSH à votre compte dans GitHub.com, effectuez les étapes suivantes.

  1. Recherchez les clés SSH existantes. Pour plus d’informations, consultez « Vérification des clés SSH existantes ».
  2. 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 GitHub.com, vous pouvez reconfigurer n’importe quel référentiel local pour utiliser SSH. Pour plus d’informations, consultez « Faire passer les URL de dépôt distant de HTTPS à SSH ».

Remarque : GitHub a amélioré la sécurité en supprimant d’anciens types de clés non sécurisés le 15 mars 2022.

Depuis cette date, les clés DSA (ssh-dss) ne sont plus prises en charge. Vous ne pouvez pas ajouter de nouvelles clés DSA à votre compte personnel sur GitHub.com.

Les clés RSA (ssh-rsa) avec une date valid_after antérieure au 2 novembre 2021 peuvent continuer à utiliser n’importe quel algorithme de signature. Les clés RSA générées après cette date doivent utiliser un algorithme de signature SHA-2. Il se peut que certains clients plus anciens nécessitent un mise à niveau pour utiliser des signatures SHA-2.

  1. 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 : Si clip 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.

    $ 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.

    1. Dans le coin supérieur droit d’une page, cliquez sur votre photo de profil, puis sur **Paramètres**.

    Icône Paramètres dans la barre de l’utilisateur

  2. Dans la section « Accès » de la barre latérale, cliquez sur Clés SSH et GPG.

  3. Cliquez sur Nouvelle clé SSH ou Ajouter une clé SSH. Bouton Clé SSH

  4. 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 ».

  5. Sélectionnez le type de clé : authentification ou signature. Pour plus d’informations sur la signature de commit, consultez « À propos de la vérification des signatures de commit ».

  6. Collez votre clé dans le champ « Clé ». Le champ de clé

  7. Cliquez sur Ajouter une clé SSH. Bouton Ajouter une clé

  8. Si vous y êtes invité, confirmez l’accès à votre compte dans GitHub Enterprise Cloud. Pour plus d’informations, consultez « Mode sudo ».

Pour en savoir plus 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.

Actuellement, vous pouvez uniquement utiliser GitHub CLI pour ajouter des clés d’authentification SSH. Vous ne pouvez pas ajouter de clés de signature SSH.

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 », vous pouvez ajouter la clé à votre compte avec cette commande.

gh ssh-key add ~/.ssh/id_ed25519.pub

Pour aller plus loin