Skip to content

Commit af19059

Browse files
[Turnstile] Troubleshooting fixes (#24974)
1 parent e70f374 commit af19059

File tree

5 files changed

+55
-46
lines changed

5 files changed

+55
-46
lines changed

public/__redirects

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1603,6 +1603,7 @@
16031603
/turnstile/get-started/terraform/ /turnstile/get-started/widget-management/terraform/ 301
16041604
/turnstile/glossary/ /turnstile/ 301
16051605
/turnstile/get-started/supported-browsers/ /cloudflare-challenges/reference/supported-browsers/ 301
1606+
/turnstile/troubleshooting/troubleshooting-faqs/ /turnstile/frequently-asked-questions/#troubleshooting 301
16061607

16071608
# waf
16081609
/waf/about/ /waf/concepts/ 301

src/content/docs/turnstile/frequently-asked-questions.mdx

Lines changed: 45 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -7,36 +7,74 @@ sidebar:
77

88
---
99

10-
## What features are available for Free or Enterprise users?
10+
import { Render } from "~/components"
11+
12+
## General
13+
14+
### What features are available for Free or Enterprise users?
1115

1216
Refer to [Availability](/turnstile/#availability) for more information on features available per tier.
1317

1418
---
1519

16-
## What languages does Turnstile support?
20+
### What languages does Turnstile support?
1721

1822
Refer to the [list of supported languages](/turnstile/reference/supported-languages/) for more information.
1923

2024
---
2125

22-
## Does Turnstile conform to WCAG 2.1 Level AA accessibility standard?
26+
### Does Turnstile conform to WCAG 2.1 Level AA accessibility standard?
2327

2428
Yes, Turnstile is WCAG 2.1 Level AA compliant.
2529

2630
---
2731

28-
## Where can I get additional support for Turnstile?
32+
### Where can I get additional support for Turnstile?
2933

3034
Refer to the [Cloudflare Community](https://community.cloudflare.com/c/website-application-performance/turnstile/83) or join the [Cloudflare Developers Discord server](https://discord.com/channels/595317990191398933/1025131875397812224).
3135

3236
---
3337

34-
## Can I use Turnstile in websites not proxied by Cloudflare?
38+
### Can I use Turnstile in websites not proxied by Cloudflare?
3539

3640
Turnstile can be embedded into any website without sending traffic through Cloudflare and works without showing visitors a CAPTCHA.
3741

3842
---
3943

40-
## What is Turnstile's data privacy policy?
44+
### What is Turnstile's data privacy policy?
45+
46+
For information on Turnstile's data privacy policy, refer to the [Turnstile Privacy Addendum](https://www.cloudflare.com/turnstile-privacy-policy/).
47+
48+
---
49+
50+
## Troubleshooting
51+
52+
### What happens if the user takes longer than five minutes?
53+
54+
The Turnstile widget needs to be refreshed to generate a new token. This can be done using the `turnstile.reset` function.
55+
56+
### Can the front end use Siteverify?
57+
58+
The Siteverify API must not be called by the front end as this may reveal the secret key used to authenticate. An attacker may simply modify the front end to not perform the siteverify check at all, rendering Turnstile ineffective.
59+
60+
### What is challenges.cloudflare.com, and why does my application connect to this origin?
61+
62+
Turnstile is hosted under `challenges.cloudflare.com`.
63+
64+
### I am seeing a 401 error in your console during a Turnstile security check, is this a problem?
65+
66+
You can safely ignore the error. It is requesting a [Private Access Token (PAT)](/cloudflare-challenges/reference/private-access-tokens/) that your device or browser does not support yet.
67+
68+
### How can I obtain the Ray ID or QR code for troubleshooting?
69+
70+
You will need to provide a [Ray ID](/fundamentals/reference/cloudflare-ray-id/) or QR code when debugging issues. The Ray ID is found at the end of the challenge page. You can obtain the QR code by clicking the success/failure/spinner logo on the widget four times.
71+
72+
### Can I use Turnstile on URI schemes such as `file://`?
73+
74+
No, Turnstile only works on `http://` and `https://` URI schemes. Other protocols such as `file://` are not supported.
75+
76+
### Why do I see a challenge on my proxied hostnames?
77+
78+
<Render file="proxied-hostnames" product="turnstile" />
4179

42-
For information on Turnstile's data privacy policy, refer to the [Turnstile Privacy Addendum](https://www.cloudflare.com/turnstile-privacy-policy/).
80+
<Render file="challenge-behavior" product="turnstile" />
Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
---
2+
pcx_content_type: troubleshooting
3+
title: Challenge solve issues
4+
external_link: /cloudflare-challenges/troubleshooting/challenge-solve-issues/
5+
sidebar:
6+
order: 4
7+
8+
---

src/content/docs/turnstile/troubleshooting/feedback-reports.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Feedback reports
33
pcx_content_type: troubleshooting
44
sidebar:
5-
order: 4
5+
order: 5
66

77
---
88

src/content/docs/turnstile/troubleshooting/troubleshooting-faqs.mdx

Lines changed: 0 additions & 38 deletions
This file was deleted.

0 commit comments

Comments
 (0)