Lab zur Zertifikatsautomatisierung: ACME, kurzlebige TLS-Zertifikate und automatische Erneuerung mit einer privaten CA

Dieses Lab gibt jeder lernenden Person eine kleine eigene Welt aus TLS-Zertifikaten: eine private Zertifizierungsstelle (CA), die ACME spricht, das Protokoll, mit dem Programme ohne menschliches Tippen Zertifikate bekommen, einen Webserver, der sein eigenes Zertifikat von ihr bezieht und erneuert, die step-Befehlszeile, um eines von Hand anzufordern, und Python mit OpenSSL, um sie zu lesen. Öffentliche Zertifikate gelten ab März 2026 höchstens 200 Tage und ab März 2029 47 Tage, also muss die Erneuerung automatisch laufen, und hier sehen Lernende, wie.

Es ist kein Angriffs-Lab. Jede Kopie hat keinen Weg ins Internet und keinen zu einer anderen lernenden Person, und nichts darin ist für einen Browser vertrauenswürdig: Die CA erzeugt beim ersten Start des Labs ihre eigenen Schlüssel. Es hat keine Webseite, also wird alles im Terminal daneben getippt, und die CA signiert Zertifikate, die 24 Stunden gelten, sodass Erneuerung ein tägliches Ereignis ist statt ein jährliches.

Was Lernende lernen

Wie man ein Zertifikat mit openssl x509 liest (seine Namen im Subject Alternative Name, seinen Aussteller, seine Daten und die Kette bis zu einer Wurzel, geprüft mit openssl verify), wie eine ACME-Bestellung vom Konto bis zum heruntergeladenen Zertifikat abläuft (das Verzeichnis der CA, eine Bestellung, eine Challenge, finalize), wie die Challenge http-01 für einen Namen besteht, den man kontrolliert, und für einen fremden scheitert, wann man erneuert (zwei Drittel der Laufzeit, step certificate needs-renewal, Jitter und ACME Renewal Information), warum ein Widerruf nur Clients hilft, die nachfragen, während eine kurze Laufzeit einen gestohlenen Schlüssel für alle begrenzt, und wie man Erneuerung im großen Maßstab betreibt: das laufende Zertifikat prüfen, ein Inventar und Alarme. Es passt zu einem Kurs über Netzwerksicherheit, Systemadministration oder DevOps, und das Modul Kurzlebige Zertifikate und ACME-Automatisierung wird darin bearbeitet.

Im Browser ausführen

Das Lab startet vier Dienste, ca, shop, client und python, und wartet, bis jeder gesund ist. Bis dahin hat der Webserver die CA schon nach seinem Zertifikat gefragt. Das Terminal erreicht jeden Dienst mit docker exec, gefolgt von seinem Namen.

  1. Container-Seite öffnen. Öffnen Sie in der Leiste „Entwickeln“ und wählen Sie „Einen Container ausführen“. Die Seite kann jeder öffnen, und das Git-Lab und das SQL-Lab starten ohne Konto. Alle anderen Labs brauchen ein kostenloses Konto: Erstellen Sie eines, melden Sie sich an und klicken Sie dann auf „Starten“.
  2. Lab suchen. Die Karte „Beispiel-Labs“ listet alle Beispiele auf. Suchen Sie „Zertifikate: ACME und automatische Erneuerung“.
  3. Auf „Starten“ klicken. „Starten“ führt das Lab unverändert mit einem einzigen Klick aus. „Zuerst die Datei bearbeiten“ öffnet die Compose-Datei, damit Sie sie vor dem Start ändern können.
  4. Öffnen. Klicken Sie auf der Seite des Labs auf „Terminal öffnen“. Unter „In Ihrem Browser“ gibt es keinen Link, weil das Lab keine Webseite hat. Tippen Sie docker exec client curl -sS --cacert /ca/certs/root_ca.crt https://shop, und der Shop antwortet über HTTPS mit einem Zertifikat von der eigenen CA des Labs. Danach gibt docker exec python python3 steps/read_shop.py die Namen aus, für die es gilt, seinen Aussteller und seine Laufzeit von 24 Stunden.

Was echt ist und was ein Modell

Echt: die CA (step-ca) mit ihrem ACME-Verzeichnis, Konten und Bestellungen, der Webserver (Caddy), der sein Zertifikat über http-01 bezieht und erneuert, ein von Hand mit dem step-Client angefordertes Zertifikat, http-01, das für einen Namen ohne Antwort und für einen Namen eines anderen Servers scheitert, die mit OpenSSL gelesene und geprüfte Kette, Erneuerungsprüfungen und ein Widerruf, auf den die von der CA abgelehnte Erneuerung folgt. Modelle in Python, die das auf der Seite sagen: dns-01, weil das Lab keinen DNS-Server hat, in den Lernende einen TXT-Eintrag schreiben können, und ACME Renewal Information (RFC 9773), weil die CA des Labs sie noch nicht anbietet. Beide folgen den Regeln des Protokolls über erfundene Werte. Seriennummern und Daten sind bei jeder Ausstellung anders, also geben die Skripte Laufzeiten und Regeln aus statt Daten.

Was Lernende abgeben sollen

Einen kurzen Bericht: das Zertifikat des Shops mit openssl gelesen (Subject, Namen, Aussteller, Laufzeit und Kette), ein selbst angefordertes Zertifikat, eine Erneuerungsprüfung, die Ja sagt, und eine, die Nein sagt, ein Widerruf mit der anschließend von der CA abgelehnten Erneuerung und ein Satz dazu, warum kurzlebige Zertifikate die Arbeit erledigen, für die der Widerruf gedacht war. Ein guter Satz sagt, dass die meisten Clients den Widerruf nicht prüfen, sodass nur das Enddatum einen gestohlenen Schlüssel für alle stoppt.

