Lässt es sich mit cremefarbenem Papier, einer Tönung, mehr Kontrast oder größerer Schrift besser lesen? Wählen Sie Ihre Farben und Ihre Schrift, einmalig für alle Seiten.

Kostenlose Lektion

Wie das ACME-Protokoll funktioniert

Nach dieser Lektion: Ich kann die Schritte einer ACME-Bestellung vom Konto bis zum heruntergeladenen Zertifikat beschreiben.

Lektion, 65 Min.4 BefehleLab zur Zertifikatsautomatisierung: ACME, kurzlebige TLS-Zertifikate und automatische Erneuerung mit einer privaten CA

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

BegriffWas er bedeutet
Verzeichnisdie Liste der ACME-Adressen einer CA
Kontoein Schlüsselpaar, an dem die CA den Client erkennt
Bestellungeine Anfrage nach einem Zertifikat und seinen Namen
Autorisierungder Eintrag der CA über den Nachweis für einen Namen
Finalisierenden Signierantrag schicken, sobald jeder Name nachgewiesen ist
CSRein 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

Befehl
docker exec client curl -s https://ca:9000/acme/acme/directory --cacert /ca/certs/root_ca.crt

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Was das Verzeichnis listet

Name in der AntwortWofür der Client ihn nutzt
newNonceVor einer Anfrage eine frische Nonce holen
newAccountDen Kontoschlüssel registrieren
newOrderEin Zertifikat für einige Namen anfordern
revokeCertErklären, dass einem Zertifikat nicht mehr zu trauen ist
keyChangeDen 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

Befehl
docker exec python python3 steps/order.py

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Was die aufgezeichnete Bestellung zeigt

SchrittZustandWas geschah
1 new-accountaccount validDer Schlüssel des Clients ist jetzt ein Konto
2 new-orderorder pendingFordert ein Zertifikat für shop an
3 und 4 authorization, challengepending, dann processingDer Client sagt: Komm und schau nach
5 authorizationvalidDie CA hat den Nachweis geholt und er passte
6 bis 8 order, finalize, orderready, processing, validDer CSR wird signiert
9 certificateissuedDer 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

Befehl
docker exec client step ca certificate client client.crt client.key --provisioner acme --standalone --force

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Ansehen, was Sie bekommen haben

Befehl
docker exec client step certificate inspect client.crt --short

Hier 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.

Über dieses Lab und seinen Quellcode: Lab zur Zertifikatsautomatisierung: ACME, kurzlebige TLS-Zertifikate und automatische Erneuerung mit einer privaten CA

Sie unterrichten eine Gruppe? Weisen Sie dieses Modul Ihren Studierenden zu, mit Handbuch für Lehrende, automatisch geprüften Aufgaben und einem Lab für jede Person.