Skip to content

Commit 158b0ad

Browse files
[SSL, CF4SaaS] Clarify CA cert is validated and CNAME config with mTLS (#25667)
* Explicitly call out that uploaded CA certs are validated * Add note about where to enforce mTLS when CNAME is in place * Improve excessive passive voice
1 parent 23faa7a commit 158b0ad

File tree

3 files changed

+12
-0
lines changed
  • src/content/docs

3 files changed

+12
-0
lines changed

src/content/docs/cloudflare-for-platforms/cloudflare-for-saas/security/certificate-management/enforce-mtls.mdx

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -28,6 +28,8 @@ Once you have [added a custom hostname](/cloudflare-for-platforms/cloudflare-for
2828

2929
:::note
3030
Currently, you cannot add mTLS policies for custom hostnames using [API Shield](/api-shield/security/mtls/).
31+
32+
Also make sure to enforce mTLS on the specific custom hostname where it should be checked. It is not enough to have it set on the CNAME target.
3133
:::
3234

3335
## Minimum TLS Version

src/content/docs/learning-paths/mtls/mtls-app-security/index.mdx

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -69,6 +69,10 @@ Example WAF Custom Rule with action block:
6969

7070
![Example of a WAF custom rule with an action block in the Cloudflare dashboard during the validate client certificate step](~/assets/images/learning-paths/mtls/waf-custom-rule-action-block.png)
7171

72+
:::note
73+
When using CNAME, enforce mTLS on the specific hostname where it should be checked. It is not enough to have it set on the CNAME target.
74+
:::
75+
7276
## Demo
7377

7478
:::note

src/content/docs/ssl/client-certificates/byo-ca.mdx

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,8 @@ Bring your own CA (BYOCA) is especially useful if you already have mTLS implemen
2323

2424
## CA certificate requirements
2525

26+
When you upload your CA, Cloudflare validates the certificate according to certain requirements.
27+
2628
<Render file="byo-ca-mtls-cert-requirements" product="ssl" />
2729

2830
:::note
@@ -71,6 +73,10 @@ Uploading the CA private key is only required if you wish to use [Zero Trust's b
7173
"action": "block"
7274
```
7375

76+
:::note
77+
When using CNAME, enforce mTLS on the specific hostname where it should be checked. It is not enough to have it set on the CNAME target.
78+
:::
79+
7480
### Multiple CAs for one hostname
7581

7682
There can be multiple CAs (Cloudflare-managed or BYOCA) associated with the same hostname. For BYOCA certificates, the most recently deployed certificate will be prioritized.

0 commit comments

Comments
 (0)