コンテンツにスキップ

クッキー

待機室は、訪問者が有効で関連付けられた待機室を持つホストとパスの組み合わせへのアクセスを要求したときにのみ、__cfwaitingroomクッキーを使用します。待機室が一時停止されると、トラフィックはオリジンに送信され、__cfwaitingroomクッキーは作成されません。__cfwaitingroomクッキーは、ユーザーによる変更を防ぐために暗号化されています。待機室クッキーの名前をカスタマイズするために、カスタムサフィックスを待機室クッキーに追加することができます。

クッキーの機能

__cfwaitingroomクッキーは以下のために使用されます:

  • 待機室のキュー内でのユーザーの位置を追跡し、正しい順序でサービスを提供します。
  • 各訪問者のアプリケーション内での滞在時間を監視し、待機室でキューに並んでいる訪問者に正確な入場時間を提供します。
  • 一定の期間(session_durationで指定)再入場を許可し、待機室に戻ることなく利用できます。

クッキーの有効期限

  • 訪問者が待機室にいる間、__cfwaitingroomクッキーの有効期限は常に5分に設定されていますが、訪問者がタブを閉じたりアプリケーションを離れたりしない限り、20秒ごとに自動的に更新されます。
  • 訪問者がアプリケーションにアクセスすると、__cfwaitingroomクッキーは一定の間隔(session_durationで指定)後に期限切れになります。

クッキー名のカスタマイズ

__cfwaitingroomの末尾にカスタムサフィックスを追加することで、待機室クッキーの名前をカスタマイズできます。

UIを介してこれを行うには、作成または編集ワークフローでカスタムクッキーフィールドを完了します。APIを介してこれを行うには、待機室を作成または編集する際にcookie_suffixの値を入力します。クッキーサフィックスは、単一の待機室に対して追加のホスト名とパスを使用する際に必須のフィールドです。クッキーが適用されるポリシーに準拠していることを確認してください。

推定待機時間(FIFOキューイング方式)

訪問者が待機室のホストとパスの組み合わせに初めて入ると、__cfwaitingroomクッキーが付与されます。そのクッキーには、訪問者が待機室に入った分のユニークなグループIDが含まれています。この値を使用して、特定のグループの前に何人の訪問者がいるかを知ることができます。

各クッキーには、訪問者がアプリケーションに入った分の分に対応するacceptedAtの値も含まれています。この値により、待機室からアプリケーションに入る訪問者の数を把握できます。

visitorsAhead ÷ activeUsersToWebApplication = estimatedWaitTime

これらの情報を組み合わせて、各訪問者グループの推定待機時間を計算します。

Cloudflare待機室の技術的実装に関する詳細については、ブログ記事を参照してください。