blog
Servidores

PasswordAuthentication no e o SSH ainda pede senha: é o PAM

O método keyboard-interactive via PAM e a ordem de leitura do Include explicam o prompt que insiste. O procedimento abaixo corta senha com caminho de volta: console fora de banda, instância em porta alternativa e teste antes do reload.

JR · · 8 min de leitura · 2 tabelas · 10 blocos de código

Resposta curta: `PasswordAuthentication no` só desliga o método `password` do SSH2. O prompt que continua aparecendo costuma vir de `KbdInteractiveAuthentication` via PAM, ou de um drop-in ignorado porque o `Include` está no fim do arquivo e o primeiro valor lido vence.

Neste artigo
  1. O método `password` é só metade do caminho: o que a diretiva desliga
  2. Primeiro valor vence: por que seu drop-in em `sshd_config.d` pode nunca ter valido
  3. `sshd -T` mostra o valor efetivo e quem ganhou a precedência
  4. Quais diretivas o bloco `Match` aceita e quais quebram o `sshd -t`
  5. Desligar a senha sem se trancar para fora do servidor
  6. Edição manual concorre com o painel em servidores cPanel/WHM
  7. Checklist de sintoma, comando e causa provável
  8. O que este texto não mede e onde conferir na sua versão

O método `password` é só metade do caminho: o que a diretiva desliga

A diretiva governa um método de autenticação específico do SSH2: password. Ela não governa o método keyboard-interactive, que no Linux costuma ser servido pelo PAM. São dois caminhos distintos dentro do mesmo protocolo, e o cliente OpenSSH tenta os dois por padrão (a lista padrão de PreferredAuthentications inclui keyboard-interactive).

O resultado prático é o prompt que parece idêntico. Password: com P maiúsculo e vindo do PAM, user@host's password: vindo do método password. Quem olha rápido conclui que a diretiva foi ignorada. Ela não foi: o servidor está autenticando por outro método.

Para fechar senha de verdade em um host com PAM ativo, as três diretivas precisam estar coerentes:

Diretiva Efeito Observação
PasswordAuthentication no Desliga o método password Sozinha não impede PAM
KbdInteractiveAuthentication no Desliga keyboard-interactive Em OpenSSH antigo o nome era ChallengeResponseAuthentication
UsePAM yes + módulos de senha Mantém o caminho PAM vivo Com KbdInteractive no, PAM segue para account/session, não para auth por senha
AuthenticationMethods publickey Exige publickey como única etapa Caminho mais explícito, falha fechado. Vírgula encadeia etapas, espaço lista alternativas

O nome canônico mudou no OpenSSH 8.7 (agosto de 2021): ChallengeResponseAuthentication passou a ser alias obsoleto de KbdInteractiveAuthentication. Na prática, versões 8.7 e posteriores aceitam os dois nomes, e o antigo ainda funciona sem quebrar o parse. Versões bem anteriores também já conheciam KbdInteractiveAuthentication, mas em bases muito antigas o seguro é não adivinhar: rode ssh -V para saber a versão e sshd -T | grep -E "kbdinteractive|challengeresponse" para ver qual chave o daemon devolve na config resolvida. A chave que aparece no sshd -T é a que você deve escrever no arquivo. Depois de editar, sshd -t confirma que a diretiva foi aceita antes de qualquer reload.

Primeiro valor vence: por que seu drop-in em `sshd_config.d` pode nunca ter valido

No OpenSSH, para a maioria das diretivas o primeiro valor lido vence. Não é o último. Isso inverte a intuição de quem vem de Nginx ou de Apache.

