====== 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:

<code bash>
git clone https://github.com/SEU_USUARIO/REPO.git
</code>

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:

<code bash>
git pull
</code>

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):

<code bash>
git config --global credential.helper cache
</code>

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

<code bash>
git config --global credential.helper store
</code>

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:

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

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:

<code bash>
# Debian/Ubuntu/Mint
sudo apt install gh

# Arch Linux
sudo pacman -S github-cli

# Fedora
sudo dnf install gh
</code>

Autenticação:

<code bash>
gh auth login
</code>

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

===== Verificação =====

Teste a configuração:

<code bash>
# 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
</code>

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

===== Links Úteis =====

  * [[https://docs.github.com/pt/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens|Documentação oficial do GitHub - Personal Access Tokens]]
  * [[https://cli.github.com/|GitHub CLI]]
  * [[https://git-scm.com/book/pt-br/v2/Ferramentas-do-Git-Credential-Armazenamento|Configuração de credenciais do Git]]