Skip to content

Commit ec7a1f9

Browse files
fix cf-clearance (#23600)
1 parent d01a2b1 commit ec7a1f9

File tree

2 files changed

+11
-11
lines changed

2 files changed

+11
-11
lines changed

src/content/docs/cloudflare-challenges/concepts/clearance.mdx

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -6,19 +6,19 @@ sidebar:
66
---
77
import { Render } from "~/components";
88

9-
## `cf-clearance` cookies
9+
## `cf_clearance` cookies
1010

11-
A `cf-clearance` cookie proves to Cloudflare that the visitor is a verified human and has passed the Challenge presented to them.
11+
A `cf_clearance` cookie proves to Cloudflare that the visitor is a verified human and has passed the Challenge presented to them.
1212

13-
If a visitor passes an Interactive Challenge (highest security level), then the `cf-clearance` cookie indicates this to the origin and allows the visitor to bypass any other Challenge on the website, whether it is another Interactive Challenge, a Managed Challenge, or a non-interactive JavaScript Challenge for as long as the cookie is valid.
13+
If a visitor passes an Interactive Challenge (highest security level), then the `cf_clearance` cookie indicates this to the origin and allows the visitor to bypass any other Challenge on the website, whether it is another Interactive Challenge, a Managed Challenge, or a non-interactive JavaScript Challenge for as long as the cookie is valid.
1414

15-
If a visitor receives a `cf-clearance` cookie on a page that uses a WAF rule with Managed or JavaScript Challenge (lower security levels), then encountering a different page with a higher security clearance level Challenge will prompt them to solve the Challenge again.
15+
If a visitor receives a `cf_clearance` cookie on a page that uses a WAF rule with Managed or JavaScript Challenge (lower security levels), then encountering a different page with a higher security clearance level Challenge will prompt them to solve the Challenge again.
1616

17-
The original `cf-clearance` cookie that was issued to the visitor from a lower security clearance level Challenge will be replaced with the new `cf-clearance` cookie from a higher security clearance level Challenge.
17+
The original `cf_clearance` cookie that was issued to the visitor from a lower security clearance level Challenge will be replaced with the new `cf_clearance` cookie from a higher security clearance level Challenge.
1818

1919
## Pre-clearance support in Turnstile
2020

21-
Pre-clearance in [Turnstile](/turnstile/) allows websites to streamline user experiences by using `cf-clearance` cookies. The `cf-clearance` cookie enables visitors to bypass WAF Challenges downstream, based on the security clearance level set by the customer. This can be particularly useful for trusted visitors, enhancing usability while maintaining security.
21+
Pre-clearance in [Turnstile](/turnstile/) allows websites to streamline user experiences by using `cf_clearance` cookies. The `cf_clearance` cookie enables visitors to bypass WAF Challenges downstream, based on the security clearance level set by the customer. This can be particularly useful for trusted visitors, enhancing usability while maintaining security.
2222

2323
By default, Turnstile issues a one-time use token to the visitor when they solve a Challenge via the widget. The token goes to your website's backend that needs to be validated by Siteverify API.
2424

@@ -30,12 +30,12 @@ The clearance token cannot be used again.
3030

3131
| Challenge type | Issued clearance |
3232
| --- | --- |
33-
| Challenge Page | `cf-clearance` cookie (default)
34-
| Turnstile widget | Token (default) <br /> `cf-clearance cookie` (optional addition) |
33+
| Challenge Page | `cf_clearance` cookie (default)
34+
| Turnstile widget | Token (default) <br /> `cf_clearance` cookie (optional addition) |
3535

36-
When you enable pre-clearance support on Turnstile, a `cf-clearance` cookie is issued to the visitor in addition to the default Turnstile token.
36+
When you enable pre-clearance support on Turnstile, a `cf_clearance` cookie is issued to the visitor in addition to the default Turnstile token.
3737

38-
You can integrate Cloudflare Challenges by allowing Turnstile to issue a `cf-clearance` cookie as pre-clearance to your visitor. The pre-clearance level is set upon widget creation or widget modification using the Turnstile API's clearance_level. Possible values for the configuration are:
38+
You can integrate Cloudflare Challenges by allowing Turnstile to issue a `cf_clearance` cookie as pre-clearance to your visitor. The pre-clearance level is set upon widget creation or widget modification using the Turnstile API's clearance_level. Possible values for the configuration are:
3939

4040
- `interactive`
4141
- `managed`

src/content/docs/turnstile/turnstile-analytics/challenge-outcomes.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -43,6 +43,6 @@ For example, the solve rate values in your analytics may look like this:
4343

4444
- **Non-interactive solves**: Challenges solved without requiring the visitor to click a checkbox.
4545
- **Interactive solves**: Challenges solved that required visitor interaction to be solved.
46-
- [**Pre-clearance solves**](/turnstile/concepts/pre-clearance-support/): Challenges solved that issued the `cf-clearance` cookie along with the Turnstile token.
46+
- [**Pre-clearance solves**](/turnstile/concepts/pre-clearance-support/): Challenges solved that issued the `cf_clearance` cookie along with the Turnstile token.
4747

4848
A low solve rate might indicate increased bot activity attempting to bypass Turnstile or anomalous traffic patterns that require further investigation.

0 commit comments

Comments
 (0)