_acme-challenge und DNS-01: Let’s-Encrypt-Zertifikat per DNS-Eintrag

Artikel anhören8 Min.
Vorgelesen von einer KI-Stimme

Wer ein Zertifikat von Let’s Encrypt per DNS-01 holt, legt dafür einen kurzen TXT-Eintrag unter dem Namen _acme-challenge an. So beweist man der Zertifizierungsstelle, dass man die Domain kontrolliert, ohne dass der Server aus dem Internet erreichbar sein muss. DNS-01 ist außerdem der einzige Weg zu Wildcard-Zertifikaten. Dieser Artikel zeigt Schritt für Schritt, wie der Eintrag aussieht, wie man ihn von Hand und automatisch setzt, wie man ihn prüft und wie man den DNS-Zugang sicher begrenzt. Die Grundlagen stehen in ACME und Let’s Encrypt, den Vergleich der drei Prüfverfahren in ACME im Detail.

So läuft DNS-01 ab

1. Der ACME-Client bestellt ein Zertifikat für beispiel.de und erhält von der CA für jeden Namen ein zufälliges Token.

2. Er bildet daraus die Key Authorization (Token, Punkt, Fingerabdruck des Kontoschlüssels), berechnet davon den SHA-256-Hash und kodiert ihn base64url. Das Ergebnis ist immer 43 Zeichen lang.

3. Diesen Wert schreibt der Client als TXT-Eintrag unter _acme-challenge.beispiel.de.

4. Er meldet der CA, dass alles bereit ist. Let’s Encrypt fragt den Eintrag aus mehreren Netzwerkstandorten ab und vergleicht ihn.

5. Stimmt der Wert, stellt die CA das Zertifikat aus. Danach kann der Eintrag wieder gelöscht werden.

Der Eintrag liegt immer vor dem Namen, der geprüft wird. Für www.beispiel.de heißt er also _acme-challenge.www.beispiel.de.

Fünf Schritte von links nach rechts: Zertifikat bestellen und Token erhalten, Hash berechnen, TXT-Eintrag unter _acme-challenge setzen, die CA prüft das DNS, das Zertifikat wird ausgestellt.
Die fünf Schritte der Prüfung per DNS-01.

Der TXT-Eintrag im Detail

In einer Zonendatei sieht der Eintrag so aus (Wert als Beispiel):

_acme-challenge.beispiel.de.  60  IN  TXT  "gfj9Xq7HBF6t5cNwvUQzxk2hLoR8CbMs1YpaVdEi4uK"

Die Zahl 60 ist die Gültigkeitsdauer (TTL) in Sekunden. Ein kleiner Wert sorgt dafür, dass alte Antworten nicht lange in Zwischenspeichern hängen. Mehrere TXT-Einträge unter demselben Namen sind erlaubt. Das passiert, wenn ein Zertifikat beispiel.de und den Platzhalter für alle Subdomains zugleich enthält: Beide Namen werden unter _acme-challenge.beispiel.de geprüft, es gibt also zwei Werte nebeneinander. Alte Einträge sollte man aufräumen, denn bei zu großen Antworten lehnt Let’s Encrypt ab.

Wildcard-Zertifikat mit DNS-01

Ein Wildcard-Zertifikat gilt für alle Namen einer Ebene, etwa shop.beispiel.de und blog.beispiel.de. Let’s Encrypt stellt es nur nach DNS-01 aus. Ein Beispiel mit Certbot im manuellen Modus, bei dem man den Eintrag selbst beim DNS-Anbieter einträgt:

certbot certonly --manual --preferred-challenges dns -d beispiel.de -d '*.beispiel.de'

Certbot zeigt zwei Werte an und wartet, bis man Enter drückt. Für den Test ist das gut, für den Betrieb nicht: Ein manuell geholtes Zertifikat erneuert sich nicht von selbst. Laufzeiten werden kürzer (siehe Zertifikatslaufzeit: 47 Tage), deshalb gehört DNS-01 automatisiert. Mehr zu Platzhaltern steht in SAN- und Wildcard-Zertifikate.

Automatisch über die API des DNS-Anbieters

Viele DNS-Anbieter haben eine Schnittstelle, über die ein Plug-in des ACME-Clients den Eintrag setzt und danach wieder löscht. Für Certbot gibt es Plug-ins für Cloudflare, Route 53, Google Cloud DNS, OVH, DigitalOcean und viele mehr. Ein Beispiel mit Cloudflare:

certbot certonly --dns-cloudflare --dns-cloudflare-credentials /root/.secrets/cloudflare.ini --dns-cloudflare-propagation-seconds 60 -d beispiel.de -d '*.beispiel.de'

Die Datei mit dem API-Token darf nur root lesen (Rechte 600). Das Token sollte nur das Recht haben, DNS-Einträge genau dieser einen Zone zu bearbeiten, nicht das ganze Konto. Die Wartezeit (propagation seconds) gibt den Nameservern des Anbieters Zeit, den neuen Eintrag überall zu verteilen. Andere Clients wie acme.sh oder lego kennen noch mehr Anbieter.

