You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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.
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
+
<Renderfile="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.
Copy file name to clipboardExpand all lines: src/content/docs/dns/internal-dns/internal-zones/setup.mdx
+1-26Lines changed: 1 addition & 26 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,14 +3,11 @@ pcx_content_type: how-to
3
3
title: Manage internal zones
4
4
sidebar:
5
5
order: 2
6
-
label: Internal zones
7
6
---
8
7
9
8
import { Example, Render } from"~/components";
10
9
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.
14
11
15
12
## Configuration conditions
16
13
@@ -28,28 +25,6 @@ When setting up internal zones, observe the following conditions:
28
25
29
26
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/).
30
27
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
-
<Renderfile="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.
0 commit comments