Skip to main content
Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais recentes, acesse a documentação em inglês. Se houver problemas com a tradução desta página, entre em contato conosco.

Esta versão do GitHub Enterprise foi descontinuada em 2022-06-03. Nenhum lançamento de patch será feito, mesmo para questões críticas de segurança. Para obter melhor desempenho, melhorar a segurança e novos recursos, upgrade to the latest version of GitHub Enterprise. Para ajuda com a atualização, contact GitHub Enterprise support.

Diferenças entre os aplicativos GitHub e OAuth

Entender as diferenças entre Aplicativos do GitHub e Aplicativos OAuth ajudará você a decidir qual aplicativo você deseja criar. O aplicativo OAuth atua como usuário do GitHub, enquanto o aplicativo GitHub usa sua própria identidade quando instalado em uma organização ou em repositórios de uma organização.

Quem pode instalar aplicativos GitHub e autorizar aplicativos OAuth?

Você pode instalar os aplicativos GitHub em sua conta pessoal ou em organizações das quais você é proprietário. Se você tiver permissões de administrador em um repositório, você poderá instalar os aplicativos GitHub em contas de organização. Se um aplicativo GitHub for instalado em um repositório e exigir permissões de organização, o proprietário da organização deverá aprovar o aplicativo.

Por padrão, somente proprietários da organização podem gerenciar as configurações dos aplicativos GitHub em uma organização. Para permitir que usuários adicionais gerenciem os Aplicativos GitHub em uma organização, um proprietário pode conceder-lhes permissões de gerente de aplicativos do GitHub. Veja "GitHub App Managers" para saber como adicionar e remover gerentes do GitHub App em sua organização.

Por outro lado, os usuários autorizam aplicativos OAuth, que dão ao aplicativo a capacidade de atuar como usuário autenticado. Por exemplo, você pode autorizar um aplicativo OAuth que encontra todas as notificações para o usuário autenticado. Você sempre pode revogar as permissões de um aplicativo OAuth.

Warning: Revogar todas as permissões de um aplicativo OAuth exclui quaisquer chaves SSH geradas pelo aplicativo em nome do usuário, incluindo deploy keys.

Aplicativos do GitHubAplicativos OAuth
Você deve ser proprietário de uma organização ou ter permissões de administrador em um repositório para instalar um aplicativo do GitHub em uma organização. Se um aplicativo GitHub for instalado em um repositório e exigir permissões de organização, o proprietário da organização deverá aprovar o aplicativo.Você pode autorizar um aplicativo OAuth para ter acesso a recursos.
Você pode instalar um aplicativo GitHub no seu repositório pessoal.Você pode autorizar um aplicativo OAuth para ter acesso a recursos.
Você deve ser um proprietário da organização, proprietário pessoal do repositório ou ter permissões de administrador em um repositório para desinstalar um aplicativo GitHub e remover seu acesso.Você pode excluir um token de acesso do OAuth para remover o acesso.
Você deve ser um proprietário de uma organização ou ter permissões de administrador em um repositório para solicitar a instalação de um aplicativo GitHub.Se uma política de aplicativos da organização estiver ativa, qualquer integrante da organização poderá solicitar a instalação de um aplicativo OAuth em uma organização. Um proprietário da organização deve aprovar ou negar a solicitação.

O que o aplicativo GitHub e o aplicativo OAuth podem acessar?

Os proprietários de contas podem usar um aplicativo GitHub em uma conta sem conceder acesso a outra. Por exemplo, você pode instalar um serviço de criação de terceiros na organização do seu empregador, mas decidir não conceder esse acesso de serviço de criação aos repositórios na sua conta pessoal. Um aplicativo GitHub permanece instalado se a pessoa que o configura sair da organização.

Um aplicativo OAuth authorized tem acesso a todos os recursos acessíveis do usuário ou do proprietário da organização.

