Skip to content

Commit d18ba42

Browse files
[DNS, SSL] Update overall org and SSL options in partial-setup/setup (#17568)
* First pass: formatting and remove link to full setup guides * Further remove empty lines * Further remove empty lines * Move SSL/TLS section higher and separate new zone vs conversion * Fix broken link * Move SSL recommendations into prep and revamp other steps * Search for and replace broken anchors
1 parent 235e0c7 commit d18ba42

File tree

7 files changed

+40
-63
lines changed

7 files changed

+40
-63
lines changed

src/content/docs/dns/zone-setups/conversions/convert-partial-to-full.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@ At least 24 hours prior to converting your zone, disable DNSSEC at your authorit
3838
:::note
3939

4040

41-
As a best practice, you should also delete the previous [zone activation TXT record](/dns/zone-setups/partial-setup/setup/#add-your-domain-to-cloudflare) at your authoritative DNS provider. To locate this value in the Cloudflare dashboard, go to **DNS** > **Records** and find the **Verification TXT Record**.
41+
As a best practice, you should also delete the previous [zone activation TXT record](/dns/zone-setups/partial-setup/setup/#1-convert-your-zone-and-review-dns-records) at your authoritative DNS provider. To locate this value in the Cloudflare dashboard, go to **DNS** > **Records** and find the **Verification TXT Record**.
4242

4343

4444
:::

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ import { FeatureTable, Render } from "~/components"
1010

1111
<Render file="partial-setup-definition" />
1212

13-
Once you are on a partial setup, the actual resolution of your records to Cloudflare depends on `CNAME` records [added at your authoritative DNS provider](/dns/zone-setups/partial-setup/setup/#add-dns-records). Check your authoritative DNS provider to know which records are pointing to `{your-hostname}.cdn.cloudflare.net`.
13+
Once you are on a partial setup, the actual resolution of your records to Cloudflare depends on `CNAME` records [added at your authoritative DNS provider](/dns/zone-setups/partial-setup/setup/#3-add-dns-records). Check your authoritative DNS provider to know which records are pointing to `{your-hostname}.cdn.cloudflare.net`.
1414

1515
## How to
1616

src/content/docs/dns/zone-setups/partial-setup/setup.mdx

Lines changed: 32 additions & 55 deletions
Original file line numberDiff line numberDiff line change
@@ -9,97 +9,74 @@ head:
99

1010
---
1111

12-
import { Details, Render } from "~/components"
12+
import { Details, Render, GlossaryTooltip, Steps } from "~/components";
1313

1414
<Render file="partial-setup-definition" />
1515

1616
:::note
17-
18-
1917
A partial setup is only available to customers on a Business or Enterprise plan.
20-
21-
2218
:::
2319

2420
***
2521

26-
## Add your domain to Cloudflare
27-
28-
29-
1. Create a Cloudflare account and [add your domain](/fundamentals/setup/manage-domains/add-site/).
30-
31-
2. For your **Plan**, choose **Business** or **Enterprise**.
22+
## Before you begin
3223

33-
3. Continue through the onboarding steps, ignoring the instructions to change your nameservers.
24+
<Steps>
25+
1. Create a Cloudflare account and add your domain.
26+
2. Choose **Business** or **Enterprise** as your plan.
27+
3. If you are onboarding a new domain to Cloudflare, ignore the instructions to change your nameservers.
28+
4. (Recommended) Plan for SSL/TLS certificates:
3429

35-
4. On the **Overview** page, select **Convert to CNAME DNS Setup**.
30+
If you are only using [Universal SSL](/ssl/edge-certificates/universal-ssl/) prior to converting your zone, a certificate will be provisioned for your subdomains only after each of the respective DNS records ([step 3](#3-add-dns-records) below) are [proxied](/dns/manage-dns-records/reference/proxied-dns-records/). Refer to [Enable Universal SSL](/ssl/edge-certificates/universal-ssl/enable-universal-ssl/#partial-dns-setup) for details.
3631

37-
5. Select **Convert** to confirm.
32+
If your domain is sensitive to downtime, instead of using Universal SSL, consider using an [advanced certificate](/ssl/edge-certificates/advanced-certificate-manager/) with [delegated DCV](/ssl/edge-certificates/changing-dcv-method/methods/delegated-dcv/#setup).
33+
</Steps>
3834

39-
6. Save the information from the **Verification TXT Record**. If you lose the information, you can also access it by going to **DNS** > **Records** > **Verification TXT Record**.
35+
## 1. Convert your zone and review DNS records
4036

37+
<Steps>
38+
1. On the **Overview** page, select **Convert to CNAME DNS Setup**.
39+
2. Select **Convert** to confirm.
40+
3. Save the information from the **Verification TXT Record**. If you lose the information, you can also access it by going to **DNS** > **Records** > **Verification TXT Record**.
41+
4. Make sure that you have all the DNS records for subdomains that you want to proxy through Cloudflare.
42+
</Steps>
4143

42-
## Verify ownership for your domain
43-
44-
45-
Once you [add your domain to Cloudflare](#add-your-domain-to-cloudflare), add the **Verification TXT Record** at your authoritative DNS provider. Cloudflare will verify the TXT record and send a confirmation email. This can take up to a few hours.
44+
## 2. Verify ownership for your domain
4645

46+
Add the **Verification TXT Record** at your authoritative DNS provider. Cloudflare will verify the TXT record and send a confirmation email. This can take up to a few hours.
4747

4848
<Details header="Example verification record">
49-
5049
A verification record for `example.com` might be:
5150

5251
| Type | Name | Content |
5352
| ---- | ------------------------------- | ------------------- |
5453
| TXT | `cloudflare-verify.example.com` | 966215192-518620144 |
55-
56-
5754
</Details>
5855

5956
:::note
60-
61-
6257
If your authoritative DNS provider automatically appends DNS record `name` fields with your domain, make sure to only insert `cloudflare-verify` as the record name. Otherwise, it may result in an incorrect record name, such as `cloudflare-verify.example.com.example.com`.
6358

6459
After creating the record, you can use this [Dig Web Interface link](https://digwebinterface.com/?type=TXT\&ns=auth\&nameservers=) to search (`dig`) for `cloudflare-verify.<YOUR DOMAIN>` and validate if it is working.
65-
66-
6760
:::
6861

6962
That record must remain in place for as long as your domain is active on the partial setup on Cloudflare.
7063

64+
## 3. Add DNS records
7165

72-
## Optional - Provision an SSL certificate
73-
74-
75-
To provision a Universal SSL certificate through Cloudflare, follow [these instructions](/ssl/edge-certificates/universal-ssl/enable-universal-ssl/#partial-dns-setup).
76-
77-
If your domain is already live with a partial (CNAME) setup — with Cloudflare or another DNS provider — you cannot use a TXT record for [Domain Control Validation](/ssl/edge-certificates/changing-dcv-method/methods/txt/). That domain's TXT record needs to be reserved for forwarding traffic to Cloudflare.
78-
79-
80-
## Add DNS records
81-
82-
83-
1. In Cloudflare, [add an `A`, `AAAA`, or `CNAME` record](/dns/manage-dns-records/how-to/create-dns-records/).
84-
2. At your authoritative DNS provider:
85-
86-
1. Remove any existing `A`, `AAAA`, or `CNAME` records on the hostname you want to proxy to Cloudflare.
87-
88-
2. Add a `CNAME` record for `{your-hostname}.cdn.cloudflare.net`.
89-
90-
<details>
91-
<summary>
92-
Example CNAME record at authoritative DNS provider
93-
</summary>
94-
95-
The `CNAME` record for `www.example.com` would be:
66+
<Steps>
67+
1. At your authoritative DNS provider:
68+
1. Create `CNAME` records pointing to `{your-hostname}.cdn.cloudflare.net` for every hostname you wish to proxy through Cloudflare.
9669

97-
```txt
98-
www.example.com CNAME www.example.com.cdn.cloudflare.net
99-
```
70+
<Details header="Example CNAME record at authoritative DNS provider">
10071

101-
</details>
72+
The `CNAME` record for `www.example.com` would be:
10273

103-
3. Repeat this process for each subdomain proxied to Cloudflare.
74+
```txt
75+
www.example.com CNAME www.example.com.cdn.cloudflare.net
76+
```
77+
</Details>
10478

79+
2. Remove any previously existing `A`, `AAAA`, or `CNAME` records referencing the hostnames you want to proxy through Cloudflare. For these hostnames, leave only the records pointing to `{your-hostname}.cdn.cloudflare.net`.
10580

81+
2. Repeat this process for each subdomain that should be proxied to Cloudflare.
82+
</Steps>

src/content/docs/dns/zone-setups/reference/domain-status.mdx

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ F[Purged]
3636

3737
:::note
3838

39-
If you use the API to add your website or application to Cloudflare, your zone will be created directly in a **Pending** status. **Initializing** only applies to domains added via the dashboard.
39+
If you use the API to add your website or application to Cloudflare, your zone will be created directly in a **Pending** status. **Initializing** only applies to domains added via the dashboard.
4040
:::
4141

4242
## Initializing (Setup)
@@ -68,7 +68,7 @@ If you have mistakenly added a zone to your account it will appear as pending. I
6868

6969
## Active
7070

71-
Cloudflare has authenticated your [nameserver changes](/dns/nameservers/update-nameservers/) or [verification TXT record](/dns/zone-setups/partial-setup/setup/#verify-ownership-for-your-domain) and you can proxy domain traffic through Cloudflare. For more details refer to [How Cloudflare works](/fundamentals/concepts/how-cloudflare-works/) and [Domain configurations](/fundamentals/setup/manage-domains/connect-your-domain/#domain-configurations).
71+
Cloudflare has authenticated your [nameserver changes](/dns/nameservers/update-nameservers/) or [verification TXT record](/dns/zone-setups/partial-setup/setup/#2-verify-ownership-for-your-domain) and you can proxy domain traffic through Cloudflare. For more details refer to [How Cloudflare works](/fundamentals/concepts/how-cloudflare-works/) and [Domain configurations](/fundamentals/setup/manage-domains/connect-your-domain/#domain-configurations).
7272

7373
## Moved
7474

@@ -78,7 +78,7 @@ Zones that do not have any active paid subscriptions and have been moved will be
7878

7979
:::caution
8080

81-
If you have an active paid subscription and no longer wish to use Cloudflare, make sure to also [manually remove your domain](/fundamentals/setup/manage-domains/remove-domain/).
81+
If you have an active paid subscription and no longer wish to use Cloudflare, make sure to also [manually remove your domain](/fundamentals/setup/manage-domains/remove-domain/).
8282
:::
8383

8484
## Deleted

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -53,7 +53,7 @@ The availability of different setups will depend on both the parent zone setup a
5353
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

56-
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.
56+
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/#1-convert-your-zone-and-review-dns-records) while it is still in pending status.
5757

5858
***
5959

src/content/docs/ssl/edge-certificates/changing-dcv-method/methods/http.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,7 @@ To make sure your domain does not accidentally block HTTP DCV, review your Cloud
4747

4848
### Complete DCV
4949

50-
Your HTTP token will be available for the Certificate Authority as soon as you finish your [partial domain setup](/dns/zone-setups/partial-setup/setup/#add-dns-records).
50+
Your HTTP token will be available for the Certificate Authority as soon as you finish your [partial domain setup](/dns/zone-setups/partial-setup/setup/#3-add-dns-records).
5151

5252
This means that you need to add a CNAME record to Cloudflare in your authoritative DNS and create [proxied DNS records](/dns/manage-dns-records/reference/proxied-dns-records/) for your hostname within Cloudflare.
5353

src/content/docs/ssl/edge-certificates/universal-ssl/enable-universal-ssl.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ If your domain is using a **partial setup**, you will need to add [Domain Contro
3232

3333
For non-authoritative or [partial domains](/dns/zone-setups/partial-setup/), Universal SSL will be:
3434

35-
* Provisioned once the DNS record is [proxied through Cloudflare](/dns/zone-setups/partial-setup/setup/#add-dns-records).
35+
* Provisioned once the DNS record is [proxied through Cloudflare](/dns/zone-setups/partial-setup/setup/#3-add-dns-records).
3636
* Validated:
3737

3838
* Immediately if you add [Domain Control Validation (DCV)](/ssl/edge-certificates/changing-dcv-method/) records to your authoritative DNS.

0 commit comments

Comments
 (0)