Association d’un e-mail à votre clé GPG

Si vous utilisez une clé GPG qui correspond à votre identité de commiteur et à votre adresse e-mail vérifiée associées à votre compte sur GitHub.com, vous pouvez commencer à signer des commits et des étiquettes.

1. Ouvrez TerminalTerminalGit Bash.

2. Utilisez la commande gpg --list-secret-keys --keyid-format=long pour répertorier la forme longue des clés GPG pour lesquelles vous disposez à la fois d’une clé publique et d’une clé privée. Une clé privée est requise pour la signature des validations ou des étiquettes.

   Shell

   gpg --list-secret-keys --keyid-format=long
   

   Remarque : pour afficher la liste des clés existantes sur certaines installations GPG exécutées sous Linux, il peut être nécessaire d’utiliser gpg2 --list-keys --keyid-format LONG. Dans ce cas, vous devez également configurer Git pour qu’il utilise gpg2 en exécutant git config --global gpg.program gpg2.

3. Dans la liste des clés GPG, copiez la forme longue de l’ID de clé GPG à utiliser. Dans cet exemple, l’ID de clé GPG est 3AA5C34371567BD2 :

   Shell

   $ gpg --list-secret-keys --keyid-format=long
   /Users/hubot/.gnupg/secring.gpg
   ------------------------------------
   sec   4096R/3AA5C34371567BD2 2016-03-10 [expires: 2017-03-10]
   uid                          Hubot <hubot@example.com>
   ssb   4096R/4BB6D45482678BE3 2016-03-10
   

4. Entrez gpg --edit-key GPG key ID en indiquant l’ID de clé GPG que vous souhaitez utiliser. Dans l’exemple suivant, l’ID de clé GPG est 3AA5C34371567BD2 :

   gpg --edit-key 3AA5C34371567BD2
   

5. Entrez gpg> adduid pour ajouter les détails de l’ID utilisateur.

   gpg> adduid
   

6. Suivez les invites pour fournir votre nom réel, votre adresse e-mail et d’éventuels commentaires. Vous pouvez modifier vos entrées en choisissant N, C ou E. Pour que votre adresse e-mail reste privée, utilisez l’adresse e-mail no-reply qui vous a été fournie par GitHub. Pour plus d’informations, consultez « Définition de votre adresse e-mail de commit ».

   Real Name: OCTOCAT
   Email address: "octocat@github.com"
   Comment: GITHUB-KEY
   Change (N)ame, (C)omment, (E)mail or (O)kay/(Q)uit?
   

7. Entrez O pour confirmer vos sélections.

8. Entrez la phrase secrète de votre clé.

9. Entrez gpg> save pour enregistrer les modifications.

   gpg> save
   

10. Entrez gpg --armor --export GPG key ID en indiquant l’ID de clé GPG que vous souhaitez utiliser. Dans l’exemple suivant, l’ID de clé GPG est 3AA5C34371567BD2 :

    $ gpg --armor --export 3AA5C34371567BD2
    # Prints the GPG key, in ASCII armor format
    

11. Chargez la clé GPG en l’ajoutant à votre compte GitHub.

Pour aller plus loin

• « Vérification des clés GPG existantes »
• « Génération d’une nouvelle clé GPG »
• « Utilisation d’une adresse e-mail vérifiée dans votre clé GPG »
• « Ajout d’une clé GPG à votre compte GitHub »
• « Signature de commits »
• « Signature d’étiquettes »