Skip to main content

Sobre o uso dos Aplicativos do GitHub

Saiba o que é um GitHub App e por que um GitHub App é usado.

Sobre os GitHub Apps

Os GitHub Apps são ferramentas que estendem a funcionalidade do GitHub. Os GitHub Apps podem fazer coisas no GitHub como abrir problemas, fazer comentários sobre solicitações de pull e gerenciar projetos. Eles também podem fazer coisas fora do GitHub com base em eventos que acontecem no GitHub. Por exemplo, um GitHub App pode postar no Slack quando um problema é aberto no GitHub.

Encontrar GitHub Apps

É possível descobrir GitHub Apps no GitHub Marketplace.

Também é possível criar seu próprio GitHub App. Para saber mais, confira Sobre a criação de Aplicativos do GitHub.

Usar GitHub Apps

Para usar um GitHub App, é necessário instalar o aplicativo em sua conta de usuário ou de organização. Ao instalar o aplicativo, você concede permissão a ele para ler ou modificar os dados do seu repositório e da sua organização. As permissões específicas dependem do aplicativo e o GitHub informará quais permissões o aplicativo solicitou antes de instalá-lo. Ao instalar o aplicativo, você também especificará quais repositórios ele pode acessar. Se o aplicativo precisar de configurações adicionais, ele direcionará você a essas configurações. Para saber mais, confira Instalando um Aplicativo GitHub por meio do GitHub Marketplace em sua conta pessoal, Instalando um Aplicativo GitHub por meio do GitHub Marketplace em suas organizações, Instalando um Aplicativo GitHub de terceiros e Instalando seu próprio Aplicativo GitHub.

Também pode ser preciso autorizar um GitHub App a verificar sua identidade, saber quais recursos você pode acessar ou realizar ações em seu nome. Se você precisar autorizar o aplicativo, ele solicitará isso a você. Para saber mais, confira Autorizando aplicativos GitHub.

Ocasionalmente, o GitHub App solicitará permissões atualizadas. O GitHub fornecerá uma notificação a você quando isso for necessário. Para que o aplicativo continue funcionando, você precisará examinar e aprovar as permissões atualizadas. Para saber mais, confira Aprovação de permissões atualizadas para um aplicativo GitHub.

Antes de instalar ou autorizar um GitHub App, verifique se o desenvolvedor do aplicativo é confiável. Se você não usar mais o aplicativo, suspenda-o ou desinstale-o e/ou revogue sua autorização a ele. Para saber mais, confira Revisar e modificar aplicativos do GitHub instalados e Revisar e revogar a autorização dos Aplicativos GitHub.

GitHub Apps e OAuth apps

O GitHub também dá suporte a OAuth apps. Diferentemente dos GitHub Apps, você não instala um OAuth app ou controla quais repositórios ele pode acessar.

O OAuth apps e o GitHub Apps usam o OAuth 2.0.

OAuth apps só podem agir em nome de um usuário, enquanto GitHub Apps podem agir em nome de um usuário ou independentemente.

Para saber mais, confira Diferenças entre os aplicativos GitHub e os aplicativos OAuth e Autorizar aplicativos OAuth.