Perché i telefoni sono il caso difficile

I default di step-ca sono pensati per i server. Un server si rinnova da solo ogni mattina, e La tua autorità di certificazione: step-ca in un container mostra che funziona per i client ACME e per tutto ciò che sa lanciare step ca renew. Quell’articolo tratta anche l’avvio della CA, le sue due password e la fiducia nella root, e questo riparte da lì. Un telefono con un certificato client per l’app di Home Assistant non sa rinnovare niente, e quando ne sparisce uno devi chiuderlo fuori oggi, non quando il suo certificato scade. Cinque default si mettono di traverso, e nessuno fa rumore. Ti lasciano semplicemente con certificati che muoiono domani e una lista di revoca che rifiuta tutti.

DefaultCosa fa a un telefonoSoluzione
I certificati durano al massimo 24 oreIl certificato del telefono muore domani, e l’app di Home Assistant non sa rinnovarloAlzare maxTLSCertDuration in ca.json
CRL spentaRevocare un telefono perso non cambia niente da nessuna parteAccendere il blocco crl
Lo scope della CRL non corrisponde ai certificatinginx rifiuta ogni telefono, anche quelli buoniImpostare idpURL e aggiungere un template con crlDistributionPoints
Nessuna CRL per l’intermedianginx rifiuta ancora ogni telefonoFirmare una CRL della root vuota una volta l’anno
La CRL dura 24 oreQuando scade, nginx torna a rifiutare ogni telefonoAggiornarla con un timer

Cloudflare fa la metà CA di tutto questo al posto tuo nel suo piano gratuito, come mostra la versione con Cloudflare. Farlo da te vuol dire fare tutti e cinque i passi. Le prove qui sotto sono state fatte su una CA chiamata Home Assistant CA, che è il nome che compare nell’output.

Default uno: i certificati durano un giorno

Chiedi un anno e la CA dice di no:

The request was forbidden by the certificate authority: requested duration of
8760h1m0s is more than the authorized maximum certificate duration of 24h1m0s.

È il default giusto per server e client ACME, che rinnovano tutto il giorno senza che nessuno se ne accorga. Il telefono è l’eccezione. L’app di Home Assistant non ha modo di rinnovare il proprio certificato client, quindi un certificato da 24 ore vuol dire passare da ogni telefono ogni giorno.

La durata è un’impostazione, e sta nella configurazione di step-ca. Ogni provisioner in ca.json accetta delle claims1:

"claims": {
  "maxTLSCertDuration": "8760h",
  "defaultTLSCertDuration": "24h"
}
ClaimSignificatoImpostato a
maxTLSCertDurationIl certificato più lungo che questo provisioner firma8760h, un anno
defaultTLSCertDurationQuello che ottieni senza chiedereLasciato a 24h, così un anno è sempre una scelta voluta
minTLSCertDurationIl più corto che firmaLasciato com’è

Riavvia il container e un anno passa. Un anno è una valutazione, non una regola. Più corto vuol dire meno tempo in cui un certificato rubato è utile, e più giri per casa a reinstallarli.

Default due: la CRL è spenta

Una lista di revoca dei certificati (CRL) è l’elenco firmato dei certificati che la CA ha ritirato. È il modo in cui un telefono perso viene chiuso fuori prima che il suo certificato scada, e step-ca non ne crea una se non glielo dici. La documentazione segna la funzione come sperimentale1.

"crl": {
  "enabled": true,
  "generateOnRevoke": true,
  "cacheDuration": "24h"
}
CampoCosa faDefault
enabledCrea una CRL, puntoSpento
generateOnRevokeRicostruisce la lista nel momento in cui un certificato viene revocatoSpento
cacheDurationQuanto resta valida ogni lista24 ore1
idpURLL’URL che la lista dice di coprireIl nome della CA più /1.0/crl2

Ricordati quelle 24 ore. Tornano.

Default tre: una CRL che nessuno accetta

Con la CRL accesa, revoca un telefono e controlla entrambi i telefoni con la lista:

$ openssl verify -CAfile client-ca.pem -CRLfile crl.pem -crl_check phone1.crt phone2.crt
CN=phone1
error 44 at 0 depth lookup: different CRL scope
error phone1.crt: verification failed
CN=phone2
error 44 at 0 depth lookup: different CRL scope
error phone2.crt: verification failed

Falliscono tutti e due, anche il telefono buono. Metti quella lista davanti a nginx e non entra nessuno.

Il perché lo dice la lista stessa. step-ca marca ogni CRL con un Issuing Distribution Point critico, che dice «questa lista copre i certificati che puntano qui». I certificati che ha emesso non puntano da nessuna parte:

$ openssl crl -in crl.pem -noout -text
        X509v3 Issuing Distribution Point: critical
            Full Name:
              URI:https://localhost/1.0/crl
$ openssl x509 -in phone1.crt -noout -ext crlDistributionPoints
No extensions in certificate

OpenSSL non applica una lista il cui scope non corrisponde al certificato. Quindi fallisce in chiusura. Il che è giusto, e non serve a nessuno.

La CRL dice di coprireIl certificato dice che la sua CRL sta inRisultato
Così com’èhttps://localhost/1.0/crl, criticoDa nessuna partedifferent CRL scope, tutti rifiutati
idpURL e un templatehttp://ca.home.example/1.0/crlhttp://ca.home.example/1.0/crlI telefoni buoni passano, quelli revocati no

L’URL di default non è nemmeno uno su cui la CA risponde. Lo dice lo stesso sorgente di step-ca: «this is currently using the port 443 by default»2. Due impostazioni lo sistemano, e devono nominare entrambe lo stesso URL. idpURL va nel blocco crl di ca.json, e un template sul provisioner stampa i crlDistributionPoints corrispondenti in ogni certificato3:

{
  "subject": {{ toJson .Subject }},
  "sans": {{ toJson .SANs }},
  "keyUsage": ["digitalSignature"],
  "extKeyUsage": ["serverAuth", "clientAuth"],
  "crlDistributionPoints": ["http://ca.home.example/1.0/crl"]
}
"options": { "x509": { "templateFile": "templates/leaf-crl.tpl" } }

Riemetti i certificati dei telefoni, perché solo i certificati nuovi portano quel campo, e lo stesso controllo dà la risposta giusta:

CN=phone2
error 23 at 0 depth lookup: certificate revoked
error phone2.crt: verification failed
phone1.crt: OK

Anche la root ha bisogno di una CRL

Quel controllo guardava solo il certificato del telefono. nginx guarda tutta la catena. Imposta il flag CRL_CHECK_ALL di OpenSSL4, e la sua documentazione lo dice chiaro: «When using intermediate certificates, their CRLs should be specified in the same file»5. step-ca emette i certificati dalla sua intermedia ed elenca sempre e solo le revoche dell’intermedia. Niente dice se l’intermedia stessa è ancora buona:

$ openssl verify -CAfile client-ca.pem -CRLfile crl.pem -crl_check_all phone1.crt
O=Home Assistant CA, CN=Home Assistant CA Intermediate CA
error 3 at 1 depth lookup: unable to get certificate CRL
Quale CRL copre quale certificatoCA rootfidata così com'èIntermediafirma ogni certphone1buonophone2revocatoServerha.example.comfirmanginx controlla ogni anelloun anello senza CRL viene rifiutatoCRL della root365 giorni, da OpenSSLCRL di step-ca24 ore, elenca phone2coprecopre
Ogni anello sotto la root ha bisogno di una CRL del certificato sopra di lui. step-ca copre la riga in basso. Niente copre l’intermedia finché non firmi tu una CRL della root.

La soluzione è una CRL firmata dalla root che non revoca niente. OpenSSL la crea dalla chiave della root e dal file della password della CA, e può durare un anno perché la root non revoca niente giorno per giorno:

[ca]
default_ca = root
[root]
database = index.txt
crlnumber = crlnumber
default_md = sha256
default_crl_days = 365
private_key = root_ca_key
certificate = root_ca.crt
crl_extensions = crl_ext
[crl_ext]
authorityKeyIdentifier = keyid:always
touch index.txt && echo 1000 > crlnumber
openssl ca -config root-crl.cnf -gencrl -passin file:password -out root.crl.pem

Le due liste in un file solo, e tutta la catena torna:

$ openssl verify -CAfile client-ca.pem -CRLfile crl-chain.pem -crl_check_all phone1.crt phone2.crt
CN=phone2
error 23 at 0 depth lookup: certificate revoked
error phone2.crt: verification failed
phone1.crt: OK

Segnati una data in agenda tra un anno. Quando la CRL della root scade, ogni telefono viene di nuovo chiuso fuori.

Pubblicare la CRL

La CRL deve stare dove punta l’URL scritto in ogni certificato. Non sulla CA stessa.

SceltaPerché
Un web server davanti, non la porta 9000La porta 9000 è tutta l’API di step-ca, firma compresa. A nessuno serve altro che la lista
HTTP semplice, non HTTPSLa RFC 5280 dice che un distribution point «SHOULD include at least one LDAP or HTTP URI»6. Scaricarla in HTTPS richiede il controllo di un certificato, che richiede la lista. L’HTTP rompe il cerchio
Nessuna paura di manomissioniLa lista è firmata. Cambia un byte e la firma non torna
Rispondono solo i due percorsi delle CRLTutto il resto è un 404

