Skip to main content

Solucionar problemas de SSH

Ao usar o SSH para se conectar e autenticar GitHub, talvez seja necessário solucionar problemas inesperados que possam surgir.

Usar SSH na porta HTTPS

Às vezes, os firewalls se recusam a permitir conexões SSH completamente. Se usar clonagem de HTTPS com armazenamento de credenciais em cache não for uma opção, experimente clonar usando uma conexão SSH na porta HTTPS. A maioria das regras de firewall deve permitir isso, mas o servidores proxy podem interferir.

Recuperar frase secreta da chave SSH

Se você perder a frase secreta da chave SSH, poderá recuperá-la ou gerar uma nova, dependendo do sistema operacional usado.

Chaves SSH excluídas ou ausentes

Como precaução de segurança, GitHub exclui automaticamente as chaves SSH que não são usadas há um ano.

Erro: falha na verificação da chave de host

Como precaução de segurança, o SSH mantém o controle dos hosts vistos anteriormente.

Erro: permissão negada (publickey)

Uma mensagem de erro "Permission denied" (permissão negada) indica que o servidor rejeitou a sua conexão. Existem diferentes razões para isso acontecer. Os exemplos mais comuns estão descritos abaixo.

Erro: número de arquivo inadequado

Este erro normalmente significa que você não conseguiu se conectar ao servidor. Quase sempre isso é causado por firewalls e servidores proxy.

Erro: chave já em uso

Este erro ocorre quando você tenta adicionar uma chave que já foi adicionada a outra conta ou repositório.

Erro: permissão de usuário/repo negada a outro usuário

O erro indica que a chave inserida está associada a uma conta sem acesso ao repositório.

Erro: permissão de usuário/repo negada a outro usuário/repo

Esse erro indica que a chave utilizada está associada a outro repositório como uma chave de deploy e não tem acesso ao repositório para o qual você está tentando enviar.

Erro: agente admitiu falha ao assinar

Em circunstâncias raras, conectar-se ao GitHub via SSH no Linux produz o erro "Agent admitted failure to sign using the key". Siga estas etapas para resolver o problema.

Erro: ssh-add: opção ilegal -- apple-use-keychain

O erro indica que sua versão do ssh-add não é compatível com a integração de keychain no macOS, que permite o armazenamento da frase secreta no keychain.

Erro: problema na certificação SSL, verifique se a cert CA está OK

O erro indica que o certificado CA root está desatualizado. Se o seu certificado raiz da AC precisar ser atualizado, você não poderá realizar push ou pull de repositórios GitHub.

Erro: Tipo de chave desconhecido

Este erro significa que o tipo de chave SSH que você usou não foi reconhecido ou não é compatível com o seu cliente SSH.

Erro: auditoria de chave SSH em andamento

O erro indica que a chave SSH em uso para uma operação Git não foi verificada.