Let’s-Encrypt-Zertifikate automatisieren: Certbot, DNS-01 und Erneuerung

Let’s-Encrypt-Automatisierung: HTTP-01 oder DNS-01, Wildcard, Erneuerung mit Certbot und acme.sh, Deploy-Hook, Validierungsfehler hinter einem CDN und Ablaufüberwachung.
Technische Zusammenfassung
Technologie
ACME (RFC 8555), Let’s Encrypt, Certbot, acme.sh, DNS-01, HTTP-01, systemd timer
Thema
Automatischer Bezug und unterbrechungsfreie Erneuerung von Zertifikaten
Niveau
Mittel
Voraussetzungen
  • root- oder sudo-Rechte auf einem Linux-Server
  • Berechtigung zur Verwaltung der DNS-Einträge der Domain
  • Kenntnisse der Nginx- oder Apache-Konfiguration
In diesem Beitrag7 Abschnitte

Ein Zertifikat, das um Mitternacht abläuft, ist die typische Störung eines Servers mit halb eingerichteter Automatisierung: Certbot hat erneuert, aber Nginx wurde nicht neu geladen, oder eine CDN-Regel hat die Validierungsanfrage nie zum Ursprung durchgelassen. Let’s Encrypt stellt das Zertifikat kostenlos aus; die eigentliche Arbeit besteht darin, Bezug, Erneuerung und Laden in den Dienst in einen Ablauf zu bringen, der funktioniert, ohne dass sich jemand daran erinnern muss. Im Folgenden geht es um die Wahl der Validierungsmethode, die Erneuerung mit Certbot und acme.sh, Deploy-Hooks, Fallstricke hinter einem CDN und die Überwachung von Erneuerungsfehlern.

ACME-Validierungsmethoden

Let’s Encrypt nimmt Zertifikatsanträge über das in RFC 8555 definierte ACME-Protokoll entgegen. Vor der Ausstellung verlangt es den Nachweis, dass der Antragsteller die Domain kontrolliert; das wird „Challenge“ genannt. Let’s Encrypt unterstützt drei Methoden:

  • HTTP-01: Der Client legt unter http://domain/.well-known/acme-challenge/<token> einen bestimmten Inhalt ab; Let’s Encrypt fragt diese Adresse über Port 80 von mehreren Netzwerkstandorten ab.
  • DNS-01: Der Client legt unter dem Namen _acme-challenge.domain einen TXT-Eintrag mit einem bestimmten Wert an.
  • TLS-ALPN-01: Die Validierung erfolgt über Port 443 mit einem speziellen TLS-Handshake. Die eingebauten Plugins von Certbot unterstützen diese Methode nicht; sie wird eher in Server- und Proxy-Software genutzt, die ACME selbst integriert.

Let’s-Encrypt-Zertifikate sind seit Langem 90 Tage gültig, und sowohl die von Let’s Encrypt angekündigten Pläne als auch Beschlüsse des CA/Browser Forum zeigen, dass die Zertifikatslaufzeit schrittweise kürzer wird. Je kürzer die Laufzeit, desto weniger ist manuelle Erneuerung durchzuhalten. Ein Kalendereintrag ist keine Methode. Verfolgen Sie den aktuellen Zeitplan in den Ankündigungen von Let’s Encrypt und richten Sie die Automatisierung so ein, dass sie unabhängig von der Laufzeit funktioniert.

HTTP-01 und DNS-01 im Vergleich

Kriterium HTTP-01 DNS-01
Wildcard (*.example.com) Nicht unterstützt Unterstützt
Zugriff auf Port 80 Erforderlich Nicht erforderlich
Interner Server ohne Internetzugang Nicht verwendbar Verwendbar
Erforderliche Berechtigung Schreiben ins Web-Root Schreiben in die DNS-Zone (API)
Mehrere Server / Load Balancer Anfrage kann auf einem anderen Knoten landen Unabhängig von der Serveranzahl
Sicherheitsrisiko Niedrig Wird der API-Schlüssel kompromittiert, kann die Zone geändert werden

Praktische Entscheidung: Für eine öffentlich erreichbare Unternehmenswebsite auf einem einzelnen Server ist HTTP-01 der einfachste Weg. Wird ein Wildcard benötigt, ist der Server nicht aus dem Internet erreichbar, liefern mehrere Knoten dieselbe Domain aus oder steht ein CDN davor, wird DNS-01 bevorzugt. Beschränken Sie bei DNS-01 das API-Token auf DNS-Bearbeitungsrechte für die betreffende Zone; vergibt Ihr DNS-Anbieter keine feingranularen Rechte, reduziert die Delegation des Eintrags _acme-challenge per CNAME an eine separate, nur dafür genutzte Zone das Risiko. Das DNS-Token ist der Schlüssel zur Domain. Details zu den Methoden von Let’s Encrypt finden Sie im Dokument Challenge Types.

