SSD Nodes Learn Hosting plans →
Guias Matt ConnorPor Matt Connor

Como corrigir SSH Permission denied (publickey)

Veja o erro exato Permission denied (publickey), interprete a saída de ssh -v e identifique uma das cinco causas sem bloquear seu próprio acesso ao servidor.

O que Permission denied (publickey) realmente significa

Permission denied (publickey) significa que o cliente enviou uma ou mais chaves públicas e o servidor não aceitou nenhuma. A rede está a funcionar e o sshd está em execução: a recusa ocorre na última etapa da autenticação. Se a sessão terminar antes desse ponto, está perante connection refused ou connection timed out, que é um diagnóstico diferente, com testes diferentes. A correção nunca deve ser baseada em suposições, porque ssh -v indica qual das cinco causas está presente.

As palavras entre parênteses são os métodos que o servidor aceitava. Permission denied (publickey), por si só, significa que o início de sessão por palavra-passe está desativado nesse servidor, portanto não há uma palavra-passe alternativa. Permission denied (publickey,password) significa que as palavras-passe estavam disponíveis e que também falhou essa autenticação.

Uma única mensagem abrange cinco falhas diferentes e é vaga de propósito. Um servidor que respondesse "utilizador inexistente" ou "essa chave não está instalada" ajudaria qualquer pessoa a identificar contas válidas. Por isso, não comece a trocar chaves nem a editar ficheiros de configuração. Execute um comando, leia três linhas da saída e reduza as cinco causas possíveis a uma.

Execute ssh -v primeiro e leia três linhas

Repita o comando que falhou, acrescentando -v:

ssh -v deploy@203.0.113.10

Uma execução reduzida, mas realista, é semelhante a esta:

OpenSSH_9.6p1 Ubuntu-3ubuntu13, OpenSSL 3.0.13 30 Jan 2024
debug1: Connecting to 203.0.113.10 [203.0.113.10] port 22.
debug1: Connection established.
debug1: Authenticating to 203.0.113.10:22 as 'deploy'
debug1: Authentications that can continue: publickey
debug1: Next authentication method: publickey
debug1: Will attempt key: /home/you/.ssh/id_ed25519 ED25519 SHA256:0eL/8sBw... agent
debug1: Offering public key: /home/you/.ssh/id_ed25519 ED25519 SHA256:0eL/8sBw... agent
debug1: Authentications that can continue: publickey
debug1: No more authentication methods to try.
deploy@203.0.113.10: Permission denied (publickey).

Três linhas contêm tudo de que precisa.

Authenticating to 203.0.113.10:22 as 'deploy' é o nome de utilizador que será realmente usado. Não é o nome que pretendia usar, mas aquele que o ssh determinou a partir da linha de comandos, de ~/.ssh/config ou do seu nome de início de sessão local.

Authentications that can continue: publickey é a lista de métodos aceites pelo servidor, enviada antes de qualquer chave ser testada. Se publickey não aparecer nessa primeira lista, o servidor tem o início de sessão com chave pública desativado e nenhuma chave poderá funcionar.

Offering public key: ... é apresentado para cada chave cuja parte pública o ssh já tem, imediatamente antes de oferecer essa chave, seguido do tipo de chave e da respetiva impressão digital SHA256. Uma chave lida a partir de um ficheiro identifica esse ficheiro. Uma chave que exista apenas em ssh-agent apresenta o comentário que o agente guardou para ela, em vez de um caminho, e a palavra agent no fim da linha identifica qualquer chave fornecida pelo agente. O ssh apresenta esta linha imediatamente antes de verificar se as duas extremidades partilham um algoritmo de assinatura para a chave. Por isso, se a linha seguinte for send_pubkey_test: no mutual signature algorithm, essa chave afinal não foi enviada (a causa 5 abrange esse caso). Uma chave cuja parte pública o ssh não conseguiu ler antecipadamente nunca tem uma linha Offering: o ssh regista Trying private key: ... apenas com o nome do ficheiro, carrega a chave privada e envia imediatamente um pedido assinado. Uma chave sem nenhuma das duas linhas nunca foi enviada para o servidor.

Agora divida o problema em dois:

  • Não existe nenhuma linha Offering public key ou Trying private key para a chave que espera. A falha está na sua máquina, porque o servidor nunca recebeu a sua chave.
  • A chave é oferecida e Authentications that can continue: publickey aparece novamente. O servidor recebeu essa chave e recusou-a, por isso a falha está no servidor.

