Turnstile ウィジェット

Turnstile ウィジェットは、ウェブページ上での Turnstile の動作を定義します。各ウィジェットには、モード、ラベル、サイトキー、シークレットキーがあります。設定の異なるウィジェットを複数作成できます。

Turnstile は challenges.cloudflare.com でホストされています。アプリケーションはこのオリジンに接続します。サイトで Content Security Policy を使っている場合は、このドメインへの接続を許可する必要があります。

各ウィジェットには、一意の sitekey とシークレットキーのペア、および設定オプションがあります。

Turnstile ウィジェットで使えるモードは、Managed、Non-Interactive、Invisible です。

Managed モードは、Cloudflare がすべて管理します。クライアント側のシグナルとリスクレベルに応じて、適切な動作を自動で選びます。Cloudflare は訪問者の情報を使い、インタラクティブなチャレンジが必要かを判断します。

訪問者が人間であることを確認するために追加のチェックが必要な場合にだけ、Turnstile は操作を求めます。操作が必要なときは、訪問者はチェックボックスを選択します。解読する画像やテキストはありません。

Managed モードは、ウィジェットの動作を細かく調整せず、シンプルな設定にしたい場合に適しています。

訪問者には、ブラウザーでチャレンジが実行されているあいだ、読み込み中のスピナー付きウィジェットが表示されます。Managed モードと違い、訪問者がウィジェットを操作する必要はありません。

Non-Interactive モードは、訪問者体験を優先し、Turnstile の操作による手間をサイトに加えたくない場合に適しています。

Invisible モードは Non-Interactive モードに近く、訪問者が Turnstile ウィジェットを操作することはありません。さらに、ウィジェットや、不可視のブラウザーチャレンジが進行中であることの表示もありません。

Invisible モードは、サイト上の訪問者体験と見た目を優先したい場合に適しています。

ウィジェットは、normal、flexible、compact のサイズで実装できます。

設定オプションとコード例の詳細は、ウィジェットの設定 を参照してください。

Turnstile ウィジェットは、サイトのデザインに合わせた複数の外観モードとテーマに対応しています。

実装の詳細は、ウィジェットの設定 を参照してください。

flowchart LR
accTitle: 通常のウィジェット動作状態
accDescr: Turnstile ウィジェットの通常の動作状態を示します。
    A[<b>読み込み中</b><br /><small>ウィジェットがチャレンジを処理しています。</small> ] --> B[<b>操作*</b><br /><small>訪問者がチェックボックスを選択する必要があります。<br />*Managed モードのみ。</small>]
    B --> C[<b>成功</b><br /><small>チャレンジが正常に完了しました。</small>]