O Include /etc/ssh/sshd_config.d/*.conf foi adicionado ao arquivo padrão de várias distros. Em algumas ele está na primeira linha, e aí o drop-in sobrepõe tudo. Em outras, principalmente em arquivos herdados de upgrades, o Include ficou no fim. Nesse caso qualquer valor já definido acima no sshd_config prevalece e o seu drop-in vira enfeite.

O caso clássico é o 50-cloud-init.conf gravado por imagens de nuvem, normalmente com PasswordAuthentication yes. Se o Include está no topo, esse arquivo é lido antes do seu 99-hardening.conf? Depende da ordem lexicográfica do glob: 50- vem antes de 99-, então 50-cloud-init.conf ganha. Numerar o seu arquivo com um prefixo menor (por exemplo 10-hardening.conf) resolve, ou remova a linha do cloud-init.

Não tente adivinhar. Peça ao próprio daemon.

`sshd -T` mostra o valor efetivo e quem ganhou a precedência

sshd -T imprime a configuração já resolvida, com includes expandidos e defaults aplicados. É a única leitura que importa.

sudo sshd -T | grep -E "passwordauthentication|kbdinteractive|pubkeyauthentication|authenticationmethods|usepam"

Saída esperada em um host já endurecido (exemplo):

pubkeyauthentication yes
passwordauthentication no
kbdinteractiveauthentication no
usepam yes
authenticationmethods publickey

As chaves saem em minúsculas e sem camelCase. Se passwordauthentication sai yes mesmo depois da sua edição, o problema é precedência, não sintaxe. Descubra quem ganhou:

grep -rniE "^[[:space:]]*(password|kbdinteractive|challengeresponse)authentication" \
  /etc/ssh/sshd_config /etc/ssh/sshd_config.d/
grep -n "^Include" /etc/ssh/sshd_config

A segunda linha mostra em que número de linha o Include entra. Tudo que estiver acima dele e já definido vence o drop-in.

Ver a config que vale para uma conexão específica com `sshd -T -C`

sshd -T sem argumentos ignora blocos Match. Para ver a config que vale para uma conexão concreta, passe o contexto:

sudo sshd -T -C user=deploy,host=app01.exemplo.com,addr=203.0.113.10 \
  | grep -E "passwordauthentication|authenticationmethods"

Os três campos (user, host, addr) são os critérios que o Match avalia; informe os que o seu bloco usa. É assim que você confirma, antes do reload, que a exceção para o usuário de deploy existe e que ela não vazou para os demais.

Quais diretivas o bloco `Match` aceita e quais quebram o `sshd -t`

O bloco Match aceita um subconjunto das diretivas. PasswordAuthentication, KbdInteractiveAuthentication, AuthenticationMethods, PubkeyAuthentication, AllowTcpForwarding, ForceCommand e ChrootDirectory estão entre as aceitas. DenyUsers, AllowUsers e AllowGroups não estão: colocá-las dentro de um Match faz sshd -t falhar com erro de diretiva não permitida nesse contexto.

Restrição por usuário vai fora do bloco:

# exemplo
AllowGroups ssh-users
PubkeyAuthentication yes
PasswordAuthentication no
KbdInteractiveAuthentication no
AuthenticationMethods publickey

Match User backup Address 198.51.100.0/24
    AuthenticationMethods publickey password

Esse exemplo é ilustrativo. A separação importa: o espaço separa alternativas aceitas (publickey password significa chave ou senha, qualquer uma basta), enquanto a vírgula encadeia etapas obrigatórias na mesma conexão. AuthenticationMethods publickey,password exige chave e depois senha, que é a construção de 2FA, não de exceção. Trocar um pelo outro por engano gera os dois erros opostos: ou você libera senha achando que exigiu duas etapas, ou tranca o usuário atrás de uma etapa que ele não consegue cumprir. Observe que o bloco Match vai no fim do arquivo: tudo depois dele pertence ao bloco até o próximo Match ou o fim do arquivo. Diretiva global escrita abaixo de um Match é um erro silencioso comum.

Desligar a senha sem se trancar para fora do servidor

Garanta o caminho de volta antes de abrir o arquivo

Valide a sintaxe com `sshd -t` antes de qualquer reload

sudo sshd -t && echo OK

sshd -t sai com código diferente de zero e imprime arquivo e linha em caso de erro. Rodar reload sem isso é a forma mais rápida de deixar o daemon sem subir depois de um restart futuro.

Teste em um daemon de resgate na porta 2222 com config separada

Antes de tocar no serviço principal, suba um daemon de teste com config separada:

sudo /usr/sbin/sshd -d -p 2222 -f /etc/ssh/sshd_config.test

O caminho absoluto não é detalhe de estilo: chamado como sshd, o daemon aborta com sshd re-exec requires execution with an absolute path, porque ele re-executa o próprio binário a cada conexão. Confirme o caminho no seu host com command -v sshd (em algumas distros é /usr/sbin/sshd, em outras /usr/bin/sshd).

-d roda em foreground, com log de debug, e atende uma conexão. Conecte de outra janela em -p 2222, confirme que a chave funciona e que a senha é recusada. Só então promova o arquivo. Libere a 2222 no firewall apenas para o seu IP e feche depois.

Aplique com reload, porque restart pode derrubar sessões

sudo systemctl reload sshd

O reload envia SIGHUP: o daemon relê a config e passa a valer para novas conexões. Sessões estabelecidas continuam. restart derruba o processo e, dependendo de como o unit e o socket estão configurados, pode encerrar sessões filhas. Em distros com socket activation (ssh.socket), o nome do unit muda; confira com systemctl list-units '*ssh*'.

Confirme o corte forçando senha de uma segunda janela

ssh -v -o PreferredAuthentications=password \
       -o PubkeyAuthentication=no \
       [email protected]

O resultado correto é falhar:

debug1: Authentications that can continue: publickey
Permission denied (publickey).

Se aparecer prompt de senha, ou se o log do cliente listar keyboard-interactive entre os métodos que podem continuar, o corte não foi feito. Repita com -o PreferredAuthentications=keyboard-interactive para testar o caminho PAM isoladamente.

Edição manual concorre com o painel em servidores cPanel/WHM

Em servidores com WHM, a edição manual do sshd_config concorre com o painel. O WHM expõe o ajuste em Security Center » SSH Password Authorization Tweak, que alterna a autenticação por senha do sshd pela interface e grava no arquivo de configuração do serviço. A documentação do cPanel descreve a função dessa tela.

A ordem segura nesse ambiente: cadastre e teste a chave pública primeiro, confirme login por chave em uma segunda sessão, e só então desative a senha. Depois de usar a tela, valide com sshd -T do mesmo jeito: o painel não substitui a checagem do valor efetivo, principalmente se existir drop-in em /etc/ssh/sshd_config.d/ no host.

Checklist de sintoma, comando e causa provável

Sintoma Comando de verificação Causa provável
sshd -T mostra passwordauthentication yes grep -n ^Include /etc/ssh/sshd_config Include no fim do arquivo ou drop-in com prefixo maior
sshd -T mostra no, mas o prompt aparece ssh -v e olhar Authentications that can continue kbdinteractiveauthentication yes com PAM
Só um usuário ainda entra com senha sshd -T -C user=fulano,addr=... Bloco Match sobrepondo
sshd -t falha depois de editar mensagem com arquivo e linha DenyUsers/AllowUsers dentro de Match
Mudança não surte efeito após salvar systemctl reload sshd e journalctl -u sshd -n 50 Config lida, mas reload não executado ou unit diferente
Daemon não sobe após restart sshd -t, console do provedor Config inválida promovida sem validação

Um detalhe de log: eleve temporariamente para LogLevel VERBOSE enquanto diagnostica. Ele registra o fingerprint da chave aceita em cada autenticação, o que distingue login por chave de login por senha e ainda mostra qual chave entrou, inclusive quando ela chegou por agent forwarding. Volte para INFO depois, VERBOSE é verboso.

Se depois de tudo o host continuar aceitando senha e o sshd -T disser o contrário, suspeite de um segundo daemon escutando na mesma porta de uma interface diferente, ou de um sshd iniciado fora do systemd. ss -lntp | grep ssh mostra quem está bound em quê e com qual PID.

O que este texto não mede e onde conferir na sua versão

Nada aqui vem de medição própria. O comportamento de precedência de Include, a lista de diretivas aceitas em Match e a semântica de sshd -T -C estão no sshd_config(5) e nas notas de versão do OpenSSH da sua distro: man 5 sshd_config e ssh -V são a referência local e autoritativa, e eles divergem entre versões com mais frequência do que se espera. O ajuste do WHM está documentado pelo cPanel no link acima.

Execute o sshd -T do seu host antes de copiar qualquer bloco deste artigo. É literalmente o ponto do texto.

Referências

  1. Documentação oficial (cpanel) — SSH Password Authorization Tweak. Consultado em 2026-09-29.
Leia também