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

ACME-Challenges: HTTP-01 und DNS-01

Nach dieser Lektion: Ich kann den Wert berechnen, den eine HTTP-01- oder DNS-01-Challenge veröffentlicht, und sagen, welche Challenge ein Name braucht.

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

Wie eine CA prüft, wem der Name gehört

Eine ACME-Challenge ist der Test, mit dem Sie einer CA beweisen, dass Sie einen Domainnamen kontrollieren, bevor sie dafür ein Zertifikat signiert. HTTP-01 verlangt einen Wert unter einer Webadresse, DNS-01 verlangt ihn in einem DNS-Eintrag.

Wählen Sie die falsche, und die Erneuerung scheitert um drei Uhr nachts.

Am Ende dieser Lektion

Notiz

Ich kann den Wert berechnen, den eine HTTP-01- oder DNS-01-Challenge veröffentlicht, und sagen, welche Challenge ein Name braucht.

Schlüsselwörter

BegriffWas er bedeutet
Fingerabdruckein kurzer Hash, der für den Kontoschlüssel steht
Schlüsselautorisierungder Wert der CA, ein Punkt und der Fingerabdruck
HTTP-01ein Nachweis auf Port 80 unter einem festen Pfad
DNS-01ein Nachweis in einem TXT-Eintrag
TXT-Eintragein DNS-Eintrag, der einfachen Text enthält
Wildcardein Name wie *.shop.example, der eine Ebene abdeckt

Die Zellen, die Lernende ausfüllen, bleiben in dieser Vorschau leer.

Beide Challenges veröffentlichen eine Schlüsselautorisierung

Die CA wählt für jede Challenge einen zufälligen Wert. Der Client hängt mit einem Punkt den Fingerabdruck seines Kontoschlüssels an. Das Ergebnis ist die Schlüsselautorisierung.

Nur wer den Kontoschlüssel besitzt, kann sie bilden. Ihre Veröffentlichung beweist zweierlei: Sie kontrollieren den Namen, und Sie sind dieses Konto.

HTTP-01 liefert sie auf Port 80 aus

Bei HTTP-01 holt die CA http://<name>/.well-known/acme-challenge/<wert> auf Port 80 ab. Die Antwort muss die Schlüsselautorisierung sein.

Das passt zu einem Webserver, der unter diesem Namen schon erreichbar ist. Einen Wildcard kann es nicht nachweisen, und es scheitert, wenn Port 80 zu ist oder der Name woandershin zeigt.

Beide Nachweise in Python berechnen

Befehl
docker exec python python3 steps/challenges.py

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

Was das Modell ausgibt

ZeileWas sie bedeutet
key authorisation: e8Kq2LvX0n4RcT7wYb1mPz9hJd3s.jW5aL0b7Qm3x...Der Wert der CA, ein Punkt, der Fingerabdruck
http://shop.example/.well-known/acme-challenge/e8Kq2LvX0n4RcT7wYb1mPz9hJd3sWo HTTP-01 abgeholt wird
_acme-challenge.shop.example TXT vmbbIVBfAfWejbz8l4MJmQwQ6JlM5mjoPCqB4qPA2HwDer DNS-01-Eintrag
43 charactersEin SHA-256-Hash in base64url, ohne Auffüllung
*.shop.example dns-01 onlyEin Wildcard braucht DNS-01

Die Zellen, die Lernende ausfüllen, bleiben in dieser Vorschau leer.

DNS-01 legt einen Hash ins DNS

Bei DNS-01 hasht der Client die Schlüsselautorisierung mit SHA-256 und schreibt sie in base64url als TXT-Eintrag unter _acme-challenge.<name>. Die CA schlägt den Eintrag nach.

Nichts muss aus dem Internet erreichbar sein, also kann auch ein interner Server seinen Namen nachweisen. Für einen Wildcard ist es die einzige Challenge. Der Preis: Der Client braucht einen Schlüssel, der Ihr DNS ändern darf.

Beispiel: eine Challenge wählen

Name oder LageChallengeWarum
shop.example auf einem öffentlichen WebserverHTTP-01Port 80 ist schon offen
*.shop.exampleDNS-01Ein Wildcard lässt sich nur im DNS nachweisen
Ein Server für Beschäftigte, von außen nicht erreichbarDNS-01Die CA verbindet sich nie mit ihm
Port 80 gesperrt, Port 443 offenTLS-ALPN-01Eine dritte Challenge, über TLS auf 443 nachgewiesen

Die Zellen, die Lernende ausfüllen, bleiben in dieser Vorschau leer.

Ein häufiger Fehler

Warnung

Viele glauben, HTTP-01 werde auf Port 443 geprüft, weil die Seite HTTPS nutzt. Die CA holt immer einfaches HTTP auf Port 80. Schließen Sie Port 80, und jede HTTP-01-Erneuerung scheitert, egal wie gut HTTPS eingerichtet ist.

HTTP-01 zweimal scheitern sehen

In Lektion 2 bestand der Name client, weil die CA den Container client erreichte. Fordern Sie jetzt zwei Namen an, die nicht Ihnen gehören.

Auf bank antwortet im Labor niemand. Der Name shop antwortet zwar, aber der Webserver dort ist nicht Ihr Client und kann Ihren Nachweis nicht ausliefern.

Einen Namen anfordern, auf den niemand antwortet

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

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

Einen Namen anfordern, den jemand anders bedient

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

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

Was die beiden Fehlschläge ausgeben

NameLetzte ZeileWas geschah
bankUnable to validate challenge: The server could not connect to validation targetNiemand antwortete auf Port 80
shopUnable to validate challenge: The server will not issue certificates for the identifierCaddy antwortete, nicht Ihr Client, also war der Nachweis falsch

Die Zellen, die Lernende ausfüllen, bleiben in dieser Vorschau leer.

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