Skip to main content

Enterprise Server 3.15 está disponível no momento como versão release candidate.

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

Não é possível instalar aplicativos de terceiros em sua empresa. Para usar a funcionalidade de um aplicativo de terceiros, entre em contato com o desenvolvedor do aplicativo e converse sobre a criação de um aplicativo com base em um manifesto ou em parâmetros de URL. Para obter mais informações, confira "Registrar um Aplicativo GitHub a partir do manifesto" e "Registrar um aplicativo GitHub usando parâmetros de URL".

Também é possível criar seu próprio GitHub App. Para obter mais informações, 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 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 obter mais informações, 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 obter mais informações, 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 obter mais informações, 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 obter mais informações, confira "Diferenças entre os aplicativos GitHub e os aplicativos OAuth" e "Autorizar aplicativos OAuth."