Autenticação em nome do titular
Um personal access token (PAT), ou token de acesso pessoal, é uma credencial que um programa utiliza para se autenticar em nome de seu titular. No GitHub, ele pode substituir a senha em chamadas à interface de programação (API) e em operações do Git por HTTPS. O programa apresenta o token para executar as ações permitidas ao seu titular.
A autorização combina o acesso do titular com o alcance concedido ao token. Por exemplo, um token fine-grained pode ficar restrito a um repositório privado e à leitura do conteúdo dele. O titular pode ter acesso a outros repositórios privados sem que esse token consiga consultá-los. Organizações também podem exigir aprovação ou restringir o uso dessas credenciais.
Um script que só precisa ler o repositório
Um script de manutenção pode consultar arquivos com uma credencial limitada à leitura. A referência de conteúdo dos repositórios documenta as permissões exigidas para gravar arquivos. Ao tentar gravar uma alteração, a chamada será recusada se o token não tiver a permissão correspondente, mesmo que o titular possa editar o repositório pelo navegador. Você precisa conferir a ação pretendida e as permissões concedidas, além da validade da credencial.
A documentação do GitHub orienta utilizar uma GitHub App para integrações duradouras ou acesso em nome de uma organização. O token pessoal permanece vinculado ao usuário que o gerou e perde acesso a um recurso quando esse usuário perde o acesso.
Guarde o valor em um gerenciador de segredos e conceda somente o acesso necessário. A documentação sobre revogação do GitHub orienta revogar tokens expostos. A remoção do texto do repositório não invalida uma credencial já obtida por terceiros.
Dúvidas frequentes
Perguntas frequentes sobre personal access token
- Um token pode conceder acesso que o titular não possui?
- No GitHub, o acesso fica limitado pelas permissões do titular e pelas permissões ou pelos escopos do token. Incluir um escopo administrativo não torna o titular administrador de uma organização.
- Qual é a diferença entre os tokens fine-grained e classic?
- Os tokens fine-grained permitem selecionar repositórios e permissões específicas para um titular de recursos. Os tokens classic usam escopos mais amplos. O GitHub recomenda fine-grained quando suas funções atendem à integração.
- O que fazer quando o token é exposto?
- Revogue a credencial exposta e atualize os locais que dependiam dela com uma nova credencial. Apagar o texto de um arquivo público não revoga o token nem remove cópias já obtidas.
Para continuar
Recursos relacionados
Documentação
GitHub: tokens pessoais e permissões
Tipos de token pessoal, permissões, políticas de organizações e situações que exigem uma GitHub App.
Abrir recursoSite de referência
DevSide: desenvolvimento colaborativo
Orientação ao vivo para revisar as credenciais de um script e investigar recusas de acesso aos repositórios.
Abrir recursoDocumentação
GitHub: expiração e revogação de tokens
Condições que encerram a validade dos tokens e orientação para revogar credenciais expostas.
Abrir recursoAplicação na formação
Formação DevOps
Scripts de manutenção precisam de credenciais com acesso compatível com os repositórios e as ações que executam.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.