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.