{"meta":{"title":"GITHUB_TOKEN","intro":"Saiba o que GITHUB_TOKEN é, como funciona e por que ele é importante para a automação segura em GitHub Actions fluxos de trabalho.","product":"GitHub Actions","breadcrumbs":[{"href":"/pt/actions","title":"GitHub Actions"},{"href":"/pt/actions/concepts","title":"Conceitos"},{"href":"/pt/actions/concepts/security","title":"Segurança"},{"href":"/pt/actions/concepts/security/github_token","title":"GITHUB_TOKEN"}],"documentType":"article"},"body":"# GITHUB_TOKEN\n\nSaiba o que GITHUB_TOKEN é, como funciona e por que ele é importante para a automação segura em GitHub Actions fluxos de trabalho.\n\n## Sobre o `GITHUB_TOKEN`\n\nNo início de cada tarefa do fluxo de trabalho, GitHub cria automaticamente um segredo exclusivo `GITHUB_TOKEN` a ser usado no fluxo de trabalho. Use o `GITHUB_TOKEN` para se autenticar em um fluxo de trabalho.\n\nQuando você habilita GitHub Actions, GitHub instala um GitHub App no repositório. O segredo `GITHUB_TOKEN` é um GitHub App token de acesso de instalação. Você pode usar o token de acesso de instalação para autenticar em nome do GitHub App instalado em seu repositório. As permissões do token são restritas ao repositório do fluxo de trabalho. Para obter mais informações, consulte [Sintaxe de fluxo de trabalho para o GitHub Actions](/pt/actions/reference/workflows-and-actions/workflow-syntax#permissions).\n\nAntes de cada trabalho começar, GitHub busca um token de acesso de instalação para o trabalho. O `GITHUB_TOKEN` expira quando o trabalho é concluído ou após seu tempo de vida máximo efetivo.\n\nO tempo de vida útil máximo efetivo do token depende do tipo de runner:\n\n* **GitHub-execuções hospedadas** O tempo de execução do trabalho máximo é de 6 horas, logo, o `GITHUB_TOKEN` pode durar, no máximo, 6 horas.\n* **Executores auto-hospedados** O tempo máximo de execução do trabalho é de 5 dias. No entanto, como o `GITHUB_TOKEN` é um token de acesso de instalação, ele só pode ser renovado por no máximo 24 horas. Se o trabalho durar mais de 24 horas, use um personal access token ou outro método de autenticação em vez disso.\n\nO token também está disponível no contexto `github.token`. Para obter mais informações, consulte [Referência de contextos](/pt/actions/reference/workflows-and-actions/contexts#github-context).\n\n## Quando `GITHUB_TOKEN` dispara execuções do fluxo de trabalho\n\nQuando você usa o `GITHUB_TOKEN` do repositório para executar tarefas, os eventos acionados pelo `GITHUB_TOKEN` não criarão uma nova execução de fluxo de trabalho, com as seguintes exceções:\n\n* ```\n            Eventos `workflow_dispatch` e `repository_dispatch` sempre criam execuções do fluxo de trabalho.\n  ```\n* ```\n            Eventos `pull_request` com os tipos de atividade `opened`, `synchronize` ou `reopened`: quando um fluxo de trabalho que usa `GITHUB_TOKEN` cria ou atualiza uma pull request, o evento `pull_request` resultante cria execuções do fluxo de trabalho em um estado **aprovação-obrigatória**. O pull request exibe um banner na caixa de merge, e um usuário com acesso de escrita ao repositório pode iniciar as execuções selecionando **Aprovar fluxos de trabalho para execução**. Outros `pull_request` tipos de atividade (como `labeled`, `edited`ou `closed`) não criam execuções de fluxo de trabalho. Isso impede que o fluxo de trabalho recursivo seja executado enquanto ainda permite que os fluxos de trabalho de CI sejam executados em solicitações de pull criadas pela automação. Para obter mais informações sobre como aprovar execuções de fluxo de trabalho, consulte [AUTOTITLE](/actions/how-tos/manage-workflow-runs/approve-runs-from-forks).\n  ```\n\nPara todos os outros eventos, esse comportamento impede que você crie acidentalmente execuções de fluxo de trabalho recursivo. Por exemplo, se uma execução de fluxo de trabalho efetuar push do código usando o `GITHUB_TOKEN` do repositório, um novo fluxo de trabalho não será executado mesmo quando o repositório contiver um fluxo de trabalho configurado para ser executado quando os eventos do `push` ocorrerem.\n\n> \\[!NOTE]\n> Se você precisar de execuções do fluxo de trabalho a partir de pull requests criadas pelo fluxo de trabalho a serem executadas sem exigir aprovação, use um GitHub App token de acesso de instalação ou um personal access token em vez de `GITHUB_TOKEN` durante a criação ou a atualização da pull request.\n\nCommits enviados por push por um fluxo de trabalho de GitHub Actions que usa o `GITHUB_TOKEN` não disparam um build de GitHub Pages.\n\n## Próximas etapas\n\n* [Usar GITHUB\\_TOKEN para autenticação em fluxos de trabalho](/pt/actions/tutorials/authenticate-with-github_token)\n* [Sintaxe de fluxo de trabalho para o GitHub Actions](/pt/actions/reference/workflows-and-actions/workflow-syntax#permissions)"}