# Documentação do GitHub Apps 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. ## Recommended * [Visão geral dos Aplicativos GitHub](/pt/enterprise-server@3.21/apps/overview) Você pode usar GitHub Apps para estender a funcionalidade de GitHub. * [Guia de início rápido para a criação de aplicativos para GitHub](/pt/enterprise-server@3.21/apps/creating-github-apps/writing-code-for-a-github-app/quickstart) Crie rapidamente um GitHub App que comenta em pull requests. * [Sobre a criação de aplicativos GitHub](/pt/enterprise-server@3.21/apps/creating-github-apps/about-creating-github-apps/about-creating-github-apps) GitHub Apps permitem criar integrações para automatizar processos e expandir a funcionalidade de GitHub. * [Registrando um aplicativo GitHub](/pt/enterprise-server@3.21/apps/creating-github-apps/registering-a-github-app/registering-a-github-app) Você pode registrar uma GitHub App na sua conta pessoal, em qualquer organização que pertença a você, ou na sua conta corporativa . * [Sobre a autenticação com um aplicativo GitHub](/pt/enterprise-server@3.21/apps/creating-github-apps/authenticating-with-a-github-app/about-authentication-with-a-github-app) O GitHub App pode se autenticar com si próprio, como uma instalação de aplicativo ou em nome de um usuário. * [Autorizando aplicativos GitHub](/pt/enterprise-server@3.21/apps/using-github-apps/authorizing-github-apps) Você pode autorizar um(a) GitHub App a obter informações sobre sua conta GitHub e fazer alterações em seu nome. * [Diferenças entre aplicativos GitHub e aplicativos OAuth](/pt/enterprise-server@3.21/apps/oauth-apps/building-oauth-apps/differences-between-github-apps-and-oauth-apps) Em geral, os GitHub Apps são mais indicados que os OAuth apps porque usam permissões refinadas, dão mais controle sobre quais repositórios o aplicativo pode acessar e usam tokens de curta duração. * [Criando um aplicativo GitHub que responde a eventos de webhook](/pt/enterprise-server@3.21/apps/creating-github-apps/writing-code-for-a-github-app/building-a-github-app-that-responds-to-webhook-events) Saiba como criar um(a) GitHub App que faz uma requisição à API em resposta a um evento de webhook. * [Práticas recomendadas para criar um aplicativo GitHub](/pt/enterprise-server@3.21/apps/creating-github-apps/about-creating-github-apps/best-practices-for-creating-a-github-app) Siga estas práticas recomendadas para melhorar a segurança e o desempenho de sua GitHub App. ## Links ### Getting started * [Visão geral dos Aplicativos GitHub](/pt/enterprise-server@3.21/apps/overview) Você pode usar GitHub Apps para estender a funcionalidade de GitHub. * [Guia de início rápido para a criação de aplicativos para GitHub](/pt/enterprise-server@3.21/apps/creating-github-apps/writing-code-for-a-github-app/quickstart) Crie rapidamente um GitHub App que comenta em pull requests. ## Articles * [Visão geral dos Aplicativos GitHub](/pt/enterprise-server@3.21/apps/overview) Você pode usar GitHub Apps para estender a funcionalidade de GitHub. * [Sobre como usar aplicativos GitHub](/pt/enterprise-server@3.21/apps/using-github-apps/about-using-github-apps) Saiba mais sobre o que GitHub App é e por que você usaria um GitHub App. * [Instalando um Aplicativo GitHub de terceiros](/pt/enterprise-server@3.21/apps/using-github-apps/installing-a-github-app-from-a-third-party) Você pode instalar GitHub Apps diretamente do proprietário do aplicativo para usar em sua conta. * [Instalando seu próprio aplicativo GitHub](/pt/enterprise-server@3.21/apps/using-github-apps/installing-your-own-github-app) 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. * [Autorizando aplicativos GitHub](/pt/enterprise-server@3.21/apps/using-github-apps/authorizing-github-apps) Você pode autorizar um(a) GitHub App a obter informações sobre sua conta GitHub e fazer alterações em seu nome. * [Aprovação de permissões atualizadas para um aplicativo GitHub](/pt/enterprise-server@3.21/apps/using-github-apps/approving-updated-permissions-for-a-github-app) 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. * [Revisão e revogação da autorização de aplicativos GitHub](/pt/enterprise-server@3.21/apps/using-github-apps/reviewing-and-revoking-authorization-of-github-apps) Você pode revisar o GitHub Apps que autorizou e revogar sua autorização. * [Revisão e modificação de aplicativos GitHub instalados](/pt/enterprise-server@3.21/apps/using-github-apps/reviewing-and-modifying-installed-github-apps) 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. * [Aplicativos GitHub com privilégios](/pt/enterprise-server@3.21/apps/using-github-apps/privileged-github-apps) Alguns GitHub Apps são aplicativos privilegiados, de propriedade de GitHub, aos quais são concedidos recursos especiais. * [Sobre a criação de aplicativos GitHub](/pt/enterprise-server@3.21/apps/creating-github-apps/about-creating-github-apps/about-creating-github-apps) GitHub Apps permitem criar integrações para automatizar processos e expandir a funcionalidade de GitHub. * [Decidir quando criar um aplicativo GitHub](/pt/enterprise-server@3.21/apps/creating-github-apps/about-creating-github-apps/deciding-when-to-build-a-github-app) 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. * [Práticas recomendadas para criar um aplicativo GitHub](/pt/enterprise-server@3.21/apps/creating-github-apps/about-creating-github-apps/best-practices-for-creating-a-github-app) Siga estas práticas recomendadas para melhorar a segurança e o desempenho de sua GitHub App. * [Migrando aplicativos OAuth para aplicativos GitHub](/pt/enterprise-server@3.21/apps/creating-github-apps/about-creating-github-apps/migrating-oauth-apps-to-github-apps) Conheça as vantagens de migrar sua OAuth app para um(a) GitHub App e saiba como migrar sua OAuth app. * [Registrando um aplicativo GitHub](/pt/enterprise-server@3.21/apps/creating-github-apps/registering-a-github-app/registering-a-github-app) Você pode registrar uma GitHub App na sua conta pessoal, em qualquer organização que pertença a você, ou na sua conta corporativa . * [Sobre a URL de retorno de chamada de autorização do usuário](/pt/enterprise-server@3.21/apps/creating-github-apps/registering-a-github-app/about-the-user-authorization-callback-url) Você pode especificar uma URL para a qual os usuários serão redirecionados depois que autorizarem uma GitHub App. * [Sobre a URL de instalação](/pt/enterprise-server@3.21/apps/creating-github-apps/registering-a-github-app/about-the-setup-url) Você pode especificar uma URL para a qual os usuários serão redirecionados após a instalação de um GitHub App. * [Escolhendo permissões para um aplicativo GitHub](/pt/enterprise-server@3.21/apps/creating-github-apps/registering-a-github-app/choosing-permissions-for-a-github-app) As permissões de um aplicativo GitHub determinam o que o aplicativo pode fazer com GitHubas APIs e quais webhooks o aplicativo pode receber. * [Usando webhooks com aplicativos GitHub](/pt/enterprise-server@3.21/apps/creating-github-apps/registering-a-github-app/using-webhooks-with-github-apps) Você GitHub App pode se inscrever em eventos de webhook para receber notificações sempre que uma determinada atividade ocorrer. * [Tornando um aplicativo GitHub público ou privado](/pt/enterprise-server@3.21/apps/creating-github-apps/registering-a-github-app/making-a-github-app-public-or-private) 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. * [Limites de taxa para aplicativos GitHub](/pt/enterprise-server@3.21/apps/creating-github-apps/registering-a-github-app/rate-limits-for-github-apps) Os limites de taxa restringem a taxa de tráfego para GitHub.com, para ajudar a garantir acesso consistente para todos os usuários. * [Criando um selo personalizado para seu aplicativo GitHub](/pt/enterprise-server@3.21/apps/creating-github-apps/registering-a-github-app/creating-a-custom-badge-for-your-github-app) 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. * [Sobre a autenticação com um aplicativo GitHub](/pt/enterprise-server@3.21/apps/creating-github-apps/authenticating-with-a-github-app/about-authentication-with-a-github-app) O GitHub App pode se autenticar com si próprio, como uma instalação de aplicativo ou em nome de um usuário. * [Autenticando como aplicativo GitHub](/pt/enterprise-server@3.21/apps/creating-github-apps/authenticating-with-a-github-app/authenticating-as-a-github-app) Você pode autenticar como um GitHub App para gerar um token de acesso de instalação ou gerenciar seu aplicativo. * [Como autenticar como uma instalação de Aplicativo GitHub](/pt/enterprise-server@3.21/apps/creating-github-apps/authenticating-with-a-github-app/authenticating-as-a-github-app-installation) 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. * [Autenticação com um aplicativo GitHub em nome de um usuário](/pt/enterprise-server@3.21/apps/creating-github-apps/authenticating-with-a-github-app/authenticating-with-a-github-app-on-behalf-of-a-user) 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. * [Gerenciando chaves privadas para aplicativos GitHub](/pt/enterprise-server@3.21/apps/creating-github-apps/authenticating-with-a-github-app/managing-private-keys-for-github-apps) Você pode gerenciar chaves privadas para autenticar com seu GitHub App. * [Gerando um JWT (Token Web JSON) para um aplicativo GitHub](/pt/enterprise-server@3.21/apps/creating-github-apps/authenticating-with-a-github-app/generating-a-json-web-token-jwt-for-a-github-app) Saiba como criar um JWT para autenticar determinados pontos de extremidade da API REST com seus GitHub App. * [Gerando um token de acesso de instalação para um aplicativo GitHub](/pt/enterprise-server@3.21/apps/creating-github-apps/authenticating-with-a-github-app/generating-an-installation-access-token-for-a-github-app) Saiba como gerar um token de acesso de instalação para seu GitHub App. * [Gerando um token de acesso do usuário para um aplicativo GitHub](/pt/enterprise-server@3.21/apps/creating-github-apps/authenticating-with-a-github-app/generating-a-user-access-token-for-a-github-app) 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. * [Atualizar tokens de acesso do usuário](/pt/enterprise-server@3.21/apps/creating-github-apps/authenticating-with-a-github-app/refreshing-user-access-tokens) 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. * [Fazer solicitações de API autenticadas com um aplicativo GitHub em um fluxo de trabalho GitHub Actions](/pt/enterprise-server@3.21/apps/creating-github-apps/authenticating-with-a-github-app/making-authenticated-api-requests-with-a-github-app-in-a-github-actions-workflow) 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. * [Sobre como escrever código para um aplicativo GitHub](/pt/enterprise-server@3.21/apps/creating-github-apps/writing-code-for-a-github-app/about-writing-code-for-a-github-app) Você precisa escrever código para adicionar funcionalidade à sua GitHub App. * [Guia de início rápido para a criação de aplicativos para GitHub](/pt/enterprise-server@3.21/apps/creating-github-apps/writing-code-for-a-github-app/quickstart) Crie rapidamente um GitHub App que comenta em pull requests. * [Criando um aplicativo GitHub que responde a eventos de webhook](/pt/enterprise-server@3.21/apps/creating-github-apps/writing-code-for-a-github-app/building-a-github-app-that-responds-to-webhook-events) Saiba como criar um(a) GitHub App que faz uma requisição à API em resposta a um evento de webhook. * [Criando um botão "Logon com GitHub" com um aplicativo GitHub](/pt/enterprise-server@3.21/apps/creating-github-apps/writing-code-for-a-github-app/building-a-login-with-github-button-with-a-github-app) 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. * [Criando uma CLI com um aplicativo GitHub](/pt/enterprise-server@3.21/apps/creating-github-apps/writing-code-for-a-github-app/building-a-cli-with-a-github-app) 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. * [Criando verificações de CI com um aplicativo GitHub](/pt/enterprise-server@3.21/apps/creating-github-apps/writing-code-for-a-github-app/building-ci-checks-with-a-github-app) Crie um servidor de integração contínua para executar testes usando um GitHub App e verificações. * [Compartilhando seu Aplicativo GitHub](/pt/enterprise-server@3.21/apps/sharing-github-apps/sharing-your-github-app) Você pode compartilhar seu GitHub App com outros usuários. * [Disponibilizando seu aplicativo GitHub para GitHub Enterprise Server](/pt/enterprise-server@3.21/apps/sharing-github-apps/making-your-github-app-available-for-github-enterprise-server) Para que as instâncias do GitHub Enterprise Server usem seu GitHub App, você deve seguir algumas etapas adicionais. * [Registrando um App do GitHub a partir de um manifesto](/pt/enterprise-server@3.21/apps/sharing-github-apps/registering-a-github-app-from-a-manifest) 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. * [Registrando um aplicativo GitHub usando parâmetros de URL](/pt/enterprise-server@3.21/apps/sharing-github-apps/registering-a-github-app-using-url-parameters) 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. * [Modificando um registro de aplicativo GitHub](/pt/enterprise-server@3.21/apps/maintaining-github-apps/modifying-a-github-app-registration) Depois de registrar um GitHub App, você pode fazer alterações nele. * [Ativando recursos opcionais para aplicativos GitHub](/pt/enterprise-server@3.21/apps/maintaining-github-apps/activating-optional-features-for-github-apps) Você pode testar novos recursos opcionais para sua GitHub Apps. * [Sobre Gerenciadores de Aplicativos do GitHub](/pt/enterprise-server@3.21/apps/maintaining-github-apps/about-github-app-managers) Os gerentes de aplicativos podem gerenciar alguns ou todos os GitHub App cadastros de uma conta. * [Suspendendo uma instalação do aplicativo GitHub](/pt/enterprise-server@3.21/apps/maintaining-github-apps/suspending-a-github-app-installation) Você pode bloquear temporariamente seu GitHub App de acessar os recursos que pertencem às contas que instalaram o GitHub App. * [Transferindo a propriedade de um aplicativo GitHub](/pt/enterprise-server@3.21/apps/maintaining-github-apps/transferring-ownership-of-a-github-app) Você pode transferir a propriedade de um registro de aplicativo GitHub para outro usuário ou organização. * [Excluindo um aplicativo GitHub](/pt/enterprise-server@3.21/apps/maintaining-github-apps/deleting-a-github-app) Você pode excluir os GitHub Apps que tiver se não quiser mais usar ou manter o aplicativo. * [Autorizar aplicativos OAuth](/pt/enterprise-server@3.21/apps/oauth-apps/using-oauth-apps/authorizing-oauth-apps) 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. * [Revisar aplicações OAuth autorizadas](/pt/enterprise-server@3.21/apps/oauth-apps/using-oauth-apps/reviewing-your-authorized-oauth-apps) 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. * [Conectar-se a aplicativos de terceiros](/pt/enterprise-server@3.21/apps/oauth-apps/using-oauth-apps/connecting-with-third-party-applications) 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. * [Aplicativos OAuth privilegiados](/pt/enterprise-server@3.21/apps/oauth-apps/using-oauth-apps/privileged-oauth-apps) Alguns OAuth apps são aplicativos privilegiados, de propriedade de GitHub, aos quais são concedidos recursos especiais. * [Diferenças entre aplicativos GitHub e aplicativos OAuth](/pt/enterprise-server@3.21/apps/oauth-apps/building-oauth-apps/differences-between-github-apps-and-oauth-apps) Em geral, os GitHub Apps são mais indicados que os OAuth apps porque usam permissões refinadas, dão mais controle sobre quais repositórios o aplicativo pode acessar e usam tokens de curta duração. * [Limites de taxa para aplicativos OAuth](/pt/enterprise-server@3.21/apps/oauth-apps/building-oauth-apps/rate-limits-for-oauth-apps) Os limites de taxa restringem a taxa de tráfego para GitHub.com, para ajudar a garantir acesso consistente para todos os usuários. * [Criar um aplicativo OAuth](/pt/enterprise-server@3.21/apps/oauth-apps/building-oauth-apps/creating-an-oauth-app) 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. * [Autenticar na API REST com um aplicativo OAuth](/pt/enterprise-server@3.21/apps/oauth-apps/building-oauth-apps/authenticating-to-the-rest-api-with-an-oauth-app) Aprenda sobre as diferentes maneiras de efetuar a autenticação com alguns exemplos. * [Autorizar aplicativos OAuth](/pt/enterprise-server@3.21/apps/oauth-apps/building-oauth-apps/authorizing-oauth-apps) Você pode permitir que outros usuários autorizem o OAuth app. * [Escopos para aplicativos OAuth](/pt/enterprise-server@3.21/apps/oauth-apps/building-oauth-apps/scopes-for-oauth-apps) 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. * [Criar um selo personalizado para o aplicativo OAuth](/pt/enterprise-server@3.21/apps/oauth-apps/building-oauth-apps/creating-a-custom-badge-for-your-oauth-app) Você pode substituir o selo padrão no OAuth app fazendo upload da sua imagem de logotipo e personalizando a tela de fundo. * [Práticas recomendadas para criar um aplicativo OAuth](/pt/enterprise-server@3.21/apps/oauth-apps/building-oauth-apps/best-practices-for-creating-an-oauth-app) Siga estas práticas recomendadas para melhorar a segurança e o desempenho de sua OAuth app. * [Modificar um aplicativo OAuth](/pt/enterprise-server@3.21/apps/oauth-apps/maintaining-oauth-apps/modifying-an-oauth-app) Depois de criar e registrar um OAuth app, você poderá fazer alterações nele. * [Ativar recursos opcionais para aplicativos OAuth](/pt/enterprise-server@3.21/apps/oauth-apps/maintaining-oauth-apps/activating-optional-features-for-oauth-apps) Você pode testar novos recursos opcionais para suas aplicações OAuth apps. * [Transferir a propriedade de um aplicativo OAuth](/pt/enterprise-server@3.21/apps/oauth-apps/maintaining-oauth-apps/transferring-ownership-of-an-oauth-app) Você pode transferir a proprietário de um OAuth app para outro usuário ou organização. de dados * [Solucionar problemas de erros de solicitação de autorização](/pt/enterprise-server@3.21/apps/oauth-apps/maintaining-oauth-apps/troubleshooting-authorization-request-errors) Ao obter um token do OAuth para um usuário, alguns erros podem ocorrer durante a fase inicial da solicitação de autorização. * [Solução de erros de solicitação de token de acesso do aplicativo OAuth](/pt/enterprise-server@3.21/apps/oauth-apps/maintaining-oauth-apps/troubleshooting-oauth-app-access-token-request-errors) 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. * [Excluir um aplicativo OAuth](/pt/enterprise-server@3.21/apps/oauth-apps/maintaining-oauth-apps/deleting-an-oauth-app) Você pode excluir OAuth apps quando deixar de usá-las. * [GitHub pontos de extremidade de descoberta de autenticação](/pt/enterprise-server@3.21/apps/github-authentication-discovery-endpoints) GitHub publica documentos de metadados do OAuth 2.0 e do OpenID Connect.