{"meta":{"title":"Autenticando como aplicativo GitHub","intro":"Você pode autenticar como um GitHub App para gerar um token de acesso de instalação ou gerenciar seu aplicativo.","product":"Aplicativos","breadcrumbs":[{"href":"/pt/apps","title":"Aplicativos"},{"href":"/pt/apps/creating-github-apps","title":"Criando aplicativos GitHub"},{"href":"/pt/apps/creating-github-apps/authenticating-with-a-github-app","title":"Autentique-se com um GitHub App"},{"href":"/pt/apps/creating-github-apps/authenticating-with-a-github-app/authenticating-as-a-github-app","title":"Autenticar-se como um aplicativo"}],"documentType":"article"},"body":"# Autenticando como aplicativo GitHub\n\nVocê pode autenticar como um GitHub App para gerar um token de acesso de instalação ou gerenciar seu aplicativo.\n\n## Sobre a autenticação como um GitHub App\n\nVocê deve se autenticar como um GitHub App para fazer solicitações de API REST como o aplicativo. Por exemplo, se você quiser usar a API para gerar um token de acesso de instalação para acessar recursos da organização, listar instalações entre contas para seu aplicativo ou suspender uma instalação de aplicativo, você deve se autenticar como um aplicativo.\n\nSe um ponto de extremidade da API REST exigir a autenticação como um aplicativo, a documentação desse ponto indicará que você deve usar um JWT para acessá-lo. A API do GraphQL não dá suporte a consultas ou mutações que exigem que você se autentique com um JWT.\n\n## Usar um JWT (Token Web JSON) para autenticar como um GitHub App\n\n1. Gere um JWT (Token Web JSON) para seu aplicativo. Para saber mais, confira [Gerando um JWT (Token Web JSON) para um aplicativo GitHub](/pt/apps/creating-github-apps/authenticating-with-a-github-app/generating-a-json-web-token-jwt-for-a-github-app).\n2. Inclua o JWT no cabeçalho `Authorization` da solicitação. No exemplo a seguir, substitua `YOUR_JWT` pelo JWT.\n\n   ```shell\n   curl --request GET \\\n   --url \"https://api.github.com/app/installations\" \\\n   --header \"Accept: application/vnd.github+json\" \\\n   --header \"Authorization: Bearer YOUR_JWT\" \\\n   --header \"X-GitHub-Api-Version: 2026-03-10\"\n   ```\n\n## Usar um SDK Octokit.js para se autenticar como um GitHub App\n\nVocê pode usar o SDK do Octokit.js do GitHub para se autenticar como um GitHub App. Uma vantagem de usar o SDK para autenticação é que você não precisa gerar um JWT (token Web JSON) por conta própria. Além disso, o SDK cuidará da regeneração do JWT quando expirar.\n\n> \\[!NOTE]\n> Você precisa instalar e importar `octokit` para usar a biblioteca do Octokit.js. O exemplo a seguir usa instruções de importação de acordo com o ES6. Para obter mais informações sobre diferentes métodos de instalação e importação, confira [Uso](https://github.com/octokit/octokit.js/#usage) no repositório octokit/octokit.\n\n1. Obter a ID do seu aplicativo. Encontre a ID do aplicativo na página de configuração do GitHub App. Para saber como acessar a página de configurações do GitHub App, confira [Modificando um registro de aplicativo GitHub](/pt/apps/maintaining-github-apps/modifying-a-github-app-registration#navigating-to-your-github-app-settings).\n\n2. Gere uma chave privada. Para saber mais, confira [Gerenciando chaves privadas para aplicativos GitHub](/pt/apps/creating-github-apps/authenticating-with-a-github-app/managing-private-keys-for-github-apps).\n\n3. Importe `App` de `octokit`.\n\n   ```javascript copy\n   import { App } from \"octokit\";\n   ```\n\n4. Crie uma nova instância do `App`. No exemplo a seguir, substitua `APP_ID` por uma referência à ID do seu aplicativo. Substitua `PRIVATE_KEY` por uma referência ao valor da chave privada do seu aplicativo.\n\n   ```javascript copy\n    const app = new App({\n     appId: APP_ID,\n     privateKey: PRIVATE_KEY,\n   });\n   ```\n\n5. Use um método `octokit` para fazer uma solicitação para um ponto de extremidade da API REST que requer um JWT. Por exemplo:\n\n   ```javascript copy\n   await app.octokit.request(\"/app\")\n   ```"}