# Turnstile

Turnstile は Cloudflare のスマートな CAPTCHA 代替です

> 以下のリンクは、各ページの Markdown 版を直接指します。 任意のページは、`index.md` サフィックスなしの URL に `Accept: text/markdown` ヘッダーを付けて取得することもできます（例: `curl -H "Accept: text/markdown" https://developers.cloudflare.com/turnstile/`）。
>
> その他の Cloudflare 製品は、[Cloudflare ドキュメントディレクトリ](https://developers.cloudflare.com/llms.txt) を参照してください。

## 概要

- [Cloudflare Turnstile](https://developers.cloudflare.com/turnstile/index.md): CAPTCHA を使わず、プライバシーを保ちながら訪問者が人間であることを確認します。

## プラン

- [プラン](https://developers.cloudflare.com/turnstile/plans/index.md): プランごとの Turnstile の機能とウィジェット上限を比較します。

## Turnstile Spin

- [Turnstile Spin](https://developers.cloudflare.com/turnstile/spin/index.md): Cloudflare ダッシュボードまたは AI コーディングエージェントから、Turnstile をエンドツーエンドで設定します（ウィジェットと正規のサーバーサイド Siteverify）。

## はじめに

- [はじめに](https://developers.cloudflare.com/turnstile/get-started/index.md): 従来の CAPTCHA を使わず、Turnstile で訪問者を検証します。
- [ウィジェットを埋め込む](https://developers.cloudflare.com/turnstile/get-started/client-side-rendering/index.md): JavaScript または HTML で、ウェブサイトに Turnstile ウィジェットを埋め込みます。
- [ウィジェットの設定](https://developers.cloudflare.com/turnstile/get-started/client-side-rendering/widget-configurations/index.md): ウィジェットの外観、言語、コールバック関数を設定します。
- [モバイル実装](https://developers.cloudflare.com/turnstile/get-started/mobile-implementation/index.md): ネイティブモバイルアプリに Turnstile を実装します。
- [トークンを検証する](https://developers.cloudflare.com/turnstile/get-started/server-side-validation/index.md): siteverify API でサーバー上の Turnstile トークンを検証します。
- [Cloudflare API でウィジェットを作成・管理する](https://developers.cloudflare.com/turnstile/get-started/widget-management/api/index.md): Cloudflare API を使って、Turnstile ウィジェットを作成・管理します。
- [Cloudflare ダッシュボードでウィジェットを作成・管理する](https://developers.cloudflare.com/turnstile/get-started/widget-management/dashboard/index.md): Cloudflare ダッシュボードで Turnstile ウィジェットを作成・管理します。
- [Terraform でウィジェットを作成・管理する](https://developers.cloudflare.com/turnstile/get-started/widget-management/terraform/index.md): Terraform プロバイダーを使い、Turnstile ウィジェットを作成して管理します。

## Turnstile Analytics

- [Turnstile Analytics](https://developers.cloudflare.com/turnstile/turnstile-analytics/index.md): Turnstile Analytics で、発行された Challenge の件数、Challenge の解決率、発行済み Challenge の指標を確認します。
- [Challenge の結果](https://developers.cloudflare.com/turnstile/turnstile-analytics/challenge-outcomes/index.md): Turnstile ウィジェットの Challenge 結果メトリクスを確認します。
- [トークン検証](https://developers.cloudflare.com/turnstile/turnstile-analytics/token-validation/index.md): Turnstile ウィジェットのトークン検証指標を確認します。

## 移行

- [移行](https://developers.cloudflare.com/turnstile/migration/index.md): reCAPTCHA または hCaptcha から Turnstile へ移行します。
- [hCaptcha からの移行](https://developers.cloudflare.com/turnstile/migration/hcaptcha/index.md): hCaptcha から Cloudflare Turnstile へ移行します。
- [reCAPTCHA からの移行](https://developers.cloudflare.com/turnstile/migration/recaptcha/index.md): Google reCAPTCHA から Cloudflare Turnstile へ移行します。

## チュートリアル

- [チュートリアル](https://developers.cloudflare.com/turnstile/tutorials/index.md): WAF、ログインページ、テスト向けに Turnstile を統合するチュートリアルです。
- [条件付きで Turnstile を適用する](https://developers.cloudflare.com/turnstile/tutorials/conditionally-enforcing-turnstile/index.md): このチュートリアルでは、受信リクエスト（ヘッダー内の事前共有シークレットや特定の IP アドレスなど）に応じて、Turnstile を条件付きで適用する方法を説明します。
- [E2E テストから Turnstile を除外する](https://developers.cloudflare.com/turnstile/tutorials/excluding-turnstile-from-e2e-tests/index.md): Turnstile 専用のテスト用キーを使って、エンドツーエンド（E2E）テストで Turnstile を扱う方法を説明します。
- [Ephemeral ID による不正検知](https://developers.cloudflare.com/turnstile/tutorials/fraud-detection-with-ephemeral-ids/index.md): Turnstile の Ephemeral ID で不正検知を実装し、IP アドレスを切り替える攻撃者を特定してブロックする方法を学びます。
- [Turnstile、WAF、Bot Management を連携する](https://developers.cloudflare.com/turnstile/tutorials/integrating-turnstile-waf-and-bot-management/index.md): Cloudflare Turnstile、Web Application Firewall（WAF）、Bot Management を連携する方法です。自動化攻撃や悪意のあるログイン試行など、さまざまな脅威に対する多層防御を構築できます。
- [フォームを保護する](https://developers.cloudflare.com/turnstile/tutorials/login-pages/index.md): ログイン、サインアップ、お問い合わせなどのウェブフォームを、Cloudflare Turnstile で保護する手順です。

## コミュニティリソース

- [コミュニティリソース](https://developers.cloudflare.com/turnstile/community-resources/index.md): Cloudflare Turnstile 向けのコミュニティ製ライブラリと連携です。

## 変更履歴

- [変更履歴](https://developers.cloudflare.com/turnstile/changelog/index.md): Cloudflare Turnstile の最新の更新と変更を確認できます。

## additional-configuration

- [Ephemeral ID](https://developers.cloudflare.com/turnstile/additional-configuration/ephemeral-id/index.md): 不正検知と分析向けに、使い捨ての Ephemeral ID を生成します。
- [ホスト名管理](https://developers.cloudflare.com/turnstile/additional-configuration/hostname-management/index.md): Turnstile ウィジェットを表示できるホスト名を制御します。
- [Any Hostname（Enterprise のみ）](https://developers.cloudflare.com/turnstile/additional-configuration/hostname-management/any-hostname/index.md): Enterprise プランでは、任意のホスト名で Turnstile ウィジェットを利用できます。
- [Pre-clearance の設定](https://developers.cloudflare.com/turnstile/additional-configuration/hostname-management/pre-clearance/index.md): Pre-clearance を設定して、訪問者への繰り返し Challenge を減らします。
- [Offlabel で Cloudflare のブランディングを外す](https://developers.cloudflare.com/turnstile/additional-configuration/offlabel/index.md): Offlabel モードで、Turnstile ウィジェットから Cloudflare のブランディングを外します。
- [Pre-clearance のサポート](https://developers.cloudflare.com/cloudflare-challenges/concepts/clearance/index.md#pre-clearance-support-in-turnstile): 有効な訪問者への繰り返し Challenge を減らすため、クリアランスクッキーを発行します。

## concepts

- [Cloudflare Challenges](https://developers.cloudflare.com/cloudflare-challenges/index.md): Turnstile ウィジェットで、Cloudflare Challenges が訪問者を検証する仕組み。
- [Turnstile ウィジェット](https://developers.cloudflare.com/turnstile/concepts/widget/index.md): Turnstile ウィジェットのモード、サイズ、描画の動作です。

## extensions

- [Google Firebase で Turnstile を実装する](https://developers.cloudflare.com/turnstile/extensions/google-firebase/index.md): Google Firebase と Turnstile を統合し、サーバー側で検証します。
- [Pages プラグイン](https://developers.cloudflare.com/pages/functions/plugins/turnstile/index.md): Pages Plugin を使って、Cloudflare Pages に Turnstile を追加します。
- [Waiting Room アナリティクス](https://developers.cloudflare.com/waiting-room/waiting-room-analytics/index.md#turnstile-widget-traffic): Waiting Room のチャレンジイベントに関する Turnstile アナリティクスを表示します。

## reference

- [Content Security Policy（CSP）](https://developers.cloudflare.com/turnstile/reference/content-security-policy/index.md): Turnstile ウィジェットに必要な Content Security Policy のディレクティブです。
- [対応ブラウザー](https://developers.cloudflare.com/cloudflare-challenges/reference/supported-browsers/index.md): Cloudflare Turnstile ウィジェットが対応するブラウザー。
- [対応言語](https://developers.cloudflare.com/turnstile/reference/supported-languages/index.md): Cloudflare Turnstile ウィジェットが対応する言語です。

## troubleshooting

- [チャレンジ解決の問題](https://developers.cloudflare.com/cloudflare-challenges/troubleshooting/challenge-solve-issues/index.md): Turnstile ウィジェットのチャレンジループと解決失敗を修正します。
- [クライアント側エラー](https://developers.cloudflare.com/turnstile/troubleshooting/client-side-errors/index.md): Turnstile ウィジェット描画時のクライアント側エラーを解決します。
- [エラーコード](https://developers.cloudflare.com/turnstile/troubleshooting/client-side-errors/error-codes/index.md): Turnstile ウィジェットが返すエラーコードと、その意味です。
- [フィードバックレポート](https://developers.cloudflare.com/turnstile/troubleshooting/feedback-reports/index.md): 誤検知のチャレンジについて、Turnstile のフィードバックレポートを送信します。
- [シークレットキーをローテーションする](https://developers.cloudflare.com/turnstile/troubleshooting/rotate-secret-key/index.md): セキュリティ対策やキー漏洩時に、Turnstile のシークレットキーをローテーションします。
- [Turnstile の実装をテストする](https://developers.cloudflare.com/turnstile/troubleshooting/testing/index.md): テスト用サイトキーで Turnstile の実装を確認します。