Einrichtung und Erneuerung mit Certbot

Certbot ist der von der EFF entwickelte ACME-Client, der über Distributionspakete und Snap installiert werden kann. Drei typische Einsatzweisen:

# 1) Nginx-Plugin: Validierung und Anpassung des server-Blocks uebernimmt Certbot
certbot --nginx -d example.com -d www.example.com

# 2) Webroot: HTTP-01 ueber das vorhandene Web-Root, ohne die Konfiguration anzufassen
certbot certonly --webroot -w /var/www/example.com/public -d example.com -d www.example.com

# 3) DNS-01 und Wildcard (mit dem Plugin certbot-dns-cloudflare)
certbot certonly --dns-cloudflare \
  --dns-cloudflare-credentials /root/.secrets/cloudflare.ini \
  -d example.com -d '*.example.com'

Die Cloudflare-Zugangsdatei besteht aus einer Zeile (dns_cloudflare_api_token = …) und muss mit chmod 600 so geschützt werden, dass nur root sie lesen kann; das Token sollte im Cloudflare-Panel nur mit DNS-Bearbeitungsrechten für die betreffende Zone erstellt werden. Auf manuell verwalteten Servern ist certonly vorhersehbarer: Der Zertifikatspfad bleibt fest, den server-Block schreiben Sie selbst, und Certbot fasst Ihre Konfiguration nicht an. In der Produktion wollen Sie keine Überraschungen.

Die Erneuerung richtet das Certbot-Paket ein: Bei Installationen über Distributionspakete führt der systemd-Timer certbot.timer, bei Snap-Installationen snap.certbot.renew.timer zweimal täglich certbot renew aus. renew verarbeitet nur Zertifikate, deren Erneuerung fällig ist. Prüfen Sie direkt nach der Einrichtung Folgendes:

systemctl list-timers | grep -i certbot
certbot certificates            # Zertifikate, Domains, Ablaufdaten
certbot renew --dry-run         # vollstaendige Probe-Erneuerung in der Staging-Umgebung

Die Erneuerungsparameter jedes Zertifikats (Validierungsmethode, Webroot-Pfad, Hooks) werden in der Datei /etc/letsencrypt/renewal/<name>.conf gespeichert; erneuert wird mit der Methode des ersten Bezugs. Nutzen Sie beim Testen mit der Option --test-cert (--staging) die Testumgebung von Let’s Encrypt. In der Produktionsumgebung stoßen wiederholte Fehlversuche an das Rate Limit und blockieren für eine Weile auch den Bezug echter Zertifikate für diese Domain.

Alternative acme.sh

acme.sh läuft als Shell-Skript, unterstützt zahlreiche DNS-Anbieter und lässt sich ohne root installieren. Ein oft übersehenes Detail: Die Standard-Zertifizierungsstelle von acme.sh ist nicht Let’s Encrypt; um Let’s Encrypt zu verwenden, geben Sie dies ausdrücklich an.

acme.sh --set-default-ca --server letsencrypt
export CF_Token="..."   # Cloudflare-API-Token
acme.sh --issue --dns dns_cf -d example.com -d '*.example.com'
acme.sh --install-cert -d example.com \
  --key-file /etc/nginx/ssl/example.com.key \
  --fullchain-file /etc/nginx/ssl/example.com.fullchain.pem \
  --reloadcmd "systemctl reload nginx"

Die mit --install-cert festgelegten Zielpfade und der Reload-Befehl werden gespeichert; der eigene Cron-Job von acme.sh kopiert die Dateien bei der Erneuerung an diese Pfade und führt den Befehl aus. Verweisen Sie den Webserver nicht direkt auf das interne Verzeichnis von acme.sh.

Deploy-Hook und Neuladen von Diensten

Die Erneuerung kann erfolgreich sein, und die Website liefert trotzdem das alte Zertifikat aus. Nginx, Apache, Postfix oder HAProxy laden das Zertifikat in den Speicher und nutzen das alte, bis ein Reload erfolgt. In Certbot dient dafür der Deploy-Hook. Der Deploy-Hook läuft nur, wenn ein Zertifikat tatsächlich erneuert wurde; er läuft nicht bei jedem renew-Aufruf.

#!/bin/sh
# /etc/letsencrypt/renewal-hooks/deploy/reload-services.sh  (chmod 755)
set -e
nginx -t && systemctl reload nginx

# Falls weitere Dienste das Zertifikat nutzen:
case "$RENEWED_DOMAINS" in
  *mail.example.com*) systemctl reload postfix ;;
