Porquê certificados em vez de chaves

O SSH confia no primeiro uso. Liga-te a uma máquina nova e ele mostra-te uma impressão digital e pergunta se tens a certeza. Ninguém verifica. Toda a gente escreve yes. É o mesmo hábito de clicar num aviso do navegador sem ler, e é exatamente o que uma máquina no meio precisa que faças.

A outra direção não é melhor. Cada servidor guarda um ficheiro authorized_keys por utilizador, e todos eles crescem. As chaves são acrescentadas e nunca removidas. Alguém sai, e a sua chave fica numa máquina de que ninguém se lembra até ao dia em que importa. Reconstróis um servidor e todos os clientes gritam que a chave do anfitrião mudou, portanto as pessoas aprendem a apagar também esse aviso.

Uma autoridade de certificação SSH acaba com as duas coisas. A CA assina a chave de cada anfitrião, e os clientes confiam na CA, não numa lista de impressões digitais. A CA assina a chave de cada utilizador por umas horas, e os servidores confiam na CA, não numa lista de chaves. Nada para aceitar na primeira ligação, nada para limpar quando alguém sai, e um certificado de utilizador que morre sozinho até amanhã.

Esta é uma configuração diferente do lado X.509 do step-ca tratado em A tua própria autoridade de certificação: step-ca num contentor, e é por isso que tem o seu próprio artigo. O mesmo contentor, chaves diferentes, ficheiros diferentes em cada máquina. Tudo aqui foi corrido com o step-ca 0.30.2 e o OpenSSH 10.0 num pod Podman.

Sem CACom step-ca
Um cliente encontra um servidor novoMostra uma impressão digital, escreves yesVerifica o certificado do anfitrião contra a CA, não diz nada
Um servidor é reconstruídoTodos os clientes avisam que a chave mudouAssinas a nova chave, os clientes nunca dão por nada
Um utilizador recebe acessoA sua chave vai para o authorized_keys em cada servidorA CA assina a sua chave, todos os servidores a aceitam
Um utilizador saiEncontrar e apagar a sua chave em cada servidorDeixar de assinar; o certificado morre em 16 horas
O que cada servidor guardaUm authorized_keys por utilizadorUma chave pública da CA
Quem assina o quê, e quem confia em quêstep-cachave CA de anfitriõeschave CA de utilizadoresClientecert. de utilizador, 16 hconfia na CA de anfitriõesServidorcert. de anfitrião, 30 diasconfia na CA de utilizadoresassina a chave de utilizadorassina a chave de anfitriãossh, sem perguntascada um verificao cert. do outro
A CA assina os dois lados. O cliente só tem de confiar na chave da CA de anfitriões, e o servidor só tem de confiar na chave da CA de utilizadores. Nenhum guarda uma lista das chaves do outro.

Ligar a CA SSH

As chaves SSH são criadas quando o step-ca é configurado pela primeira vez, ou nunca. Define DOCKER_STEPCA_INIT_SSH=true no primeiro arranque1, e o registo mostra duas chaves extra:

SSH Host CA Key: ecdsa-sha2-nistp256 AAAAE2VjZHNhLXNoYTItbmlzdHAyNTYAAAAIbmlzdHAy...
SSH User CA Key: ecdsa-sha2-nistp256 AAAAE2VjZHNhLXNoYTItbmlzdHAyNTYAAAAIbmlzdHAy...
ChaveAssinaQuem confia nela
CA de anfitriõesA chave de anfitrião de cada servidorTodos os clientes, no known_hosts
CA de utilizadoresA chave de login de cada pessoaTodos os servidores, no sshd_config

Também acrescenta um provisioner sshpop, que é o que permite a um anfitrião renovar mais tarde o seu próprio certificado. Se a CA já estiver a correr sem SSH, não há interruptor para virar. É uma CA nova.

Assinar o anfitrião

Pega na chave de anfitrião que o servidor já tem, assina-a, e devolve o certificado ao servidor:

step ssh certificate --host --sign \
  --provisioner admin --provisioner-password-file prov-pass \
  nas.home.example ssh_host_ecdsa_key.pub

A ordem importa. Com as flags do provisioner depois do nome do anfitrião e do ficheiro da chave, o step recusou:

too many positional arguments were provided in 'step ssh certificate <key-id> <key-file>'

Põe todas as flags primeiro e ele assina. O certificado, tal como o ssh-keygen -L o lê:

CampoValor
Tipoecdsa-sha2-nistp256-cert-v01@openssh.com host certificate
Key IDnas.home.example
Principalsnas.home.example
Validade30 dias, 2026-10-09T18:34:30 a 2026-11-08T17:35:30

O principal é o nome que um cliente tem de usar para se ligar. Liga-te por um nome que não está no certificado e o cliente não o aceita, portanto assina todos os nomes a que o anfitrião responde.

O servidor

Duas linhas no sshd_config2:

HostCertificate /etc/ssh/ssh_host_ecdsa_key-cert.pub
TrustedUserCAKeys /etc/ssh/ssh_user_ca_key.pub

O HostCertificate entrega o certificado do anfitrião aos clientes, e a sua chave «must match a private host key already specified»2. O TrustedUserCAKeys é a chave pública da CA de utilizadores, «trusted to sign user certificates for authentication»2. Corre sshd -t antes de reiniciar. Uma gralha em qualquer dos caminhos e o sshd diz Could not load host certificate, o que é muito melhor descobrir agora do que a partir de uma sessão bloqueada.

Não há authorized_keys nenhum no servidor de teste. ls /home/damien/.ssh/authorized_keys devolve No such file or directory, e os logins abaixo funcionam na mesma.

