tencent cloud

Tencent Cloud EdgeOne

ドキュメントTencent Cloud EdgeOneDDoSとWeb保護Web 保護関連参考Web保護識別結果ヘッダーを付与したオリジンサーバーへのアクセス

Web保護識別結果ヘッダーを付与したオリジンサーバーへのアクセス

ダウンロード
フォーカスモード
フォントサイズ
最終更新日: 2026-10-15 18:07:47
AI翻訳・品質チェック済み

機能概要

EdgeOne Web防护モジュールはリクエスト特徴の識別を完了した後、識別結果をHTTPリクエストヘッダーの形式でオリジンサーバーへのリクエストに付与できます。オリジンサーバーは追加のインターフェースを呼び出すことなく、ビジネスロジック内でBotとクライアントのリスク情報を直接読み取り、それに基づいて二次的な対処を行うことができます。例えば、差別化されたレート制限、コンテンツのデグレード、手動審査などです。
説明:
この機能は段階的にグレースケール公開されています。お客様のアカウントに関連する設定カードが表示されない場合は、後続の製品全体公開をお待ちいただいてから設定を行ってください。
この機能は、エンタープライズ版プランのサイトにのみ開放されています。
まず、ヘッダーに対応するBot管理機能モジュールを有効にする必要があります。モジュールが識別結果を生成した後、このヘッダーはオリジンサーバーへのリクエストに付与されます。
HTTPSリクエストのみがJA3、JA4フィンガープリントを付与します。ドメイン名で高度なBot管理を有効にしているにもかかわらず、オリジンサーバーへのリクエストにおけるEO-Bot-Fingerprintヘッダーが空の場合、そのドメイン名でHTTPSアクセスが有効になっているかを確認してください。
互換性に関する説明:既存のEO-Bot-Tagヘッダーは引き続き保持され、動作は変更されず、本文で説明するヘッダーとは相互に独立しています。

操作手順

1. EdgeOne コンソールにログインし、左側のメニューバーでサービス概要に移動し、Webサイト安全な加速内で設定が必要なサイトをクリックします。
2. セキュリティ保護 > Web保護をクリックします。デフォルトではサイトレベルの保護ポリシーが適用されます。ドメイン名レベル保護ポリシータブをクリックし、ドメイン名レベル保護ポリシー内で対象ドメイン名をクリックして、対象ドメイン名の保護ポリシー設定画面に移動します。例えばwww.example.comです。
3. ポリシーページ下部の一般設定カテゴリで、オリジンサーバーへのWeb保護識別結果ヘッダー付与カードを見つけ、編集をクリックします。
4. 表示されたウィンドウで、オリジンサーバーに返す必要があるヘッダーを選択します。
5. 確定をクリックして、設定を保存します。

オリジンサーバーリクエストヘッダーの詳細説明

以下、各ヘッダーがオリジンサーバーに返された後の完全な形式について順に説明します。例として示す値は形式の説明のみを目的としており、実際の値はEdgeOneの識別結果に準じます。

フォーマット説明

関連ヘッダーはすべてRFC 9651『Structured Field Values for HTTP』に従ってシリアル化され、トップレベルタイプはDictionaryとListの2種類に分けられます。各ヘッダーのメンバー数は固定されていないため、RFC 9651仕様に従って解析することをお勧めします。固定されたフィールド順序やメンバー数に依存しないでください。
トップレベルタイプ
構造
適用ヘッダー
Dictionary
メンバーは「キー=値」で、メンバー間はカンマで区切られます。
EO-Bot-Fingerprint、EO-Bot-Known-Tool、EO-Bot-Search-Engine、EO-Bot-Source-IDC、EO-Bot-IP-Reputation、EO-Bot-Intelligence、EO-Bot-Botnet-ID
List
メンバーは認証インスタンスで、インスタンス間はカンマで区切られます。単一インスタンスは裸値とパラメータで構成され、パラメータはセミコロンで導出されます。
EO-Bot-Client-Attestation、EO-Bot-Client-Risk、EO-Bot-User-Risk

クライアントフィンガープリント

EO-Bot-Fingerprint

