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 GitHub.
Usar GitHub Apps
Para usar um GitHub App, instale o aplicativo em sua conta do usuário ou da organização. Ao instalar o aplicativo, você concede a permissão do aplicativo para ler ou modificar os dados da sua conta. 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 em sua organização ou conta de usuário, você também especificará quais repositórios o aplicativo 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 necessário autorizar um GitHub App para verificar sua identidade, saber a quais recursos você pode acessar ou realizar ações em seu nome. Se você precisar autorizar o aplicativo, ele solicitará isso a você. Quando um aplicativo age em seu nome, ele tem acesso aos mesmos recursos que você, desde que o aplicativo seja instalado na conta que detém os recursos e você tenha dado a ele as permissões certas. Para saber mais, confira Autorizando aplicativos GitHub.
Ocasionalmente, o GitHub App solicitará permissões atualizadas. O GitHub irá notificá-lo quando isso ocorrer. 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 Revisão e modificação de aplicativos GitHub instalados e Revisão e revogação da autorização de 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 aplicativos GitHub e aplicativos OAuth e Autorizar aplicativos OAuth.