Skip to content

Commit 2a03256

Browse files
authored
[Turnstile] Remove trailing spaces (#20247)
1 parent efb4596 commit 2a03256

File tree

15 files changed

+39
-39
lines changed

15 files changed

+39
-39
lines changed

src/content/docs/turnstile/concepts/ephemeral-id.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ sidebar:
88

99
Ephemeral IDs generate a unique short-lived ID that can link behavior to a specific client instead of an IP address without relying on setting any cookies or using similar client-side storage.
1010

11-
When the same visitor interacts with Turnstile widgets from different Cloudflare customers, they receive different Ephemeral IDs for each contact. In attacks where fraudsters attempt to disguise themselves using different IP addresses, Ephemeral IDs detect abuse patterns more accurately than determining whether the visitor is a human or a bot.
11+
When the same visitor interacts with Turnstile widgets from different Cloudflare customers, they receive different Ephemeral IDs for each contact. In attacks where fraudsters attempt to disguise themselves using different IP addresses, Ephemeral IDs detect abuse patterns more accurately than determining whether the visitor is a human or a bot.
1212

1313
Ephemeral IDs are not unique and have a lifespan of up to a few days. They can be useful for identifying a bad actor in acute attacks such as sudden spikes in fake account creations or credential stuffing.
1414

src/content/docs/turnstile/concepts/hostname-management.mdx

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -16,13 +16,13 @@ Only Enterprise Bot Management and Enterprise Turnstile customers can have this
1616

1717
## Add a custom hostname
1818

19-
You can add a hostname to your Turnstile widget even if it is not on the Cloudflare network or registered as a zone. There are no prerequisites for using Turnstile.
19+
You can add a hostname to your Turnstile widget even if it is not on the Cloudflare network or registered as a zone. There are no prerequisites for using Turnstile.
2020

2121
To add a custom hostname:
2222

2323
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/) and select your account.
2424
2. Go to **Turnstile**.
25-
3. On an existing widget, select **Settings**.
25+
3. On an existing widget, select **Settings**.
2626
4. Select **Add Hostnames** under Hostname Management.
2727
5. Add a custom hostname or choose from an existing hostname.
2828
6. Select **Add**.
@@ -42,7 +42,7 @@ When associating hostnames with a widget, follow these requirements:
4242
- A port (for example, `443`)
4343
- A path (for example, `/path`)
4444

45-
### Subdomain specification
45+
### Subdomain specification
4646

4747
Specifying a subdomain is optional, but it can be used to further restrict the widget. For example, adding `www.example.com` as a hostname will allow widgets to work on:
4848

src/content/docs/turnstile/concepts/pre-clearance-support.mdx

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -6,22 +6,22 @@ sidebar:
66

77
---
88

9-
Pre-clearance in Turnstile allows websites to streamline user experiences by using clearance cookies. These cookies enable 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.
9+
Pre-clearance in Turnstile allows websites to streamline user experiences by using clearance cookies. These cookies enable 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.
1010

1111
You can integrate Cloudflare challenges by allowing Turnstile to issue a pre-clearance cookie. 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:
1212

1313
- `no_clearance`
1414
- `jschallenge`
1515
- `managed`
16-
- `interactive`
16+
- `interactive`
1717

1818
All widgets are set to `no_clearance` by default.
1919

2020
For Enterprise customers eligible to toggle off domain checks, Cloudflare recommends issuing pre-clearance cookies on widgets where at least one domain is specified.
2121

2222
:::note
2323

24-
Clearance cookies only support zones that are orange-clouded.
24+
Clearance cookies only support zones that are orange-clouded.
2525
:::
2626

