# 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.

> `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.

João Rizzon · 2026-11-05 · Servidores

---

## 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.

```bash
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:

```bash
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:

```bash
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

- Mantenha a sessão SSH atual aberta do começo ao fim. Ela não cai com reload nem com alteração de arquivo.
- Confirme acesso ao console KVM, serial ou VNC do provedor. Teste o login agora, não depois.
- Tire snapshot ou, no mínimo, `cp -a /etc/ssh/sshd_config /root/sshd_config.bak`.

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

```bash
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:

```bash
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

```bash
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

```bash
ssh -v -o PreferredAuthentications=password \
       -o PubkeyAuthentication=no \
       deploy@203.0.113.10
```

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](https://docs.cpanel.net/whm/security-center/ssh-password-authorization-tweak/) 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.