esac

Certbot übergibt dem Hook die Umgebungsvariablen RENEWED_LINEAGE (das live-Verzeichnis des Zertifikats) und RENEWED_DOMAINS (durch Leerzeichen getrennte Domains). Wird ein Hook nur für ein einzelnes Zertifikat benötigt, kann beim ersten Bezug der Parameter --deploy-hook "systemctl reload nginx" angegeben werden; dieser Wert wird in der Erneuerungskonfiguration dieses Zertifikats gespeichert.

Muss das Zertifikat auf eine andere Maschine (Load Balancer, Container, Windows-Server) übertragen werden, erfolgt das Kopieren im Hook. In diesem Fall sollte der Zugriff auf dem Zielsystem auf einen eingeschränkten Benutzer begrenzt sein, der nur die Zertifikatsdateien schreiben kann, und der Hook muss bei einem fehlgeschlagenen Kopiervorgang einen Exit-Code ungleich null zurückgeben, damit der Fehler in den Logs erscheint. Ein stiller Hook ist eine stille Störung. Bei containerbasierten Bereitstellungen sollte die Einbindung des Zertifikats in den Reverse-Proxy-Container zusammen mit der Struktur aus dem Leitfaden Nginx-Reverse-Proxy konfigurieren betrachtet werden.

Validierung hinter Proxy und CDN

Bei HTTP-01-Fehlern liegt die Schuld selten bei Certbot; das Problem steckt meist in einer Schicht auf dem Weg der Anfrage. Reihenfolge der Prüfung:

  • Weiterleitungen: Let’s Encrypt folgt bei HTTP-01 Weiterleitungen, aber nur auf die Ports 80 und 443 und die Schemata http/https. Eine Weiterleitungsregel auf einen anderen Port oder eine andere Domain bricht die Validierung.
  • IPv6: Hat die Domain einen AAAA-Eintrag, versucht Let’s Encrypt die Validierung bevorzugt über IPv6. Zeigt der AAAA-Eintrag auf einen alten Server oder antwortet der Webserver unter IPv6 mit der falschen Website, kann die Validierung fehlschlagen; korrigieren oder entfernen Sie den AAAA-Eintrag.
  • CDN und WAF: Bot-Schutz, Länderblockaden, „Under Attack“-Modi oder Regeln, die den Pfad /.well-known/ cachen, lassen die Validierungsanfrage nicht zum Ursprung durch. Definieren Sie für diesen Pfad eine Ausnahme oder wechseln Sie zu DNS-01.
  • Mehrknotige Struktur: Der Load Balancer kann die Validierungsanfrage an einen Knoten senden, der das Zertifikat nicht angefordert hat. Verwenden Sie ein gemeinsames Webroot, eine Regel, die den Pfad /.well-known/acme-challenge/ an einen einzelnen Knoten leitet, oder DNS-01.
  • CAA-Eintrag: Hat die Domain einen CAA-Eintrag, muss er für letsencrypt.org die Berechtigung issue (für Wildcards issuewild) enthalten.

Speziell bei Cloudflare liefert Cloudflare das Zertifikat für den Besucher ohnehin selbst aus; die Aufgabe des Zertifikats auf dem Ursprungsserver ist es, die Verbindung zwischen CDN und Ursprung zu schützen. Hier kann statt Let’s Encrypt auch das Ursprungszertifikat von Cloudflare (Origin CA) verwendet werden; dieses Zertifikat gilt aber nur für Cloudflare als vertrauenswürdig, und bei abgeschaltetem Proxy melden Browser einen Fehler. Zur Cache-Seite der Cloudflare-Schicht lesen Sie den Beitrag Cloudflare, WP Rocket und Redis.

Erneuerungsfehler überwachen

Automatisierung bricht stillschweigend. Let’s Encrypt hat 2025 die Warn-E-Mails zum Ablauf eingestellt; die Warnung müssen Sie nun selbst erzeugen. Richten Sie die Überwachung zweistufig ein:

  1. Von innen: Überwachen Sie, dass der Timer läuft und keine Fehler meldet. journalctl -u certbot.service (bei Snap snap.certbot.renew.service) und /var/log/letsencrypt/letsencrypt.log zeigen die letzten Erneuerungsversuche. In systemd lässt sich mit OnFailure= eine Unit definieren, die bei einem fehlgeschlagenen Lauf eine Benachrichtigung sendet.
  2. Von außen: Entscheidend ist das Ablaufdatum des ausgelieferten Zertifikats. Prüfen Sie nicht das Zertifikat in der Datei, sondern das über das Netz ausgelieferte; so werden auch Fälle erfasst, in denen der Reload vergessen wurde oder das CDN das alte Zertifikat ausliefert.
