Dlaczego telefony są trudnym przypadkiem

Ustawienia domyślne step-ca są zrobione pod serwery. Serwer co rano sam się odnawia, a Własny urząd certyfikacji: step-ca w kontenerze pokazuje, że to działa dla klientów ACME i wszystkiego, co potrafi uruchomić step ca renew. Tamten wpis omawia też uruchomienie CA, jego dwa hasła i zaufanie do roota, a ten zaczyna tam, gdzie tamten skończył. Telefon z certyfikatem klienckim dla aplikacji Home Assistant niczego nie odnowi, a kiedy jeden zginie, musisz go odciąć dziś, a nie wtedy, gdy wygaśnie jego certyfikat. Na drodze stoi pięć ustawień domyślnych i żadne nie krzyczy. Po prostu zostawiają cię z certyfikatami, które umrą jutro, i listą unieważnień, która odrzuca wszystkich.

Ustawienie domyślneCo robi telefonowiPoprawka
Certyfikaty żyją najwyżej 24 godzinyCertyfikat telefonu umiera jutro, a aplikacja Home Assistant nie umie go odnowićPodnieś maxTLSCertDuration w ca.json
CRL wyłączonaUnieważnienie zgubionego telefonu niczego nigdzie nie zmieniaWłącz blok crl
Zakres CRL nie pasuje do certyfikatównginx odrzuca każdy telefon, także dobreUstaw idpURL i dodaj szablon z crlDistributionPoints
Brak CRL dla pośredniegonginx dalej odrzuca każdy telefonRaz w roku podpisz pustą CRL roota
CRL żyje 24 godzinyKiedy wygaśnie, nginx znowu odrzuca każdy telefonOdświeżaj ją z timera

Cloudflare robi za ciebie połowę dotyczącą CA w swoim darmowym planie, co pokazuje wersja z Cloudflare. Zrobienie tego samemu oznacza zrobienie wszystkich pięciu. Testy poniżej szły na CA o nazwie Home Assistant CA i to ta nazwa widnieje w wynikach.

Ustawienie pierwsze: certyfikaty żyją jeden dzień

Poproś o rok, a CA odmówi:

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

To dobre ustawienie domyślne dla serwerów i klientów ACME, które odnawiają się cały dzień i nikt tego nie zauważa. Telefon jest wyjątkiem. Aplikacja Home Assistant nie ma jak odnowić własnego certyfikatu klienckiego, więc certyfikat na 24 godziny oznacza codzienny obchód wszystkich telefonów.

Okres ważności to ustawienie i siedzi we własnej konfiguracji step-ca. Każdy provisioner w ca.json przyjmuje claims1:

"claims": {
  "maxTLSCertDuration": "8760h",
  "defaultTLSCertDuration": "24h"
}
ClaimZnaczenieUstawione na
maxTLSCertDurationNajdłuższy certyfikat, jaki ten provisioner podpisze8760h, rok
defaultTLSCertDurationCo dostajesz, jeśli nie prosiszZostaje 24h, więc rok jest zawsze świadomym wyborem
minTLSCertDurationNajkrótszy, jaki podpiszeBez zmian

Zrestartuj kontener i rok przechodzi. Rok to ocena sytuacji, nie reguła. Krócej znaczy mniej czasu, w którym skradziony certyfikat się do czegoś przyda, i więcej rundek po domu z ponowną instalacją.

Ustawienie drugie: CRL jest wyłączona

Lista unieważnionych certyfikatów (CRL) to podpisana lista certyfikatów, które CA wycofał. Tak odcina się zgubiony telefon, zanim jego certyfikat wygaśnie, a step-ca jej nie tworzy, dopóki mu się nie każe. Dokumentacja oznacza tę funkcję jako eksperymentalną1.

"crl": {
  "enabled": true,
  "generateOnRevoke": true,
  "cacheDuration": "24h"
}
PoleCo robiDomyślnie
enabledW ogóle tworzy CRLWyłączone
generateOnRevokePrzebudowuje listę w chwili unieważnienia certyfikatuWyłączone
cacheDurationJak długo każda lista jest ważna24 godziny1
idpURLURL, który według listy ona obejmujeWłasna nazwa CA plus /1.0/crl2

Zapamiętaj te 24 godziny. Jeszcze wrócą.

Ustawienie trzecie: CRL, której nic nie przyjmie

Z włączoną CRL unieważnij jeden telefon i sprawdź oba telefony:

$ 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

Oba nie przechodzą, ten dobry też. Postaw tę listę przed nginx i nikt nie wejdzie.

Sama lista mówi dlaczego. step-ca oznacza każdą CRL krytycznym Issuing Distribution Point, który mówi „ta lista obejmuje certyfikaty, które wskazują tutaj”. Wystawione przez niego certyfikaty nie wskazują nigdzie:

$ 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 nie zastosuje listy, której zakres nie pasuje do certyfikatu. Więc zamyka drzwi. Co jest słuszne i nikomu do niczego się nie przyda.

