Skip to content

Commit 37c4fef

Browse files
[DNS] Add note about subdomain setup and Access apps (#17589)
1 parent 6a1aef7 commit 37c4fef

File tree

3 files changed

+22
-4
lines changed

3 files changed

+22
-4
lines changed

src/content/docs/dns/zone-setups/subdomain-setup/index.mdx

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ sidebar:
66
label: About
77
---
88

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

1111
When you use a subdomain setup, you can manage the [Cloudflare configurations](/fundamentals/concepts/how-cloudflare-works/) for one or more subdomains separately from those associated with your <GlossaryTooltip term="apex domain">apex domain</GlossaryTooltip>. This means that, on your [account homepage](https://dash.cloudflare.com/?to=/:account/), you would find websites like `example.com` or `blog.example.com` listed as separate <GlossaryTooltip term="DNS zone">zones</GlossaryTooltip>.
1212

@@ -22,6 +22,10 @@ Subdomain setups are also useful when different subdomains require entirely diff
2222

2323
<FeatureTable id="dns.subdomain_setup" />
2424

25+
### Access applications
26+
27+
<Render file="subdomain-setup-access-apps" />
28+
2529
## Resources
2630

2731
<DirectoryListing />

src/content/docs/dns/zone-setups/subdomain-setup/setup/index.mdx

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -9,11 +9,11 @@ head:
99

1010
---
1111

12-
import { DirectoryListing, GlossaryTooltip } from "~/components"
12+
import { DirectoryListing, GlossaryTooltip, Render } from "~/components"
1313

1414
:::caution
1515

16-
Subdomain setup is only available for Enterprise accounts. If you only want to create a subdomain for your site in Cloudflare, refer to [Create a subdomain record](/dns/manage-dns-records/how-to/create-subdomain/).
16+
Subdomain setup is only available for Enterprise accounts. If you only want to create a subdomain for your site in Cloudflare, refer to [Create a subdomain record](/dns/manage-dns-records/how-to/create-subdomain/).
1717
:::
1818

1919
[Subdomain setup](/dns/zone-setups/subdomain-setup/) relies on a process known as delegation. When, in a parent domain such as `example.com`, an [`NS` record](https://www.cloudflare.com/learning/dns/dns-records/dns-ns-record/) is created for a subdomain `blog.example.com`, this means that DNS management for the subdomain can be done separately, in its own <GlossaryTooltip term="DNS zone" link="/dns/concepts/#zone">DNS zone</GlossaryTooltip>.
@@ -50,7 +50,7 @@ The availability of different setups will depend on both the parent zone setup a
5050

5151
:::caution[* Subdomain zones in partial setup are not delegated]
5252

53-
Subdomains using a partial setup represent an exception in the sense that [delegation](#subdomain-delegation) does not apply in this context. As explained in the dedicated [Partial (CNAME) setup section](/dns/zone-setups/partial-setup/), this setup is intended to simply proxy individual subdomains through Cloudflare. For completeness, however, this is listed as an option in this table and the [how-to guide](/dns/zone-setups/subdomain-setup/setup/parent-on-partial/) has detailed explanation on how to achieve a subdomain zone using partial setup.
53+
Subdomains using a partial setup represent an exception in the sense that [delegation](#subdomain-delegation) does not apply in this context. As explained in the dedicated [Partial (CNAME) setup section](/dns/zone-setups/partial-setup/), this setup is intended to simply proxy individual subdomains through Cloudflare. For completeness, however, this is listed as an option in this table and the [how-to guide](/dns/zone-setups/subdomain-setup/setup/parent-on-partial/) has detailed explanation on how to achieve a subdomain zone using partial setup.
5454
:::
5555

5656
This table assumes zones that are in an [active status](/dns/zone-setups/reference/domain-status/). For example, if you need to add the parent zone to Cloudflare when its child zone already exists in a partial setup, you can [convert the parent zone to partial](/dns/zone-setups/partial-setup/setup/#add-your-domain-to-cloudflare) while it is still in pending status.
@@ -72,3 +72,7 @@ Although the how-to guides in this documentation are focused on both parent doma
7272
If the parent domain's SSL/TLS certificate explicitly lists the delegated subdomain and is created after the subdomain's SSL/TLS own certificate, the parent domain's certificate will take precedence over the subdomain's certificate.
7373

7474
For instance, if `example.com` [creates an advanced certificate](/ssl/edge-certificates/advanced-certificate-manager/manage-certificates/) that directly lists `docs.example.com`, visitors to `docs.example.com` might see the SSL/TLS certificate for `example.com`.
75+
76+
## Access applications
77+
78+
<Render file="subdomain-setup-access-apps" />
Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
---
2+
{}
3+
4+
---
5+
6+
To use subdomain setups with [Cloudflare Access](/cloudflare-one/policies/access/), note that:
7+
8+
- If the child zone is in a pending state when you create the Access application, your configuration will not automatically apply when you activate the zone. You must also re-save the Access application once your subdomain setup is active.
9+
10+
- If you split out a subdomain which already has an Access application, you will also need to re-save the Access application to associate it with the new child zone.

0 commit comments

Comments
 (0)