Skip to main content
We publish frequent updates to our documentation, and translation of this page may still be in progress. For the most current information, please visit the English documentation.

Criando um token de acesso pessoal

Você pode criar um personal access token a ser usado no lugar de uma senha com a linha de comando ou com a API.

Aviso: trate os tokens de acesso como uma senha.

Para acessar o GitHub por meio da linha de comando, considere usar a GitHub CLI ou o Git Credential Manager em vez de criar um personal access token.

Ao usar um personal access token em um script, considere armazenar o token como um segredo e executar o script por meio do GitHub Actions. Para saber mais, confira "Segredos criptografados".

Se essas opções não forem possíveis, considere usar outro serviço, como a CLI do 1Password, para armazenar seu token com segurança.

Sobre os personal access tokens

Os Personal access token são uma alternativa ao uso de senhas para autenticação no GitHub Enterprise Server ao usar a API do GitHub ou a linha de comando. Os Personal access tokens são usados para acessar recursos do GitHub em nome de si mesmo. Para acessar recursos em nome de uma organização ou para integrações de longa duração, você deve usar um GitHub App. Para obter mais informações, confira "Sobre os aplicativos".

Como criar um personal access token

  1. No canto superior direito de qualquer página, clique na foto do seu perfil e em Configurações.

    Ícone Settings (Configurações) na barra de usuário

  2. Na barra lateral esquerda, clique em Configurações do desenvolvedor.

  3. Na barra lateral esquerda, clique em Personal access token . Personal access tokens 1. Clique em Gerar novo token. Botão Gerar novo token

  4. Dê ao seu token um nome descritivo. Campo Descrição do token

  5. Para dar uma validade ao token, selecione o menu suspenso Validade e clique em um padrão ou use o seletor de calendário. Campo de validade do token

  6. Selecione os escopos ou as permissões que deseja conceder a esse token. Para usar o token para acessar os repositórios na linha de comando, selecione repositório. Um token com nenhum escopo atribuído só pode acessar informações públicas. Para obter mais informações, confira "Escopos disponíveis". Seleção de escopos de token

  7. Clique em Gerar token. Botão Gerar token Token recém-criado

Usar um token na linha de comando

Se você tem um token, é possível inseri-lo em vez de sua senha ao realizar operações Git em HTTPS.

Por exemplo, você digitaria o seguinte na linha de comando:

$ git clone https://HOSTNAME/USERNAME/REPO.git
Username: YOUR_USERNAME
Password: YOUR_TOKEN

Os Personal access tokens só podem ser usados para operações HTTP do Git. Se o repositório usar uma URL remota SSH, você precisará alternar o repositório remoto de SSH para HTTPS.

Se não for solicitado a informar seu nome de usuário e a senha, suas credenciais poderão ser armazenadas em cache no seu computador. Você pode atualizar suas credenciais no conjunto de chaves para substituir sua senha antiga pelo token.

Em vez de inserir manualmente os dados do personal access token para cada operação HTTPS do Git, você pode armazenar em cache os dados do personal access token com um cliente Git. O Git irá armazenar temporariamente as suas credenciais na memória até que um intervalo de expiração tenha passado. Você também pode armazenar o token em um arquivo de texto simples que o Git pode ler antes de cada solicitação. Para obter mais informações, confira "Como armazenar em cache suas credenciais do GitHub no Git".

Leitura adicional