Skip to content

Commit 581229e

Browse files
authored
[SSL] Update API documentation for cipher suite customization
Added a warning about per-hostname cipher suite customization and its implications. CUSTESC-54412
1 parent 658a199 commit 581229e

File tree

1 file changed

+5
-1
lines changed
  • src/content/docs/ssl/edge-certificates/additional-options/cipher-suites/customize-cipher-suites

1 file changed

+5
-1
lines changed

src/content/docs/ssl/edge-certificates/additional-options/cipher-suites/customize-cipher-suites/api.mdx

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,13 +23,17 @@ Note that:
2323
- You cannot set specific TLS 1.3 ciphers. Instead, you can [enable TLS 1.3](/ssl/edge-certificates/additional-options/tls-13/#enable-tls-13) for your entire zone and Cloudflare will use all applicable [TLS 1.3 cipher suites](/ssl/edge-certificates/additional-options/cipher-suites/supported-cipher-suites/).
2424
- Each cipher suite also supports a specific algorithm (RSA or ECDSA) so you should consider the algorithms in use by your edge certificates when making your ciphers selection. You can find this information under each certificate listed in [**SSL/TLS** > **Edge Certificates**](https://dash.cloudflare.com/?to=/:account/:zone/ssl-tls/edge-certificates).
2525
- It is not possible to configure minimum TLS version nor cipher suites for [Cloudflare Pages](/pages/) hostnames.
26-
- If setting up a per-hostname cipher suite customization, make sure that the hostname is specified on the certificate (instead of being covered by a wildcard).
2726
- If you use Windows you might need to adjust the `curl` syntax, refer to [Making API calls on Windows](/fundamentals/api/how-to/make-api-calls/#making-api-calls-on-windows) for further guidance.
2827

2928
:::note
3029
Updating the cipher suites will result in certificates being redeployed.
3130
:::
3231

32+
:::warning
33+
If setting up a per-hostname cipher suite customization, make sure that the hostname is specified on the certificate (instead of being covered by a wildcard).
34+
Applying a per-hostname configuration on a wildcard certificate will result in the configuration being applied to all hostnames!
35+
:::
36+
3337
## Steps and API examples
3438

3539
1. Decide which cipher suites you want to specify and which ones you want to disable (meaning they will not be included in your selection).

0 commit comments

Comments
 (0)