Perché certificati invece di chiavi

SSH si fida al primo utilizzo. Ti colleghi a una macchina nuova, lui ti mostra un’impronta e ti chiede se sei sicuro. Nessuno controlla. Tutti scrivono yes. È la stessa abitudine di chi ignora un avviso del browser, ed è esattamente ciò che serve a una macchina messa in mezzo.

Nell’altra direzione non va meglio. Ogni server tiene un file authorized_keys per utente, e ognuno cresce. Le chiavi vengono aggiunte e mai tolte. Qualcuno se ne va, e la sua chiave resta su una macchina di cui nessuno si ricorda fino al giorno in cui conta. Ricostruisci un server e ogni client grida che la chiave host è cambiata, così la gente impara a cancellare anche quell’avviso.

Un’autorità di certificazione SSH chiude entrambe le questioni. La CA firma la chiave di ogni host, e i client si fidano della CA, non di una lista di impronte. La CA firma la chiave di ogni utente per qualche ora, e i server si fidano della CA, non di una lista di chiavi. Niente da accettare alla prima connessione, niente da ripulire quando qualcuno se ne va, e un certificato utente che muore da solo entro domani.

È una configurazione diversa dal lato X.509 di step-ca trattato in La tua autorità di certificazione: step-ca in un container, ed è per questo che ha un articolo a sé. Stesso container, chiavi diverse, file diversi su ogni macchina. Tutto quello che segue è stato provato con step-ca 0.30.2 e OpenSSH 10.0 in un pod Podman.

Senza CACon step-ca
Un client incontra un server nuovoMostra un’impronta, tu scrivi yesControlla il certificato host sulla CA, non dice niente
Un server viene ricostruitoOgni client avvisa che la chiave è cambiataFirmi la chiave nuova, i client non se ne accorgono
Un utente riceve accessoLa sua chiave va in authorized_keys su ogni serverLa CA firma la sua chiave, ogni server la accetta
Un utente se ne vaTrovi e cancelli la sua chiave su ogni serverSmetti di firmare; il suo certificato è morto entro 16 ore
Cosa tiene ogni serverUn authorized_keys per utenteUna chiave pubblica della CA
Chi firma cosa, e chi si fida di cosastep-cachiave CA hostchiave CA utenteClientcert utente, 16 oresi fida della CA hostServercert host, 30 giornisi fida della CA utentefirma la chiave utentefirma la chiave hostssh, nessuna domandaognuno controlla ilcert dell'altro
La CA firma entrambi i lati. Il client deve fidarsi solo della chiave della CA host, e il server solo della chiave della CA utente. Nessuno dei due tiene una lista delle chiavi dell’altro.

Attivare la CA SSH

Le chiavi SSH vengono create al primo setup di step-ca, oppure mai. Imposta DOCKER_STEPCA_INIT_SSH=true al primo avvio1, e il log mostra due chiavi in più:

SSH Host CA Key: ecdsa-sha2-nistp256 AAAAE2VjZHNhLXNoYTItbmlzdHAyNTYAAAAIbmlzdHAy...
SSH User CA Key: ecdsa-sha2-nistp256 AAAAE2VjZHNhLXNoYTItbmlzdHAyNTYAAAAIbmlzdHAy...
ChiaveFirmaChi se ne fida
CA hostLa chiave host di ogni serverOgni client, in known_hosts
CA utenteLa chiave di login di ogni personaOgni server, in sshd_config

Aggiunge anche un provisioner sshpop, che è quello che più avanti permette a un host di rinnovare da solo il proprio certificato. Se la CA sta già girando senza SSH, non c’è nessun interruttore da girare. È una CA nuova.

Firmare l’host

Prendi la chiave host che il server ha già, firmala e restituisci il certificato al server:

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

L’ordine conta. Con i flag del provisioner dopo il nome host e il file della chiave, step l’ha rifiutato:

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

Metti tutti i flag prima e firma. Il certificato, come lo legge ssh-keygen -L:

CampoValore
Tipoecdsa-sha2-nistp256-cert-v01@openssh.com host certificate
Key IDnas.home.example
Principalnas.home.example
Validità30 giorni, da 2026-10-09T18:34:30 a 2026-11-08T17:35:30

Il principal è il nome che un client deve usare per collegarsi. Collegati con un nome che non è nel certificato e il client non lo accetterà, quindi firma ogni nome a cui l’host risponde.

Il server

Due righe in sshd_config2:

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

HostCertificate consegna il certificato host ai client, e la sua chiave «must match a private host key already specified»2. TrustedUserCAKeys è la chiave pubblica della CA utente, «trusted to sign user certificates for authentication»2. Lancia sshd -t prima di riavviare. Un errore di battitura in uno dei due percorsi e sshd risponde Could not load host certificate, che è molto meglio scoprire adesso che da una sessione rimasta chiusa fuori.

