Skip to content

非公式本サイトは非公式の日本語ドキュメントであり、Cloudflare 公式サイトではありません。最新情報はdevelopers.cloudflare.comをご確認ください。

設定項目

最終更新 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 のドキュメント を参照してください。有効な値は offinvisiblevisible_non_interactivevisible_managed です。off にすると、Turnstile 連携は完全に無効になります。

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

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

エンドユーザーが Turnstile チャレンジに失敗したときのアクションです。有効な値は loginfinite_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 は一定時間操作がないと期限切れになります。空きが出るとすぐに新しい枠が開き、推定待ち時間はより低く、より正確になります。

役に立ちましたか?