Table of Contents
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
- Acesse https://github.com e faça login
- Clique no seu avatar (canto superior direito) e selecione Settings
- No menu lateral esquerdo, navegue até: Developer settings > Personal access tokens > Tokens (classic)
- Clique em Generate new token (classic)
- Preencha os campos:
- * Note: Dê um nome descritivo (ex: Petrolina workstation, IFSertãoPE server)
- * Expiration: Defina uma data de expiração ou selecione No expiration para uso pessoal
- * Select scopes: Marque pelo menos a opção repo (acesso completo a repositórios públicos e privados)
- Clique em Generate token no final da página
- 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