Sul server di prova non c’è proprio nessun authorized_keys. ls /home/damien/.ssh/authorized_keys restituisce No such file or directory, e i login qui sotto funzionano lo stesso.

L’utente

La CA crea la coppia di chiavi e la firma in un colpo solo:

step ssh certificate damien id_ecdsa \
  --provisioner admin --provisioner-password-file prov-pass
CampoValore
Tipouser certificate
Principaldamien
Validità16 ore
Estensionipermit-agent-forwarding, permit-port-forwarding, permit-X11-forwarding, permit-pty, permit-user-rc

Sedici ore sono il punto. Coprono una giornata di lavoro e muoiono durante la notte. Revocare un utente è soprattutto questione di non firmare per lui domani.

Il client

Una riga in known_hosts sostituisce ogni impronta che altrimenti accumulerebbe3:

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

Vuol dire: qualsiasi host sotto home.example il cui certificato è firmato da questa chiave è autentico. È il marcatore @cert-authority a farne una riga di CA invece della chiave di un singolo host.

Cosa hanno mostrato le prove

Tutte e quattro da un client che non aveva altro che il certificato utente e quell’unica riga di known_hosts, con StrictHostKeyChecking=yes, così non si poteva accettare niente al volo:

ProvaRisultato
Chiave firmata con il suo certificato, come damienlogged in as damien, exit 0
Stessa chiave, certificato toltoPermission denied (publickey,password,keyboard-interactive)
Certificato usato per entrare come rootPermission denied: il certificato nomina solo damien
Client senza la riga della CA hostHost key verification failed.

La terza è quella che sfugge. Un certificato non apre ogni account della macchina, solo i principal scritti dentro. Una chiave nell’authorized_keys di qualcuno questo non lo sa fare.

Il rinnovo

Un host rinnova il proprio certificato con la chiave che ha già. È il provisioner sshpop, che «allows a client to renew, revoke, or rekey an SSH certificate using that certificate for authentication with the CA»4. Nessuna password5:

step ssh renew --force ssh_host_ecdsa_key-cert.pub ssh_host_ecdsa_key
SerialeValido fino a
Firmato151663258693294169972026-11-08 17:35:30
Rinnovato66789577897973167682026-11-08 17:35:59

Un seriale nuovo e altri 30 giorni. Mettilo su un timer settimanale e l’host non scade mai. Dopo, ricarica sshd, altrimenti il vecchio certificato resta in memoria.

Gli utenti rinnovano chiedendo di nuovo. Uno step ssh certificate al giorno, o al primo login della giornata, e il lavoro è tutto lì.

Dove non regge

CasoCosa succedeCosa fare
CA giùI certificati esistenti continuano a funzionare; nessuno ne riceve uno nuovoFar girare la CA su qualcosa che resta su; gli utenti hanno 16 ore di margine
Il certificato host scadeI client rifiutano l’host, come se fosse uno sconosciutoUn timer di rinnovo, e sshd ricaricato subito dopo
Un utente deve andarsene oggi, non domaniIl suo certificato funziona finché non scadeRevokedKeys in sshd_config accetta una lista di chiavi revocate2
Nome host non tra i principalIl client rifiuta l’hostFirmare ogni nome a cui risponde
CA SSH non creata al setupNon c’è modo di aggiungerlaUna CA nuova, configurata con SSH attivo
Rubate le chiavi SSH della CAChi le ha può entrare ovunque ed essere qualsiasi hostTenere la CA su una macchina sua, con backup, offline se puoi

L’ultimo è il compromesso. Ogni file authorized_keys era un piccolo rischio a sé. Adesso c’è un unico rischio grande, in un posto solo. È meglio, perché un posto solo si può sorvegliare e blindare, ma solo se qualcuno lo fa.

Fiducia dove si può verificare

La richiesta dell’impronta e il file authorized_keys hanno una cosa in comune. Entrambi chiedono a una persona di prendere una decisione di fiducia senza alcuna informazione, ogni giorno, per sempre. Le persone non sono brave a farlo e non lo saranno mai, quindi smettono di decidere e cominciano a scrivere yes.

Una CA sposta quella decisione in un posto solo, una volta, dove può essere presa come si deve. L’idea è tutta qui, ed è la stessa che sta dietro a ogni standard che valga qualcosa: fai la cosa con cura una volta, mettila per iscritto, e smetti di chiedere alla gente di farla a mente cento volte a settimana. La macchina controlla la firma. Tu controlli la CA. È una divisione del lavoro che regge.


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

  2. OpenBSD manual — 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. OpenBSD manual — sshd(8), SSH_KNOWN_HOSTS FILE FORMAT — il marcatore «@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 — il comando usato per rinnovare il certificato host. ↩︎