#!/bin/sh
# Beispiel: Warnung, wenn das ausgelieferte Zertifikat weniger als 14 Tage gueltig ist
HOST=www.example.com
if ! echo | openssl s_client -connect "$HOST:443" -servername "$HOST" 2>/dev/null \
     | openssl x509 -noout -checkend $((14*86400)); then
  echo "WARNUNG: Zertifikat von $HOST laeuft in 14 Tagen ab" | logger -t cert-check
fi

Wird diese Prüfung an ein Monitoringsystem angebunden (Uptime-Dienst, Zabbix, Prometheus Blackbox Exporter usw.), erhalten Sie Sichtbarkeit für alle Domains auf einem Bildschirm. Wählen Sie die Schwelle so großzügig, dass die automatische Erneuerung mehrmals versucht werden kann; wenn die Warnung kommt, haben Sie dann noch Zeit, das Problem zu lösen. Eine Warnung am letzten Tag kommt zu spät.

Erste Anlaufstellen bei einem Erneuerungsfehler:

Fehlersymptom Mögliche Ursache
404 bei der Validierung Webroot-Pfad hat sich geändert oder der server-Block leitet den Pfad /.well-known/ anderswohin
Timeout bei der Validierung Port 80 in der Firewall geschlossen oder AAAA-Eintrag fehlerhaft
Eintrag bei DNS-01 nicht gefunden API-Token abgelaufen, Berechtigung eingeschränkt oder Propagationszeit zu kurz
Erneuert, aber altes Zertifikat wird ausgeliefert Deploy-Hook fehlt oder ist fehlgeschlagen
Rate-Limit-Fehler Wiederholte Nutzung der Produktionsumgebung beim Testen

In Strukturen, die viele Domains auf einem Server hosten, kann die Zertifikatsverwaltung auch über ein Panel laufen; dieses Szenario behandelt der Beitrag Server mit vielen Websites mit Virtualmin verwalten. Mit welchen Protokollen und Ciphern das bezogene Zertifikat ausgeliefert wird, ist Thema des Leitfadens TLS-Konfiguration. Um Zertifikate, Backups und Monitoring serverseitig gemeinsam aufzubauen, sehen Sie sich unsere Leistung Linux-VPS- und Hosting-Verwaltung an; alle Optionen von Certbot finden Sie in der Certbot-Dokumentation.

Häufig gestellte Fragen

Kann ich für ein Wildcard-Zertifikat HTTP-01 verwenden?

Nein. Let’s Encrypt stellt Wildcard-Zertifikate nur mit DNS-01-Validierung aus. Dafür muss Ihr ACME-Client über die API Ihres DNS-Anbieters einen TXT-Eintrag anlegen können, oder der Eintrag _acme-challenge muss per CNAME an eine für die Automatisierung geeignete Zone delegiert werden.

Erneuert certbot renew das Zertifikat jeden Tag, wenn es täglich läuft?

Nein. renew verarbeitet nur Zertifikate, deren Erneuerung fällig ist, und überspringt die anderen. Deshalb läuft es zweimal täglich: Tritt ein vorübergehender Fehler auf, wird es beim nächsten Lauf erneut versucht.

Das Zertifikat wurde erneuert, aber die Website zeigt noch das alte – warum?

Der Webserver lädt das Zertifikat beim Start in den Speicher; auch wenn sich die Datei ändert, liefert er das neue Zertifikat erst nach einem Reload aus. Führen Sie per Deploy-Hook nach der Erneuerung systemctl reload nginx oder apache2 aus. Gibt es weitere Dienste, die die Zertifikatsdatei kopieren (Mailserver, Container, Load Balancer), nehmen Sie diese ebenfalls in den Hook auf.

Kann man bei aktivem Cloudflare-Proxy ein Let’s-Encrypt-Zertifikat erhalten?

Ja. Erreicht die HTTP-01-Anfrage den Ursprung über Cloudflare, funktioniert die Validierung; WAF, Bot-Schutz oder Weiterleitungsregeln können den Pfad /.well-known/acme-challenge/ jedoch blockieren. Die problemloseste Methode ist DNS-01 mit einem Cloudflare-API-Token, das nur DNS-Bearbeitungsrechte für die betreffende Zone hat.

Support

Kontaktieren Sie uns für Support oder eine Bestandsaufnahme zu diesem Thema.

Kontaktformular
[email protected]

Eretek Web

Wir bauen Unternehmenswebsites, WordPress- und CMS-Plattformen, Intranet- und SharePoint-Portale, Dokumentenmanagement sowie Formular- und Freigabeprozesse auf und halten sie sicher und aktuell.

Wissenszentrum

Weitere Beiträge