# Solucionar problemas de SSH

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

## Links

* [Usar SSH na porta HTTPS](/pt/authentication/troubleshooting-ssh/using-ssh-over-the-https-port)

  À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](/pt/authentication/troubleshooting-ssh/recovering-your-ssh-key-passphrase)

  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](/pt/authentication/troubleshooting-ssh/deleted-or-missing-ssh-keys)

  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](/pt/authentication/troubleshooting-ssh/error-host-key-verification-failed)

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

* [Erro: permissão negada (publickey)](/pt/authentication/troubleshooting-ssh/error-permission-denied-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](/pt/authentication/troubleshooting-ssh/error-bad-file-number)

  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](/pt/authentication/troubleshooting-ssh/error-key-already-in-use)

  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](/pt/authentication/troubleshooting-ssh/error-permission-to-userrepo-denied-to-other-user)

  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](/pt/authentication/troubleshooting-ssh/error-permission-to-userrepo-denied-to-userother-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](/pt/authentication/troubleshooting-ssh/error-agent-admitted-failure-to-sign)

  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](/pt/authentication/troubleshooting-ssh/error-ssh-add-illegal-option----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](/pt/authentication/troubleshooting-ssh/error-ssl-certificate-problem-verify-that-the-ca-cert-is-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](/pt/authentication/troubleshooting-ssh/error-unknown-key-type)

  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](/pt/authentication/troubleshooting-ssh/error-were-doing-an-ssh-key-audit)

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