Aplicativos do GitHubAplicativos OAuth
A instalação de um aplicativo GitHub concede o acesso do aplicativo aos repositórios escolhidos por um usuário ou conta de organização.Autorizar um aplicativo OAuth concede acesso aos recursos acessíveis do usuário. Por exemplo, repositórios que podem acessar.
O token de instalação de um aplicativo GitHub perde acesso aos recursos se um administrador remover repositórios da instalação.Um token de acesso do OAuth perde acesso aos recursos quando o usuário perde acesso, como quando perdem acesso de gravação em um repositório.
Os tokens de acesso de instalação são limitados a repositórios especificados com as permissões escolhidas pelo criador do aplicativo.Um token de acesso do OAuth é limitado por meio de escopos.
Os aplicativos GitHub podem solicitar acesso separado para problemas e pull requests sem acessar o conteúdo real do repositório.Os aplicativos OAuth precisam solicitar o escopo do repositório para obter acesso a problemas, pull requests ou qualquer coisa que seja propriedade do repositório.
Os aplicativos GitHub não estão sujeitos � s políticas do aplicativo da organização. Um aplicativo GitHub só tem acesso aos repositórios que o proprietário de uma organização concedeu.Se uma política de aplicativos da organização estiver ativa, somente um proprietário da organização poderá autorizar a instalação de um aplicativo OAuth. Se instalado, o aplicativo OAuth ganhará acesso a qualquer coisa visível para o token que o proprietário da organização tem dentro da organização aprovada.
Um aplicativo GitHub recebe um evento do webhook quando uma instalação é alterada ou removida. Isto informa ao criador do aplicativo quando receberam mais ou menos acesso aos recursos de uma organização.Os aplicativos OAuth podem perder acesso a uma organização ou repositório a qualquer momento com na alteração de acesso do usuário concedido. O aplicativo OAuth não irá informá-lo quando perde acesso a um recurso.

Identificação baseada em token

Observação: Os aplicativos GitHub também podem usar token baseado em usuários. Para obter mais informações, consulte "Identificar e autorizar usuários para aplicativos GitHub".

Aplicativos do GitHubAplicativos OAuth
Um aplicativo GitHub pode solicitar um token de acesso de instalação usando uma chave privada com um formato de token do JSON fora da banda.Um aplicativo OAuth pode trocar um token de solicitação por um token de acesso após um redirecionamento por meio de uma solicitação da web.
Um token de instalação identifica o aplicativo como o bot do aplicativo GitHub, como, por exemplo, @jenkins-bot.Um token de acesso identifica o aplicativo como o usuário que concedeu o token ao aplicativo, como, por exemplo, o @octocat.
Os tokens de instalação expiram após um tempo predefinido (atualmente, 1 hora).Os tokens do OAuth permanecem ativos até que sejam cancelados pelo cliente.
Aplicativos do GitHub instalado em organizações ou repositórios estão sujeitos a limites de taxa para solicitações de servidor para servidor. Para obter mais informações, consulte "Limites de taxa para Aplicativos do GitHub".Os tokens OAuth usam o limite de taxa do usuário de 5.000 por hora.
Os aumentos no limite de taxa pode ser concedido tanto no nível do aplicativo GitHub (afetando todas as instalações) quanto no nível de instalação individual.Os aumentos no limite de taxa são concedidos pelo aplicativo OAuth. Todo token concedido para que o aplicativo OAuth obtém um aumento do limite.
Aplicativos do GitHub pode efetuar a autenticação em nome do usuário, que é chamado de solicitação de usuário para servidor. O fluxo para autorizar é o mesmo que o fluxo de autorização do aplicativo OAuth. Os tokens de usuário para servidor podem expirar e ser renovados com um token de atualização. Para obter mais informações, consulte "Atualizando tokens de acesso do usuário para servidor" e "identificando e autorizando os usuários para os aplicativos GitHub".O fluxo do OAuth usado por Aplicativos OAuth autoriza um aplicativo OAuth em nome do usuário. Este é o mesmo fluxo de uso na autorização de usuário para servidor do aplicativo GitHub.

Solicitar níveis de permissão para os recursos

