Skip to content

非公式 / UnofficialCloudflare, Inc. 非提携。アカウント情報は入力しないでください。Not affiliated with Cloudflare, Inc. Do not enter Cloudflare credentials here.Official docsこのサイトについてプライバシー

設定項目

最終更新 Markdown で表示Agent セットアップ

Waiting Room では、さまざまなオプションをカスタマイズできます。

ダッシュボードの設定 補足

ダッシュボードの設定

設定備考
ダッシュボードの設定API パラメーター必須?説明推奨事項
名前nameはい一意の Waiting Room 名です。
ホスト名hostはいWaiting Room を適用するホスト名です(ワイルドカードは使えません)。

http:// や https:// は含めないでください。

パスpathいいえ

Waiting Room のパスです。大文字と小文字は区別されます。すべてのサブパスで Waiting Room が有効になります。 ワイルドカードとクエリパラメーターは使えません。

サーバーが大文字と小文字を区別できない場合は、path に数字を使います。

追加のホスト名とパスadditional_routesいいえ

Waiting Room の対象に、ホスト名やパスを追加します。

追加のホスト名は、同じゾーン内である必要があります。ホスト名とパスの組み合わせは、Waiting Room ごとに一意である必要があります。

カスタム Cookie サフィックスcookie_suffixadditional_routes を使う場合は必須です。

Waiting Room Cookie のサフィックスをカスタマイズします。サフィックスは _cfwaitingroom に付きます。

Cookie 名が要件を満たすようにしてください。頻繁に変更しないでください。

アクティブユーザー総数total_active_usersはい

ある時点で host/path に許可するアクティブセッションの上限です (200 より大きい値である必要があります)。

オリジンのトラフィック容量の 75% に設定し、必要に応じて調整します。調整すると、エンドユーザーに表示される推定待ち時間に影響することがあります。

1 分あたりの新規ユーザー数new_users_per_minuteはい

host/path に入れるユーザー数の しきい値 です。200 より大きく、アクティブユーザー総数 以下である必要があります。

ピークトラフィックの 100% に設定し、必要なときだけユーザーがキューに入るようにします
セッション期間session_durationいいえ

host/path を離れたユーザーが、Waiting Room を通らずに 直接戻れる 時間(分)です。1〜30 の範囲です。デフォルトは 5 分です。

セッション取り消しいいえ

ユーザーが特定の操作をしたときにセッションを取り消します。オリジンからの応答に HTTP ヘッダーで Waiting Room へコマンドを送ります。

ダッシュボードでこの設定を有効にし、オリジンからの応答に Cf-Waiting-Room-Command: revoke HTTP ヘッダーを追加します。
説明descriptionいいえWaiting Room の説明です。
セッション更新を無効にするdisable_session_renewalいいえ

有償の Enterprise のお客様のみ利用できます。true の場合、ユーザーがサイトを閲覧できるのは session duration の分数だけです。false の場合、ユーザーのセッション Cookie はリクエストのたびに更新されます。

JSON レスポンスjson_response_enabledいいえ。デフォルトは false です。

Accept: application/json ヘッダーを受け取ったときに JSON 本文を送ります。ネイティブモバイルアプリケーションでよく使います。

ブラウザー以外のトラフィックに Waiting Room を使う場合は true にします。追加手順は こちらのドキュメント を参照してください。

キューイングのステータスコードqueueing_status_codeいいえ。デフォルトは 200(OK)です。

ユーザーがキューに入っているあいだに返す HTTP ステータスコードです。

Turnstile ウィジェットモードturnstile_modeはい。デフォルトは invisible です。

使う Turnstile ウィジェットの種類です。詳細は Turnstile のドキュメント を参照してください。有効な値は off、invisible、visible_non_interactive、visible_managed です。off にすると、Turnstile 連携は完全に無効になります。

ほとんどの Waiting Room では invisible が適切です。エンドユーザーにチャレンジの実行を知らせたい場合を除きます。

Turnstile 失敗時のアクションturnstile_actionはい。デフォルトは log です。

エンドユーザーが Turnstile チャレンジに失敗したときのアクションです。有効な値は log と infinite_queue です。

ほとんどの Waiting Room では log が適切です。無限キューでボットを積極的にブロックしたい場合を除きます。

補足

1 分あたりの新規ユーザー数

new users per minute を設定しても、この値は 1 分あたりに追加するユーザー数ではありません。

これは、1 分あたりに許可するユーザー数のしきい値です(total active users 以下)。想定ピークトラフィックの 100% に設定し、必要なときだけユーザーがキューに入るようにしてください。

セッション期間

セッション期間は、次の 2 点でユーザー体験を改善します。

1 つ目は、同じ取引で訪問者が Waiting Room を 2 度通らずに済むことです。たとえば、訪問者が example.com で購入したいとします。example.com は混雑しているため、オンラインストアに入る前に Waiting Room で待ちます。しばらくすると Waiting Room を出て、オンラインストアに入ります。購入してオンラインストアを離れます。

しかし、注文へのメモ追加や領収書の請求を忘れていました。セッション Cookie がまだ有効なら(session duration で指定した時間内なら)、Waiting Room で再び並ばずにアプリケーションへ戻れます。

2 つ目は、セッション期間により、Waiting Room がアプリケーションからの動的な流出(動的な流入に加えて)を作れることです。ユーザーのセッション Cookie は一定時間操作がないと期限切れになります。空きが出るとすぐに新しい枠が開き、推定待ち時間はより低く、より正確になります。

役に立ちましたか?