{"meta":{"title":"Documentação do GitHub Apps","intro":"Aprofunde-se em GitHub integrando-se com nossas APIs e webhooks, personalizando o fluxo de trabalho do GitHub, desenvolvendo e compartilhando aplicativos com a comunidade.","product":"Aplicativos","breadcrumbs":[{"href":"/pt/enterprise-server@3.22/apps","title":"Aplicativos"}],"documentType":"product"},"body":"# Documentação do GitHub Apps\n\nAprofunde-se em GitHub integrando-se com nossas APIs e webhooks, personalizando o fluxo de trabalho do GitHub, desenvolvendo e compartilhando aplicativos com a comunidade.\n\n## Recommended\n\n* [Visão geral dos Aplicativos GitHub](/pt/enterprise-server@3.22/apps/overview)\n\n  Você pode usar GitHub Apps para estender a funcionalidade de GitHub.\n\n* [Guia de início rápido para a criação de aplicativos para GitHub](/pt/enterprise-server@3.22/apps/creating-github-apps/writing-code-for-a-github-app/quickstart)\n\n  Crie rapidamente um GitHub App que comenta em pull requests.\n\n* [Sobre a criação de aplicativos GitHub](/pt/enterprise-server@3.22/apps/creating-github-apps/about-creating-github-apps/about-creating-github-apps)\n\n  GitHub Apps permitem criar integrações para automatizar processos e expandir a funcionalidade de GitHub.\n\n* [Registrando um aplicativo GitHub](/pt/enterprise-server@3.22/apps/creating-github-apps/registering-a-github-app/registering-a-github-app)\n\n  Você pode registrar uma GitHub App na sua conta pessoal, em qualquer organização que pertença a você, ou na sua conta corporativa .\n\n* [Sobre a autenticação com um aplicativo GitHub](/pt/enterprise-server@3.22/apps/creating-github-apps/authenticating-with-a-github-app/about-authentication-with-a-github-app)\n\n  O GitHub App pode se autenticar com si próprio, como uma instalação de aplicativo ou em nome de um usuário.\n\n* [Autorizando aplicativos GitHub](/pt/enterprise-server@3.22/apps/using-github-apps/authorizing-github-apps)\n\n  Você pode autorizar um(a) GitHub App a obter informações sobre sua conta GitHub e fazer alterações em seu nome.\n\n* [Diferenças entre aplicativos GitHub e aplicativos OAuth](/pt/enterprise-server@3.22/apps/oauth-apps/building-oauth-apps/differences-between-github-apps-and-oauth-apps)\n\n  Em geral, GitHub Apps são preferenciais porque OAuth apps usam permissões refinadas, dão mais controle sobre quais repositórios o aplicativo pode acessar e usam tokens de curta duração.\n\n* [Criando um aplicativo GitHub que responde a eventos de webhook](/pt/enterprise-server@3.22/apps/creating-github-apps/writing-code-for-a-github-app/building-a-github-app-that-responds-to-webhook-events)\n\n  Saiba como criar um(a) GitHub App que faz uma requisição à API em resposta a um evento de webhook.\n\n* [Práticas recomendadas para criar um aplicativo GitHub](/pt/enterprise-server@3.22/apps/creating-github-apps/about-creating-github-apps/best-practices-for-creating-a-github-app)\n\n  Siga estas práticas recomendadas para melhorar a segurança e o desempenho de sua GitHub App.\n\n## Links\n\n### Getting started\n\n* [Visão geral dos Aplicativos GitHub](/pt/enterprise-server@3.22/apps/overview)\n\n  Você pode usar GitHub Apps para estender a funcionalidade de GitHub.\n\n* [Guia de início rápido para a criação de aplicativos para GitHub](/pt/enterprise-server@3.22/apps/creating-github-apps/writing-code-for-a-github-app/quickstart)\n\n  Crie rapidamente um GitHub App que comenta em pull requests.\n\n## Articles\n\n* [Visão geral dos Aplicativos GitHub](/pt/enterprise-server@3.22/apps/overview)\n\n  Você pode usar GitHub Apps para estender a funcionalidade de GitHub.\n\n* [Sobre como usar aplicativos GitHub](/pt/enterprise-server@3.22/apps/using-github-apps/about-using-github-apps)\n\n  Saiba mais sobre o que GitHub App é e por que você usaria um GitHub App.\n\n* [Instalando um Aplicativo GitHub de terceiros](/pt/enterprise-server@3.22/apps/using-github-apps/installing-a-github-app-from-a-third-party)\n\n  Você pode instalar GitHub Apps diretamente do proprietário do aplicativo para usar em sua conta.\n\n* [Instalando seu próprio aplicativo GitHub](/pt/enterprise-server@3.22/apps/using-github-apps/installing-your-own-github-app)\n\n  Você pode instalar um GitHub App que você criou na conta proprietária do aplicativo. Se o aplicativo for público, o GitHub App também poderá ser instalado em outras contas.\n\n* [Como instalar um aplicativo do GitHub em sua empresa](/pt/enterprise-server@3.22/apps/using-github-apps/installing-a-github-app-on-your-enterprise)\n\n  Você pode instalar GitHub Apps em sua empresa para gerenciar sua conta corporativa e executar operações de nível empresarial.\n\n* [Autorizando aplicativos GitHub](/pt/enterprise-server@3.22/apps/using-github-apps/authorizing-github-apps)\n\n  Você pode autorizar um(a) GitHub App a obter informações sobre sua conta GitHub e fazer alterações em seu nome.\n\n* [Aprovação de permissões atualizadas para um aplicativo GitHub](/pt/enterprise-server@3.22/apps/using-github-apps/approving-updated-permissions-for-a-github-app)\n\n  Quando uma GitHub App solicita permissões adicionais, você pode examinar qual comportamento as permissões habilitarão e decidir se aprovam as permissões.\n\n* [Revisão e revogação da autorização de aplicativos GitHub](/pt/enterprise-server@3.22/apps/using-github-apps/reviewing-and-revoking-authorization-of-github-apps)\n\n  Você pode revisar o GitHub Apps que autorizou e revogar sua autorização.\n\n* [Revisão e modificação de aplicativos GitHub instalados](/pt/enterprise-server@3.22/apps/using-github-apps/reviewing-and-modifying-installed-github-apps)\n\n  Você pode revisar as permissões e alterar o acesso ao repositório de GitHub Apps que você instalou. Você também pode impedir temporariamente ou permanentemente que um GitHub App usuário acesse recursos pertencentes à sua conta ou organização.\n\n* [Aplicativos GitHub com privilégios](/pt/enterprise-server@3.22/apps/using-github-apps/privileged-github-apps)\n\n  Alguns GitHub Apps são aplicativos privilegiados, de propriedade de GitHub, aos quais são concedidos recursos especiais.\n\n* [Sobre a criação de aplicativos GitHub](/pt/enterprise-server@3.22/apps/creating-github-apps/about-creating-github-apps/about-creating-github-apps)\n\n  GitHub Apps permitem criar integrações para automatizar processos e expandir a funcionalidade de GitHub.\n\n* [Decidir quando criar um aplicativo GitHub](/pt/enterprise-server@3.22/apps/creating-github-apps/about-creating-github-apps/deciding-when-to-build-a-github-app)\n\n  Ao criar uma integração, você deve considerar o uso de um GitHub App nos cenários a seguir, em vez de um OAuth app, personal access tokenou GitHub Actions.\n\n* [Práticas recomendadas para criar um aplicativo GitHub](/pt/enterprise-server@3.22/apps/creating-github-apps/about-creating-github-apps/best-practices-for-creating-a-github-app)\n\n  Siga estas práticas recomendadas para melhorar a segurança e o desempenho de sua GitHub App.\n\n* [Migrando aplicativos OAuth para aplicativos GitHub](/pt/enterprise-server@3.22/apps/creating-github-apps/about-creating-github-apps/migrating-oauth-apps-to-github-apps)\n\n  Conheça as vantagens de migrar sua OAuth app para um(a) GitHub App e saiba como migrar sua OAuth app.\n\n* [Registrando um aplicativo GitHub](/pt/enterprise-server@3.22/apps/creating-github-apps/registering-a-github-app/registering-a-github-app)\n\n  Você pode registrar uma GitHub App na sua conta pessoal, em qualquer organização que pertença a você, ou na sua conta corporativa .\n\n* [Sobre a URL de retorno de chamada de autorização do usuário](/pt/enterprise-server@3.22/apps/creating-github-apps/registering-a-github-app/about-the-user-authorization-callback-url)\n\n  Você pode especificar URLs para as quais os usuários podem ser redirecionados depois que autorizarem um GitHub App.\n\n* [Sobre a URL de instalação](/pt/enterprise-server@3.22/apps/creating-github-apps/registering-a-github-app/about-the-setup-url)\n\n  Você pode especificar uma URL para a qual os usuários serão redirecionados após a instalação de um GitHub App.\n\n* [Escolhendo permissões para um aplicativo GitHub](/pt/enterprise-server@3.22/apps/creating-github-apps/registering-a-github-app/choosing-permissions-for-a-github-app)\n\n  As permissões de um aplicativo GitHub determinam o que o aplicativo pode fazer com GitHubas APIs e quais webhooks o aplicativo pode receber.\n\n* [Usando webhooks com aplicativos GitHub](/pt/enterprise-server@3.22/apps/creating-github-apps/registering-a-github-app/using-webhooks-with-github-apps)\n\n  Você GitHub App pode se inscrever em eventos de webhook para receber notificações sempre que uma determinada atividade ocorrer.\n\n* [Tornando um aplicativo GitHub público ou privado](/pt/enterprise-server@3.22/apps/creating-github-apps/registering-a-github-app/making-a-github-app-public-or-private)\n\n  Ao registrar umGitHub App, você pode torná-lo público para que outras contas GitHub possam instalar o aplicativo ou privadas para que você só possa instalá-lo na conta que possui o aplicativo.\n\n* [Limites de taxa para aplicativos GitHub](/pt/enterprise-server@3.22/apps/creating-github-apps/registering-a-github-app/rate-limits-for-github-apps)\n\n  Os limites de taxa restringem a taxa de tráfego para GitHub.com, para ajudar a garantir acesso consistente para todos os usuários.\n\n* [Criando um selo personalizado para seu aplicativo GitHub](/pt/enterprise-server@3.22/apps/creating-github-apps/registering-a-github-app/creating-a-custom-badge-for-your-github-app)\n\n  Você pode substituir o selo-padrão no seu aplicativo GitHub fazendo o upload da sua própria imagem de logotipo e personalizando o plano de fundo.\n\n* [Sobre a autenticação com um aplicativo GitHub](/pt/enterprise-server@3.22/apps/creating-github-apps/authenticating-with-a-github-app/about-authentication-with-a-github-app)\n\n  O GitHub App pode se autenticar com si próprio, como uma instalação de aplicativo ou em nome de um usuário.\n\n* [Autenticando como aplicativo GitHub](/pt/enterprise-server@3.22/apps/creating-github-apps/authenticating-with-a-github-app/authenticating-as-a-github-app)\n\n  Você pode autenticar como um GitHub App para gerar um token de acesso de instalação ou gerenciar seu aplicativo.\n\n* [Como autenticar como uma instalação de Aplicativo GitHub](/pt/enterprise-server@3.22/apps/creating-github-apps/authenticating-with-a-github-app/authenticating-as-a-github-app-installation)\n\n  Você pode fazer com que seu GitHub App se autentique como instalação para fazer solicitações à API que afetam os recursos da conta em que o aplicativo está instalado.\n\n* [Autenticação com um aplicativo GitHub em nome de um usuário](/pt/enterprise-server@3.22/apps/creating-github-apps/authenticating-with-a-github-app/authenticating-with-a-github-app-on-behalf-of-a-user)\n\n  O GitHub App pode executar ações em nome de um usuário, como criar um problema, postar um comentário ou criar uma implantação.\n\n* [Gerenciando chaves privadas para aplicativos GitHub](/pt/enterprise-server@3.22/apps/creating-github-apps/authenticating-with-a-github-app/managing-private-keys-for-github-apps)\n\n  Você pode gerenciar chaves privadas para autenticar com seu GitHub App.\n\n* [Gerando um JWT (Token Web JSON) para um aplicativo GitHub](/pt/enterprise-server@3.22/apps/creating-github-apps/authenticating-with-a-github-app/generating-a-json-web-token-jwt-for-a-github-app)\n\n  Saiba como criar um JWT para autenticar determinados pontos de extremidade da API REST com seus GitHub App.\n\n* [Gerando um token de acesso de instalação para um aplicativo GitHub](/pt/enterprise-server@3.22/apps/creating-github-apps/authenticating-with-a-github-app/generating-an-installation-access-token-for-a-github-app)\n\n  Saiba como gerar um token de acesso de instalação para seu GitHub App.\n\n* [Gerando um token de acesso do usuário para um aplicativo GitHub](/pt/enterprise-server@3.22/apps/creating-github-apps/authenticating-with-a-github-app/generating-a-user-access-token-for-a-github-app)\n\n  Você pode gerar um token de acesso do usuário para o seu GitHub App, a fim de atribuir a atividade no aplicativo a um usuário.\n\n* [Atualizar tokens de acesso do usuário](/pt/enterprise-server@3.22/apps/creating-github-apps/authenticating-with-a-github-app/refreshing-user-access-tokens)\n\n  Para impor a rotação regular de tokens e reduzir o impacto de um token comprometido, você pode configurar seu GitHub App para usar tokens de acesso do usuário que expiram.\n\n* [Fazer solicitações de API autenticadas com um aplicativo GitHub em um fluxo de trabalho GitHub Actions](/pt/enterprise-server@3.22/apps/creating-github-apps/authenticating-with-a-github-app/making-authenticated-api-requests-with-a-github-app-in-a-github-actions-workflow)\n\n  Você pode usar um token de acesso à instalação de um GitHub App para fazer solicitações autenticadas à API em um fluxo de trabalho GitHub Actions. Também é possível transmitir o token a uma ação personalizada para permitir que ela faça solicitações de API autenticadas.\n\n* [Sobre como escrever código para um aplicativo GitHub](/pt/enterprise-server@3.22/apps/creating-github-apps/writing-code-for-a-github-app/about-writing-code-for-a-github-app)\n\n  Você precisa escrever código para adicionar funcionalidade à sua GitHub App.\n\n* [Guia de início rápido para a criação de aplicativos para GitHub](/pt/enterprise-server@3.22/apps/creating-github-apps/writing-code-for-a-github-app/quickstart)\n\n  Crie rapidamente um GitHub App que comenta em pull requests.\n\n* [Criando um aplicativo GitHub que responde a eventos de webhook](/pt/enterprise-server@3.22/apps/creating-github-apps/writing-code-for-a-github-app/building-a-github-app-that-responds-to-webhook-events)\n\n  Saiba como criar um(a) GitHub App que faz uma requisição à API em resposta a um evento de webhook.\n\n* [Criando um botão \"Logon com GitHub\" com um aplicativo GitHub](/pt/enterprise-server@3.22/apps/creating-github-apps/writing-code-for-a-github-app/building-a-login-with-github-button-with-a-github-app)\n\n  Siga este tutorial para escrever o código Ruby para gerar um token de acesso do usuário por meio do fluxo de aplicativo Web para seu GitHub App.\n\n* [Criando uma CLI com um aplicativo GitHub](/pt/enterprise-server@3.22/apps/creating-github-apps/writing-code-for-a-github-app/building-a-cli-with-a-github-app)\n\n  Siga este tutorial para escrever uma CLI no Ruby que gera um token de acesso do usuário para um GitHub App por meio do fluxo do dispositivo.\n\n* [Criando verificações de CI com um aplicativo GitHub](/pt/enterprise-server@3.22/apps/creating-github-apps/writing-code-for-a-github-app/building-ci-checks-with-a-github-app)\n\n  Crie um servidor de integração contínua para executar testes usando um GitHub App e verificações.\n\n* [Compartilhando seu Aplicativo GitHub](/pt/enterprise-server@3.22/apps/sharing-github-apps/sharing-your-github-app)\n\n  Você pode compartilhar seu GitHub App com outros usuários.\n\n* [Disponibilizando seu aplicativo GitHub para GitHub Enterprise Server](/pt/enterprise-server@3.22/apps/sharing-github-apps/making-your-github-app-available-for-github-enterprise-server)\n\n  Para que as instâncias do GitHub Enterprise Server usem seu GitHub App, você deve seguir algumas etapas adicionais.\n\n* [Registrando um App do GitHub a partir de um manifesto](/pt/enterprise-server@3.22/apps/sharing-github-apps/registering-a-github-app-from-a-manifest)\n\n  Um GitHub App manifesto é uma maneira de compartilhar um registro pré-configurado GitHub App com outros usuários. O fluxo de manifesto permite que alguém registre rapidamente um GitHub App.\n\n* [Registrando um aplicativo GitHub usando parâmetros de URL](/pt/enterprise-server@3.22/apps/sharing-github-apps/registering-a-github-app-using-url-parameters)\n\n  Você pode usar parâmetros de consulta de URL para ajudar outras pessoas a configurar rapidamente um novo GitHub App com uma configuração específica pré-selecionada.\n\n* [Modificando um registro de aplicativo GitHub](/pt/enterprise-server@3.22/apps/maintaining-github-apps/modifying-a-github-app-registration)\n\n  Depois de registrar um GitHub App, você pode fazer alterações nele.\n\n* [Ativando recursos opcionais para aplicativos GitHub](/pt/enterprise-server@3.22/apps/maintaining-github-apps/activating-optional-features-for-github-apps)\n\n  Você pode testar novos recursos opcionais para sua GitHub Apps.\n\n* [Sobre Gerenciadores de Aplicativos do GitHub](/pt/enterprise-server@3.22/apps/maintaining-github-apps/about-github-app-managers)\n\n  Os gerentes de aplicativos podem gerenciar alguns ou todos os GitHub App cadastros de uma conta.\n\n* [Suspendendo uma instalação do aplicativo GitHub](/pt/enterprise-server@3.22/apps/maintaining-github-apps/suspending-a-github-app-installation)\n\n  Você pode bloquear temporariamente seu GitHub App de acessar os recursos que pertencem às contas que instalaram o GitHub App.\n\n* [Transferindo a propriedade de um aplicativo GitHub](/pt/enterprise-server@3.22/apps/maintaining-github-apps/transferring-ownership-of-a-github-app)\n\n  Você pode transferir a propriedade de um registro de aplicativo GitHub para outro usuário ou organização.\n\n* [Excluindo um aplicativo GitHub](/pt/enterprise-server@3.22/apps/maintaining-github-apps/deleting-a-github-app)\n\n  Você pode excluir os GitHub Apps que tiver se não quiser mais usar ou manter o aplicativo.\n\n* [Autorizar aplicativos OAuth](/pt/enterprise-server@3.22/apps/oauth-apps/using-oauth-apps/authorizing-oauth-apps)\n\n  Você pode conectar sua GitHub identidade a aplicativos de terceiros usando o OAuth. Ao autorizar um OAuth app, você deve garantir que confie no aplicativo, examine por quem ele foi desenvolvido e examine os tipos de informações que o aplicativo deseja acessar.\n\n* [Revisar aplicações OAuth autorizadas](/pt/enterprise-server@3.22/apps/oauth-apps/using-oauth-apps/reviewing-your-authorized-oauth-apps)\n\n  Você deve revisar seus aplicativos autorizados para verificar se não há nenhum novo aplicativo autorizado com permissões abrangentes, como aqueles que têm acesso a seus repositórios privados.\n\n* [Conectar-se a aplicativos de terceiros](/pt/enterprise-server@3.22/apps/oauth-apps/using-oauth-apps/connecting-with-third-party-applications)\n\n  Você pode conectar sua GitHub identidade a aplicativos de terceiros usando o OAuth. Ao autorizar um desses aplicativos, você deve ter certeza de que se trata de um aplicativo confiável, examinar por quem ele foi desenvolvido e analisar os tipos de informação que o aplicativo quer acessar.\n\n* [Aplicativos OAuth privilegiados](/pt/enterprise-server@3.22/apps/oauth-apps/using-oauth-apps/privileged-oauth-apps)\n\n  Alguns OAuth apps são aplicativos privilegiados, de propriedade de GitHub, aos quais são concedidos recursos especiais.\n\n* [Diferenças entre aplicativos GitHub e aplicativos OAuth](/pt/enterprise-server@3.22/apps/oauth-apps/building-oauth-apps/differences-between-github-apps-and-oauth-apps)\n\n  Em geral, GitHub Apps são preferenciais porque OAuth apps usam permissões refinadas, dão mais controle sobre quais repositórios o aplicativo pode acessar e usam tokens de curta duração.\n\n* [Limites de taxa para aplicativos OAuth](/pt/enterprise-server@3.22/apps/oauth-apps/building-oauth-apps/rate-limits-for-oauth-apps)\n\n  Os limites de taxa restringem a taxa de tráfego para GitHub.com, para ajudar a garantir acesso consistente para todos os usuários.\n\n* [Criar um aplicativo OAuth](/pt/enterprise-server@3.22/apps/oauth-apps/building-oauth-apps/creating-an-oauth-app)\n\n  Você pode criar e registrar um OAuth app na sua conta pessoal ou em qualquer organização à qual tenha acesso administrativo. Ao criar o OAuth app, lembre-se de proteger sua privacidade usando apenas as informações que considera públicas.\n\n* [Autenticar na API REST com um aplicativo OAuth](/pt/enterprise-server@3.22/apps/oauth-apps/building-oauth-apps/authenticating-to-the-rest-api-with-an-oauth-app)\n\n  Aprenda sobre as diferentes maneiras de efetuar a autenticação com alguns exemplos.\n\n* [Autorizar aplicativos OAuth](/pt/enterprise-server@3.22/apps/oauth-apps/building-oauth-apps/authorizing-oauth-apps)\n\n  Você pode permitir que outros usuários autorizem o OAuth app.\n\n* [Escopos para aplicativos OAuth](/pt/enterprise-server@3.22/apps/oauth-apps/building-oauth-apps/scopes-for-oauth-apps)\n\n  Os escopos permitem especificar exatamente que tipo de acesso você precisa. Os escopos *limitam* o acesso para tokens OAuth. Não concedem qualquer autorização adicional para além da que o usuário já possui.\n\n* [Criar um selo personalizado para o aplicativo OAuth](/pt/enterprise-server@3.22/apps/oauth-apps/building-oauth-apps/creating-a-custom-badge-for-your-oauth-app)\n\n  Você pode substituir o selo padrão no OAuth app fazendo upload da sua imagem de logotipo e personalizando a tela de fundo.\n\n* [Práticas recomendadas para criar um aplicativo OAuth](/pt/enterprise-server@3.22/apps/oauth-apps/building-oauth-apps/best-practices-for-creating-an-oauth-app)\n\n  Siga estas práticas recomendadas para melhorar a segurança e o desempenho de sua OAuth app.\n\n* [Modificar um aplicativo OAuth](/pt/enterprise-server@3.22/apps/oauth-apps/maintaining-oauth-apps/modifying-an-oauth-app)\n\n  Depois de criar e registrar um OAuth app, você poderá fazer alterações nele.\n\n* [Ativar recursos opcionais para aplicativos OAuth](/pt/enterprise-server@3.22/apps/oauth-apps/maintaining-oauth-apps/activating-optional-features-for-oauth-apps)\n\n  Você pode testar novos recursos opcionais para suas aplicações OAuth apps.\n\n* [Transferir a propriedade de um aplicativo OAuth](/pt/enterprise-server@3.22/apps/oauth-apps/maintaining-oauth-apps/transferring-ownership-of-an-oauth-app)\n\n  Você pode transferir a proprietário de um OAuth app para outro usuário ou organização. de dados\n\n* [Solucionar problemas de erros de solicitação de autorização](/pt/enterprise-server@3.22/apps/oauth-apps/maintaining-oauth-apps/troubleshooting-authorization-request-errors)\n\n  Ao obter um token do OAuth para um usuário, alguns erros podem ocorrer durante a fase inicial da solicitação de autorização.\n\n* [Solução de erros de solicitação de token de acesso do aplicativo OAuth](/pt/enterprise-server@3.22/apps/oauth-apps/maintaining-oauth-apps/troubleshooting-oauth-app-access-token-request-errors)\n\n  Ao trocar um código para um token de acesso, há um conjunto adicional de erros que podem ocorrer. O formato dessas respostas é determinado pelo cabeçalho aceito que você passa.\n\n* [Excluir um aplicativo OAuth](/pt/enterprise-server@3.22/apps/oauth-apps/maintaining-oauth-apps/deleting-an-oauth-app)\n\n  Você pode excluir OAuth apps quando deixar de usá-las.\n\n* [GitHub pontos de extremidade de descoberta de autenticação](/pt/enterprise-server@3.22/apps/github-authentication-discovery-endpoints)\n\n  GitHub publica documentos de metadados do OAuth 2.0 e do OpenID Connect."}