CRL mówi, że obejmujeCertyfikat mówi, że jego CRL jest podWynik
Prosto z pudełkahttps://localhost/1.0/crl, krytyczneNigdziedifferent CRL scope, wszyscy odrzuceni
idpURL i szablonhttp://ca.home.example/1.0/crlhttp://ca.home.example/1.0/crlDobre telefony przechodzą, unieważnione nie

Domyślny URL nie jest nawet takim, na którym CA nasłuchuje. Kod źródłowy step-ca sam to przyznaje: „this is currently using the port 443 by default”2. Naprawiają to dwa ustawienia i oba muszą wskazywać ten sam URL. idpURL trafia do bloku crl w ca.json, a szablon na provisionerze wbija pasujące crlDistributionPoints w każdy certyfikat3:

{
  "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" } }

Wystaw telefonom certyfikaty od nowa, bo tylko nowe certyfikaty niosą to pole, a ta sama kontrola daje właściwą odpowiedź:

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

Root też potrzebuje CRL

Tamta kontrola patrzyła tylko na certyfikat telefonu. nginx patrzy na cały łańcuch. Ustawia flagę OpenSSL CRL_CHECK_ALL4, a jego dokumentacja mówi to wprost: „When using intermediate certificates, their CRLs should be specified in the same file”5. step-ca wystawia certyfikaty ze swojego pośredniego i wypisuje wyłącznie unieważnienia pośredniego. Nic nie mówi, czy sam pośredni jest nadal dobry:

$ 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
Która CRL pokrywa który certyfikatRoot CAzaufany wprostPośrednipodpisuje wszystkophone1dobryphone2unieważnionySerwerha.example.compodpisujenginx sprawdza każde ogniwoogniwo bez CRL jest odrzucaneCRL roota365 dni, z OpenSSLCRL step-ca24 godziny, zawiera phone2pokrywapokrywa
Każde ogniwo poniżej roota potrzebuje CRL od certyfikatu nad nim. step-ca pokrywa dolny rząd. Pośredniego nie pokrywa nic, dopóki sam nie podpiszesz CRL roota.

Poprawka to CRL podpisana przez roota, która niczego nie unieważnia. OpenSSL robi ją z klucza roota i własnego pliku z hasłem CA, a może żyć rok, bo root na co dzień niczego nie unieważnia:

[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

Obie listy w jednym pliku i cały łańcuch się zgadza:

$ 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

Wpisz sobie datę w kalendarz za rok. Kiedy CRL roota wygaśnie, każdy telefon znowu zostaje za drzwiami.

Publikacja CRL

CRL musi być tam, gdzie wskazuje URL w każdym certyfikacie. Nie na samym CA.

WybórDlaczego
Serwer WWW z przodu, nie port 9000Port 9000 to całe API step-ca, razem z podpisywaniem. Nikt nie potrzebuje z niego niczego poza listą
Zwykłe HTTP, nie HTTPSRFC 5280 mówi, że punkt dystrybucji „SHOULD include at least one LDAP or HTTP URI”6. Pobieranie po HTTPS wymaga sprawdzenia certyfikatu, które wymaga listy. HTTP przerywa to błędne koło
Bez obaw o podmianęLista jest podpisana. Zmień jeden bajt i podpis się nie zgadza
Odpowiadają tylko dwie ścieżki CRLWszystko inne to 404

Oba serwery WWW robią to w kilku linijkach i oba przekazują listę prosto ze step-ca, a CRL roota serwują jako plik:

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
	}
}
ŻądanienginxCaddy
/1.0/crl200, application/pkix-crl, wystawca to pośredni200, application/pkix-crl, wystawca to pośredni
/root.crl200, application/pkix-crl200, application/pkix-crl
/roots.pem, /1.0/sign i reszta API404404

Oba odpowiadają po IPv6 tak samo jak po IPv4 i tak powinno być. Caddy domyślnie nasłuchuje na obu. nginx nasłuchuje tylko tam, gdzie mu powiesz, więc samo listen 80; to tylko IPv4 i potrzebuje obok listen [::]:80;. Sprawdzone przez ::1: lista wróciła z 200 od obu, gdy nginx dostał tę linijkę. Samo step-ca od razu nasłuchuje na obu.

Test szedł na portach 8080 i 8081, więc URL w testowych certyfikatach zawierał port. W użyciu to port 80, a URL jest dokładnie taki, jak w szablonie.

Żeby lista była świeża

Każda CRL, którą robi step-ca, ma nextUpdate 24 godziny naprzód. Potem jest przeterminowana, a przeterminowana lista zawodzi dokładnie tak samo jak brakująca:

$ 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

To jest ten dobry telefon. Dwa dni później. Za drzwiami, bo nic nie pobrało nowej listy.

Publikacja CRL i utrzymanie jej świeżościstep-ca:9000, całe APIzostaje w środkunginx lub Caddyport 80, v4 i v6/1.0/crl, /root.crlreszta to 404Lista wygasapo 24 godzinach,każdy telefon odrzuconyTimerco kilka godzinproxy mTLSssl_crl, przeładowaneCRLpobieraprzeładowujestaje
API step-ca zostaje w środku. Serwer WWW wydaje tylko dwie listy, a timer pobiera świeżą i przeładowuje proxy. Zatrzymaj timer, a lista wygaśnie dzień później i każdy telefon zostanie za drzwiami.

