Skip to content

Commit 23d14e9

Browse files
Add info about CNAME flatenning to iDNS docs
1 parent 647e895 commit 23d14e9

File tree

3 files changed

+18
-7
lines changed

3 files changed

+18
-7
lines changed

src/content/docs/dns/cname-flattening/index.mdx

Lines changed: 2 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -6,16 +6,12 @@ sidebar:
66
label: About
77
---
88

9-
import { Render } from "~/components"
9+
import { Render, GlossaryTooltip } from "~/components"
1010

11-
CNAME flattening speeds up CNAME resolution and allows you to use a CNAME record at your root/apex domain (`example.com`).
11+
CNAME flattening speeds up CNAME resolution and allows you to use a CNAME record at your <GlossaryTooltip term="zone apex" link="/dns/concepts/#zone-apex">zone apex</GlossaryTooltip> (`example.com`).
1212

1313
:::note
14-
15-
1614
This functionality is also what allows you to use a [root custom domain](/pages/configuration/custom-domains/) with a Cloudflare Pages site.
17-
18-
1915
:::
2016

2117
## How it works

src/content/docs/dns/internal-dns/internal-zones/index.mdx

Lines changed: 12 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,4 +29,15 @@ Internal zones can contain the same [DNS record types](/dns/manage-dns-records/r
2929

3030
You can manage internal DNS records in the same way as you would manage public DNS records, with the difference that [proxy status](/dns/proxy-status/) does not apply to internal DNS records.
3131

32-
Refer to [Manage DNS records](/dns/manage-dns-records/how-to/create-dns-records/) or to the [API documentation](/api/resources/dns/subresources/records/) for further guidance.
32+
Refer to [Manage DNS records](/dns/manage-dns-records/how-to/create-dns-records/) or to the [API documentation](/api/resources/dns/subresources/records/) for further guidance.
33+
34+
### CNAME flattening
35+
36+
With CNAME flattening, Cloudflare finds the IP address that a CNAME points to and then returns the final IP address instead of a CNAME record. With Internal DNS, this behavior is applied by default and cannot be turned off.
37+
38+
Cloudflare will try to flatten the CNAME record within the same [DNS view](/dns/internal-dns/dns-views/). If that is not possible, the following will happen:
39+
40+
1. The CNAME record is returned to Gateway resolver as-is.
41+
2. Gateway resolver will process the returned record, depending on the **Fallback through public DNS** configuration:
42+
- On: Gateway will try to resolve the query by sending it to Cloudflare's public DNS resolver ([1.1.1.1](/1.1.1.1/)).
43+
- Off: Gateway will return the response as-is to the client.

src/content/glossary/dns.yaml

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -79,3 +79,7 @@ entries:
7979
When a [DNS record is proxied](/dns/proxy-status/), requests are processed according to your configurations, and Cloudflare can optimize, cache, and protect your domain. Refer to [How Cloudflare works](/fundamentals/concepts/how-cloudflare-works/) for details.
8080
associated_products:
8181
- Fundamentals
82+
83+
- term: zone apex
84+
general_definition: |-
85+
zone apex refers to the domain or subdomain on which the control of DNS records starts.

0 commit comments

Comments
 (0)