Skip to content

Commit 08b11a6

Browse files
Re-org internal-zones as folder with concept and how-to pages
1 parent d8a2393 commit 08b11a6

File tree

3 files changed

+56
-26
lines changed

3 files changed

+56
-26
lines changed
Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
---
2+
pcx_content_type: concept
3+
title: Internal zones
4+
sidebar:
5+
order: 2
6+
group:
7+
label: Internal zones
8+
---
9+
10+
import { Example, Render } from "~/components";
11+
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.
13+
14+
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.
15+
16+
## Reference zones
17+
18+
During an [internal DNS query resolution](/dns/internal-dns/#architecture-overview), if no internal record is found within a matching internal zone, Cloudflare will check if the matching internal zone is referencing another internal zone.
19+
20+
Successive references can be followed with a maximum of five references in a chain.
21+
22+
Each internal zone can only reference one other zone, but the same zone can be referenced by multiple internal zones. Public zones cannot be used as reference zones.
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.
Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
---
2+
pcx_content_type: how-to
3+
title: Set up reference zones
4+
sidebar:
5+
order: 4
6+
---
7+
8+
import { Example, Render } from "~/components";
9+
10+
During an [internal DNS query resolution](/dns/internal-dns/#architecture-overview), if no internal record is found within a matching internal zone, Cloudflare will check if the matching internal zone is referencing another internal zone.
11+
12+
Successive references can be followed with a maximum of five references in a chain.
13+
14+
Each internal zone can only reference one other zone, but the same zone can be referenced by multiple internal zones. Public zones cannot be used as reference zones.
15+
16+
## Steps
17+
18+
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`.
19+
20+
<Example>
21+
<Render file="internal-reference-zone-api"/>
22+
23+
A third zone (C) could also point to zone B as a reference, but zone A cannot add another zone as a reference while also having zone B configured as its reference zone.
24+
25+
</ Example>

src/content/docs/dns/internal-dns/internal-zones.mdx renamed to src/content/docs/dns/internal-dns/internal-zones/setup.mdx

Lines changed: 1 addition & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -3,14 +3,11 @@ pcx_content_type: how-to
33
title: Manage internal zones
44
sidebar:
55
order: 2
6-
label: Internal zones
76
---
87

98
import { Example, Render } from "~/components";
109

11-
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 allow you to manage resources that should only be available within your private network.
12-
13-
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.
10+
Refer to the following sections to learn how to manage your internal DNS zones.
1411

1512
## Configuration conditions
1613

@@ -28,28 +25,6 @@ When setting up internal zones, observe the following conditions:
2825

2926
Since the resolver policy configuration will require a view, you must link the internal zones to at least one view to be able to use them when routing requests to Internal DNS. For a full procedure overview, refer to [get started](/dns/internal-dns/get-started/).
3027

31-
## Reference zones
32-
33-
### How it works
34-
35-
During an [internal DNS query resolution](/dns/internal-dns/#architecture-overview), if no internal record is found within a matching internal zone, Cloudflare will check if the matching internal zone is referencing another internal zone.
36-
37-
Successive references can be followed with a maximum of five references in a chain.
38-
39-
### Setup
40-
41-
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`.
42-
43-
Each internal zone can only reference one other zone, but the same zone can be referenced by multiple internal zones.
44-
45-
Public zones cannot be used as reference zones.
46-
47-
<Example>
48-
<Render file="internal-reference-zone-api"/>
49-
50-
A third zone (C) could also point to zone B as a reference, but zone A cannot add another zone as a reference while also having zone B configured as its reference zone.
51-
52-
</ Example>
5328

5429
## Other actions
5530

0 commit comments

Comments
 (0)