nginx czyta ssl_crl tylko przy starcie albo przeładowaniu. Więc coś musi co kilka godzin pobrać listę, przebudować plik i przeładować nginx, tak długo, jak to działa, czy ktoś patrzy, czy nie.

#!/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}
PrzebiegWynik
NormalnyNowa lista na miejscu, nginx przeładowany, phone1 200, unieważniony phone2 400
CA nieosiągalnycurl: (22) The requested URL returned error: 404, kod wyjścia 22, stara lista nietknięta, bez przeładowania

Prawdziwą robotę wykonuje set -e. Nieudane pobranie nigdy nie może nadpisać dobrego pliku pustym, bo zepsuta lista zamyka drzwi przed wszystkimi tak samo pewnie jak przeterminowana. Uruchamiaj to co kilka godzin z timera systemd albo crona. To daje mu kilka podejść, zanim cokolwiek wygaśnie. Nic sprytnego, a to jest ten kawałek, dzięki któremu drzwi działają.

Wystawienie telefonowi certyfikatu

Jeden certyfikat na telefon, nazwany od telefonu, na rok:

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

Telefon chce certyfikat, jego klucz i pośredni w jednym pliku PKCS12, a step sam go buduje7:

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

To nowoczesne szyfrowanie, czyli to, co dokumentacja Home Assistant Companion każe wypróbować najpierw, zanim sięgnie się po kontener w starym formacie8.

Telefon potrzebuje od CA trzech rzeczy, nie jednej:

PlikInstaluj jakoDlaczego
root_ca.crtCertyfikat CAŻeby telefon ufał certyfikatowi serwera, który step-ca wystawił dla proxy
intermediate_ca.crtCertyfikat CAŁańcuch między rootem a każdym certyfikatem, który CA faktycznie podpisuje
phone1.p12Certyfikat użytkownika VPN i aplikacjiWłasny klucz telefonu, to, co go wpuszcza

Aplikacja Home Assistant na Androida ufa certyfikatom CA zainstalowanym przez użytkownika, tak samo jak wbudowanym9, więc certyfikat serwera ze step-ca działa. Do tej roboty to zresztą lepszy zamek. Nazwa hosta ma znaczenie tylko w domu i dla telefonów, a urządzenie bez twojego roota nie ufa nawet serwerowi, nie mówiąc już o tym, żeby przez niego przejść.

Kiedy telefon zginie:

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

Nowa lista powstaje od ręki, a najbliższe odświeżenie stawia ją przed nginx.

CA to obietnica, którą dotrzymujesz codziennie

Kiedy to uruchomiłem, uderzyło mnie, jak mało tej roboty to wystawianie certyfikatów. Jedno polecenie. I tyle. Cała robota siedzi w obietnicach dookoła: że unieważniony telefon zostaje za drzwiami, że dobry telefon zostaje w środku, że lista nigdy nie jest przeterminowana. step-ca dotrzymuje pierwszej, resztę zostawia tobie, a jego ustawienia domyślne zakładają, że jesteś flotą serwerów odnawiających się co rano.

To nie jest wada, po prostu dla takich go zbudowano. Ale to jest przepaść między tym, co narzędzie robi, a tym, jak się je sprzedaje. „Postaw własne CA” brzmi jak kontener i jedno popołudnie. To jest kontener, popołudnie, szablon, CRL roota z datą w kalendarzu i timer, o którego istnieniu zapomnisz aż do dnia, w którym stanie.

I tak to zrób. CA, które sam prowadzisz, to takie, którego nikt inny nie wyłączy, nie przeceni i nie przeczyta. Wiedz tylko, że posiadanie kluczy oznacza posiadanie obowiązków, a to te obowiązki trzymają drzwi zamknięte.


  1. Smallstep — step-ca configuration — maxTLSCertDuration, defaultTLSCertDuration, minTLSCertDuration; blok crl jest „(experimental)”, cacheDuration „Defaults to 24h”. ↩︎ ↩︎ ↩︎

  2. smallstep/certificates v0.30.2 — authority/tls.go — Issuing Distribution Point listy CRL to idpURL, jeśli jest ustawiony, a w przeciwnym razie własna nazwa CA plus /1.0/crl, oznaczony jako krytyczny. ↩︎ ↩︎

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

  4. nginx — src/event/ngx_event_openssl.c — ssl_crl ustawia 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 — sekcja 4.2.1.13: DistributionPointName „SHOULD include at least one LDAP or HTTP URI”. ↩︎

  7. Smallstep — step certificate p12 — pakuje certyfikat, jego klucz i certyfikaty CA do pliku PKCS12. ↩︎

  8. Home Assistant Companion — Networking, TLS Client Authentication — najpierw wypróbuj obecny domyślny PKCS12, a kontener OpenSSL -legacy tylko wtedy, gdy to zawiedzie. ↩︎

  9. home-assistant/android — network_security_config.xml — kotwice zaufania to system plus user: „Additionally trust user added CAs”. ↩︎