User Tools

Site Tools


wiki:dicas:gh-token

Configurando Acesso ao GitHub via Token no Terminal Linux

Este guia descreve como configurar a autententicação ao GitHub usando Personal Access Token para operações de git clone, git pull e git push via terminal.

Pré-requisitos

  • Conta no GitHub
  • Git instalado na máquina
  • Terminal Linux

Passo 1: Gerar o Token no GitHub

  1. Acesse https://github.com e faça login
  2. Clique no seu avatar (canto superior direito) e selecione Settings
  3. No menu lateral esquerdo, navegue até: Developer settings > Personal access tokens > Tokens (classic)
  4. Clique em Generate new token (classic)
  5. Preencha os campos:
    1. * Note: Dê um nome descritivo (ex: Petrolina workstation, IFSertãoPE server)
    2. * Expiration: Defina uma data de expiração ou selecione No expiration para uso pessoal
    3. * Select scopes: Marque pelo menos a opção repo (acesso completo a repositórios públicos e privados)
  6. Clique em Generate token no final da página
  7. Copie o token gerado — você só poderá vê-lo uma única vez

Passo 2: Usar o Token no Terminal

Opção A: Usar Diretamente na URL

Para clonar um repositório:

git clone https://github.com/SEU_USUARIO/REPO.git

Quando solicitado:

  • Username: Seu usuário do GitHub
  • Password: Cole o token (nenhum caractere aparecerá enquanto digita)

Para fazer pull em repositório já clonado:

git pull

Digite novamente:

  • Username: Seu usuário do GitHub
  • Password: O token

Opção B: Configurar Cache de Credenciais (Recomendado)

Para não precisar digitar o token toda vez, configure o cache de credenciais:

Cache temporário (válido por 15 minutos):

git config --global credential.helper cache

Armazenamento permanente em disco (menos seguro, mas mais prático):

git config --global credential.helper store

Após configurar, na próxima operação que exigir autenticação (pull, push, etc.), digite usuário e token uma única vez. O Git salvará as credenciais.

Opção C: Incluir Token na URL Remota (Avançado)

Se preferir configurar diretamente na URL do remote:

git remote set-url origin https://SEU_TOKEN@github.com/SEU_USUARIO/REPO.git

Atenção: Este método deixa o token visível no arquivo .git/config e no histórico de comandos do shell. Use apenas em ambientes controlados.

Dica Extra: GitHub CLI (gh)

Para usuários avançados de Linux, a CLI oficial do GitHub gerencia tokens automaticamente:

Instalação:

# Debian/Ubuntu/Mint
sudo apt install gh
 
# Arch Linux
sudo pacman -S github-cli
 
# Fedora
sudo dnf install gh

Autenticação:

gh auth login

Siga o processo interativo. O utilitário gh gerencia tokens automaticamente e se integra com o Git.

Verificação

Teste a configuração:

# Clone um repositório seu
git clone https://github.com/SEU_USUARIO/UM_REPO_SEU.git
 
# Entre no repositório
cd UM_REPO_SEU
 
# Faça pull
git pull

Se não houver erro de autenticação, a configuração está correta.

Segurança e Boas Práticas

  • Nunca compartilhe seu token
  • Use tokens com expiração definida quando possível
  • Revogue tokens antigos periodicamente em: https://github.com/settings/tokens
  • Evite incluir tokens diretamente em URLs ou scripts
  • Em servidores de produção, considere usar chaves SSH em vez de tokens
wiki/dicas/gh-token.txt · Last modified: by cleiton

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki