Skip to main content

Sobre a autenticação com um aplicativo GitHub

Seu GitHub App pode se autenticar como ele mesmo, como uma instalação de aplicativo ou em nome de um usuário.

Autenticação como GitHub App

Para realizar a autenticação como ele mesmo, o aplicativo usará um Token Web JSON (JWT). Seu aplicativo deverá se autenticar como ele mesmo quando precisar gerar um token de acesso de instalação. Um token de acesso de instalação é necessário para autenticar-se como uma instalação de aplicativo. Seu aplicativo também deverá se autenticar como ele mesmo quando precisar fazer solicitações de API para gerenciar recursos relacionados ao aplicativo. Por exemplo, quando for necessário listar as contas em que está instalado. Para saber mais, confira Autenticando como aplicativo GitHub e Gerando um JWT (Token Web JSON) para um aplicativo GitHub.

Autenticação como instalação de app

Para realizar a autenticação como uma instalação, o aplicativo usará um token de acesso à instalação. Seu aplicativo será autenticado como uma instalação de aplicativo quando você quiser atribuir a atividade do aplicativo ao aplicativo. A autenticação como uma instalação de aplicativo permite que o aplicativo acesse recursos pertencentes ao usuário ou à organização que instalou o aplicativo. A autenticação como uma instalação de aplicativo é ideal para fluxos de trabalho de automação que não envolvem a entrada de usuário. Para saber mais, confira Como autenticar como uma instalação de Aplicativo GitHub e Gerando um token de acesso de instalação para um aplicativo GitHub.

Autenticação em nome de um usuário

Para realizar a autenticação em nome de um usuário, o aplicativo usará um token de acesso do usuário. Seu aplicativo será autenticado em nome de um usuário quando você quiser atribuir a atividade do aplicativo a um usuário. Semelhante à autenticação como uma instalação de aplicativo, o aplicativo pode acessar recursos pertencentes ao usuário ou à organização que instalou o aplicativo. A autenticação em nome de um usuário é ideal quando você deseja garantir que o aplicativo execute apenas ações que possam ser executadas por um usuário específico. Para saber mais, confira Autenticação com um aplicativo GitHub em nome de um usuário e Gerando um token de acesso do usuário para um aplicativo GitHub.