A basic lesson on this lab

Certificate Automation Basics ist eine kleine Lektion, die in diesem Lab durchgeführt wird. Darin liest man das ACME-Verzeichnis der CA, ruft den Shop über HTTPS ab und liest sein Zertifikat, fordert ein Zertifikat von Hand an, sieht, wie ein fremder Name abgelehnt wird, und prüft, ob ein Zertifikat erneuert werden muss.

Kostenlose persönliche Konten haben sie im Modul Basics, das auf der Startseite liegt, jede Einrichtung kann sie aus dem Basics-Ordner der Bibliothek kopieren, und eine neue Einrichtung startet mit ihr in einem Modul namens DevOps Labs (Sample). Sie ist bewusst klein: Sie zeigt Lehrkräften, was eine Lektion in einem Lab ist, und das Lab erledigt den Rest. Kopieren Sie sie in ein eigenes Modul, um sie zu ändern.

Der Code auf GitHub

Die Compose-Datei hat kein Dockerfile: Sie startet öffentliche Standard-Images, auf Versionen festgelegt, step-ca für die CA und den Client (Apache-2.0), Caddy für den Webserver (Apache-2.0) und das offizielle Python-Image, das OpenSSL mitbringt, mit insgesamt 384 MB Speicher. Keines davon wird von uns verteilt. Die CA bewahrt ihre Schlüssel in einem benannten Volume auf, sodass vor einem Stopp ausgestellte Zertifikate nach einem Start weiter die Prüfung bestehen, und die anderen Dienste lesen nur ihre Wurzel. Die Skripte in steps/ schreibt die Compose-Datei selbst aus festem Text. Das Lab hat keinen Weg ins Internet und enthält weder Schlüssel noch Passwort: Die CA erzeugt ihre eigenen beim ersten Start zufällig.

Als Aufgabe stellen

Sagen Sie in der Aufgabe, was abzugeben ist.

  1. Lab erstellen. Fügen Sie in Ihrem Modul eine Aufgabe hinzu und wählen Sie die Karte „Container-Lab“, dann „In einem GitHub-Repository“. Geben Sie https://github.com/mitsurutech/lab-acme-lab mit dem Branch main an. Die Compose-Datei ist standardmäßig compose.yaml. Forken Sie das Repository zuerst, wenn Sie es ändern möchten.
  2. Veröffentlichen und ausprobieren. „Veröffentlichen“ legt den Commit fest, den Sie gesehen haben. Eine spätere Änderung im Repository verändert also kein Lab, das Sie bereits gestellt haben. Starten Sie zuerst Ihre eigene Kopie.
  3. Zuweisen. Weisen Sie es wie jede Aufgabe zu, auf Wunsch mit Fälligkeitsdatum, und schreiben Sie in die Aufgabe, was zu tun ist und was abgegeben werden soll.
  4. Abgaben bewerten. Öffnen Sie die Kopie einer lernenden Person und die abgegebene Arbeit, bewerten Sie sie und geben Sie sie mit einer Begründung zur Überarbeitung zurück, wenn mehr nötig ist.

Dieses Lab ausprobieren, und was es kostet

Mit einem kostenlosen persönlichen Konto können Sie die Grundlagenlektionen in diesem Lab durcharbeiten, mit genug kostenlosem Guthaben pro Monat für die meisten Lektionen und ohne Karte. Für eine Klasse sind die ersten 365 Tage für eine Schule kostenlos, für bis zu 50 Lernende; danach zahlt sie je lernender Person und Jahr, alle Labs inklusive und Lehrkräfte kostenlos.

Häufige Fragen

Warum gelten Zertifikate in diesem Lab nur 24 Stunden?
Das ist der eigene Standard der CA des Labs, und so sehen Lernende die Erneuerung in einer einzigen Sitzung statt einmal im Jahr. Öffentliche Zertifikate gehen in dieselbe Richtung: 200 Tage ab März 2026, 100 ab März 2027 und 47 ab März 2029.
Vertraut ein Browser dem Zertifikat des Shops?
Nein, und das soll er auch nicht. Die Wurzel gehört allein zu dieser Kopie des Labs und entstand bei ihrem ersten Start. Im Lab bekommen curl und OpenSSL mit --cacert und -CAfile gesagt, ihr zu vertrauen, genau wie eine Firma es mit ihrer eigenen privaten CA tut.
Warum sind dns-01 und ARI Modelle und nicht echt?
dns-01 braucht einen DNS-Server, in den Lernende einen TXT-Eintrag schreiben können, und das Lab hat keinen. ACME Renewal Information braucht eine CA, die sie anbietet, und die CA des Labs tut das noch nicht. Beide werden in Python mit den Regeln des Protokolls berechnet, also sind die Werte die, die ein echter Client errechnen würde.
Warum besteht ein widerrufenes Zertifikat noch die Prüfung?
step certificate verify prüft, wie die meisten Clients, die Signaturen und die Daten und fragt die CA nicht, ob das Zertifikat widerrufen wurde. Die CA selbst erinnert sich daran, weshalb sie die Erneuerung danach ablehnt. Diese Lücke ist der Kern der Lektion: Nur das Enddatum stoppt einen gestohlenen Schlüssel für jeden Client.