クライアントTLSフィンガープリントを付与します。ja3とja4は実際の識別能力に応じて付与され、両方のうちどちらか一方のみが含まれる場合があります。
関連機能モジュール:高度なBot管理
フィールド
タイプ
説明
ja3
String
TLSクライアントのJA3フィンガープリント。
ja4
String
TLSクライアントのJA4フィンガープリント。
EO-Bot-Fingerprint: ja3="d41d8cd98f00b204e9800998ecf8427e", ja4="t13d1516h2_8daaf6152771_02713d6af862"

Bot管理機能関連

EO-Bot-Known-Tool

検出された既知のツール(クローラーまたは自動化プログラム)が属する分類と名前を付与します。
関連機能モジュール:高度なBot管理 > 基本特徴管理(UA特徴ルール)
フィールド
タイプ
説明
category_name
String
ヒットしたツールが属するカテゴリです。値はEdgeOneツール特徴ライブラリによって維持されます。例えば、search_engine(検索エンジン)です。
tool_name
String
ヒットしたツールの名前です。例えば、Bingbot、GoogleBot、PagePeekerです。
EO-Bot-Known-Tool: category_name="search_engine", tool_name="Bingbot"

EO-Bot-Search-Engine

検出された検索エンジン提供元の名前を付与します。
関連機能モジュール:高度なBot管理 > 基本特徴管理(検索エンジンルール)
フィールド
タイプ
説明
provider_name
String
ヒットした検索エンジン提供元の名前です。例えば、360Spider、DuckDuckBot、GoogleBotです。
EO-Bot-Search-Engine: provider_name="360Spider"

EO-Bot-Source-IDC

リクエスト元IPが属するIDCと通信事業者の名前を付与します。
関連機能モジュール:高度なBot管理 > 基本特徴管理(IDCルール)
フィールド
タイプ
説明
idc_name
String
IDCまたは事業者の名前です。例えば、pccw.comです。
EO-Bot-Source-IDC: idc_name="pccw.com"

EO-Bot-IP-Reputation

リクエスト元IPの脅威タイプと信頼度レベルを付与します。メンバー数は固定されておらず、複数の脅威タイプに該当する場合は並列で付与されます。
関連機能モジュール:高度なBot管理 > クライアントProfile Analytics
フィールド
タイプ
説明
<threat_type>
String
フィールド名は脅威タイプです。値にはattacker(ネットワーク攻撃)、proxy(ネットワークプロキシ)、scanner(スキャナー)、account_take_over(アカウント乗っ取り攻撃)、malicious_bot(悪意のあるBot)が含まれます。
<threat_type> の値
String
対応する脅威タイプの信頼度レベルです。値にはhigh(高い信頼度)、medium(中程度の信頼度)、low(一般的な信頼度)が含まれます。
EO-Bot-IP-Reputation: proxy="high", account_take_over="medium"

EO-Bot-Intelligence

Botインテリジェント分析のリスクスコアとリスクレベルを付与します。
関連機能モジュール:高度なBot管理 > Botインテリジェント分析
フィールド
タイプ
説明
bot_rating
String
Bot評価。値にはevil_bot(悪意のあるBotリクエスト)、suspect_bot(疑わしいBotリクエスト)、good_bot(正常なBotリクエスト)、normal(正常なリクエスト)が含まれ、未分類の場合は-です。
EO-Bot-Intelligence: bot_rating="evil_bot"

EO-Bot-Client-Attestation

クライアント認証チケットの検証ステータスと異常理由を付与します。同一リクエストに複数の認証インスタンスが存在する場合、インスタンス間はカンマで区切られます。
関連機能モジュール:高度なBot管理 > クライアント認証
フィールド
タイプ
説明
token_status
String
チケット検証ステータス。値にはvalid(チケット有効)、invalid(チケット無効)、expired(チケット期限切れ)が含まれます。
token_exceptions
String
チケット検証異常の原因。複数の異常タグは半角カンマ(,)で区切られ、値はEO-Attest-TokenMissing(リクエストに認証結果チケットが含まれていません)、EO-Attest-TokenExpired(チケットの有効期限が切れています)、EO-Attest-UsageLimitExceeded(チケットの使用回数が上限を超えています)などです。
EO-Bot-Client-Attestation: attest-0000056382;token_status="expired";token_exceptions="EO-Attest-TokenExpired"

