# Como instalar um aplicativo do GitHub em sua empresa

Você pode instalar GitHub Apps em sua empresa para gerenciar sua conta corporativa e executar operações de nível empresarial.

## Sobre a instalação de GitHub Apps na sua empresa

GitHub Apps instalados pela empresa são aplicativos que solicitam permissões de nível corporativo e podem realizar operações na sua conta corporativa. Ao contrário das instalações da organização ou do usuário, eles não têm acesso a nenhuma permissão de repositório ou organização, apenas gerenciam a empresa em si.

Quando um proprietário da empresa instala um GitHub App em sua empresa, o aplicativo receberá as permissões corporativas solicitadas. Essas permissões permitem que o aplicativo execute operações como criar organizações na empresa, instalar aplicativos entre organizações e gerenciar provisionamento SCIM.

## Requisitos para instalar um GitHub App em sua empresa

O GitHub App deve solicitar permissões de nível empresarial. Ele também pode solicitar outras permissões, mas apenas as permissões corporativas serão concedidas durante a instalação.

O aplicativo pode pertencer à sua empresa ou organização em sua empresa.

## Instalando um GitHub App em sua empresa

Para instalar um aplicativo em sua empresa, navegue até a GitHub App página de instalação. O desenvolvedor do aplicativo pode fornecer isso como um link de instalação ou você pode encontrá-lo no registro do aplicativo. A URL será semelhante a `http(s)://HOSTNAME/apps/APP-NAME/installations/new`, onde `APP-NAME` é o nome do GitHub App.

Se for possível instalar o aplicativo, a lista de locais de instalação disponíveis incluirá sua empresa. Você pode selecionar sua empresa para instalar o aplicativo.

Após a instalação, o aplicativo poderá criar um token de instalação para sua empresa ou conectar membros da empresa para agir em seu nome no nível da empresa. Agir em nome de um usuário exige que o usuário consiga executar as operações desejadas dentro da empresa. Por exemplo, se o aplicativo precisar convidar um usuário para uma empresa, o usuário também deverá ter permissão para convidar membros para a empresa.

## O que os aplicativos instalados pela empresa podem fazer

Instalação empresarial GitHub Apps não pode chamar cada API corporativa, mas várias APIs já foram atualizadas em suporte a GitHub Apps. Essas APIs e mutações do GraphQL incluem:

* [Listar e criar organizações em sua empresa](/pt/enterprise-server@3.23/graphql/reference/enterprise-admin#mutation-createenterpriseorganization)
* [Gerenciar usuários em sua empresa](/pt/enterprise-server@3.23/graphql/reference/enterprise-admin#object-enterprise)
* Criar e gerenciar instalações GitHub App em suas organizações
* Gerenciar propriedades do repositório personalizado da empresa
* Gerenciar a cobrança empresarial, incluindo orçamentos, centros de custos e relatórios de uso. Para obter mais informações, consulte [Endpoints da API REST para faturamento](/pt/enterprise-server@3.23/rest/billing).
* Chamar as APIs SCIM corporativas

Verifique o [changelog](https://github.blog/changelog/) para atualizações sobre novas APIs e permissões para GitHub Apps.

Para obter mais informações sobre permissões disponíveis e pontos de extremidade de API, confira [Permissões necessárias para aplicativos GitHub](/pt/enterprise-server@3.23/rest/authentication/permissions-required-for-github-apps).

## Limitações atuais

Os aplicativos instalados pela empresa GitHub Apps têm algumas limitações no que podem fazer.

### Suporte à API

Nem todas as APIs oferecem suporte à instalação empresarial GitHub Apps ainda. À medida que mais permissões forem criadas e as APIs forem atualizadas, o suporte passará a ser mais amplo. Para obter mais informações sobre as APIs e permissões que dão suporte aos instalados pela empresa GitHub Apps, consulte [Permissões necessárias para aplicativos GitHub](/pt/enterprise-server@3.23/rest/authentication/permissions-required-for-github-apps) e [Gerenciar contas corporativas](/pt/enterprise-server@3.23/graphql/guides/managing-enterprise-accounts).

### Suporte ao Webhook

No momento, as instalações empresariais não dão suporte a webhooks. Os aplicativos instalados no nível da empresa não podem receber eventos de webhook para atividades de nível empresarial. Instale-os em organizações ou repositórios para receber eventos de webhook para esses recursos.

### Acesso da organização

As instalações empresariais não recebem acesso a organizações ou repositórios em sua empresa, com exceção da API de instalações da organização. Para acessar recursos de organização ou repositório, você deve instalar o aplicativo separadamente em cada organização em que o acesso é necessário.

Se você precisar instalar o mesmo aplicativo em muitas organizações, poderá automatizar isso com uma API. Confira [Automatizando instalações de aplicativo nas organizações da sua empresa](/pt/enterprise-server@3.23/admin/managing-github-apps-for-your-enterprise/automate-installations).

## Próximas etapas

* Para conceder ao aplicativo acesso a organizações específicas, instale-o nessas organizações. Para saber mais, confira [Instalando um Aplicativo GitHub de terceiros](/pt/enterprise-server@3.23/apps/using-github-apps/installing-a-github-app-from-a-third-party).
* Saiba mais sobre como gerenciar aplicativos instalados em suas organizações. Para saber mais, confira [Revisão e modificação de aplicativos GitHub instalados](/pt/enterprise-server@3.23/apps/using-github-apps/reviewing-and-modifying-installed-github-apps).