Skip to main content

Solucionar problemas de SSH

Ao usar o SSH para se conectar e autenticar no GitHub, talvez você precise solucionar problemas inesperados que podem 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 medida de segurança, o GitHub exclui automaticamente chaves SSH que não tenham sido usadas em 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 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

O erro indica que a chave inserida está associada a outro repositório como uma chave de implantação e não tem acesso ao repositório que você está tentando entrar.

Erro: agente com falha ao entrar

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. Não será possível fazer push ou pull nos repositórios GitHub se houver necessidade de atualizar o certificado CA root.

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.