फ़ोन कठिन मामला क्यों हैं
step-ca के defaults servers के लिए बने हैं। Server हर सुबह खुद को renew करता है, और आपकी अपनी Certificate Authority: Container में step-ca दिखाता है कि यह ACME clients और हर उस चीज़ के लिए कैसे काम करता है जो step ca renew चला सकती है। वह पोस्ट CA शुरू करना, उसके दो passwords और root पर भरोसा करना भी बताती है, और यह पोस्ट वहीं से आगे बढ़ती है। Home Assistant app के लिए client certificate रखने वाला फ़ोन कुछ भी renew नहीं कर सकता, और जब कोई फ़ोन खो जाए तो आपको उसे आज ही बाहर करना होता है, उसका certificate ख़त्म होने पर नहीं। पाँच defaults रास्ते में खड़े हैं, और उनमें से कोई शोर नहीं मचाता। वे बस आपको ऐसे certificates देते हैं जो कल मर जाते हैं और ऐसी revocation list जो सबको ठुकरा देती है।
| Default | यह फ़ोन के साथ क्या करता है | उपाय |
|---|---|---|
| Certificates ज़्यादा से ज़्यादा 24 घंटे चलते हैं | फ़ोन का certificate कल मर जाता है, और Home Assistant app उसे renew नहीं कर सकता | ca.json में maxTLSCertDuration बढ़ाएँ |
| CRL बंद | खोए फ़ोन को revoke करने से कहीं कुछ नहीं बदलता | crl block चालू करें |
| CRL का scope certificates से मेल नहीं खाता | nginx हर फ़ोन ठुकराता है, अच्छे वाले भी | idpURL सेट करें और crlDistributionPoints वाला template जोड़ें |
| Intermediate के लिए कोई CRL नहीं | nginx फिर भी हर फ़ोन ठुकराता है | साल में एक बार एक ख़ाली root CRL sign करें |
| CRL 24 घंटे चलता है | जब यह ख़त्म होता है, nginx फिर से हर फ़ोन ठुकराता है | इसे timer पर refresh करें |
Cloudflare अपने free plan पर इसका CA वाला आधा हिस्सा आपके लिए करता है, जैसा Cloudflare वाला संस्करण दिखाता है। खुद करने का मतलब है पाँचों करना। नीचे के tests Home Assistant CA नाम के CA पर चले, जो output में दिखने वाला नाम है।
पहला default: Certificates एक दिन चलते हैं
एक साल माँगिए और CA मना कर देता है:
The request was forbidden by the certificate authority: requested duration of
8760h1m0s is more than the authorized maximum certificate duration of 24h1m0s.
Servers और ACME clients के लिए यह सही default है, जो किसी के ध्यान दिए बिना दिन भर renew करते हैं। फ़ोन अपवाद है। Home Assistant app के पास अपना client certificate renew करने का कोई तरीका नहीं, तो 24 घंटे के certificate का मतलब है हर दिन हर फ़ोन तक चलकर जाना।
Validity की अवधि एक setting है, और वह step-ca के अपने config में रहती है। ca.json में हर provisioner claims लेता है1:
"claims": {
"maxTLSCertDuration": "8760h",
"defaultTLSCertDuration": "24h"
}
| Claim | मतलब | सेट किया |
|---|---|---|
maxTLSCertDuration | सबसे लंबा certificate जो यह provisioner sign करेगा | 8760h, एक साल |
defaultTLSCertDuration | बिना माँगे जो मिलता है | 24h पर छोड़ा, ताकि एक साल हमेशा सोच-समझकर चुना जाए |
minTLSCertDuration | सबसे छोटा जो यह sign करेगा | छुआ नहीं |
Container restart कीजिए और एक साल पास हो जाता है। एक साल फ़ैसला है, नियम नहीं। छोटा मतलब चोरी हुए certificate के काम आने का कम समय, और उन्हें दोबारा install करने के लिए घर के ज़्यादा चक्कर।
दूसरा default: CRL बंद है
Certificate revocation list (CRL), CA की sign की हुई उन certificates की सूची है जो उसने वापस ले लिए हैं। इसी से खोया फ़ोन उसके certificate के expire होने से पहले बाहर होता है, और step-ca बिना कहे इसे नहीं बनाता। Docs इस feature को experimental बताते हैं1।
"crl": {
"enabled": true,
"generateOnRevoke": true,
"cacheDuration": "24h"
}
| Field | क्या करता है | Default |
|---|---|---|
enabled | CRL बनाता ही है | बंद |
generateOnRevoke | certificate revoke होते ही सूची दोबारा बनाता है | बंद |
cacheDuration | हर सूची कितनी देर valid रहती है | 24 घंटे1 |
idpURL | वह URL जिसे सूची कहती है कि वह cover करती है | CA का अपना नाम और /1.0/crl2 |
वे 24 घंटे याद रखिए। वे लौटकर आते हैं।
तीसरा default: ऐसा CRL जिसे कुछ भी स्वीकार नहीं करेगा
CRL चालू करके, एक फ़ोन revoke कीजिए और दोनों फ़ोनों को उसके सामने जाँचिए:
$ 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
दोनों फ़ेल, अच्छा फ़ोन भी। वह सूची nginx के आगे रखिए और कोई अंदर नहीं आता।
सूची खुद बताती है क्यों। step-ca हर CRL पर एक critical Issuing Distribution Point लगाता है, जो कहता है “यह सूची उन certificates को cover करती है जो यहाँ इशारा करते हैं”। उसके जारी किए certificates कहीं इशारा नहीं करते:
$ 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 ऐसी सूची लागू नहीं करेगा जिसका scope certificate से मेल न खाए। तो यह बंद होकर फ़ेल होता है। जो सही है, और किसी के काम का नहीं।
| CRL कहता है कि वह cover करता है | Certificate कहता है कि उसका CRL यहाँ है | नतीजा | |
|---|---|---|---|
| जैसा आता है | https://localhost/1.0/crl, critical | कहीं नहीं | different CRL scope, सब मना |
idpURL और एक template | http://ca.home.example/1.0/crl | http://ca.home.example/1.0/crl | अच्छे फ़ोन पास, revoked फ़ेल |
Default URL वह भी नहीं जिस पर CA सेवा देता है। step-ca का source यह कहता भी है: “this is currently using the port 443 by default”2। दो settings इसे ठीक करती हैं, और दोनों में वही URL होना चाहिए। idpURL, ca.json के crl block में जाता है, और provisioner पर एक template हर certificate में मेल खाता crlDistributionPoints लगाता है3:
{
"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" } }
फ़ोनों के certificates दोबारा जारी कीजिए, क्योंकि सिर्फ़ नए certificates में यह field होता है, और वही जाँच सही जवाब देती है:
CN=phone2
error 23 at 0 depth lookup: certificate revoked
error phone2.crt: verification failed
phone1.crt: OK
Root को भी CRL चाहिए
उस जाँच ने सिर्फ़ फ़ोन का certificate देखा। nginx पूरी chain देखता है। यह OpenSSL का CRL_CHECK_ALL flag सेट करता है4, और इसका documentation साफ़ कहता है: “When using intermediate certificates, their CRLs should be specified in the same file”5। step-ca अपने intermediate से certificates जारी करता है और सिर्फ़ intermediate के revocations की सूची बनाता है। कुछ भी नहीं बताता कि intermediate खुद अब भी ठीक है या नहीं:
$ 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
उपाय root का sign किया एक CRL है जो कुछ भी revoke नहीं करता। OpenSSL इसे root key और CA की अपनी password file से बनाता है, और यह एक साल चल सकता है क्योंकि root रोज़-रोज़ कुछ revoke नहीं करता:
[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
दोनों सूचियाँ एक file में, और पूरी chain पास होती है:
$ 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
एक साल बाद की तारीख़ डायरी में लिख लीजिए। जब root CRL ख़त्म होगा, हर फ़ोन फिर बाहर हो जाएगा।
CRL प्रकाशित करना
CRL को वहाँ रहना होगा जहाँ हर certificate का URL इशारा करता है। CA पर नहीं।
| फ़ैसला | क्यों |
|---|---|
| आगे एक web server, port 9000 नहीं | Port 9000, step-ca की पूरी API है, signing समेत। सूची के सिवा किसी को उसमें से कुछ नहीं चाहिए |
| सादा HTTP, HTTPS नहीं | RFC 5280 कहता है कि distribution point “SHOULD include at least one LDAP or HTTP URI”6। HTTPS पर लाने के लिए certificate जाँच चाहिए, जिसके लिए सूची चाहिए। HTTP यह चक्र तोड़ता है |
| छेड़छाड़ की चिंता नहीं | सूची signed है। एक byte बदलिए और signature फ़ेल |
| सिर्फ़ दो CRL paths जवाब देते हैं | बाकी सब 404 है |
दोनों web servers यह कुछ लाइनों में करते हैं, और दोनों सूची को step-ca से सीधे आगे भेजते हैं और root CRL को 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
}
}
| Request | nginx | Caddy |
|---|---|---|
/1.0/crl | 200, application/pkix-crl, issuer intermediate | 200, application/pkix-crl, issuer intermediate |
/root.crl | 200, application/pkix-crl | 200, application/pkix-crl |
/roots.pem, /1.0/sign और बाकी API | 404 | 404 |
दोनों IPv4 के साथ IPv6 पर भी जवाब देते हैं, और देने चाहिए। Caddy default में दोनों पर सुनता है। nginx सिर्फ़ वहीं सुनता है जहाँ कहा जाए, तो अकेला listen 80; सिर्फ़ IPv4 है और उसके बगल में listen [::]:80; चाहिए। ::1 पर टेस्ट किया, nginx में वह लाइन आने के बाद दोनों से सूची 200 के साथ लौटी। step-ca खुद शुरू से दोनों पर सुनता है।
टेस्ट ports 8080 और 8081 पर चला, तो test certificates के URL में port था। असल इस्तेमाल में यह port 80 है और URL ठीक वही है जो template कहता है।
इसे ताज़ा रखना
step-ca का बनाया हर CRL 24 घंटे आगे का nextUpdate रखता है। उसके बाद वह expire हो चुका है, और expire हुई सूची उसी तरह फ़ेल होती है जैसे ग़ायब सूची:
$ 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
यह अच्छा फ़ोन है। दो दिन बाद। बाहर, क्योंकि किसी ने नई सूची नहीं लाई।
nginx ssl_crl सिर्फ़ शुरू होने या reload होने पर पढ़ता है। तो किसी चीज़ को सूची लानी होगी, file दोबारा बनानी होगी और हर कुछ घंटे में nginx reload करना होगा, जब तक यह चलता है, कोई देख रहा हो या न हो।
#!/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}
| Run | नतीजा |
|---|---|
| सामान्य | नई सूची अपनी जगह, nginx reload, phone1 200, revoked phone2 400 |
| CA तक नहीं पहुँचा जा सका | curl: (22) The requested URL returned error: 404, exit 22, पुरानी सूची छुई नहीं, कोई reload नहीं |
असली काम set -e कर रहा है। नाकाम fetch कभी अच्छी file के ऊपर ख़ाली file नहीं लिखनी चाहिए, क्योंकि टूटी सूची भी पुरानी सूची की तरह ही सबको बाहर कर देती है। इसे systemd timer या cron से हर कुछ घंटे में चलाइए। इससे कुछ भी ख़त्म होने से पहले इसे कई मौके मिलते हैं। इसमें कुछ भी चालाकी नहीं, और यही वह हिस्सा है जो दरवाज़े को काम करता रखता है।
फ़ोन को उसका certificate जारी करना
हर फ़ोन का एक certificate, फ़ोन के नाम पर, एक साल के लिए:
step ca certificate phone1 phone1.crt phone1.key \
--provisioner admin --provisioner-password-file prov-pass \
--not-after 8760h --kty EC
फ़ोन को certificate, उसकी key और intermediate एक PKCS12 file में चाहिए, और step इसे खुद बनाता है7:
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
यह आधुनिक encryption है, जिसे Home Assistant Companion के docs legacy container पर लौटने से पहले पहले आज़माने को कहते हैं8।
फ़ोन को CA से तीन चीज़ें चाहिए, एक नहीं:
| File | किस रूप में install करें | क्यों |
|---|---|---|
root_ca.crt | CA certificate | ताकि फ़ोन उस server certificate पर भरोसा करे जो step-ca ने proxy के लिए जारी किया |
intermediate_ca.crt | CA certificate | root और CA के असल में sign किए हर certificate के बीच की chain |
phone1.p12 | VPN और app user certificate | फ़ोन की अपनी key, वह चीज़ जो उसे अंदर ले जाती है |
Home Assistant Android app built-in CA certificates के साथ-साथ यूज़र के install किए CA certificates पर भी भरोसा करता है9, तो step-ca का server certificate काम करता है। इस काम के लिए यह बेहतर ताला भी है। Hostname सिर्फ़ घर के अंदर और फ़ोनों के लिए मायने रखता है, और जिस device के पास आपका root नहीं, वह server पर भरोसा ही नहीं करता, उसके पार जाना तो दूर।
जब फ़ोन खो जाए:
step ca revoke --cert phone2.crt --key phone2.key --reason "phone lost"
Certificate with Serial Number 89334534279272070053632987406394420097 has been revoked.
नई सूची उसी वक़्त बनती है, और अगला refresh उसे nginx के आगे रख देता है।
CA एक वादा है जो आप हर दिन निभाते हैं
इसे चलाते हुए मुझे यह बात खटकी कि काम का कितना कम हिस्सा certificates जारी करना है। एक command। बस इतना। सारा काम उसके आसपास के वादों में है: कि revoked फ़ोन बाहर रहे, कि अच्छा फ़ोन अंदर रहे, कि सूची कभी पुरानी न हो। step-ca पहला वादा निभाता है और बाकी आप पर छोड़ता है, और इसके defaults मानते हैं कि आप servers का एक बेड़ा हैं जो हर सुबह खुद को renew करते हैं।
यह कमी नहीं, यह वह है जिसके लिए इसे बनाया गया। पर यही उस बीच की दूरी है जो एक tool करता है और जो बताकर उसे बेचा जाता है। “अपना CA चलाइए” एक container और एक दोपहर जैसा लगता है। यह एक container, एक दोपहर, एक template, डायरी में तारीख़ वाला एक root CRL, और एक timer है जिसे आप उस दिन तक भूल जाएँगे जिस दिन वह रुक जाए।
फिर भी कीजिए। जो CA आप चलाते हैं उसे कोई और बंद नहीं कर सकता, उसकी कीमत नहीं बदल सकता, उसे पढ़ नहीं सकता। बस यह जानिए कि keys का मालिक होने का मतलब है काम-धंधों का मालिक होना, और वही काम-धंधे दरवाज़े को बंद रखते हैं।
Smallstep — step-ca configuration —
maxTLSCertDuration,defaultTLSCertDuration,minTLSCertDuration;crlblock “(experimental)” है,cacheDuration“Defaults to 24h”। ↩︎ ↩︎ ↩︎smallstep/certificates v0.30.2 — authority/tls.go — CRL का Issuing Distribution Point, सेट हो तो
idpURL, वरना CA का अपना नाम और/1.0/crl, critical चिह्नित। ↩︎ ↩︎Smallstep — Certificate templates —
crlDistributionPoints“defines URLs with the certificate revocation list”। ↩︎nginx — src/event/ngx_event_openssl.c —
ssl_crl,X509_V_FLAG_CRL_CHECK|X509_V_FLAG_CRL_CHECK_ALLसेट करता है। ↩︎nginx — ngx_http_ssl_module, ssl_crl — “When using intermediate certificates, their CRLs should be specified in the same file.” ↩︎
RFC 5280 — Internet X.509 PKI Certificate and CRL Profile — section 4.2.1.13: DistributionPointName “SHOULD include at least one LDAP or HTTP URI”। ↩︎
Smallstep — step certificate p12 — certificate, उसकी key और CA certificates को एक PKCS12 file में पैक करता है। ↩︎
Home Assistant Companion — Networking, TLS Client Authentication — पहले मौजूदा PKCS12 default आज़माएँ, OpenSSL
-legacycontainer सिर्फ़ उसके फ़ेल होने पर। ↩︎home-assistant/android — network_security_config.xml — trust anchors
systemऔरuserहैं: “Additionally trust user added CAs”। ↩︎