CAA-Record per Kommandozeile abfragen

· 3 Min. Lesezeit

Ein CAA-Record legt fest, welche Zertifizierungsstellen für eine Domain Zertifikate ausstellen dürfen. Ist er falsch gesetzt, scheitert die nächste Verlängerung, ohne dass vorher etwas auffällt. Diese Anleitung zeigt die Abfrage mit dig, nslookup, PowerShell und host, erklärt die drei Eigenschaften und warum die Suche bei Subdomains nach oben wandert.

CAA-Record abfragen

Die Abfrage ist ein gewöhnlicher DNS-Lookup mit dem Typ CAA. Wähle dein Werkzeug und setz die Domain ein.

Werkzeug

Wird nur in deinem Browser in die Befehle eingesetzt.

dig · Linux, macOS

Jede Zeile ist ein CAA-Record: Flag, Eigenschaft und Wert. issue nennt die Zertifizierungsstelle, die Zertifikate ausstellen darf. Eine leere Antwort heißt: kein CAA-Record, jede CA darf ausstellen.

Shell
dig +short CAA example.com
Beispielausgabe
0 issue "letsencrypt.org"
0 issuewild "letsencrypt.org"
0 iodef "mailto:security@example.com"

nslookup · Windows, Linux, macOS

Das nslookup von Linux und macOS kennt CAA nicht mit Namen und schreibt „rdata_257“ (CAA ist Record-Typ 257). Der Wert dahinter stimmt. Unter Windows nimm die PowerShell-Variante.

Shell
nslookup -type=CAA example.com
Beispielausgabe
Non-authoritative answer:
example.com	rdata_257 = 0 issue "letsencrypt.org"
example.com	rdata_257 = 0 issuewild "letsencrypt.org"

PowerShell · Windows

Resolve-DnsName kann den Typ CAA nicht abfragen. Dieser Aufruf fragt stattdessen den öffentlichen Resolver von Google über HTTPS; der Record steht im Feld data. Gibt es keinen, bleibt die Ausgabe leer.

PowerShell
(Invoke-RestMethod "https://dns.google/resolve?name=example.com&type=CAA").Answer

host · Linux, macOS

Die kurze Form für Linux und macOS.

Shell
host -t CAA example.com
Beispielausgabe
example.com has CAA record 0 issue "letsencrypt.org"
example.com has CAA record 0 issuewild "letsencrypt.org"

Die meisten Domains haben keinen CAA-Record; die Antwort ist dann leer und der Status NOERROR. Das ist erlaubt und bedeutet schlicht: keine Einschränkung.

issue, issuewild und iodef lesen

Ein CAA-Record besteht aus einem Flag (fast immer 0), einer Eigenschaft und einem Wert in Anführungszeichen:

  • issue "letsencrypt.org": Diese CA darf Zertifikate für die Domain ausstellen. Mehrere CAs bekommen je einen eigenen Record.
  • issuewild "letsencrypt.org": gilt nur für Wildcard-Zertifikate (*.example.com). Fehlt issuewild, gilt dafür issue.
  • issue ";": Der leere Wert verbietet jeder CA die Ausstellung. Sinnvoll für Domains, die nie ein Zertifikat brauchen.
  • iodef "mailto:security@example.com": Adresse, an die eine CA abgelehnte Anfragen melden kann. Nur wenige CAs nutzen das.
  • Der Wert ist die Kennung der CA, nicht ihr Markenname: letsencrypt.org, pki.goog (Google Trust Services), digicert.com, sectigo.com. Die gültige Kennung steht in der Dokumentation der CA.

Subdomains: Die Suche wandert nach oben

Eine CA prüft vor der Ausstellung zuerst den genauen Namen. Findet sie dort keinen CAA-Record, fragt sie die nächsthöhere Ebene und so weiter bis zur Wurzel, also über die registrierte Domain hinaus bis zur Endung (RFC 8659). Der erste Treffer zählt. In der Praxis endet die Suche bei der eigenen Domain oder ohne Treffer; für www.shop.example.com gehst du dieselben Schritte:

Shell
dig +short CAA www.shop.example.com
dig +short CAA shop.example.com
dig +short CAA example.com

Ist der Name ein CNAME, zeigt dig zuerst das Ziel und dann dessen CAA-Records: Die Prüfung folgt dem Alias. Das ist die häufigste Überraschung, wenn eine Subdomain per CNAME auf einen Dienstleister zeigt, dessen CAA-Records die eigene CA nicht nennen.

Typische Fehlerbilder

Wenn die Zertifikatsausstellung an CAA scheitert, liegt es fast immer an einem dieser Punkte:

  • Die CA meldet sinngemäß „CAA record for example.com prevents issuance“: Der Record nennt eine andere CA. Ergänz einen issue-Record für die CA, die dein Hoster oder dein ACME-Client tatsächlich nutzt.
  • Wildcard-Zertifikat scheitert, das normale nicht: Ein issuewild-Record schließt die CA aus, issue erlaubt sie.
  • Hoster wechselt die CA: Viele Plattformen stellen ohne Ankündigung auf eine andere CA um. Ein enger CAA-Record blockiert dann die automatische Verlängerung.
  • SERVFAIL bei der Abfrage: Eine CA darf bei einem Fehler nicht ausstellen. Ursache ist oft DNSSEC oder ein Nameserver, der auf den Typ CAA nicht sauber antwortet.
  • Record im Editor als TXT angelegt: Dann ist es kein CAA-Record. Der Typ muss CAA sein; bietet der Hoster ihn nicht an, lässt sich CAA dort nicht setzen.
  • nslookup zeigt „rdata_257“: kein Fehler, nur die Darstellung des Typs 257.

Ohne Kommandozeile prüfen

Der CAA-Record Checker sucht den geltenden CAA-Satz vom Hostnamen aufwärts, zerlegt issue, issuewild und iodef und gleicht die erlaubten Zertifizierungsstellen mit dem Aussteller des Zertifikats ab, das der Server gerade ausliefert. So siehst du vor dem Ablauf, ob die nächste Verlängerung durchgeht. Was CAA im Zusammenspiel mit Certificate Transparency leistet, erklärt das Glossar.

Häufige Fragen

Wie frage ich einen CAA-Record mit dig ab?
dig +short CAA example.com. Jede Zeile der Antwort ist ein Record mit Flag, Eigenschaft (issue, issuewild, iodef) und Wert. Eine leere Antwort bedeutet, dass kein CAA-Record gesetzt ist.
Was passiert, wenn kein CAA-Record existiert?
Dann darf jede öffentlich anerkannte Zertifizierungsstelle ein Zertifikat ausstellen, sofern sie die Kontrolle über die Domain prüft. CAA ist freiwillig.
Funktioniert Resolve-DnsName mit CAA?
Nein. Der Parameter -Type von Resolve-DnsName kennt CAA nicht. Unter Windows hilft eine Abfrage über DNS-over-HTTPS oder ein Online-Check.
Gilt ein CAA-Record auch für Subdomains?
Ja, solange die Subdomain keinen eigenen CAA-Record hat. Die CA sucht vom genauen Namen aufwärts und nimmt den ersten Treffer.
Jetzt prüfen

CAA-Records kostenlos prüfen: issue, issuewild und iodef, abgeglichen mit der CA deines Zertifikats. Zeigt, ob die nächste Verlängerung scheitert.

DomainWarn prüft CAA-Records und Zertifikate aller Kundendomains regelmäßig und meldet Änderungen und ablaufende Zertifikate, bevor eine Verlängerung scheitert.

Diese Domain dauerhaft überwachen14 Tage kostenlos testen, keine Kreditkarte.

Weitere Anleitungen