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

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:

Para fazer pull em repositório já clonado:

git pull

Digite novamente:

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