Skip to content

Commit 889116f

Browse files
[SSL] Add list hostname associations example call to byo-ca (#16970)
* [SSL] Update byo-ca.mdx * Style guide adjustments --------- Co-authored-by: Rebecca Tamachiro <[email protected]>
1 parent 01803af commit 889116f

File tree

1 file changed

+8
-2
lines changed
  • src/content/docs/ssl/client-certificates

1 file changed

+8
-2
lines changed

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

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -56,7 +56,7 @@ This is especially useful if you already have mTLS implemented and client certif
5656

5757
:::caution
5858

59-
Submitting an empty array will remove all hostnames associations.
59+
Submitting an empty array will remove all hostnames associations.
6060
:::
6161

6262
* `mtls_certificate_id` string required
@@ -65,13 +65,19 @@ This is especially useful if you already have mTLS implemented and client certif
6565

6666
:::caution
6767

68-
If no `mtls_certificate_id` is provided, the action will be performed against a Cloudflare Managed CA.
68+
If no `mtls_certificate_id` is provided, the action will be performed against a Cloudflare Managed CA.
6969
:::
7070

7171

7272

7373
4. (Optional) Since this process is API-only, and hostnames that use your uploaded CA certificate **are not** listed on the dashboard, you can make a [GET request](/api/operations/client-certificate-for-a-zone-list-hostname-associations) with the `mtls_certificate_id` as a query parameter to confirm the hostname association.
7474

75+
```bash
76+
curl "https://api.cloudflare.com/client/v4/zones/zone_id/certificate_authorities/hostname_associations?mtls_certificate_id={id_from_step_2}" \
77+
--header "X-Auth-Email: <EMAIL>" \
78+
--header "X-Auth-Key: <API_KEY>"
79+
```
80+
7581
5. Create a custom rule to enforce client certificate validation.
7682
You can do this [via the dashboard](/api-shield/security/mtls/configure/) or [via API](/waf/custom-rules/create-api/).
7783

0 commit comments

Comments
 (0)