Skip to content

Commit 49ae345

Browse files
authored
Some grammar, some structure
1 parent e5253c0 commit 49ae345

File tree

1 file changed

+21
-22
lines changed

1 file changed

+21
-22
lines changed
Lines changed: 21 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1,33 +1,38 @@
11
# Hostname Pre-Validation
22

3-
In typical scenarios, the recommended approach for hostname validation in Umbraco Cloud is to point your Domain Name System (DNS) directly to Umbraco Cloud. The platform handles the process from start to finish. However, this may not be suitable for all environmentssuch as when working with production domains where zero downtime is critical.
3+
In typical scenarios, the recommended approach for hostname validation in Umbraco Cloud is to point your Domain Name System (DNS) directly to Umbraco Cloud. The platform handles the process from start to finish. However, this may not be suitable for all environments, such as when working with production domains where zero downtime is critical.
44

5-
In such cases, Umbraco Cloud supports using a pre-validation method. You can complete hostname validation and Transport Layer Security (TLS) certificate issuance before switching your live DNS over. This approach ensures a seamless transition with no interruptions in service.
5+
In these cases, Umbraco Cloud supports using a pre-validation method. You can complete hostname validation and Transport Layer Security (TLS) certificate issuance before switching over your live DNS. This approach ensures a seamless transition with no interruptions in service.
66

77
## When to Use Hostname Pre-Validation
88

99
Use pre-validation when:
10+
1011
- You're dealing with live or production domains that require 100% uptime.
1112
- You want to avoid the brief downtime that may occur while TLS certificates are being validated after pointing DNS to Umbraco Cloud.
1213

1314
## How to Use Hostname Pre-Validation
1415

16+
The following steps outline how to use hostname pre-validation.
17+
1518
### 1. Enable Pre-Validation for the Hostname
1619

17-
After adding your custom hostname in the Umbraco Cloud Portal, navigate to the Hostname Settings. Toggle the Pre-Validation option to enable it.
20+
After adding your custom hostname in the Umbraco Cloud Portal:
1821

19-
Umbraco Cloud will then provide two DNS records:
22+
1. Navigate to **Hostname Settings**.
23+
2. Toggle the Pre-Validation option to enable it.
2024

21-
- A **TXT** record used to verify domain ownership.
25+
Umbraco Cloud will provide two DNS records:
2226

23-
- A **CNAME** record required for the TLS certificate issuance.
27+
- A **TXT** record used to verify domain ownership.
28+
- A **CNAME** record that is required for the TLS certificate issuance.
2429

2530
<figure><img src="images/hostname-settings-modal.png" alt="This is an image of the Hostname settings modal"></figure>
2631

27-
2832
### 2. Add DNS Records at Your Domain Registrar
2933

30-
Log in to your DNS provider or domain registrar and add the records provided:
34+
1. Log in to your DNS provider or domain registrar.
35+
2. Add the records provided:
3136

3237
- **TXT Record:**
3338

@@ -50,40 +55,34 @@ DNS propagation times can vary. Changes may take a few minutes to several hours
5055

5156
Return to the Hostname page in Umbraco Cloud. You'll see a Hostname Information Box showing the current status of your validation.
5257

53-
The status will change to Active when everything is set up correctly. The hostname will have been validated and the TLS certificate has been issued.
58+
The status will change to Active when everything is set up correctly. The hostname is validated, and the TLS certificate issued.
5459

5560
<figure><img src="images/pre-validation-status-modal.png" alt="This is an image of the Pre-Validation status modal"></figure>
5661

5762
pre-validation-status-modal
5863

5964
### 4. Point Your DNS to Umbraco Cloud
6065

61-
Once the certificate is issued:
62-
63-
- Update your domain's A record or CNAME to point to the Umbraco Cloud DNS (add link).
64-
65-
- Your site will be accessible securely via HTTPS without any downtime because the certificate is already in place.
66+
Once the certificate is issued, update your domain's A record or CNAME to point to the Umbraco Cloud DNS (add link).
6667

68+
Your site will be accessible securely via HTTPS without any downtime because the certificate is already in place.
6769

6870
### 5. Disable Pre-Validation and Clean Up DNS Records
6971

7072
After the hostname is active and secure:
7173

72-
- Go back to Hostname Settings and disable the pre-validation method.
73-
74-
- Remove the TXT and CNAME records you added for pre-validation.
75-
76-
Umbraco Cloud will automatically handle future certificate renewals without requiring manual DNS management.
74+
1. Go back to Hostname Settings and disable the pre-validation method.
75+
2. Remove the TXT and CNAME records you added for pre-validation.
7776

77+
Umbraco Cloud will automatically handle future certificate renewals without the need for manual DNS management.
7878

7979
## Custom Certificate
8080

8181
If you plan to use a [custom certificate](security-certificates), the Hostname Pre-Validation method can be used to prove ownership of the hostname before binding the custom certificate.
8282

83-
You can do this by:
83+
You can do this by following these steps:
8484

8585
1. Enable Pre-Validation for the Hostname.
8686
2. Add the TXT record provided to your Domain Name System (DNS) settings. The record will prove ownership of the domain.
8787
3. Upload a custom certificate and set a binding to the Hostname.
88-
4. Wait a couple of minutes then disable Pre-Validation for the Hostname. The status will now show "Manual" for the Hostname.
89-
88+
4. Wait a couple of minutes, then disable Pre-Validation for the Hostname. The status will now show "Manual" for the Hostname.

0 commit comments

Comments
 (0)