What is a CAA record?
A CAA (certification authority authorization) record lists the certificate authorities that may issue certificates for a domain. Every public CA must check it before issuing.
Without a CAA record, any CA may issue. With one, a request to a CA that is not listed is refused, which limits the damage of a compromised account or a mistaken request.
How to read a CAA record
In a zone file, the record looks like this:
example.com. 3600 IN CAA 0 issue "letsencrypt.org"
- The flag: 0, or 128 for "critical".
- The tag: issue (normal certificates), issuewild (wildcard certificates) or iodef (where to report violations).
- The value: the CA's domain, or an address for reports.
From the command line
Look up CAA records without this site.
On macOS and Linux, use dig:
dig example.com CAA +short
On Windows, use nslookup:
nslookup -type=CAA example.com
To skip caches, ask one of the domain’s nameservers directly: dig @ns1.example.net example.com CAA. The “Its own nameservers” option on the result page does the same.
Questions and answers
My certificate renewal fails with a CAA error. What should I do?
Look up the CAA records of the domain and its parent domains. Add an issue record for your CA, or remove the record that excludes it.
Do subdomains need their own CAA record?
No. A CA climbs from the requested name through its parent domains, up to the top-level domain, and uses the first CAA record set it finds. A record at the main domain covers every subdomain.