Skip to content

Commit 2804f5f

Browse files
[SSL, SaaS] Explain cloudflare_branding for hostnames over 64 characters (#18097)
* Add references to cloudflare_branding within SSL/TLS tile * Add explanation to CH docs and improve RFC links consistency
1 parent 61b3e71 commit 2804f5f

File tree

4 files changed

+34
-4
lines changed

4 files changed

+34
-4
lines changed

src/content/docs/cloudflare-for-platforms/cloudflare-for-saas/domain-support/create-custom-hostnames.mdx

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -28,3 +28,18 @@ To create a custom hostname:
2828
</TabItem> </Tabs>
2929

3030
<Render file="issue-certs-preamble" />
31+
32+
33+
## Hostnames over 64 characters
34+
35+
The Common Name (CN) restriction establishes a limit of 64 characters ([RFC 5280](https://www.rfc-editor.org/rfc/rfc5280.html)). If you have a hostname that exceeds this length, you can set `cloudflare_branding` to `true` when creating your custom hostnames [via API](/api/operations/custom-hostname-for-a-zone-create-custom-hostname).
36+
37+
```txt
38+
39+
"ssl": {
40+
"cloudflare_branding": true
41+
}
42+
43+
```
44+
45+
Cloudflare branding means that `sni.cloudflaressl.com` will be added as the certificate Common Name (CN) and the long hostname will be included as a part of the Subject Alternative Name (SAN).

src/content/docs/cloudflare-for-platforms/cloudflare-for-saas/reference/troubleshooting.mdx

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -110,3 +110,15 @@ Refer to the [full migration guide](/ssl/reference/migration-guides/lets-encrypt
110110

111111
The [zone hold feature](/fundamentals/setup/account/account-security/zone-holds/) is a toggle that will prevent their zone from being activated on other Cloudflare account.
112112
When the option `Also prevent subdomains` is enabled, this prevents the verification of custom hostnames for this domain. The custom hostname will remain in the `Blocked` status, with the following error message: `The hostname is associated with a held zone. Please contact the owner of this domain to have the hold removed.` In this case, the owner of the zone needs to [release the hold](/fundamentals/setup/account/account-security/zone-holds/#release-zone-holds) before the custom hostname can become activated.
113+
114+
## Hostnames over 64 characters
115+
116+
The Common Name (CN) restriction establishes a limit of 64 characters ([RFC 5280](https://www.rfc-editor.org/rfc/rfc5280.html)). If you have a hostname that exceeds this length, you may find the following error:
117+
118+
```txt
119+
Since no host is 64 characters or fewer, Cloudflare Branding is required. Please check your input and try again. (1469)
120+
```
121+
122+
To solve this, you can set `cloudflare_branding` to `true` when [creating your custom hostnames](/cloudflare-for-platforms/cloudflare-for-saas/domain-support/create-custom-hostnames/#hostnames-over-64-characters) via API.
123+
124+
Cloudflare branding means that `sni.cloudflaressl.com` will be added as the certificate Common Name (CN) and the long hostname will be included as a part of the Subject Alternative Name (SAN).

src/content/docs/ssl/edge-certificates/advanced-certificate-manager/manage-certificates.mdx

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -25,16 +25,19 @@ To create a new advanced certificate in the dashboard:
2525
3. Select **Order Advanced Certificate**.
2626
4. If Cloudflare does not have your billing information, you will need to enter that information.
2727
5. Enter the following information:
28-
- Certificate Authority
29-
- Certificate Hostnames
28+
- Certificate authority
29+
- Certificate hostnames
30+
- For hostnames longer than 64 characters, use the API.
3031
- Validation method
31-
- Certificate Validity Period
32+
- Certificate validity period
3233
6. Select **Save**.
3334

3435
</TabItem> <TabItem label="API">
3536

3637
To create a new certificate using the API, send a [POST request](/api/operations/certificate-packs-order-advanced-certificate-manager-certificate-pack) to the Cloudflare API.
3738

39+
If you need certificates for hostnames longer than 64 characters ([RFC 5280](https://www.rfc-editor.org/rfc/rfc5280.html)), set the `cloudflare_branding` option to `true`. This will add `sni.cloudflaressl.com` in the Common Name (CN) field and will include the long hostname as a part of the Subject Alternative Name (SAN).
40+
3841
</TabItem> </Tabs>
3942

4043
:::caution

src/content/partials/ssl/total-tls-character-limitation.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,4 +3,4 @@
33

44
---
55

6-
Total TLS certificates follow the [Common Name (CN) restriction](https://www.rfc-editor.org/rfc/rfc5280.html) of 64 characters. If you have a hostname that exceeds this length, you can manually create an [Advanced Certificate](/ssl/edge-certificates/advanced-certificate-manager/manage-certificates/#create-a-certificate) to cover it.
6+
Total TLS certificates follow the Common Name (CN) restriction of 64 characters ([RFC 5280](https://www.rfc-editor.org/rfc/rfc5280.html)). If you have a hostname that exceeds this length, you can create an [Advanced Certificate](/ssl/edge-certificates/advanced-certificate-manager/manage-certificates/#create-a-certificate) via API to cover it.

0 commit comments

Comments
 (0)