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_keys

IdentitiesOnly=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_keys

A 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çãoComputador com OpenSSHTelemóvel (iOS/Android)
Detalhe da negociaçãossh -vvv num terminal localDepende do cliente; o registo do servidor é a referência
Utilizador remotossh -G mostra o valor efetivoCampo de utilizador da ligação guardada
Chave oferecidassh-add -l e ssh -iChave atribuída à ligação; no termi1, guardada no armazenamento seguro
Permissões no servidorchmod a partir da sessãochmod a partir da sessão, com Ctrl e Tab no teclado do termi1
Inspecionar authorized_keyscat ou um editor remotocat 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.