As causas abaixo estão ordenadas pela frequência com que acabam por ser a resposta.

Causa 1: está a ligar-se com o nome de utilizador errado

A causa mais comum também é a menos interessante. O sshd, o daemon de servidor SSH (secure shell), nunca informa que uma conta não existe. Executa toda a negociação com um nome de utilizador inventado e recusa a ligação no fim com a mesma mensagem, porque divulgar nomes de contas válidos ajuda um atacante. Um erro de digitação no nome de utilizador parece exatamente uma chave avariada.

Verifique a linha Authenticating to ... as antes de qualquer outra coisa. Se indicar o seu login no portátil em vez da conta no servidor, não incluiu o nome de utilizador no comando.

ssh -v deploy@203.0.113.10
ssh -v root@203.0.113.10

A conta predefinida depende da imagem criada pelo fornecedor. Em agosto de 2026, as imagens cloud do Ubuntu normalmente incluem uma conta ubuntu, as imagens Debian incluem debian ou admin, Rocky Linux e AlmaLinux incluem rocky e almalinux, e muitos fornecedores de VPS instalam a sua chave diretamente em root. O painel de controlo do fornecedor regista qual foi a conta criada. Nenhum comando executado fora do servidor pode consultar essa informação.

Um bloco Host em ~/.ssh/config também define o nome de utilizador e tem precedência sobre o seu nome de login local:

Host vps-prod
  HostName 203.0.113.10
  User deploy

Se criou a conta e depois não conseguiu iniciar sessão com ela, é provável que a chave tenha sido instalada para o utilizador predefinido da imagem e nunca tenha sido copiada para essa conta. Esse passo faz parte dos primeiros dez minutos num VPS novo e é fácil ignorá-lo.

Causa 2: a chave que pensa estar a enviar não é a que está a ser enviada

Por predefinição, o ssh oferece apenas as chaves mantidas por ssh-agent e um conjunto fixo de nomes de ficheiros em ~/.ssh: id_rsa, id_ecdsa, id_ed25519, as variantes para chaves de hardware id_ecdsa_sk e id_ed25519_sk e a chave híbrida pós-quântica id_mldsa44_ed25519. O OpenSSH atual já não tem suporte para DSA (o OpenSSH 10.0 removeu-o em abril de 2025), por isso um ficheiro id_dsa antigo nunca é testado. Uma chave guardada como ~/.ssh/vps-prod fica invisível para o ssh até ser indicada explicitamente. Por isso, a saída detalhada não mostra nenhuma linha Offering public key correspondente.

Indique o ficheiro e impeça que as chaves do agente sejam usadas no lugar dele:

ssh -i ~/.ssh/vps-prod -o IdentitiesOnly=yes deploy@203.0.113.10

-i, por si só, não é suficiente quando o agente tem chaves, porque o ssh continua a oferecer primeiro as chaves do agente e só depois o ficheiro indicado. Isto é importante porque um servidor que execute uma versão do OpenSSH anterior à 10.6 conta cada chave recusada para o limite MaxAuthTries, que por predefinição é 6. Um agente com sete chaves pode atingir o limite antes de a chave correta ser testada. O OpenSSH 10.6, lançado em 6 de outubro de 2026, adiciona a palavra-chave max-pk-ok à opção existente do sshd PubkeyAuthOptions, escrita como PubkeyAuthOptions max-pk-ok:6. Isto permite que o servidor verifique até esse número de chaves oferecidas, 6 por predefinição, antes de as seguintes começarem a contar para MaxAuthTries. Isto aumenta o limite, mas não o elimina. Quando o limite é atingido, a mensagem muda para:

Received disconnect from 203.0.113.10 port 22:2: Too many authentication failures

Se essa for a mensagem apresentada, o servidor encerrou a sessão antes de a sua chave correta ser testada. Este é o tema de demasiadas falhas de autenticação. IdentitiesOnly=yes limita a tentativa ao ficheiro indicado. Liste as chaves mantidas pelo agente com ssh-add -l e remova-as com ssh-add -D se este tiver acumulado chaves antigas ao longo dos anos. Depois, registe as definições para que o próximo início de sessão não dependa da memorização de flags:

Host vps-prod
  HostName 203.0.113.10
  User deploy
  IdentityFile ~/.ssh/vps-prod
  IdentitiesOnly yes

