Gerenciando chaves privadas para aplicativos GitHub

Sobre chaves privadas para GitHub Apps

Depois de criar uma GitHub App, você precisará gerar uma chave privada para fazer solicitações à GitHub API como o próprio aplicativo. Por exemplo, você precisa de uma chave privada para assinar um JWT (Token Web JSON) e solicitar um token de acesso de instalação. Para saber mais, confira Gerando um JWT (Token Web JSON) para um aplicativo GitHub

Você pode criar até 25 chaves privadas para um aplicativo. Você deve usar várias chaves para realizar a rotação sem tempo de inatividade no caso de um comprometimento de chave. Se o aplicativo tiver 25 ou mais chaves, você deverá excluir algumas antes de criar mais.

As chaves privadas não expiram e, assim, precisam ser revogadas manualmente. Para obter mais informações sobre como revogar ou excluir uma chave privada, confira Como excluir chaves privadas.

Você deve manter as chaves privadas de GitHub Apps seguras. Para obter mais informações, confira Como armazenar chaves privadas.

Para verificar se uma chave privada corresponde a uma chave pública, confira Como verificar chaves privadas.

Gerar chaves privadas

Para gerar uma chave privada:

1. No canto superior direito de qualquer página do GitHub, clique na foto do seu perfil.

2. Acesse as configurações da sua conta.

   • Para um aplicativo de propriedade de uma conta pessoal, clique em Configurações.
   • Para um aplicativo de propriedade de uma organização:
     1. Clique em Suas organizações.
     2. À direita da organização, clique em Configurações.

3. Na barra lateral esquerda, clique em Developer settings.

4. Na barra lateral esquerda, clique em GitHub Apps .

5. Ao lado de GitHub App, para o qual você deseja gerar uma chave privada, clique em Editar.

6. Na barra lateral esquerda, clique em Credenciais e, em seguida, clique em Pares de chaves.

7. Clique em Nova chave.

8. Você verá uma chave privada no formato PEM baixado no seu computador. Certifique-se de armazenar esse arquivo porque GitHub armazena apenas a parte pública da chave. Para obter mais informações sobre como armazenar sua chave com segurança, confira Como armazenar chaves privadas.

Verificar chaves privadas