Entrambi i web server lo fanno in poche righe, ed entrambi passano la lista così com’è da step-ca e servono la CRL della root come file:

server {
    listen 80;
    listen [::]:80;
    server_name ca.home.example;

    location = /1.0/crl {
        proxy_pass https://127.0.0.1:9000;
        proxy_ssl_trusted_certificate /etc/step/root_ca.crt;
        proxy_ssl_verify on;
        proxy_ssl_name localhost;
    }

    location = /root.crl {
        alias /etc/step/root.crl;
        default_type application/pkix-crl;
    }

    location / {
        return 404;
    }
}
http://ca.home.example {
	handle /1.0/crl {
		reverse_proxy https://127.0.0.1:9000 {
			transport http {
				tls_trust_pool file /etc/step/root_ca.crt
				tls_server_name localhost
			}
		}
	}
	handle /root.crl {
		header Content-Type application/pkix-crl
		root * /etc/step
		file_server
	}
	handle {
		respond 404
	}
}
RichiestanginxCaddy
/1.0/crl200, application/pkix-crl, emittente l’intermedia200, application/pkix-crl, emittente l’intermedia
/root.crl200, application/pkix-crl200, application/pkix-crl
/roots.pem, /1.0/sign e il resto dell’API404404

Entrambi rispondono su IPv6 oltre che su IPv4, ed è giusto così. Caddy ascolta su entrambi per default. nginx ascolta solo dove gli viene detto, quindi listen 80; da solo è solo IPv4 e ha bisogno di listen [::]:80; accanto. Provata su ::1, la lista è tornata con 200 da entrambi una volta che nginx ha avuto quella riga. step-ca ascolta su entrambi già così com’è.

La prova girava sulle porte 8080 e 8081, quindi l’URL nei certificati di prova aveva una porta. In uso è la porta 80 e l’URL è esattamente quello che dice il template.

Tenerla fresca

Ogni CRL creata da step-ca porta un nextUpdate a 24 ore. Dopo è scaduta, e una lista scaduta fallisce nello stesso modo di una lista mancante:

$ openssl verify -CAfile client-ca.pem -CRLfile crl-chain.pem -crl_check_all \
    -attime $(( $(date +%s) + 172800 )) phone1.crt
error 12 at 0 depth lookup: CRL has expired

Quello è il telefono buono. Due giorni dopo. Chiuso fuori, perché niente è andato a prendere una lista nuova.

Pubblicare la CRL e tenerla frescastep-ca:9000, tutta l'APIresta dentronginx o Caddyporta 80, v4 e v6/1.0/crl, /root.crlil resto 404La lista scadedopo 24 ore,ogni telefono rifiutatoTimerogni poche oreproxy mTLSssl_crl, ricaricatoCRLscaricaricaricasi ferma
L’API di step-ca resta dentro. Il web server distribuisce solo le due liste, e un timer va a prendere quella fresca e ricarica il proxy. Ferma il timer e la lista scade un giorno dopo, chiudendo fuori ogni telefono.

nginx legge ssl_crl solo quando parte o viene ricaricato. Quindi qualcosa deve scaricare la lista, ricostruire il file e ricaricare nginx ogni poche ore, per tutto il tempo che questa cosa resta in funzione, che qualcuno guardi o no.

#!/bin/sh
# Fetch step-ca's CRL, add the root CRL, and reload nginx only if both parse.
set -eu
dir=${CRL_DIR:-/etc/nginx/pki}
tmp=$(mktemp)
trap 'rm -f "$tmp" "$tmp.pem"' EXIT
curl -fsS --max-time 20 "${CRL_URL:-http://ca.home.example/1.0/crl}" -o "$tmp"
openssl crl -inform DER -in "$tmp" -out "$tmp.pem"
openssl crl -in "$dir/root.crl.pem" -noout
cat "$tmp.pem" "$dir/root.crl.pem" > "$dir/crl-chain.pem.new"
mv "$dir/crl-chain.pem.new" "$dir/crl-chain.pem"
${RELOAD:-nginx -s reload}
EsecuzioneRisultato
NormaleLista nuova al suo posto, nginx ricaricato, phone1 200, phone2 revocato 400
CA irraggiungibilecurl: (22) The requested URL returned error: 404, exit 22, vecchia lista lasciata dov’era, nessun reload

Il lavoro vero lo fa set -e. Un download fallito non deve mai scrivere un file vuoto sopra uno buono, perché una lista rotta chiude fuori tutti esattamente come una lista vecchia. Lancialo ogni poche ore da un timer systemd o da cron. Così ha diversi tentativi prima che qualcosa scada. Niente di furbo, ed è il pezzo che tiene la porta funzionante.