Existe ainda uma armadilha do lado do cliente. O ssh recusa utilizar uma chave privada que possa ser lida por outras contas no próprio computador. Apresenta um aviso e recusa carregar a chave, pelo que esta nunca pode ser usada para iniciar sessão. No entanto, não espere que a linha Offering esteja ausente: quando o ssh já tem a parte pública, por exemplo a partir do ficheiro .pub junto da chave, oferece essa parte, e o servidor pode responder Server accepts key. Só depois o ssh carrega a chave privada para assinar, apresenta este aviso e desiste dessa chave:

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@         WARNING: UNPROTECTED PRIVATE KEY FILE!          @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
Permissions 0644 for '/home/you/.ssh/vps-prod' are too open.

chmod 600 ~/.ssh/vps-prod corrige o problema. Transferir uma chave através de uma pen USB ou de uma partilha do Windows é a forma habitual de perder o modo. A localização das chaves e os nomes a atribuir-lhes são abordados em Noções básicas sobre a gestão de chaves SSH.

Causa 3: a chave pública nunca chegou a authorized_keys

Se ssh -v mostrar que a chave foi enviada e o servidor continuar a recusá-la, a próxima questão é saber se essa chave está no ficheiro authorized_keys da conta. Abra a consola do seu fornecedor para verificar, porque não consegue iniciar sessão por SSH para consultar o ficheiro.

sudo ls -l /home/deploy/.ssh/
sudo ssh-keygen -lf /home/deploy/.ssh/authorized_keys

ssh-keygen -lf num ficheiro authorized_keys mostra uma impressão digital por entrada:

256 SHA256:0eL/8sBw... you@laptop (ED25519)
3072 SHA256:9Tq2yZk... old-laptop (RSA)

Compare-as com a impressão digital da sua linha Offering public key. Se a sua chave tiver sido enviada numa linha Trying private key, essa linha indica apenas o ficheiro. Nesse caso, obtenha a impressão digital com ssh-keygen -lf no ficheiro .pub correspondente. Se não estiver na lista, a chave não está instalada nessa conta, independentemente do que se recorda de ter feito.

Quatro formas comuns de isto falhar:

  • Colou a chave privada em vez do ficheiro .pub. Uma linha de chave pública contém um tipo de chave, como ssh-ed25519, ecdsa-sha2-nistp256 ou ssh-rsa, seguido de uma longa cadeia base64 e de um comentário opcional. Opções como restrict podem aparecer antes do tipo de chave. Uma chave privada começa por -----BEGIN OPENSSH PRIVATE KEY-----.
  • A colagem foi dividida em várias linhas. Cada entrada deve ocupar exatamente uma linha. Uma chave dividida é lida como várias entradas incompletas e não corresponde a nada.
  • A chave foi colocada em /root/.ssh/authorized_keys, mas inicia sessão como deploy, ou o contrário. O ficheiro é específico de cada conta. Não existe um ficheiro partilhado.
  • A caixa "add my key" do fornecedor escreveu a chave apenas para o utilizador predefinido da imagem. Por isso, a conta criada posteriormente tem um diretório .ssh vazio.

A forma segura de adicionar uma chave a partir da consola, como root, é:

sudo install -d -m 700 -o deploy -g deploy /home/deploy/.ssh
sudo tee -a /home/deploy/.ssh/authorized_keys >/dev/null <<'EOF'
ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIExampleKeyDataHere you@laptop
EOF
sudo chown deploy:deploy /home/deploy/.ssh/authorized_keys
sudo chmod 600 /home/deploy/.ssh/authorized_keys

Execute sudo ssh-keygen -lf /home/deploy/.ssh/authorized_keys novamente depois disso. A nova impressão digital deverá aparecer na lista. A partir de uma máquina que ainda consiga iniciar sessão com uma palavra-passe, ssh-copy-id -i ~/.ssh/vps-prod.pub deploy@203.0.113.10 adiciona a chave por si e cria .ssh e authorized_keys com permissões privadas, caso ainda não existam. O comando não altera as permissões de um diretório .ssh ou de um ficheiro authorized_keys que já exista. Verifique-as conforme descrito na causa 4.

Causa 4: por que o sshd ignora authorized_keys quando as permissões são demasiado abertas