EO-Bot-Client-Risk

クライアント認証-人間と機械の検証で識別されたクライアントリスク情報を付与します。
関連機能モジュール:高度なBot管理 > クライアント認証
フィールド
タイプ
説明
attester_type
String
認証方式識別子は、認証プロバイダーと認証オプションの組み合わせによって生成されます。例えばTC-EO-CAPTCHAです。選択可能な認証プロバイダーには、EdgeOneヒューマンベリフィケーション、Tencent Captcha、RCEが含まれます。具体的な値は、コンソールのクライアント認証 > 認証オプションの設定に準じます。
device_type
String
認証を開始するクライアントデバイスタイプです。例えばandroidです。
risk_score
Integer
クライアントリスクスコアです。値の範囲は0~100で、スコアが高いほどリスクが高いことを示します。
risk_level
String
クライアントリスクレベルです。値にはhigh(高リスク)、medium(中リスク)、low(一般リスク)が含まれます。
risk_details
String
クライアントリスク詳細です。複数のリスクタグは半角カンマ(,)で区切られます。例えばEO-App-DataAnomaly(クライアントデータ異常)、EO-App-FPLowConfidence(クライアントフィンガープリントの信頼度が低い)です。
EO-Bot-Client-Risk: attest-0000056382;attester_type="TC-EO-CAPTCHA";device_type="android";risk_score=100;risk_level="high";risk_details="EO-App-DataAnomaly,EO-App-FPLowConfidence"

EO-Bot-User-Risk

クライアント認証-アカウント保護で識別されたユーザーリスク情報を付与します。
関連機能モジュール:高度なBot管理 > クライアント認証
フィールド
タイプ
説明
attester_type
String
認証方式識別子は、認証プロバイダーと認証オプションの組み合わせによって生成されます。例えばTC-EO-CAPTCHAです。選択可能な認証プロバイダーには、EdgeOneヒューマンベリフィケーション、Tencent Captcha、RCEが含まれます。具体的な値は、コンソールのクライアント認証 > 認証オプションの設定に準じます。
device_type
String
認証を開始するクライアントデバイスタイプです。例えばandroidです。
user_id
String
認証を開始するユーザーアカウント識別子です。値は元のアカウントを表すBase64エンコードです。
user_operation
String
ユーザー操作タイプです。業務でクライアント認証ルールに定義され、値は元の操作タイプのBase64エンコードです。
risk_score
Integer
アカウントリスクスコアです。値の範囲は0~100で、スコアが高いほどリスクが高いことを示します。
risk_level
String
アカウントリスクレベルです。値にはhigh(高リスク)、medium(中リスク)、low(一般リスク)が含まれます。
risk_details
String
アカウントリスク詳細です。複数のリスクタグは半角カンマ(,)で区切られます。例えばEO-Acc-UReqRateE(ユーザーリクエスト速度が速すぎる)です。
EO-Bot-User-Risk: attest-0000056382;attester_type="TC-EO-CAPTCHA";device_type="android";user_id="YWRtaW4=";user_operation="YWNjb3VudC5sb2dpbg==";risk_score=99;risk_level="high";risk_details="EO-Acc-UReqRateE"

Bot識別情報

EO-Bot-Botnet-ID

Botが属するネットワーク(ボットネット)の識別子を付与します。同一のBotネットワークに属するリクエストは同じ識別子を付与されるため、オリジンサーバーはこれに基づいてクラスタリング処理を行うことができます。
関連機能モジュール:高度なBot管理
フィールド
タイプ
説明
botnet_id
String
Botネットワーク識別子。例えば、0dad2a4c7f1e93b5c2d84e6f0a1b3c57。
EO-Bot-Botnet-ID: botnet_id="0dad2a4c7f1e93b5c2d84e6f0a1b3c57"


ヘルプとサポート

この記事はお役に立ちましたか?

フィードバック