diff --git a/content/docs/configuration/acme/dns01/README.md b/content/docs/configuration/acme/dns01/README.md index a19ff32874f..68e2aebf736 100644 --- a/content/docs/configuration/acme/dns01/README.md +++ b/content/docs/configuration/acme/dns01/README.md @@ -138,6 +138,19 @@ _acme-challenge.bar.example.com IN CNAME _acme-challenge.less-privileged.example With this configuration cert-manager will follow CNAME records recursively in order to determine which DNS zone to update during DNS01 challenges. +> ⚠️ With `cnameStrategy: Follow`, cert-manager follows *any* CNAME record +> found at `_acme-challenge.`, including one synthesized by a +> wildcard record. For example, a record like +> `*.example.com IN CNAME lb.example.org` also answers CNAME queries for +> `_acme-challenge.example.com`, so cert-manager will try to create the +> challenge TXT record at `lb.example.org` — typically failing with an error +> such as Route 53's +> `RRSet with DNS name lb.example.org. is not permitted in zone example.com.`. +> To avoid this, create an explicit record at `_acme-challenge.` +> (an exact-match name prevents wildcard synthesis), or use the default +> `cnameStrategy: None` if you are not delegating challenges to another +> zone. + ## Supported DNS01 providers