StrictModes yes é a predefinição do sshd. Com essa configuração, o sshd recusa ler authorized_keys se esse ficheiro, o diretório .ssh ou o diretório home da conta puderem ser escritos por alguém que não seja o proprietário, ou pertencerem à conta errada. O motivo é direto: se o grupo ou todos os utilizadores puderem escrever no seu diretório home, qualquer conta com esse acesso poderá substituir authorized_keys e assumir o controlo do login. O sshd trata um caminho não fiável como se não existisse nenhuma chave.

O cliente apresenta a mensagem simples Permission denied. O log do servidor regista o motivo real:

Authentication refused: bad ownership or modes for directory /home/deploy/.ssh

ou, quando o problema está no próprio ficheiro:

Authentication refused: bad ownership or modes for file /home/deploy/.ssh/authorized_keys

O que o sshd aceita:

  • O diretório home: não pode permitir escrita pelo grupo nem por todos os utilizadores. 755, 750 e 700 são aceites. 775 e 777 falham.
  • ~/.ssh: aplica-se a mesma regra. O manual do sshd recomenda acesso apenas para o proprietário, correspondente ao modo 700.
  • ~/.ssh/authorized_keys: aplica-se a mesma regra, e tem de ser um ficheiro normal. Se não for, o log indica que o caminho is not a regular file. O manual recomenda leitura e escrita apenas para o proprietário, correspondente ao modo 600.
  • Proprietário: cada elemento deve pertencer à conta usada no login ou a root. Qualquer outro proprietário faz a verificação falhar.

A propriedade é tão importante como o modo. O sshd lê authorized_keys como a conta usada no login. Por isso, um ficheiro criado com sudo nano e que não seja devolvido à conta fica pertencente a root com o modo 600. Passa a verificação de propriedade, mas o sshd não consegue abri-lo, e o log indica que não conseguiu abrir o ficheiro. Corrija ambos de uma vez:

sudo chown -R deploy:deploy /home/deploy/.ssh
sudo chmod 700 /home/deploy/.ssh
sudo chmod 600 /home/deploy/.ssh/authorized_keys
sudo chmod go-w /home/deploy
ls -ld /home/deploy /home/deploy/.ssh

O último comando mostra o resultado. O diretório home deve ter drwxr-xr-x ou permissões mais restritivas, e drwx------ em .ssh. Se estas sequências ainda não forem claras, leia como interpretar uma sequência de permissões como drwxr-xr-x antes de alterar os modos num servidor em produção.

No Rocky Linux e no AlmaLinux, inclua o SELinux (security-enhanced Linux) na lista de possíveis causas. Um diretório .ssh criado por um método pouco habitual pode ter o rótulo de ficheiro errado. Nesse caso, o sshd tem o acesso de leitura recusado mesmo que os modos estejam corretos. sudo restorecon -Rv /home/deploy/.ssh repõe os rótulos, e sudo ausearch -m avc -ts recent mostra se o SELinux foi o componente que recusou o acesso.

Causa 5: o sshd está configurado para recusar a sua ligação