Dare a un telefono il suo certificato

Un certificato per telefono, col nome del telefono, per un anno:

step ca certificate phone1 phone1.crt phone1.key \
  --provisioner admin --provisioner-password-file prov-pass \
  --not-after 8760h --kty EC

Il telefono vuole il certificato, la sua chiave e l’intermedia in un unico file PKCS12, e step lo costruisce da solo7:

step certificate p12 phone1.p12 phone1.crt phone1.key \
  --ca certs/intermediate_ca.crt
MAC: sha256, Iteration 2048
PKCS7 Encrypted data: PBES2, PBKDF2, AES-256-CBC, Iteration 2048, PRF hmacWithSHA256

È la cifratura moderna, ed è quella che la documentazione di Home Assistant Companion dice di provare per prima, prima di ripiegare su un contenitore legacy8.

Al telefono servono tre cose dalla CA, non una:

FileDa installare comePerché
root_ca.crtCertificato CACosì il telefono si fida del certificato server che step-ca ha emesso per il proxy
intermediate_ca.crtCertificato CALa catena tra la root e ogni certificato che la CA firma davvero
phone1.p12Certificato utente per VPN e appLa chiave del telefono, la cosa che lo fa entrare

L’app Android di Home Assistant si fida dei certificati CA installati dall’utente oltre che di quelli di sistema9, quindi un certificato server di step-ca funziona. Ed è anche la serratura migliore per questo lavoro. Il nome host conta solo dentro casa e per i telefoni, e un dispositivo senza la tua root non si fida nemmeno del server, figuriamoci superarlo.

Quando il telefono sparisce:

step ca revoke --cert phone2.crt --key phone2.key --reason "phone lost"
Certificate with Serial Number 89334534279272070053632987406394420097 has been revoked.

La lista nuova viene costruita sul momento, e l’aggiornamento successivo la mette davanti a nginx.

Una CA è una promessa che mantieni ogni giorno

Facendo girare tutto questo, quello che mi ha colpito è quanto poco del lavoro consista nell’emettere certificati. Un comando. Tutto qui. Il lavoro sta tutto nelle promesse che ci stanno attorno: che un telefono revocato resti fuori, che un telefono buono resti dentro, che la lista non sia mai vecchia. step-ca mantiene la prima e lascia il resto a te, e i suoi default danno per scontato che tu sia una flotta di server che si rinnovano da soli ogni mattina.

Non è un difetto, è il pubblico per cui è stata costruita. Ma è la distanza tra quello che uno strumento fa e quello che viene venduto come capace di fare. «Fatti la tua CA» suona come un container e un pomeriggio. È un container, un pomeriggio, un template, una CRL della root con una data in agenda, e un timer di cui ti dimenticherai l’esistenza fino al giorno in cui si ferma.

Fallo lo stesso. Una CA che gestisci tu è una CA che nessun altro può spegnere, rimettere a listino o leggere. Sappi solo che possedere le chiavi vuol dire possedere le faccende, e sono le faccende a tenere la porta chiusa.


  1. Smallstep — step-ca configuration — maxTLSCertDuration, defaultTLSCertDuration, minTLSCertDuration; il blocco crl è «(experimental)», cacheDuration «Defaults to 24h». ↩︎ ↩︎ ↩︎

  2. smallstep/certificates v0.30.2 — authority/tls.go — l’Issuing Distribution Point della CRL è idpURL se impostato, altrimenti il nome della CA più /1.0/crl, marcato critico. ↩︎ ↩︎

  3. Smallstep — Certificate templates — crlDistributionPoints «defines URLs with the certificate revocation list». ↩︎

  4. nginx — src/event/ngx_event_openssl.c — ssl_crl imposta X509_V_FLAG_CRL_CHECK|X509_V_FLAG_CRL_CHECK_ALL. ↩︎

  5. nginx — ngx_http_ssl_module, ssl_crl — «When using intermediate certificates, their CRLs should be specified in the same file.» ↩︎

  6. RFC 5280 — Internet X.509 PKI Certificate and CRL Profile — sezione 4.2.1.13: il DistributionPointName «SHOULD include at least one LDAP or HTTP URI». ↩︎

  7. Smallstep — step certificate p12 — impacchetta un certificato, la sua chiave e i certificati CA in un file PKCS12. ↩︎

  8. Home Assistant Companion — Networking, TLS Client Authentication — prima prova il default PKCS12 attuale, il contenitore OpenSSL -legacy solo se quello fallisce. ↩︎

  9. home-assistant/android — network_security_config.xml — i trust anchor sono system più user: «Additionally trust user added CAs». ↩︎