O utilizador

A CA cria o par de chaves e assina-o de uma vez:

step ssh certificate damien id_ecdsa \
  --provisioner admin --provisioner-password-file prov-pass
CampoValor
Tipouser certificate
Principalsdamien
Validade16 horas
Extensõespermit-agent-forwarding, permit-port-forwarding, permit-X11-forwarding, permit-pty, permit-user-rc

As dezasseis horas são a questão. Cobrem um dia de trabalho e morrem durante a noite. Revogar um utilizador é sobretudo uma questão de não assinar para ele amanhã.

O cliente

Uma linha no known_hosts substitui todas as impressões digitais que de outra forma acumularia3:

@cert-authority *.home.example ecdsa-sha2-nistp256 AAAAE2VjZHNhLXNoYTItbmlzdHAy...

Isto diz: qualquer anfitrião sob home.example cujo certificado esteja assinado por esta chave é genuíno. O marcador @cert-authority é o que faz dela uma linha de CA em vez da chave de um anfitrião.

O que o teste mostrou

Os quatro a partir de um cliente que não tinha nada além do certificado de utilizador e aquela linha do known_hosts, com StrictHostKeyChecking=yes, para que nada pudesse ser aceite à pressa:

TesteResultado
Chave assinada com o seu certificado, como damienlogged in as damien, saída 0
A mesma chave, sem o certificadoPermission denied (publickey,password,keyboard-interactive)
Certificado usado para entrar como rootPermission denied: o certificado só nomeia damien
Cliente sem a linha da CA de anfitriõesHost key verification failed.

O terceiro é o que as pessoas não veem. Um certificado não abre todas as contas da máquina, só os principals escritos nele. Uma chave no authorized_keys de alguém não consegue fazer isso.

Renovar

Um anfitrião renova o seu próprio certificado com a chave que já tem. É o provisioner sshpop, que «allows a client to renew, revoke, or rekey an SSH certificate using that certificate for authentication with the CA»4. Sem palavra-passe5:

step ssh renew --force ssh_host_ecdsa_key-cert.pub ssh_host_ecdsa_key
SérieVálido até
Assinado151663258693294169972026-11-08 17:35:30
Renovado66789577897973167682026-11-08 17:35:59

Um número de série novo e 30 dias frescos. Mete-o num temporizador semanal e o anfitrião nunca caduca. Recarrega o sshd a seguir, senão o certificado antigo fica em memória.

Os utilizadores renovam pedindo outra vez. Um step ssh certificate por dia, ou no primeiro login do dia, e é esse o trabalho todo.

Onde é que falha

CasoO que aconteceO que fazer
CA em baixoOs certificados existentes continuam a funcionar; ninguém recebe um novoCorre a CA em algo que se mantenha de pé; os utilizadores têm 16 horas de folga
O certificado do anfitrião caducaOs clientes recusam o anfitrião, como se fosse um estranhoUm temporizador de renovação, e o sshd recarregado a seguir
Um utilizador tem de sair hoje, não amanhãO certificado funciona até expirarRevokedKeys no sshd_config aceita uma lista de chaves revogadas2
Nome do anfitrião fora dos principalsO cliente recusa o anfitriãoAssina todos os nomes a que ele responde
CA SSH não criada na configuraçãoNão há forma de a acrescentarUma CA nova, configurada com SSH ligado
As chaves SSH da CA roubadasQuem as tiver pode entrar em qualquer lado e fazer-se passar por qualquer anfitriãoMantém a CA numa máquina só dela, com cópia de segurança, offline se puderes

O último é a contrapartida. Cada ficheiro authorized_keys era um pequeno risco próprio. Agora há um grande, num só sítio. Isso é melhor, porque um só sítio pode ser vigiado e trancado, mas só se alguém o fizer.

Confiança onde pode ser verificada

O pedido da impressão digital e o ficheiro authorized_keys têm uma coisa em comum. Ambos pedem a uma pessoa que tome uma decisão de confiança sem informação nenhuma, todos os dias, para sempre. As pessoas não são boas nisso e nunca vão ser, portanto deixam de decidir e começam a escrever yes.

Uma CA leva essa decisão para um só sítio, uma vez, onde pode ser bem feita. É essa a ideia toda, e é a mesma que está por trás de qualquer norma que valha a pena ter: faz a coisa cuidadosa uma vez, escreve-a, e deixa de pedir às pessoas que a façam de cabeça cem vezes por semana. A máquina verifica a assinatura. Tu verificas a CA. É uma divisão de trabalho que se aguenta.


  1. smallstep/certificates — docker/entrypoint.sh — DOCKER_STEPCA_INIT_SSH=true acrescenta --ssh ao step ca init. ↩︎

  2. Manual do OpenBSD — sshd_config(5) — HostCertificate: «The certificate’s public key must match a private host key already specified by HostKey»; TrustedUserCAKeys: «public keys of certificate authorities that are trusted to sign user certificates for authentication»; RevokedKeys: «Keys listed in this file will be refused for public key authentication». ↩︎ ↩︎ ↩︎ ↩︎

  3. Manual do OpenBSD — sshd(8), SSH_KNOWN_HOSTS FILE FORMAT — o marcador «@cert-authority» «to indicate that the line contains a certification authority (CA) key». ↩︎

  4. Smallstep — Provisioners, SSHPOP — «An SSHPOP provisioner allows a client to renew, revoke, or rekey an SSH certificate using that certificate for authentication with the CA.» ↩︎

  5. Smallstep — step ssh renew — o comando usado para renovar o certificado do anfitrião. ↩︎