Consultar /etc/ssh/sshd_config não é suficiente num sistema Ubuntu ou Debian atual. Esse ficheiro começa com Include /etc/ssh/sshd_config.d/*.conf, e o OpenSSH mantém o primeiro valor encontrado para cada definição. Por isso, um ficheiro drop-in como 50-cloud-init.conf é lido antes do restante ficheiro principal e prevalece sobre qualquer definição global que edite mais abaixo. A exceção é um bloco Match: o manual de sshd_config diz que as definições dentro desse bloco substituem as definidas na secção global. Assim, um bloco Match correspondente, mesmo no fim do ficheiro principal, prevalece sobre um drop-in para as ligações às quais corresponde. Os drop-ins são lidos por ordem lexicográfica. Portanto, um ficheiro chamado 00-something.conf é lido antes de 50-cloud-init.conf, e a primeira definição de um valor prevalece. É por isso que uma edição pode parecer correta e não alterar absolutamente nada.

Peça ao sshd a configuração efetiva que constrói a partir de todos esses ficheiros:

sudo sshd -T | grep -Ei 'pubkeyauth|authorizedkeysfile|permitrootlogin|allowusers|allowgroups|denyusers'

sshd -T inicia um processo de teste independente que lê os ficheiros tal como estão agora no disco. Não consulta o sshd que já está em execução. Por isso, uma edição que ainda não aplicou com um reinício aparece aqui antes de o servidor em execução a utilizar.

Uma resposta correta tem este aspeto:

permitrootlogin prohibit-password
pubkeyauthentication yes
authorizedkeysfile .ssh/authorized_keys .ssh/authorized_keys2

Procure o seguinte no seu próprio resultado:

  • pubkeyauthentication no. Nenhuma chave será aceite. Isto também aparece em ssh -v como uma primeira lista Authentications that can continue: sem publickey.
  • authorizedkeysfile a apontar para outro local, por exemplo /etc/ssh/authorized_keys/%u. Nesse caso, o ficheiro no diretório pessoal é completamente ignorado, e as regras de permissões da causa 4 aplicam-se ao novo caminho.
  • allowusers ou allowgroups presentes. Qualquer conta que não esteja listada é recusada exatamente com este erro e sem explicação. denyusers e denygroups fazem o mesmo no sentido inverso.
  • permitrootlogin no enquanto tenta iniciar sessão como root. prohibit-password é a definição intermédia útil: root pode utilizar uma chave, mas não uma palavra-passe.

Os blocos Match não aparecem num sshd -T simples, porque o resultado depende de quem está a estabelecer a ligação. Consulte uma ligação específica:

sudo sshd -T -C user=deploy,host=vps.example.com,addr=198.51.100.7

Outra definição afeta as chaves antigas. O OpenSSH 8.8 deixou de aceitar assinaturas SHA-1 (ssh-rsa) por predefinição. Por isso, uma chave RSA que funcionou durante anos pode deixar de funcionar depois de uma atualização num dos lados, quando o outro lado é demasiado antigo para utilizar RSA com SHA-256. Um cliente atual a comunicar com um servidor antigo desse tipo indica claramente o problema:

debug1: send_pubkey_test: no mutual signature algorithm

Normalmente, a chave está correta. As notas de lançamento do OpenSSH 8.8 indicam que não é necessário substituir chaves ssh-rsa, porque estas passam a utilizar RSA/SHA-256 ou RSA/SHA-512 quando ambos os lados o suportam. Por isso, atualizar o lado antigo é uma correção duradoura. Se não puder atualizá-lo, uma chave nova também funciona desde que o lado antigo execute OpenSSH 6.5 ou posterior, a versão que adicionou Ed25519 (RSA com SHA-256 só foi adicionado na versão 7.2): ssh-keygen -t ed25519 -C "deploy@vps-prod". Depois, instale o ficheiro .pub conforme mostrado acima. Um lado anterior à versão 6.5 não suporta Ed25519 nem RSA com SHA-256. Nesse caso, uma chave Ed25519 nova não resolve o problema. Definir PubkeyAcceptedAlgorithms +ssh-rsa no lado atualizado, num bloco Host do ~/.ssh/config do cliente ou na configuração sshd do servidor, volta a ativar as assinaturas antigas e permite aceder ao sistema hoje. Considere esta definição uma forma de aceder ao servidor, não a solução final. As restantes definições do lado do servidor que vale a pena rever estão em reforçar a segurança do servidor SSH num VPS.

Como provar que uma chave privada corresponde à chave pública instalada

Grande parte da incerteza neste erro resulta de não saber se dois ficheiros formam um par. Um comando responde a essa questão:

ssh-keygen -y -f ~/.ssh/vps-prod

Isto imprime a chave pública derivada da chave privada. Nunca lê o ficheiro .pub que está ao lado dela. Assim, mostra o que a chave privada realmente é, e não o que um ficheiro .pub desatualizado afirma. Se a chave tiver uma frase-passe, o comando pede-a. Isso também confirma que ainda conhece a frase-passe.

ssh-keygen -lf ~/.ssh/vps-prod.pub
ssh-add -l

O primeiro comando imprime a impressão digital de um ficheiro de chave pública. O segundo imprime as impressões digitais que o seu agente tem em memória. Compare quatro representações da mesma cadeia: a impressão digital na linha Offering public key de ssh -v, a impressão digital do seu ficheiro .pub, as impressões digitais em ssh-keygen -lf no authorized_keys do servidor e a impressão digital no log do servidor. O ponto em que deixam de coincidir identifica o problema.

Leia o log do servidor enquanto o início de sessão falha

O cliente não recebe deliberadamente nenhuma informação útil. O servidor regista o motivo real. Inicie um processo que acompanhe o log na sessão de consola e execute depois o comando ssh que falha a partir do seu portátil.

sudo journalctl -u ssh -f

A imagem cloud padrão do servidor Ubuntu 24.04 instala o rsyslog por predefinição (o manifesto do pacote indica-o em 3 November 2026), por isso os mesmos registos também são escritos em /var/log/auth.log. As imagens cloud minimal do Ubuntu 24.04 são fornecidas sem rsyslog. Nelas, auth.log não existe por predefinição e o journal é o local onde deve procurar. No Rocky Linux e no AlmaLinux, a unidade chama-se sshd e os mesmos registos também são escritos em /var/log/secure.

Defina LogLevel VERBOSE na configuração do sshd e recarregue o serviço. Cada tentativa passa então a registar a impressão digital que o servidor recebeu efetivamente:

Failed publickey for deploy from 198.51.100.7 port 49812 ssh2: ED25519 SHA256:0eL/8sBw...

Essa linha indica de que lado está o problema. Uma impressão digital que reconhece significa que a sua chave chegou ao servidor e foi rejeitada por este. Nesse caso, analise as causas 3, 4 e 5. Uma impressão digital que não reconhece significa que o cliente enviou uma chave diferente da pretendida. Nesse caso, volte à causa 2.

Quando o log continuar pouco claro, execute um segundo sshd noutra porta, em modo de depuração. O processo permanece em primeiro plano, atende uma ligação, mostra o raciocínio e termina:

sudo /usr/sbin/sshd -ddd -p 2222

Na sessão de consola do mesmo servidor, ligue-se a ele através do endereço de loopback:

ssh -p 2222 -i ~/.ssh/vps-prod -o IdentitiesOnly=yes deploy@127.0.0.1

Usar 127.0.0.1 mantém fora do teste a rede entre si e o servidor. O tráfego de loopback continua a passar pelo filtro de pacotes do kernel, mas no Ubuntu as regras predefinidas do ufw aceitam tudo na interface lo. Por isso, a porta 2222 não precisa da sua própria regra de firewall, a menos que alguém tenha removido essa predefinição. A saída de depuração indica o ficheiro que foi aberto, a impressão digital que foi comparada e o motivo exato da recusa, incluindo linhas como Authentication refused: bad ownership or modes for directory /home/deploy. Prima Ctrl+C quando obtiver a resposta. O sshd real, na porta 22, não é alterado durante o processo.

Como evitar ficar sem acesso ao servidor

Cada passo que altera a configuração do servidor precisa de uma forma de acesso que não dependa de SSH. Configure isso enquanto o SSH ainda funciona, não depois de falhar.

  1. Abra a consola do seu fornecedor, por serial ou VNC (virtual network computing), e confirme que consegue iniciar sessão por esse meio.
  2. Confirme que conhece uma palavra-passe local funcional para uma conta com sudo. Se não tiver uma, reponha primeiro a palavra-passe de root a partir da consola do fornecedor.
  3. Mantenha a sessão SSH atual aberta. Uma sessão aberta sobrevive a systemctl restart ssh, por isso continua a ser uma forma de voltar a entrar se a nova configuração estiver errada.
  4. Verifique a sintaxe antes de reiniciar: sudo sshd -t não imprime nada quando o ficheiro é válido e imprime o ficheiro e o número da linha quando não é.
  5. Abra um segundo terminal e inicie uma nova sessão antes de fechar a primeira. Uma configuração inválida impede novos inícios de sessão, mas mantém as sessões existentes. Por isso, a sessão que está a utilizar não permite confirmar se a alteração funcionou.

Reinicie com sudo systemctl restart ssh no Debian e no Ubuntu, ou com sudo systemctl restart sshd no Rocky Linux e no AlmaLinux. No Ubuntu 24.04, o sshd é iniciado a partir de uma unidade de socket cuja porta e endereço vêm de sshd_config através de um gerador do systemd. Por isso, uma alteração a Port ou ListenAddress também requer sudo systemctl daemon-reload e, depois, sudo systemctl restart ssh.socket para entrar em vigor.

FAQ

Por que recebo Permission denied (publickey) quando a mesma chave funciona noutro servidor?

Porque a chave está correta e o problema está noutro ponto. Execute ssh -v e procure a linha Offering public key ou Trying private key correspondente à sua chave. Se a chave não aparecer em nenhuma das duas, o ssh nunca a enviou: o ficheiro não está em ~/.ssh com um nome predefinido e a chave não foi carregada no agent, por isso adicione -i /path/to/key -o IdentitiesOnly=yes. Se a chave aparecer e o servidor continuar a recusá-la, essa chave não está no authorized_keys da conta, o caminho até ao ficheiro permite escrita pelo grupo ou a configuração do sshd bloqueia o utilizador. O log do servidor distingue estes casos.

Como vejo qual chave o SSH está realmente a enviar?

ssh -v host imprime uma linha debug1: Offering public key: para cada chave cuja parte pública já conhece, com o tipo de chave e uma impressão digital SHA256. Uma chave lida a partir de um ficheiro identifica esse ficheiro, enquanto uma chave mantida apenas no agent mostra o comentário do agent; agent no fim da linha identifica as chaves fornecidas pelo agent. Se a linha seguinte for send_pubkey_test: no mutual signature algorithm, essa chave afinal não foi enviada. Uma chave cuja parte pública o ssh não conseguiu ler antecipadamente não recebe nenhuma linha Offering: o ssh imprime Trying private key: com o nome do ficheiro, carrega a chave privada e envia diretamente um pedido assinado. ssh-add -l lista as impressões digitais mantidas pelo agent. ssh-keygen -lf ~/.ssh/id_ed25519.pub imprime a impressão digital de um único ficheiro de chave, e ssh-keygen -y -f ~/.ssh/id_ed25519 imprime a chave pública que deriva realmente de uma chave privada. Para o login ser bem-sucedido, a impressão digital da chave enviada também tem de aparecer no resultado de ssh-keygen -lf executado contra o authorized_keys do servidor.

Por que o sshd ignora o meu ficheiro authorized_keys?

Porque StrictModes está ativo por predefinição e o ficheiro, o diretório .ssh ou o diretório home pode permitir escrita pelo grupo ou por outros utilizadores, ou ser propriedade de uma conta diferente da sua ou de root. O sshd não confia num caminho que outra pessoa possa alterar, por isso comporta-se como se não existisse nenhuma chave. A verificação exige que nenhum dos três permita escrita pelo grupo ou por outros utilizadores, que cada um pertença à conta de login ou a root e que authorized_keys seja um ficheiro regular. Por isso, remover apenas as permissões de escrita nem sempre é suficiente. 755 ou mais restrito no diretório home, 700 em .ssh e 600 em authorized_keys, todos pertencentes à conta de login, é a configuração segura a utilizar. Com LogLevel VERBOSE, o servidor regista Authentication refused: bad ownership or modes for directory /home/deploy/.ssh.

A minha chave deixou de funcionar logo depois de uma atualização do servidor. O que mudou?

Se for uma chave RSA, a causa mais provável é a alteração relacionada com SHA-1. O OpenSSH 8.8 desativou por predefinição as assinaturas SHA-1 ssh-rsa, por isso uma chave RSA é recusada quando o outro lado só consegue utilizá-la dessa forma. Um cliente atual mostra debug1: send_pubkey_test: no mutual signature algorithm. Não é necessário substituir a chave se puder atualizar o lado antigo, porque as chaves RSA utilizam SHA-256 ou SHA-512 quando ambos os lados suportam esses algoritmos. Se não puder atualizar e o lado antigo executar OpenSSH 6.5 ou posterior, gere uma chave moderna com ssh-keygen -t ed25519 e instale o respetivo ficheiro .pub. Um lado anterior à versão 6.5 não suporta Ed25519 nem RSA com SHA-256, por isso uma chave nova não resolve esse caso. Se precisar de acesso imediatamente, PubkeyAcceptedAlgorithms +ssh-rsa no lado atualizado reativa as assinaturas antigas. Remova essa linha assim que a correção definitiva estiver aplicada.

Editei o sshd_config e agora não consigo iniciar sessão. Como recupero o acesso?

Utilize a consola do seu fornecedor, que não passa pelo SSH. Inicie sessão nessa consola com uma palavra-passe local, execute sudo sshd -t para ver o erro de sintaxe e o respetivo número de linha, desfaça a alteração e reinicie o serviço. Em seguida, execute sudo sshd -T para ver os valores efetivos produzidos pelos ficheiros, porque um ficheiro em /etc/ssh/sshd_config.d/ pode estar a substituir a configuração principal. O comando lê novamente os ficheiros, em vez de consultar o sshd em execução. Por isso, reinicie o serviço depois de qualquer alteração adicional antes de testar o login. Se não tiver uma palavra-passe local, redefina primeiro a palavra-passe de root através da consola e depois corrija o ficheiro.

Este artigo foi útil?