Ao contrário dos aplicativos OAuth, os aplicativos GitHub têm permissões direcionadas que lhes permitem solicitar acesso apenas ao que precisam. Por exemplo, uma Integração Contínua (CI) do aplicativo GitHub pode solicitar acesso de leitura ao conteúdo do repositório e acesso de gravação �  API de status. Outro aplicativo GitHub não pode ter acesso de leitura ou de gravação para o código, mas ainda assim pode gerenciar problemas, etiquetas e marcos. Os aplicativos OAuth não podem usar permissões granulares.

AccessAplicativos GitHub (permissões de leitura ou gravação)Aplicativos OAuth
Para acesso a repositórios públicosO repositório público precisa ser escolhido durante a instalação.Escopo do public_repo.
Para acesso ao código/conteúdo do repositórioConteúdo do repositórioEscopo do repositório.
Para acesso a problema, etiquetas e marcosProblemasEscopo do repositório.
Para acesso a pull requests, etiquetas e marcosPull requestsEscopo do repositório.
Para acesso ao status do commit (para criações de CI)Status do commitEscopo do repo:status.
Para acesso � s implantações e status de implantaçãoImplantaçõesEscopo do repo_deployment.
Para receber eventos por meio de um webhookUm aplicativo de GitHub inclui um webhook por padrão.Escopo write:repo_hook ou write:org_hook.

Descoberta de repositório

Aplicativos do GitHubAplicativos OAuth
Os aplicativos GitHub podem olhar para /installation/repositórios para ver os repositórios que a instalação pode acessar.Aplicativos OAuth podem olhar para /user/repos para obter uma visualização do usuário ou para /orgs/:org/repos para obter uma visualização da organização dos repositórios repositórios acessíveis.
Os aplicativos GitHub recebem webhooks quando os repositórios são adicionados ou removidos da instalação.Os aplicativos OAuth criam webhooks de organização para notificações quando um novo repositório é criado dentro de uma organização.

Webhooks

Aplicativos do GitHubAplicativos OAuth
Por padrão, os aplicativos GitHub têm um único webhook que recebe os eventos que estão configurados para receber para cada repositório ao qual têm acesso.Os aplicativos OAuth solicitam o escopo do webhook para criar um webhook do repositório para cada repositório do qual precisam receber eventos.
O aplicativo GitHub recebe certos eventos a nível da organização com a permissão do integrante da organização.Os aplicativos OAuth solicitam o escopo do webhook da organização para criar um webhook da organização para cada organização da qual precisam para receber eventos a nível da organização.
Os webhooks são automaticamente desabilitados quando o aplicativo GitHub é desinstalado.Os webhooks não são automaticamente desabilitados se o token de acesso do OAuth do aplicativo for excluído, e não há nenhuma maneira de limpá-los automaticamente. Você terá que pedir que os usuários façam isso manualmente.

Acesso Git

Aplicativos do GitHubAplicativos OAuth
Os aplicativos GitHub solicitam permissão de conteúdo de repositórios e usam seu token de instalação para efetuar a autenticação por meio do Git baseado em HTTP.Os aplicativos OAuth solicitam escopo write:public_key e Criar uma chave de implantação por meio da API. Você pode usar essa chave para realizar comandos do Git.
O token é usado como senha HTTP.O token é usado como nome de usuário HTTP.

Máquina vs. contas de bot

Contas de usuário de máquina são contas pessoal baseadas no OAuth que separam sistemas automatizados usando o sistema de usuário do GitHub.

As contas do bot são específicas para os aplicativos GitHub e são construídas em todos os aplicativos GitHub.

Aplicativos do GitHubAplicativos OAuth
Os bots do aplicativo GitHub não consomem uma estação GitHub Enterprise.Uma conta de usuário de máquina consome uma estação GitHub Enterprise.
Como um bot do aplicativo GitHub nunca recebe uma senha, um cliente não pode entrar diretamente nele.Um nome de usuário e senha são concedidos a uma conta de usuário de máquina para ser gerenciada e protegida pelo cliente.