Skip to content

Commit 0f0a6aa

Browse files
RebeccaTamachiromaxvp
authored andcommitted
[DNS] Call out differences between standard vs advanced NS (#23504)
* Introduce new limitations section for advanced NS * Expand to more general considerations and move to setup.mdx * Text review and add example DNS table for delegation * Re-add note on Advanced NS vs Custom NS to concept page * Use specific header for more emphasis and better linking * Nest DNSSEC keys under Advanced NS in Foundation DNS features * Add note on advanced ns vs custom in account-custom-nameservers * Further clarify advanced-vs-custom NS and align with UI messaging * Revert "Nest DNSSEC keys under Advanced NS in Foundation DNS features" This reverts commit 459ff3b. * Replace 'zone' by 'account' in features list * Create dedicated page explaining Foundation DNSSEC keys * Add clarification on how to get unique DNSSEC keys * Apply suggestions from code review Co-authored-by: Max Phillips <[email protected]> --------- Co-authored-by: Max Phillips <[email protected]>
1 parent 6c63acd commit 0f0a6aa

File tree

6 files changed

+58
-6
lines changed

6 files changed

+58
-6
lines changed

src/content/docs/dns/foundation-dns/advanced-nameservers.mdx

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,8 +12,9 @@ Advanced nameservers included with [Foundation DNS](/dns/foundation-dns/) offer
1212

1313
Consider the sections below for details about advanced nameservers, and refer to [Set up advanced nameservers](/dns/foundation-dns/setup/) to learn how to enable this feature.
1414

15-
:::caution
16-
<Render file="ns-advanced-vs-custom" />
15+
:::note
16+
<Render file="ns-advanced-vs-custom" />
17+
Also, [some behaviors are different](/dns/foundation-dns/setup/#differences-from-standard-nameservers) when compared to standard nameservers.
1718
:::
1819

1920
## Anycast network groups
Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
---
2+
pcx_content_type: reference
3+
title: DNSSEC keys
4+
sidebar:
5+
order: 5
6+
7+
---
8+
9+
With [Foundation DNS](/dns/foundation-dns/), you can request that the ZSK/KSK pair that is used for [DNSSEC](/dns/dnssec/) is unique to your Cloudflare account. To opt in to this feature, contact your account team.
10+
11+
All zones within your Cloudflare account - regardless of using [standard](/dns/nameservers/#standard-nameservers) or [advanced nameservers](/dns/foundation-dns/advanced-nameservers/) - will use the dedicated Zone Signing Key (ZSK) and Key Signing Key (KSK) for DNSSEC. These keys are set at the account level.
12+
13+
## Further reading
14+
15+
For more background information, refer to [How DNSSEC works](https://www.cloudflare.com/learning/dns/dnssec/how-dnssec-works/).
16+
17+
For details about DNSSEC settings at Cloudflare, refer to the [DNSSEC documentation](/dns/dnssec/).

src/content/docs/dns/foundation-dns/index.mdx

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ With Foundation DNS, you get access to increased reliability, security, and insi
1414
* Strategically distributed IPs to enhance resiliency
1515
* Reduced exposure to incidents or software regression
1616
* More consistent nameserver assignment
17-
* DNSSEC keys unique to your zone
17+
* [DNSSEC keys](/dns/foundation-dns/dnssec-keys/) unique to your account
1818
* Additional DNS settings, including:
1919
* [Zone defaults](/dns/additional-options/dns-zone-defaults/)
2020
* [Account custom nameservers](/dns/nameservers/custom-nameservers/account-custom-nameservers/)
@@ -24,7 +24,9 @@ With Foundation DNS, you get access to increased reliability, security, and insi
2424

2525
Foundation DNS is only available to Enterprise customers.
2626

27-
Advanced nameservers are an opt-in configuration. Refer to [set up advanced nameservers](/dns/foundation-dns/setup/).
27+
:::note
28+
Both advanced nameservers and unique ZSK/KSK are opt-in configurations. Refer to [set up advanced nameservers](/dns/foundation-dns/setup/) and [DNSSEC keys](/dns/foundation-dns/dnssec-keys/) for details.
29+
:::
2830

2931
## Related resources
3032

src/content/docs/dns/foundation-dns/setup.mdx

Lines changed: 29 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,10 +6,38 @@ sidebar:
66
label: Setup
77
---
88

9-
import { TabItem, Tabs, APIRequest } from "~/components";
9+
import { TabItem, Tabs, APIRequest, Render, Details, Example } from "~/components";
1010

1111
Advanced nameservers included with [Foundation DNS](/dns/foundation-dns/) are an opt-in configuration.
1212

13+
14+
## Before you begin
15+
16+
Before opting in for advanced nameservers, consider the following:
17+
18+
- <Render file="ns-advanced-vs-custom" />
19+
20+
### Differences from standard nameservers
21+
22+
Some behaviors are different from standard Cloudflare nameservers:
23+
- Wildcard records: if moving from standard Cloudflare nameservers to Foundation DNS advanced nameservers, make sure to explicitly create records for subdomains currently covered by wildcard records (`*.example.com`).
24+
- Subdomain delegation: once a subdomain is delegated via NS records, Cloudflare will not serve any other records (such as A, TXT, or CNAME) on that subdomain from the parent zone, even if those records exist.
25+
26+
<Details header="Example">
27+
28+
<Example>
29+
DNS management for **example.com**
30+
| **Type** | **Name** | **Content** |
31+
| -------- | -------- | ------------------------- |
32+
| NS | www | ns1.externalhost.com |
33+
| NS | www | ns2.externalhost.com |
34+
| TXT | www | "5bb16e6b5a444eedb48ace40c471bcc9" |
35+
| A | www | `192.0.2.1` |
36+
</Example>
37+
38+
In this example, the TXT record and the A record for `www.example.com` will not be served.
39+
</Details>
40+
1341
## Enable on a zone
1442

1543
To enable advanced nameservers on an existing zone:

src/content/docs/dns/nameservers/custom-nameservers/account-custom-nameservers.mdx

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,10 @@ import { Example, Render, Tabs, TabItem } from "~/components"
2020

2121
Account custom nameservers are available for customers on Business (after [contacting Cloudflare Support](/support/contacting-cloudflare-support/)) or Enterprise plans. Once configured, account custom nameservers can be used by all zones in the account, regardless of the zone plan. Via API or on the dashboard.
2222

23+
:::note
24+
<Render file="ns-advanced-vs-custom" />
25+
:::
26+
2327
## Configuration conditions
2428

2529
For this configuration to be possible, a few conditions apply:

src/content/partials/dns/ns-advanced-vs-custom.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,4 +3,4 @@
33

44
---
55

6-
The advantages that come with Foundation DNS [advanced nameservers](/dns/foundation-dns/advanced-nameservers/) are currently not available for [custom nameservers](/dns/nameservers/custom-nameservers/).
6+
The advantages that come with Foundation DNS [advanced nameservers](/dns/foundation-dns/advanced-nameservers/) are currently not available for [custom nameservers](/dns/nameservers/custom-nameservers/). Make sure you only use one at a time.

0 commit comments

Comments
 (0)