Skip to content

Commit 636f135

Browse files
committed
Adding in last bits of feedback
1 parent 5ec4b7e commit 636f135

File tree

5 files changed

+7
-5
lines changed

5 files changed

+7
-5
lines changed
27.7 KB
Loading

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ By default, mTLS uses Client Certificates issued by a Cloudflare Managed CA. Clo
1818
1. Go to your Cloudflare dashboard and selecting your account.
1919
2. Select **SSL/TLS** > **[Client Certificates](/ssl/client-certificates/)** tab and add the Hosts (hostnames) you want to [enable mTLS](/ssl/client-certificates/enable-mtls/) for.
2020

21-
Example host: [mtls-test.example.com](https://mtls-test.example.com/)
21+
`Example host: [mtls-test.example.com](https://mtls-test.example.com/)`
2222

2323
3. Select **Create Certificate** to generate the private key (usually referred to as Private Certificate) and Certificate Signing Request (CSR) with Cloudflare (which includes the Public Certificate), or use your own private key and CSR. Using your own allows you to also [label client certificates](/ssl/client-certificates/label-client-certificate/).
2424

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

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -99,7 +99,7 @@ Contact your account team for more information.
9999
[Revoked](/api-shield/security/mtls/configure/#check-for-revoked-certificates) Client Certificates are not automatically blocked unless you have an active WAF Custom Rule specifically checking for and blocking them. This check only applies to Client Certificates issued by the Cloudflare-managed CA. Cloudflare currently does not check certificate revocation lists (CRL) for CAs that have been uploaded by the customer ([BYO CA](/ssl/client-certificates/byo-ca/)). One can opt for Workers to manage a custom business logic and block revoked Client Certificates. See the [Workers section](/learning-paths/mtls/mtls-workers/) for more information.
100100
:::
101101

102-
In order to effectively implement mTLS with Cloudflare, it is strongly recommended to properly configure the [Cloudflare WAF](/waf/). Review the available []`cf.tls_*`](/ruleset-engine/rules-language/fields/dynamic-fields/#cftls_cipher) dynamic fields.
102+
In order to effectively implement mTLS with Cloudflare, it is strongly recommended to properly configure the [Cloudflare WAF](/waf/). Review the available [`cf.tls_*`](/ruleset-engine/rules-language/fields/dynamic-fields/#cftls_cipher) dynamic fields.
103103

104104
Example WAF Custom Rule with action block:
105105

@@ -121,6 +121,8 @@ Another example WAF Custom Rule with action block, using the [cf.tls_client_auth
121121

122122
Here's another example of a WAF custome rule to associate a serial number with a hostname:
123123

124+
![Example expression of a WAF Custom Rule to associate a serial number with a hostname](~/assets/images/learning-paths/mtls/waf-custom-rule.png)
125+
124126
```txt
125127
(http.host in {"mtls.example.com" "mtls2.example.com"} and cf.tls_client_auth.cert_serial ne "ADD_STRING_OF_CLIENT_CERT_SERIAL")
126128
```

src/content/docs/learning-paths/mtls/mtls-cloudflare-access/index.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -104,7 +104,7 @@ cfssl gencert -ca=ca.pem -ca-key=ca-key.pem -config=ca-config.json -profile=clie
104104

105105
Follow the steps outlined in the [developer documentation](/cloudflare-one/identity/devices/access-integrations/mutual-tls-authentication/#add-mtls-authentication-to-your-access-configuration).
106106

107-
Using the example from Step 2: upload the **\`ca.pem\`** to your Cloudflare Access account via the [Dashboard](/cloudflare-one/identity/devices/access-integrations/mutual-tls-authentication/#add-mtls-authentication-to-your-access-configuration) or [Cloudflare API](/api/operations/access-mtls-authentication-add-an-mtls-certificate).
107+
Using the example from Step 2: upload the `ca.pem` to your Cloudflare Access account via the [Dashboard](/cloudflare-one/identity/devices/access-integrations/mutual-tls-authentication/#add-mtls-authentication-to-your-access-configuration) or [Cloudflare API](/api/operations/access-mtls-authentication-add-an-mtls-certificate).
108108

109109
Do not forget to enter the fully-qualified domain names (FQDN / associated hostnames) that will use this CA certificate.
110110

@@ -116,7 +116,7 @@ Additionally, authenticated requests also send the `Cf-Access-Jwt-Assertion\` JW
116116

117117
Finally, the hostname you want to protect with mTLS needs to be added as a [self-hosted app](/cloudflare-one/applications/configure-apps/self-hosted-apps/) in Cloudflare Access, defining an [Access Policy](/cloudflare-one/policies/access/) which uses the action [Service Auth](/cloudflare-one/policies/access/#service-auth) and the Selector *“Valid Certificate”*, or simply requiring an [IdP](/cloudflare-one/identity/idp-integration/) authentication. You can also take advantage of extra requirements, such as the “Common Name” (CN), which expects the indicated hostname, and more [Selectors](/cloudflare-one/policies/access/#selectors). Alternatively, one can also [extend ZTNA with external authorization and serverless computing](/reference-architecture/diagrams/sase/augment-access-with-serverless/).
118118

119-
## Usage
119+
## Demo
120120

121121
:::note
122122
Make sure that you are not using any VPN that could interfere with the certificates or TLS decryption.

src/content/docs/learning-paths/mtls/mtls-implementation/index.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ There are different ways to implement mTLS authentication. The most common ones
1111

1212
This version of mTLS is for device certificates, primarily focused on the number of IoT devices, not user devices.
1313

14-
here we recommend using [mTLS with Application Security](/learning-paths/mtls/mtls-app-security/).
14+
Here we recommend using [mTLS with Application Security](/learning-paths/mtls/mtls-app-security/).
1515

1616
## Option 2: mTLS User Authentication
1717

0 commit comments

Comments
 (0)