Permission denied (publickey) significa que o servidor OpenSSH só permite autenticação por chave e rejeitou todas as chaves que o seu cliente ofereceu para esse utilizador. Quatro causas cobrem quase todos os casos: o utilizador remoto errado, uma chave que não está carregada ou não é oferecida, permissões incorretas em ~/.ssh ou authorized_keys, e um algoritmo de assinatura da chave que o outro lado recusa.
O que Permission denied (publickey) lhe diz sobre o servidor OpenSSH
O OpenSSH mostra esta mensagem quando o método publickey falhou e não resta nenhum outro método de autenticação. O texto entre parênteses lista os métodos que o servidor aceita. Se apenas indicar publickey, o início de sessão por palavra-passe está desativado e não há alternativa. O sshd nunca diz ao cliente porque é que uma chave foi recusada, por conceção. O diagnóstico faz-se pelas duas pontas: a saída detalhada do cliente e o registo do servidor.
Passo 1: ler a saída de ssh -vvv para ver que chave SSH é oferecida
A flag -v aumenta o nível de detalhe do ssh, até três níveis. -vvv mostra cada chave que o cliente tenta e como o servidor responde. Filtrar poupa-lhe percorrer centenas de linhas:
ssh -vvv -p 22 [email protected] 2>&1 | grep -E 'Connecting to|Offering|Trying|Authentications|Server accepts|No more'Estas são as linhas que importam:
- Connecting to: o anfitrião e a porta reais depois de aplicado o ~/.ssh/config. A predefinição é a porta TCP 22.
- Offering public key: a chave que está a ser enviada. Se não aparecer nenhuma, o cliente não encontra nenhuma chave (passo 3).
- Authentications that can continue: publickey logo a seguir a uma oferta: o servidor rejeitou essa chave.
- Server accepts key: a chave é válida. Uma falha depois disto aponta para a frase-passe ou para o agente.
- No more authentication methods to try: o cliente esgotou as chaves.
Passo 2: confirmar o utilizador remoto da ligação SSH
Se não especificar um utilizador, o ssh envia o seu nome de utilizador local. Num telemóvel ou numa máquina emprestada, esse nome raramente coincide com a conta do servidor. ssh -G mostra a configuração efetiva sem estabelecer ligação:
ssh -G server.example.com | grep -E '^(user|hostname|port|identityfile) 'Cada conta tem o seu próprio authorized_keys. Uma chave autorizada em /home/ana/.ssh/authorized_keys não o deixa entrar como root nem como qualquer outro utilizador. As imagens de cloud costumam criar o seu próprio utilizador não-root, por isso consulte a documentação do seu fornecedor antes de investigar mais.
Passo 3: verificar se a chave SSH está carregada no agente e é realmente oferecida
ssh-add -l lista as chaves guardadas pelo agente. Se indicar que não há identidades, o cliente só tenta os ficheiros predefinidos em ~/.ssh. Para forçar uma chave específica e comparar impressões digitais:
ssh-add -l
ssh-add ~/.ssh/id_ed25519
ssh -i ~/.ssh/id_ed25519 -o IdentitiesOnly=yes [email protected]
ssh-keygen -lf ~/.ssh/id_ed25519.pub
# on the server:
ssh-keygen -lf ~/.ssh/authorized_keysIdentitiesOnly=yes impede que o agente ofereça um monte de chaves antes da correta. O sshd termina a ligação quando atinge o seu limite MaxAuthTries. Se a impressão digital SHA256 da sua chave pública não aparecer na lista de authorized_keys, copiou uma chave diferente.
No termi1, pode gerar chaves no próprio telemóvel, e estas ficam guardadas no armazenamento seguro do sistema. A chave privada nunca sai do dispositivo, por isso o que cola no servidor é sempre a metade pública. Num Mac, o termi1 Companion instala essa chave pública quando faz o emparelhamento com um código de seis dígitos.
Passo 4: corrigir as permissões de ~/.ssh e authorized_keys no servidor
O OpenSSH espera ~/.ssh com o modo 700, e authorized_keys e as chaves privadas com 600. Com StrictModes ativo, que é a predefinição, o sshd ignora o authorized_keys se o ficheiro, o ~/.ssh ou o diretório pessoal puderem ser escritos por outros utilizadores.
chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys
chown -R ana:ana ~/.ssh
chmod go-w ~
ls -ld ~ ~/.ssh ~/.ssh/authorized_keysA mesma regra aplica-se no cliente. Se uma chave privada puder ser lida por outros, o ssh mostra UNPROTECTED PRIVATE KEY FILE e recusa-se a usá-la. Peça à IA do termi1 para “corrigir as permissões do meu .ssh” e o comando é escrito na linha de comandos sem premir Enter. Nas ligações marcadas como produção, o Production Guard retém qualquer alteração antes de chegar à linha de comandos.
Passo 5: ler /var/log/auth.log para ver porque é que o sshd recusa a chave
No Debian e no Ubuntu, o sshd regista as tentativas de autenticação em /var/log/auth.log. Em sistemas só com journald, a mesma informação está disponível através do journalctl:
sudo tail -f /var/log/auth.log
sudo journalctl -u ssh -f # Debian/Ubuntu
sudo journalctl -u sshd -f # RHEL, Fedora, Arch
sudo sshd -T | grep -iE 'pubkey|authorizedkeys|strictmodes'- Invalid user: a conta não existe no servidor (passo 2).
- Authentication refused: bad ownership or modes: permissões ou dono incorretos (passo 4).
- Connection closed by authenticating user … [preauth]: foi oferecida uma chave, mas não correspondia a nada em authorized_keys.
- Mensagens que mencionam ssh-rsa e PubkeyAcceptedAlgorithms: o algoritmo de assinatura foi recusado (passo 6).
Se o registo não disser nada útil, defina LogLevel VERBOSE no sshd_config para registar a impressão digital de cada chave tentada. Consulte as opções documentadas do servidor no sshd_config. No teclado do termi1, Ctrl+C interrompe o tail -f, e o tmux mantém a sessão ativa se a sua rede mudar.
Passo 6: excluir a hipótese de o OpenSSH recusar a assinatura ssh-rsa da chave
Desde o OpenSSH 8.8 (setembro de 2021), a assinatura ssh-rsa baseada em SHA-1 está desativada por predefinição. Uma chave RSA pode falhar mesmo que tenha sido copiada corretamente, se um dos lados só negociar essa assinatura. A solução mais limpa é o Ed25519, suportado pelo OpenSSH desde a versão 6.5 (janeiro de 2014):
ssh-keygen -t ed25519 -C "ana@phone"
ssh-copy-id -i ~/.ssh/id_ed25519.pub [email protected]O ssh-copy-id precisa de outra forma de acesso que funcione. Sem ela, acrescente a linha da chave pública ao authorized_keys a partir da consola do seu fornecedor. As flags do cliente estão listadas no manual oficial do cliente ssh.
Diagnosticar Permission denied (publickey) no telemóvel versus no computador
| Verificação | Computador com OpenSSH | Telemóvel (iOS/Android) |
|---|---|---|
| Detalhe da negociação | ssh -vvv num terminal local | Depende do cliente; o registo do servidor é a referência |
| Utilizador remoto | ssh -G mostra o valor efetivo | Campo de utilizador da ligação guardada |
| Chave oferecida | ssh-add -l e ssh -i | Chave atribuída à ligação; no termi1, guardada no armazenamento seguro |
| Permissões no servidor | chmod a partir da sessão | chmod a partir da sessão, com Ctrl e Tab no teclado do termi1 |
| Inspecionar authorized_keys | cat ou um editor remoto | cat ou o SFTP integrado do termi1 |
Se gere servidores a partir do bolso, o terminal SSH para iOS e Android funciona sem conta.
Perguntas frequentes
Porque é que o SSH diz Permission denied (publickey) quando a minha chave está em authorized_keys?
O SSH indica Permission denied (publickey) mesmo com a chave em authorized_keys quando o sshd ignora esse ficheiro ou este pertence a outro utilizador. As causas típicas são permissões abertas com StrictModes ativo, o dono errado, iniciar sessão com outra conta ou uma assinatura ssh-rsa recusada.
Que permissões precisa a pasta .ssh?
A pasta .ssh precisa do modo 700, para que só o seu dono a possa ler, escrever e abrir. O ficheiro authorized_keys e as chaves privadas precisam do modo 600. O diretório pessoal não pode ter permissão de escrita para o grupo nem para outros utilizadores; caso contrário, o sshd recusa a chave.
Onde está o registo do SSH no Ubuntu?
O registo do SSH no Ubuntu é /var/log/auth.log, e pode acompanhá-lo em tempo real com sudo tail -f /var/log/auth.log. Os mesmos eventos estão disponíveis no journald através de sudo journalctl -u ssh -f. Definir LogLevel VERBOSE no sshd_config regista a impressão digital de cada chave tentada.
O Mosh consegue contornar Permission denied (publickey)?
O Mosh não consegue contornar Permission denied (publickey), porque inicia o mosh-server através de uma ligação SSH inicial. Se a autenticação por chave falhar aí, o Mosh nunca abre a sua sessão UDP. Corrija primeiro o acesso SSH; depois disso, o Mosh mantém a sessão ativa quando muda de rede.