Skip to main content

Enterprise Server 3.21 está disponível no momento como versão candidata a lançamento.

Sobre como usar aplicativos GitHub

Saiba mais sobre o que GitHub App é e por que você usaria um GitHub App.

Sobre o GitHub Apps

GitHub Apps são ferramentas que expandem a funcionalidade de GitHub. GitHub Apps pode fazer coisas no GitHub, como abrir issues, comentar em pull requests e gerenciar projetos. Eles também podem fazer coisas fora de GitHub com base em eventos que acontecem em GitHub. Por exemplo, um(a) GitHub App pode postar no Slack quando um problema é aberto em GitHub.

Localizando 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, consulte Registrando um App do GitHub a partir de um manifesto e Registrando um aplicativo GitHub usando parâmetros de URL.

Você também pode criar seu próprio GitHub App. Para saber mais, confira Sobre a criação de aplicativos GitHub.

Usando GitHub Apps

Para usar um GitHub App, você deve instalar o aplicativo na sua de 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 GitHub informarão quais permissões o aplicativo solicitou antes de instalar o aplicativo. 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 obter mais informações, consulte Instalando um Aplicativo GitHub de terceiros e Instalando seu próprio aplicativo GitHub.

Talvez você também precise autorizar um GitHub App para verificar sua identidade, saber quais recursos você pode acessar ou executar 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. GitHub o notificará 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, você deve ter certeza de que confia no desenvolvedor do aplicativo. 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

GitHub também oferece suporte a OAuth apps. Ao contrário de GitHub Apps, você não instala um OAuth app nem controla quais repositórios ele pode acessar.

Tanto OAuth apps quanto GitHub Apps usam OAuth 2.0.

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

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