Skip to content

Commit 53bf5dd

Browse files
Create dedicated pages to reference zones and internal records
1 parent 938dbf6 commit 53bf5dd

File tree

5 files changed

+32
-29
lines changed

5 files changed

+32
-29
lines changed

src/content/docs/dns/internal-dns/get-started.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,7 @@ Although there are some steps that can be achieved on the dashboard, currently t
4747

4848
### (Optional) Reference a zone from another zone
4949

50-
1. Use the [Update DNS settings](/api/resources/dns/subresources/settings/methods/edit/) endpoint to add a reference from an internal zone to another internal zone. In `--data`, specify the `internal_dns` object with the parameter `reference_zone_id`. For details, refer to [reference zones](/dns/internal-dns/internal-zones/#reference-zones).
50+
1. Use the [Update DNS settings](/api/resources/dns/subresources/settings/methods/edit/) endpoint to add a reference from an internal zone to another internal zone. In `--data`, specify the `internal_dns` object with the parameter `reference_zone_id`. For details, refer to [reference zones](/dns/internal-dns/internal-zones/reference-zones/).
5151

5252
<Example>
5353
<Render file="internal-reference-zone-api"/>

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -76,7 +76,7 @@ flowchart LR
7676
end
7777
```
7878

79-
Internal DNS zones contain the <GlossaryTooltip term="DNS record" link="/dns/internal-dns/internal-zones/#internal-dns-records">DNS records</ GlossaryTooltip> that should be used to resolve an internal DNS query. Also, if no internal record is found within a matching internal zone, Cloudflare will check if the matching internal zone is [referencing another internal zone](/dns/internal-dns/internal-zones/#reference-zones).
79+
Internal DNS zones contain the <GlossaryTooltip term="DNS record" link="/dns/internal-dns/internal-zones/internal-dns-records/">DNS records</ GlossaryTooltip> that should be used to resolve an internal DNS query. Also, if no internal record is found within a matching internal zone, Cloudflare will check if the matching internal zone is [referencing another internal zone](/dns/internal-dns/internal-zones/reference-zones/).
8080

8181
<Example>
8282

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

Lines changed: 4 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -7,35 +7,14 @@ sidebar:
77
label: Internal zones
88
---
99

10-
import { Example, Render } from "~/components";
10+
import { Example, Render, DirectoryListing } from "~/components";
1111

12-
Internal DNS zones are groupings of internal DNS records. While [public DNS records](/dns/manage-dns-records/) contain information about resources that you want to make available to the public Internet, [internal DNS records](#internal-dns-records) allow you to manage resources that should only be available within your private network.
12+
Internal DNS zones are groupings of internal DNS records. While [public DNS records](/dns/manage-dns-records/) contain information about resources that you want to make available to the public Internet, [internal DNS records](/dns/internal-dns/internal-zones/internal-dns-records/) allow you to manage resources that should only be available within your private network.
1313

1414
Refer to [Manage internal zones](/dns/internal-dns/internal-zones/setup/) for a full list of configuration conditions and step-by-step instructions.
1515

1616
Internal DNS zones do not get assigned Cloudflare nameservers and can only be queried via [Cloudflare Gateway](/cloudflare-one/policies/gateway/resolver-policies/) when linked to a [DNS view](/dns/internal-dns/dns-views/). The Gateway configuration must exist within the same Cloudflare account where the internal zone exists.
1717

18-
## Reference zones
18+
## Resources
1919

20-
<Render file="reference-zone-intro" />
21-
22-
Refer to [Set up reference zones](/dns/internal-dns/internal-zones/reference-zones/) for step-by-step instructions.
23-
24-
## Internal DNS records
25-
26-
Internal zones can contain the same [DNS record types](/dns/manage-dns-records/reference/dns-record-types/) that Cloudflare supports for public zones.
27-
28-
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.
29-
30-
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.
31-
32-
### CNAME flattening
33-
34-
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.
35-
36-
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:
37-
38-
1. The CNAME record is returned to Gateway resolver as-is.
39-
2. Gateway resolver will process the returned record, depending on the **Fallback through public DNS** configuration:
40-
- 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/)).
41-
- Off: Gateway will return the response as-is to the client.
20+
<DirectoryListing />
Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
---
2+
pcx_content_type: concept
3+
title: Manage internal DNS records
4+
sidebar:
5+
order: 4
6+
label: Internal DNS records
7+
---
8+
9+
Internal zones can contain the same [DNS record types](/dns/manage-dns-records/reference/dns-record-types/) that Cloudflare supports for public zones.
10+
11+
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.
12+
13+
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.
14+
15+
### CNAME flattening
16+
17+
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.
18+
19+
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:
20+
21+
1. The CNAME record is returned to Gateway resolver as-is.
22+
2. Gateway resolver will process the returned record, depending on the **Fallback through public DNS** configuration:
23+
- 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/)).
24+
- Off: Gateway will return the response as-is to the client.

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
pcx_content_type: how-to
3-
title: Set up reference zones
3+
title: Reference zones
44
sidebar:
55
order: 4
66
---
@@ -9,7 +9,7 @@ import { Example, Render } from "~/components";
99

1010
<Render file="reference-zone-intro" />
1111

12-
## Steps
12+
## Set up
1313

1414
To set up a reference zone, use the [Update DNS settings](/api/resources/dns/subresources/settings/methods/edit/) endpoint. In `--data`, specify the `internal_dns` object with the parameter `reference_zone_id`.
1515

0 commit comments

Comments
 (0)