2727
Refer to the [blog post](https://blog.cloudflare.com/integrating-turnstile-with-the-cloudflare-waf-to-challenge-fetch-requests) for more details on how pre-clearance works with WAF.

src/content/docs/turnstile/concepts/widget.mdx

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -12,9 +12,9 @@ Every instance of Turnstile belongs to a Turnstile widget. It is configured on a
1212

1313
The 3 modes for Turnstile are **Managed**, **Non-Interactive**, and **Invisible**.
1414

15-
Refer to [appearance modes](/turnstile/get-started/client-side-rendering/#appearance-modes) to configure whether to have the widget be always visible or visible only when interaction is required.
15+
Refer to [appearance modes](/turnstile/get-started/client-side-rendering/#appearance-modes) to configure whether to have the widget be always visible or visible only when interaction is required.
1616

17-
Widgets can be implemented in normal, flexible, or compact sizes.
17+
Widgets can be implemented in normal, flexible, or compact sizes.
1818

1919
<Render file="widget-size" />
2020

@@ -24,9 +24,9 @@ Refer to [widget sizes](/turnstile/get-started/client-side-rendering/#widget-siz
2424
Customers with Enterprise Bot Management and Enterprise Turnstile have the ability to remove the Cloudflare branding and customize the Turnstile widget.
2525
:::
2626

27-
## Availability
27+
## Availability
2828

29-
Free users are limited to 10 widgets per account.
29+
Free users are limited to 10 widgets per account.
3030

3131
Customers with Enterprise Bot Management and Enterprise Turnstile can have this limit increased. Contact your account team to increase your widget limit.
3232

@@ -50,7 +50,7 @@ This mode is fully managed by Cloudflare. It automatically chooses the appropria
5050

5151
### Compact mode
5252

53-
You can configure the Turnstile widget in compact mode, which functions in the same way as a Managed widget.
53+
You can configure the Turnstile widget in compact mode, which functions in the same way as a Managed widget.
5454

5555
#### Light mode
5656

@@ -84,15 +84,15 @@ This mode is similar to non-interactive mode where visitors will never interact
8484

8585
![Unknown error state](~/assets/images/turnstile/unknown-error-state.png)
8686

87-
When an unknown error occurs during the challenge, visitors will encounter this widget state. Visitors can refresh and retry the challenge. If the error persists, they can submit a feedback form by selecting **Send feedback** on the widget.
87+
When an unknown error occurs during the challenge, visitors will encounter this widget state. Visitors can refresh and retry the challenge. If the error persists, they can submit a feedback form by selecting **Send feedback** on the widget.
8888

8989
Refer to [Feedback reports](/turnstile/troubleshooting/feedback-reports) for more information.
9090

9191
### Interaction timed out state
9292

9393
![Interaction timed out](~/assets/images/turnstile/interaction-timed-out.png)
9494

95-
When the challenge is not solved for an extended period of time, it must be issued again by reloading the page or the widget.
95+
When the challenge is not solved for an extended period of time, it must be issued again by reloading the page or the widget.
9696

9797
### Challenge timed out state
9898

src/content/docs/turnstile/extensions/google-firebase.mdx

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -11,15 +11,15 @@ Turnstile is [available as an extension](https://extensions.dev/extensions/cloud
1111

1212
Google Firebase is a comprehensive app development platform that provides a variety of tools and services to help developers build, improve, and grow their mobile and web applications.
1313

14-
Firebase App Check helps protect Firebase resources like Cloud Firestore, Realtime Database, Cloud Storage, and Functions from abuse, such as automated fraud attacks and denial of service (DoS) attacks, by ensuring that incoming requests are from legitimate visitors and trusted sources.
14+
Firebase App Check helps protect Firebase resources like Cloud Firestore, Realtime Database, Cloud Storage, and Functions from abuse, such as automated fraud attacks and denial of service (DoS) attacks, by ensuring that incoming requests are from legitimate visitors and trusted sources.
1515

1616
## Set up a Google Firebase project
1717

1818
1. Create a Firebase project by going to the [Firebase Console](https://console.firebase.google.com/).
1919
2. Select **Add Project** and follow the prompts to create a new project.
2020
3. Add an app to your project by selecting your project.
2121
4. In the project overview, select **Add App** and choose the platform: **Web**.
22-
5. [Register your app](https://firebase.google.com/docs/web/setup?hl=en&authuser=0#register-app) and follow the guide to get your Firebase configuration.
22+
5. [Register your app](https://firebase.google.com/docs/web/setup?hl=en&authuser=0#register-app) and follow the guide to get your Firebase configuration.
2323

2424
:::note
2525

@@ -28,7 +28,7 @@ It is important to register your web app first to connect it with Turnstile late
2828

2929
## Set up Cloudflare Turnstile
3030

31-
1. Create a Cloudflare Turnstile site by going to the [Cloudflare Turnstile dashboard](https://dash.cloudflare.com/?to=/:account/turnstile).
31+
1. Create a Cloudflare Turnstile site by going to the [Cloudflare Turnstile dashboard](https://dash.cloudflare.com/?to=/:account/turnstile).
3232
2. Create a new widget and get the [sitekey and secret key](/turnstile/get-started/#get-a-sitekey-and-secret-key).
3333
- The domain you configure with the Turnstile widget should be the domain of your web app.
3434
- The [widget mode](/turnstile/concepts/widget/) must be **Invisible**.
@@ -43,7 +43,7 @@ It is important to register your web app first to connect it with Turnstile late
4343
4. Enter the secret key from Cloudflare Turnstile and your Firebase App ID.
4444
5. Select **Install extension**.
4545

46-
### Grant access to the Cloudflare extension
46+
### Grant access to the Cloudflare extension
4747

4848
1. Grant access to the Cloudflare extension under the IAM section of your project by selecting **Grant Access** under **View by Principals**.
4949
2. Select `ext-cloudflare-turnstile` from the dropdown menu.
@@ -88,9 +88,9 @@ cpo.getToken().then(({ token }) => {
8888

8989
```
9090

91-
### Verify the App Check token in your web application
91+
### Verify the App Check token in your web application
9292

93-
To verify the App Check token in your web application, refer to Firebase's [Token Verification guide](https://firebase.google.com/docs/app-check/custom-resource-backend?hl=en#verification).
93+
To verify the App Check token in your web application, refer to Firebase's [Token Verification guide](https://firebase.google.com/docs/app-check/custom-resource-backend?hl=en#verification).
9494

9595
```js
9696
import express from "express";

src/content/docs/turnstile/get-started/index.mdx

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ The sitekey and secret key are generated upon the creation of a widget, allowing
2424

2525
:::note
2626

27-
You can find special sitekeys to be used for testing in the [testing](/turnstile/troubleshooting/testing/) section.
27+
You can find special sitekeys to be used for testing in the [testing](/turnstile/troubleshooting/testing/) section.
2828
:::
2929

3030
### New sites
@@ -41,7 +41,7 @@ You can find special sitekeys to be used for testing in the [testing](/turnstile
4141
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/?to=/:account/turnstile) and select your account.
4242
2. Go to **Turnstile**.
4343
3. In the widget overview, select **Settings**.
44-
4. Confirm the [hostnames](/turnstile/concepts/hostname-management/) configured.
44+
4. Confirm the [hostnames](/turnstile/concepts/hostname-management/) configured.
4545
5. (Optional) Opt in for [pre-clearance support](/turnstile/concepts/pre-clearance-support/).
4646
6. Copy your sitekey and secret key.
4747

@@ -73,5 +73,5 @@ Refer to [Server-side validation](/turnstile/get-started/server-side-validation/
7373

7474
:::note
7575

76-
Rendering the client-side integration & validating the server-side response are both necessary to allow Turnstile to function properly.
76+
Rendering the client-side integration & validating the server-side response are both necessary to allow Turnstile to function properly.
7777
:::

src/content/docs/turnstile/get-started/mobile-implementation.mdx

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -13,13 +13,13 @@ Any modifications to the environment, such as the User Agent, [Content Security
1313

1414
## WebView configurations
1515

16-
Turnstile requires specific WebView settings to function properly. For Android implementations, refer to [`setJavaScriptEnabled`](https://developer.android.com/reference/android/webkit/WebSettings#setJavaScriptEnabled(boolean)) to tell the WebView to enable JavaScript execution and [`setDomStorageEnabled`](https://developer.android.com/reference/android/webkit/WebSettings#setDomStorageEnabled(boolean)) to enable the DOM storage API.
16+
Turnstile requires specific WebView settings to function properly. For Android implementations, refer to [`setJavaScriptEnabled`](https://developer.android.com/reference/android/webkit/WebSettings#setJavaScriptEnabled(boolean)) to tell the WebView to enable JavaScript execution and [`setDomStorageEnabled`](https://developer.android.com/reference/android/webkit/WebSettings#setDomStorageEnabled(boolean)) to enable the DOM storage API.
1717

1818
These settings ensure that the mobile WebView can properly load and execute the Turnstile challenge. If these configurations are missing, Turnstile may malfunction.
1919

2020
## Update allowed origins
2121

22-
In addition to ensuring proper WebView settings, if you have allowed origins configured, it is essential to update the list to include:
22+
In addition to ensuring proper WebView settings, if you have allowed origins configured, it is essential to update the list to include:
2323

2424
```txt
2525
@@ -32,11 +32,11 @@ challenges.cloudflare.com, about:blank, about:srcdoc
3232
Only [React Native](https://github.com/react-native-webview/react-native-webview/blob/master/docs/Reference.md#originwhitelist) contains the allowed origins above by default.
3333
:::
3434

35-
Without this, Turnstile challenges might fail to load. WebView should also be configured to allow insecure connections (`http` and `https`).
35+
Without this, Turnstile challenges might fail to load. WebView should also be configured to allow insecure connections (`http` and `https`).
3636

3737
## Maintain a consistent user agent
3838

39-
When implementing Turnstile with WebViews, the user agent must stay consistent as changing the user agent will cause the challenges to fail.
39+
When implementing Turnstile with WebViews, the user agent must stay consistent as changing the user agent will cause the challenges to fail.
4040

4141
## Use clearance cookies
4242

src/content/docs/turnstile/get-started/pre-clearance.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ import { Render } from "~/components"
1313

1414
To enable pre-clearance, you must ensure that the hostname of the Turnstile widget matches the zone with the WAF rules. During the Turnstile configuration setup in the Cloudflare dashboard, you can see the registered zones. Select the appropriate hostname from this list.
1515

16-
The prerequisite is crucial for pre-clearance to function properly. If set up correctly, visitors who successfully solve Turnstile will receive a cookie with the security clearance level set by the customer. When encountering a WAF challenge on the same zone, they will bypass additional challenges for the configured clearance level and below.
16+
The prerequisite is crucial for pre-clearance to function properly. If set up correctly, visitors who successfully solve Turnstile will receive a cookie with the security clearance level set by the customer. When encountering a WAF challenge on the same zone, they will bypass additional challenges for the configured clearance level and below.
1717

1818
For more details on managing hostnames, refer to the [Hostname Management documentation](/turnstile/concepts/hostname-management/).
1919

src/content/docs/turnstile/migration/hcaptcha.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -44,7 +44,7 @@ turnstile.render(element, {
4444
Turnstile supports:
4545

4646
- the `render()` call
47-
- hCaptcha invisible mode with the `execute()` call
47+
- hCaptcha invisible mode with the `execute()` call
4848
:::
4949

5050
## Server-side integration

src/content/docs/turnstile/migration/recaptcha.mdx

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ To complete the migration, you must obtain the [sitekey and secret key](/turnsti
1212

1313
:::note
1414

15-
Turnstile migration is currently compatible up to reCAPTCHA v2.
15+
Turnstile migration is currently compatible up to reCAPTCHA v2.
1616
:::
1717

1818
## Client-side integration
@@ -32,7 +32,7 @@ enables the following features:
3232

3333
- implicit rendering for reCAPTCHA
3434
- `g-recaptcha-response` input name for forms
35-
- register the Turnstile API as `grecaptcha`
35+
- register the Turnstile API as `grecaptcha`
3636
:::
3737

3838
</div>
@@ -44,7 +44,7 @@ enables the following features:
4444
Turnstile supports:
4545

4646
- the `render()` call
47-
- reCAPTCHA v2 invisible mode with the `execute()` call
47+
- reCAPTCHA v2 invisible mode with the `execute()` call
4848
:::
4949

5050
## Server-side integration
@@ -57,5 +57,5 @@ reCAPTCHA supports `GET` requests using query parameters, i.e: `GET /siteverify?
5757

5858
Turnstile's siteverify endpoint does _not_ support this and only accepts `POST` requests with a FormData or JSON body.
5959

60-
Refer to [server-side validation](/turnstile/get-started/server-side-validation/) for more information.
60+
Refer to [server-side validation](/turnstile/get-started/server-side-validation/) for more information.
6161
:::

0 commit comments

Comments
 (0)