Skip to content

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

Signals Intelligence

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

Bot Management のお客様は、Cloudflare ネットワーク全体のトラフィックに基づき、各 JA4 フィンガープリント の集計インテリジェンスデータを確認できます。このデータは、リクエストが特定のボットスコアになった理由を理解するためや、Cloudflare Workers またはオリジンで動かす独自の機械学習モデルへの入力に使えます。

具体的には、JA4 フィンガープリントごとに次の情報にアクセスできます。

  • Cloudflare が観測する、ブラウザーに関連するトラフィックの割合。
  • Cloudflare が観測する、既知のボットに関連するトラフィックの割合。
  • このフィンガープリントを実際に使っている、Cloudflare が観測したネットワーク数。
  • このフィンガープリントからのトラフィックを観測している Cloudflare サイト数。
  • そのフィンガープリントのリクエストがコンテンツをキャッシュし、エラーを発生させる頻度。

これらのフィールドは、Workers AI と組み合わせて、独自の機械学習モデルを構築することもできます。

Signals Intelligence フィールド

Signals Intelligence フィールドは、特定の JA4 について、直近 1 時間に Cloudflare がグローバルで観測した内容を示します。

フィールド名
説明
h2h3_ratio_1h 直近 1 時間における、その JA4 フィンガープリントの総リクエスト数に対する HTTP/2 と HTTP/3 の合計比率です。値が高いほど、他のプロトコル版と比べて HTTP/2 と HTTP/3 の割合が高いことを示します。
heuristic_ratio_1h 直近 1 時間における、その JA4 フィンガープリントで scoreSrc が "heuristics" のリクエストの比率です。値が高いほど、ヒューリスティックベースのスコアリングでフラグが付いたリクエストの割合が大きいことを示します。
reqs_quantile_1h 直近 1 時間における、全フィンガープリントのリクエスト数に基づく、その JA4 フィンガープリントの分位点です。値が高いほど、他のフィンガープリントと比べてリクエスト数が相対的に多いことを示します。
uas_rank_1h 直近 1 時間における、全フィンガープリントの異なるユーザーエージェント数に基づく、その JA4 フィンガープリントの順位です。値が低いほど、そのフィンガープリントに紐づくユーザーエージェントの多様性が高いことを示します。
browser_ratio_1h 直近 1 時間における、その JA4 フィンガープリントでブラウザー系ユーザーエージェントから発生したリクエストの比率です。値が高いほど、ブラウザー由来のリクエストの割合が高いことを示します。
paths_rank_1h 直近 1 時間における、全フィンガープリントの一意なリクエストパス数に基づく、その JA4 フィンガープリントの順位です。値が低いほど、そのフィンガープリントに紐づくリクエストパスの多様性が高いことを示します。
reqs_rank_1h 直近 1 時間における、全フィンガープリントのリクエスト数に基づく、その JA4 フィンガープリントの順位です。値が低いほど、そのフィンガープリントに紐づくリクエスト数が多いことを示します。
cache_ratio_1h 直近 1 時間における、その JA4 フィンガープリントのキャッシュ可能なレスポンスの比率です。値が高いほど、キャッシュできるレスポンスの割合が高いことを示します。
ips_rank_1h 直近 1 時間における、全フィンガープリントの一意なクライアント IP アドレス数に基づく、その JA4 フィンガープリントの順位です。値が低いほど、そのフィンガープリントに紐づく異なるクライアント IP が多いことを示します。
ips_quantile_1h 直近 1 時間における、全フィンガープリントの一意なクライアント IP アドレス数に基づく、その JA4 フィンガープリントの分位点です。値が高いほど、他のフィンガープリントと比べて異なるクライアント IP が相対的に多いことを示します。

JA4 フィンガープリントと Signals Intelligence を使う場合、Bot Management が JA4 Signals を算出または設定できないとき(TLS 以外のトラフィック、Bot Management がスキップされた場合など)に欠けるフィールドを、Workers スクリプト側で扱えるようにしてください。Bot Management が有効な Orange-to-Orange(O2O)では、JA4 Signals は eyeball(エンドユーザー)接続に対応し、O2O チェーン全体で保持されます。O2O ゾーン上のリクエストと、対応するサブリクエストも対象です。

  • JA4 フィンガープリントが欠ける可能性があります。
  • ja4Signals 配列が欠ける可能性があります(リクエストに JA4 が使えない場合など)。
  • NaN または Infinity の値を持つ結果は、配列から除外されます。

役に立ちましたか?