Skip to main content

Criando um token de acesso pessoal

Você pode criar um token de acesso pessoal para usar no lugar de uma senha com a linha de comando ou com a API.

Observações:

  • se você usar a GitHub CLI para se autenticar no GitHub Enterprise Server na linha de comando, ignore a geração de um token de acesso pessoal e se autentique pelo navegador da Web. Para obter mais informações sobre como se autenticar com a GitHub CLI, confira gh auth login.
  • O Gerenciador de Credenciais do Git é uma alternativa segura e multiplataforma ao uso de PATs (tokens de acesso pessoal) e elimina a necessidade de gerenciar o escopo e a validade do PAT. Para obter instruções de instalação, confira Baixar e instalar no repositório GitCredentialManager/git-credential-manager.

Os PATs (tokens de acesso pessoal) 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.

Um token com nenhum escopo atribuído só pode acessar informações públicas. Para usar seu token para acessar os repositórios na linha de comando, selecione repo. Para obter mais informações, confira "Escopos disponíveis".

Criar um 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. In the left sidebar, click Developer settings.

  3. Na barra lateral esquerda, clique em Tokens de acesso pessoal. Tokens de acesso pessoal 1. Clique em Gerar novo token. Botão Gerar novo token

  4. Dê ao seu token um nome descritivo. Campo de 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, aos quais deseja conceder esse token. Para usar o token para acessar os repositórios na linha de comando, selecione repositório. Seleção de escopos de token

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

    Aviso: trate seus tokens como senhas e mantenha-os em segredo. Ao trabalhar com a API, use tokens como variáveis de ambiente em vez de embuti-los em código nos seus programas.

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 tokens de acesso pessoais podem ser usados apenas para operações Git HTTPS. 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 seu PAT para cada operação de HTTPS do Git, você pode armazenar seu PAT 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