Sicherer: _acme-challenge per CNAME delegieren

Ein DNS-Token auf dem Webserver ist ein Risiko: Wird der Server übernommen, kann der Angreifer die ganze Zone ändern und Besucher umleiten. Besser ist es, nur den Namen _acme-challenge an eine kleine, eigene Zone abzugeben. Let’s Encrypt folgt dabei CNAME-Einträgen:

_acme-challenge.beispiel.de.  3600  IN  CNAME  beispiel.de.acme.beispiel-validierung.de.

Der ACME-Client schreibt dann nur noch in die Zone beispiel-validierung.de. Das Projekt acme-dns ist ein kleiner DNS-Server genau für diesen Zweck. Auch eine Abgabe per NS-Eintrag an einen eigenen Nameserver funktioniert.

Drei Kästen: Die Hauptzone beispiel.de enthält nur einen CNAME für _acme-challenge, der auf eine kleine Validierungszone zeigt; der ACME-Client darf per API-Token nur diese kleine Zone ändern.
Mit einer CNAME-Delegation braucht der ACME-Client keinen Zugriff auf die ganze Zone.

Prüfen, ob der Eintrag sichtbar ist

Bevor man die CA prüfen lässt, lohnt sich ein Blick mit dig. Erst über den normalen Resolver, dann direkt beim zuständigen Nameserver der Domain:

dig +short TXT _acme-challenge.beispiel.de
dig +short NS beispiel.de
dig +short TXT _acme-challenge.beispiel.de @ns1.beispiel-dns.de

Unter Windows leistet nslookup -type=TXT dasselbe. Zeigt der zuständige Nameserver den Wert, der Resolver aber noch nicht, hilft Warten. Wie Namen aufgelöst werden, erklärt Wie funktioniert DNS?.

Typische Fehler bei DNS-01

  • Falscher Name: Manche Webformulare hängen die Domain selbst an. Wer dort _acme-challenge.beispiel.de einträgt, erzeugt _acme-challenge.beispiel.de.beispiel.de. In das Feld gehört nur _acme-challenge.
  • Zu früh geprüft: Der Eintrag ist beim Anbieter gespeichert, aber noch nicht auf allen Nameservern. Wartezeit erhöhen.
  • CAA-Eintrag verbietet die CA: Gibt es CAA-Einträge, muss letsencrypt.org erlaubt sein, für Wildcards per issuewild, falls dieser Eintrag existiert; siehe CAA, DNSSEC und DANE.
  • Kaputtes DNSSEC: Let’s Encrypt prüft DNSSEC-Signaturen. Ist die Zone falsch signiert, scheitert die Prüfung.
Vier Zeilen mit Fehlern: falscher Name, weil das Formular die Domain doppelt anhängt; zu frühe Prüfung vor der Verteilung; ein CAA-Eintrag ohne letsencrypt.org; fehlerhaft signiertes DNSSEC.
Die vier häufigsten Ursachen, wenn DNS-01 scheitert.

Ausblick: dauerhafte DNS-Prüfung

Weil Laufzeiten sinken, arbeiten Let’s Encrypt, das CA/Browser Forum und die IETF an DNS-PERSIST-01. Dabei bleibt ein TXT-Eintrag dauerhaft stehen, der das ACME-Konto nennt; der Client braucht dann keinen Schreibzugriff mehr auf die Zone. Stand November 2026 ist das Verfahren angekündigt, aber noch nicht im Produktivbetrieb.

Häufige Fragen

Muss ich für DNS-01 einen Port öffnen? Nein. Die CA fragt nur das DNS ab. Der Server kann im Firmennetz oder hinter einer Firewall stehen.

Wie lange muss der TXT-Eintrag stehen bleiben? Nur bis die Prüfung bestanden ist. Gute Clients löschen ihn danach selbst.

Funktioniert DNS-01 mit einem dynamischen DNS-Dienst? Nur, wenn der Dienst TXT-Einträge über eine JSON.">API erlaubt. Sonst hilft die CNAME-Delegation an eine Zone, die das kann.

Kann ich DNS-01 für IP-Adressen nutzen? Nein. Zertifikate für IP-Adressen prüft Let’s Encrypt nur über HTTP-01 oder TLS-ALPN-01.

Fazit

DNS-01 braucht keinen offenen Port und ist der Weg zu Wildcard-Zertifikaten. Wichtig sind der richtige Name _acme-challenge, eine kurze TTL, genug Wartezeit und ein DNS-Zugang, der nur so viel darf wie nötig, am besten über eine delegierte Teilzone. Mehr in der Übersicht Verschlüsselung und IT-Sicherheit.

Rating: 4.98/5. From 21 votes.
Please wait...


IT-Berater und Softwareentwickler aus Deutschland mit mehr als 25 Jahren Erfahrung in Unternehmenssoftware. Schwerpunkt: Public-Key-Infrastruktur (PKI) und Zertifikats-Lebenszyklus-Management, dazu lokale KI und große Sprachmodelle. Betreibt techuni.de, Tech Crates und Student Life Online. Mehr auf carsten-kraft.com.