Skip to main content

Sobre a autenticação com um GitHub App

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 um 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 a autenticação 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 ele precisa listar as contas em que ele está instalado. Para obter mais informações, confira "Efetuar autenticação como um aplicativo GitHub" e "Como gerar um JWT (Token Web JSON) para um Aplicativo GitHub."

Autenticação como uma instalação de aplicativo

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 obter mais informações, confira "Como autenticar como uma instalação de Aplicativo GitHub" e "Como gerar 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 obter mais informações, confira "Autenticação com um aplicativo GitHub em nome de um usuário" e "Como gerar um token de acesso do usuário para um GitHub App."