{"meta":{"title":"Instalando um Aplicativo GitHub de terceiros","intro":"Você pode instalar GitHub Apps diretamente do proprietário do aplicativo para usar em sua conta.","product":"Aplicativos","breadcrumbs":[{"href":"/pt/apps","title":"Aplicativos"},{"href":"/pt/apps/using-github-apps","title":"Usar GitHub Apps"},{"href":"/pt/apps/using-github-apps/installing-a-github-app-from-a-third-party","title":"Instalar de terceiros"}],"documentType":"article"},"body":"# Instalando um Aplicativo GitHub de terceiros\n\nVocê pode instalar GitHub Apps diretamente do proprietário do aplicativo para usar em sua conta.\n\n## Sobre a instalação GitHub Apps\n\nEste artigo descreve como instalar um GitHub App diretamente do proprietário do aplicativo em vez de partir de GitHub Marketplace. Para obter mais informações sobre como instalar GitHub AppsGitHub Marketplace, consulte [Instalando um Aplicativo GitHub por meio do GitHub Marketplace em sua conta pessoal](/pt/apps/using-github-apps/installing-a-github-app-from-github-marketplace-for-your-personal-account) e [Instalando um Aplicativo GitHub por meio do GitHub Marketplace em suas organizações](/pt/apps/using-github-apps/installing-a-github-app-from-github-marketplace-for-your-organizations). Para obter mais informações sobre como instalar GitHub Apps que você possui, consulte [Instalando seu próprio aplicativo GitHub](/pt/apps/using-github-apps/installing-your-own-github-app).\n\nPara usar um GitHub App em seus recursos, você deve instalar o aplicativo em sua organizacional ou pessoal. Você pode instalar o mesmo GitHub App em várias contas. Por exemplo, se você instalar o aplicativo em sua conta pessoa ou em algumas organizações que possui, poderá usar o aplicativo nos repositórios pessoais, nas organizações em que instalou o aplicativo e em repositórios que são propriedade dessas organizações.\n\nAo instalar um aplicativo, você concede a permissão do aplicativo para acessar os organizacionais e de repositório que ele solicitou. Durante o processo de instalação, GitHub informará quais permissões o GitHub App solicitou. Para obter mais informações sobre as solicitações que a API REST GitHub App pode fazer com essas permissões, consulte [Permissões necessárias para aplicativos GitHub](/pt/rest/authentication/permissions-required-for-github-apps).\n\nAo instalar um aplicativo que solicita permissões de repositório, você também escolherá a quais repositórios conceder o GitHub App acesso.\n\nAntes de instalar um GitHub App, você deve garantir que confie no proprietário do GitHub App. Você também deve examinar as permissões que está GitHub App solicitando e certificar-se de que está confortável concedendo essas permissões. Para obter mais informações sobre as solicitações que a API REST GitHub App pode fazer com essas permissões, consulte [Permissões necessárias para aplicativos GitHub](/pt/rest/authentication/permissions-required-for-github-apps).\n\nNão há limite na quantidade de aplicativos que você pode instalar.\n\n### Diferença entre instalação e autorização\n\nDepois de instalar um GitHub App, você também pode ser solicitado a autorizar o aplicativo.\n\nAo **instalar** uma GitHub App em sua conta ou organização, você concede a permissão do aplicativo para acessar os recursos da organização e do repositório solicitados. Você também especifica quais repositórios o aplicativo pode acessar. Durante o processo de instalação, o GitHub App indicará quais permissões de repositório e organização você está concedendo. Para obter mais informações sobre quais permissões diferentes permitem GitHub App fazer, consulte [Escolhendo permissões para um aplicativo GitHub](/pt/apps/creating-github-apps/registering-a-github-app/choosing-permissions-for-a-github-app).\n\nPor exemplo, você pode conceder a GitHub App permissão para ler metadados do repositório e problemas de gravação e conceder o GitHub App acesso a todos os seus repositórios.\n\n![Captura de tela da página para instalar um Aplicativo GitHub. O aplicativo solicita acesso de leitura aos metadados e acesso de escrita a issues.](/assets/images/github-apps/install-app.png)\n\nAo **autorizar** um GitHub App, você concede ao aplicativo acesso à sua GitHub conta, com base nas permissões de conta solicitadas pelo aplicativo. Durante o processo de autorização, o aplicativo indicará quais recursos o aplicativo pode acessar em sua conta. Ao autorizar um GitHub App, você também concede a permissão do aplicativo para agir em seu nome.\n\nPor exemplo, você pode conceder à GitHub App permissão para ler seus endereços de e-mail e criar gists.\n\n![Captura de tela da página para autorizar um Aplicativo GitHub. O aplicativo está solicitando acesso de leitura a email e acesso de gravação a gists.](/assets/images/github-apps/authorize-app.png)\n\nVocê pode instalar um GitHub App sem autorizar o aplicativo. Da mesma forma, é possível autorizar o aplicativo sem instalá-lo.\n\nPara obter mais informações sobre como autorizar GitHub Apps, consulte [Autorizando aplicativos GitHub](/pt/apps/using-github-apps/authorizing-github-apps).\n\n## Requisitos para instalação de um GitHub App\n\nQualquer pessoa pode instalar GitHub Apps em a sua conta pessoal.\n\nOs proprietários da organização podem instalar GitHub Apps em sua organização.\n\nOs administradores do repositório poderão instalar GitHub Apps na organização que possui o repositório se o aplicativo não solicitar permissões de organização nem a permissão de \"administração do repositório\". Ao fazer isso, eles só podem instalar o aplicativo com acesso aos repositórios que eles administram. Os proprietários da organização podem restringir GitHub App a instalação por administradores de repositório. Quando essa restrição está habilitada, os administradores do repositório não podem instalar GitHub Apps e, em vez disso, devem solicitar que os proprietários da organização instalem o aplicativo desejado. Para obter mais informações, consulte [Limitando as solicitações de acesso e instalações de aplicativos OAuth e GitHub App](/pt/organizations/managing-programmatic-access-to-your-organization/limiting-oauth-app-and-github-app-access-requests-and-installations).\n\nMembros da organização e colaboradores externos que não podem instalar um aplicativo na organização ainda podem selecionar a organização durante o processo de instalação. Em vez de instalar o aplicativo, GitHub enviará uma notificação ao proprietário da organização para solicitar que o proprietário da organização instale o aplicativo. A capacidade de fazer essas solicitações pode ser controlada usando políticas de solicitação de acesso ao aplicativo. Confira [Limitando as solicitações de acesso e instalações de aplicativos OAuth e GitHub App](/pt/organizations/managing-programmatic-access-to-your-organization/limiting-oauth-app-and-github-app-access-requests-and-installations).\n\nA função \"gerenciador de aplicativos\" não dá a uma pessoa a capacidade de instalar uma GitHub App na organização. Confira [Sobre Gerenciadores de Aplicativos do GitHub](/pt/apps/maintaining-github-apps/about-github-app-managers).\n\n## Instalando um GitHub App\n\nDurante o processo de instalação, o proprietário do aplicativo direcionará você para uma URL de GitHub para instalar o GitHub App. A URL será semelhante a `https://github.com/apps/APP-NAME/installations/new`, onde `APP-NAME` é o nome do GitHub App.\n\n1. Selecione o local onde você deseja instalar o GitHub App. Você pode selecionar sua conta pessoal ou uma organização da qual você é membro.\n\n2. Caso o aplicativo exija permissões do repositório, selecione **Todos os repositórios** ou **Somente repositórios selecionados**. O aplicativo sempre terá acesso somente leitura a, pelo menos, todos os repositórios públicos em GitHub\n\n   Se o aplicativo não exigir permissões de repositório, essas opções serão omitidas.\n\n3. Se você escolheu **Apenas repositórios selecionados** na etapa anterior, na lista suspensa **Selecionar repositórios**, escolha os repositórios que você deseja que o aplicativo acesse.\n\n   Se o aplicativo cria algum repositório, ele também terá acesso a esses repositórios automaticamente.\n\n4. Examine as permissões que o aplicativo está solicitando. Para obter mais informações sobre as solicitações que a API REST GitHub App pode fazer com essas permissões, consulte [Permissões necessárias para aplicativos GitHub](/pt/rest/authentication/permissions-required-for-github-apps).\n\n5. Clique em **Instalar**, **Instalar e solicitar** ou **Solicitar**. O botão apresentado dependerá da necessidade do proprietário da organização aprovar alguns, nenhum ou todos os acessos solicitados para o aplicativo. Para obter mais informações, consulte [Requisitos para instalar um GitHub App](#requirements-to-install-a-github-app)."}