Passo a passo: Como resolver erro de permissão ao fazer push para o GitHub

Como resolver erro de permissão ao fazer push para o GitHub?

Se você recebeu um erro de permissão ao tentar fazer push no GitHub, isso geralmente indica problemas de autenticação ou falta de permissões no repositório. Vamos explorar as principais causas e soluções.

1. Verificando a mensagem de erro

Antes de corrigir o problema, veja a mensagem de erro exibida ao tentar fazer push. Os erros mais comuns são:

• fatal: Authentication failed for 'https://github.com/usuario/repositorio.git'
• remote: Permission to usuario/repositorio.git denied to outro-usuario.
• ERROR: Permission to usuario/repositorio.git denied. Please make sure you have the correct access rights.

2. Conferindo as permissões no repositório

Se o erro indicar que você não tem permissão para o repositório, verifique se sua conta GitHub tem acesso de escrita:

• Acesse o repositório no GitHub.
• Vá até Settings > Collaborators.
• Confirme se sua conta está listada com permissões de escrita.

Se não tiver acesso, solicite ao proprietário do repositório que conceda permissão de escrita.

3. Atualizando credenciais do GitHub

Se o erro for de autenticação, pode ser necessário atualizar suas credenciais:

• Se estiver usando HTTPS, remova credenciais antigas do cache:

git credential reject https://github.com

• Em seguida, ao fazer push novamente, o Git solicitará suas credenciais.

• Caso prefira não digitar a senha sempre, utilize um Personal Access Token (PAT) em vez de senha. Gere um token em:

  • GitHub > Settings > Developer settings > Personal access tokens
  • Use o token no push:

git remote set-url origin https://TOKEN@github.com/usuario/repositorio.git

4. Verificando se está usando SSH ou HTTPS corretamente

Se estiver usando HTTPS, considere mudar para SSH para evitar problemas de autenticação recorrentes:

git remote set-url origin git@github.com:usuario/repositorio.git

Se ainda não tiver configurado SSH, adicione sua chave SSH ao GitHub:

ssh-keygen -t rsa -b 4096 -C "seu-email@gmail.com"

Depois, adicione a chave ao GitHub em Settings > SSH and GPG keys.

Por que ocorrem erros de permissão ao fazer push para o GitHub?

Erros de permissão ao fazer push para o GitHub são comuns, principalmente quando há mudanças nas políticas de autenticação da plataforma. Desde 2021, o GitHub não aceita mais autenticação por senha ao usar HTTPS, exigindo um Personal Access Token.

Além disso, usuários que trabalham com múltiplas contas podem enfrentar conflitos de credenciais salvas no cache do Git. Nesses casos, usar SSH é uma solução eficaz para evitar autenticações manuais constantes. Configurar corretamente as permissões do repositório também evita frustrações, garantindo que todos os colaboradores tenham acesso adequado para enviar alterações ao código.

Algumas aplicações:

• Corrigir problemas de autenticação ao fazer push
• Garantir que sua conta GitHub tenha as permissões corretas
• Configurar SSH para evitar digitação de senha constantemente
• Atualizar credenciais do Git armazenadas no cache
• Evitar erros ao trabalhar com múltiplas contas no GitHub

Dicas para quem está começando

• Se o Git solicitar uma senha ao fazer push, use um Personal Access Token em vez da senha da conta.
• Se estiver trabalhando em um repositório de outra pessoa, peça permissão de escrita ao proprietário.
• Use 'git credential reject' para remover credenciais antigas e forçar um novo login.
• Prefira configurar SSH para facilitar a autenticação no GitHub.
• Verifique se a URL do repositório remoto está correta com 'git remote -v'.

Compartilhe este tutorial