Gerar uma nova chave GPG

Algoritmos de chave GPG suportados

GitHub suporta vários algoritmos de chave GPG. Se você tentar adicionar uma chave gerada com um algoritmo não suportado, você pode encontrar um erro.

• RSA
• ElGamal
• DSA
• ECDH
• ECDSA
• EdDSA

Gerar uma chave GPG

1. Baixe e instale as ferramentas de linha de comando do GPG para seu sistema operacional. A instalação da última versão de seu sistema operacional é recomendada.

2. Abra TerminalTerminalGit Bash.

3. Gere um par de chaves GPG. Como há várias versões do GPG, talvez seja necessário consultar a página de manual relevante para encontrar o comando de geração de chave apropriado.

   • Se a sua versão for 2.1.17 ou posterior, cole o texto abaixo para gerar um par de chaves GPG.

     Shell

     gpg --full-generate-key
     

   • Se você não estiver usando a versão 2.1.17 ou superior, o comando gpg --full-generate-key não funcionará. Cole o texto abaixo e passe para a etapa 6.

     Shell

     gpg --default-new-key-algo rsa4096 --gen-key
     

4. No prompt, especifique o tipo de chave desejada ou pressione Enter para aceitar o padrão.

5. No prompt, especifique o tamanho de chave desejado ou pressione Enter para aceitar o padrão.

6. Digite o prazo de validade da chave. Pressione Enter para especificar a seleção padrão, indicando que a chave não vence. A menos que uma data de validade seja necessária, recomendamos aceitar o padrão.

7. Verifique se suas seleções estão corretas.

8. Insira seu ID de usuário.

   Observação: quando precisar inserir seu endereço de email, insira o endereço de email verificado para sua conta do GitHub. Para manter seu endereço de email privado, use seu endereço de email no-reply fornecido pelo GitHub. Para saber mais, confira "Verificar endereço de e-mail" e "Configurar o endereço de e-mail do commit".

9. Digite uma frase secreta segura.

10. Use o comando gpg --list-secret-keys --keyid-format=long para listar a forma longa das chaves GPG para as quais você tem uma chave pública e privada. Uma chave privada é necessária para assinar commits ou tags.

    Shell

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

    Observação: algumas instalações de GPG no Linux podem exigir o uso de gpg2 --list-keys --keyid-format LONG para ver uma lista das chaves existentes. Nesse caso, você também precisará configurar o Git para usar gpg2 executando git config --global gpg.program gpg2.

11. Da lista de chaves GPG, copie a forma longa do ID da chave GPG que você gostaria de usar. Neste exemplo, a ID da chave GPG é 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
    

12. Cole o texto abaixo, substituindo o ID da chave GPG que você quer usar. Neste exemplo, a ID da chave GPG é 3AA5C34371567BD2:

    Shell

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

13. Copie a chave GPG, começando com -----BEGIN PGP PUBLIC KEY BLOCK----- e terminando com -----END PGP PUBLIC KEY BLOCK-----.

14. Adicione a chave GPG à sua conta do GitHub.

Leitura adicional

• "Verificar se há chaves GPG"
• "Como adicionar uma chave GPG a uma conta do GitHub"
• "Informar ao Git sobre a chave de assinatura"
• "Associar um e-mail à chave GPG"
• "Assinar commits"
• "Assinar tags"