ACME holt ein Zertifikat, ohne dass jemand tippt
ACME, das Automatic Certificate Management Environment, ist das Protokoll, mit dem ein Programm ohne menschliches Zutun ein Zertifikat von einer CA bekommt. Es ist in RFC 8555 festgelegt.
Ohne ACME heißt ein 47-Tage-Zertifikat: Alle paar Wochen erneuert ein Mensch, für jeden Namen. Mit ACME ist die Erneuerung ein Job, der von selbst läuft.
Am Ende dieser Lektion
Notiz
Ich kann die Schritte einer ACME-Bestellung vom Konto bis zum heruntergeladenen Zertifikat beschreiben.
Schlüsselwörter
| Begriff | Was er bedeutet |
|---|---|
| Verzeichnis | die Liste der ACME-Adressen einer CA |
| Konto | ein Schlüsselpaar, an dem die CA den Client erkennt |
| Bestellung | eine Anfrage nach einem Zertifikat und seinen Namen |
| Autorisierung | der Eintrag der CA über den Nachweis für einen Namen |
| Finalisieren | den Signierantrag schicken, sobald jeder Name nachgewiesen ist |
| CSR | ein Signierantrag, der den öffentlichen Schlüssel enthält |
Die Zellen, die Lernende ausfüllen, bleiben in dieser Vorschau leer.
Alles beginnt beim Verzeichnis
Ein Client bekommt eine einzige Adresse, das Verzeichnis. Er liest es und findet dort alle anderen Adressen. Sie sagen, wo es eine Nonce gibt, wo man ein Konto anlegt, bestellt, widerruft und Schlüssel wechselt.
Eine Nonce ist eine Zahl, die nur einmal verwendet wird. Jede Anfrage trägt eine frische, damit niemand eine alte Anfrage noch einmal senden kann.
Das Verzeichnis der Labor-CA lesen
docker exec client curl -s https://ca:9000/acme/acme/directory --cacert /ca/certs/root_ca.crtHier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
Was das Verzeichnis listet
| Name in der Antwort | Wofür der Client ihn nutzt |
|---|---|
| newNonce | Vor einer Anfrage eine frische Nonce holen |
| newAccount | Den Kontoschlüssel registrieren |
| newOrder | Ein Zertifikat für einige Namen anfordern |
| revokeCert | Erklären, dass einem Zertifikat nicht mehr zu trauen ist |
| keyChange | Den Kontoschlüssel gegen einen neuen tauschen |
Die Zellen, die Lernende ausfüllen, bleiben in dieser Vorschau leer.
Eine Bestellung durchläuft fünf Zustände
Jede Anfrage ist mit dem Kontoschlüssel signiert. Der Client gibt eine Bestellung für einige Namen auf. Jeder Name bekommt eine Autorisierung, die Challenges anbietet.
Die Bestellung ist pending, bis jeder Name nachgewiesen ist, dann ready. Der Client finalisiert mit einem CSR, und die Bestellung ist processing, dann valid. Ein gescheiterter Nachweis macht sie invalid.
Eine aufgezeichnete Bestellung Schritt für Schritt ausgeben
docker exec python python3 steps/order.pyHier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
Was die aufgezeichnete Bestellung zeigt
| Schritt | Zustand | Was geschah |
|---|---|---|
| 1 new-account | account valid | Der Schlüssel des Clients ist jetzt ein Konto |
| 2 new-order | order pending | Fordert ein Zertifikat für shop an |
| 3 und 4 authorization, challenge | pending, dann processing | Der Client sagt: Komm und schau nach |
| 5 authorization | valid | Die CA hat den Nachweis geholt und er passte |
| 6 bis 8 order, finalize, order | ready, processing, valid | Der CSR wird signiert |
| 9 certificate | issued | Der Client lädt die Kette herunter |
Die Zellen, die Lernende ausfüllen, bleiben in dieser Vorschau leer.
Ein häufiger Fehler
Warnung
Viele glauben, die CA erzeuge den Schlüssel des Servers und schicke ihn. Der Client erzeugt sein eigenes Schlüsselpaar und schickt nur die öffentliche Hälfte, im CSR. Der private Schlüssel verlässt den Server nie.
Jetzt eine echte Bestellung aufgeben
Der Container client hat den Befehl step und weiß, wo die CA ist und welcher Wurzel er traut. Der nächste Run legt ein Konto an, bestellt ein Zertifikat für den Namen client, weist ihn mit http-01 nach und finalisiert.
Er gibt done! für die Challenge, das Warten auf ready und das Finalisieren aus und nennt dann client.crt und client.key.
Ein Zertifikat für client bestellen
docker exec client step ca certificate client client.crt client.key --provisioner acme --standalone --forceHier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
Ansehen, was Sie bekommen haben
docker exec client step certificate inspect client.crt --shortHier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
Ihr Zertifikat in Kurzform
Die Kurzansicht nennt Subject: client, Issuer: Lab Private CA Intermediate CA und Provisioner: acme, dazu Ihre eigene Seriennummer und zwei Daten, die einen Tag auseinanderliegen.
Der Shop hat beim Start dasselbe selbst getan. Tippen Sie docker logs shop ins Terminal, um seine Zeilen zu Konto, Bestellung, Challenge und Finalisieren zu sehen. Seine Zeiten und IDs sind seine eigenen.