すべてのプロダクト
Search
ドキュメントセンター

Web Application Firewall:ポリシー設定

最終更新日:Aug 12, 2026

このトピックでは、Agentic API セキュリティの組み込みポリシーとカスタムポリシーの設定について説明します。Agentic API セキュリティは、組み込みの検出メカニズムに基づき、お客様のビジネス特性に合わせたカスタム検出ポリシーをサポートします。リスク検出、セキュリティイベント、機密データ、認証情報、ビジネス目的、ホワイトリスト、ライフサイクル管理、ログサブスクリプション、および対象オブジェクトを設定することで、識別された API データを実際のビジネスシナリオにより適合させることができます。これにより、API セキュリティ検出の精度と再現率がさらに向上し、ビジネスニーズに基づいた適切なアクションを実行し、API ビジネス資産への攻撃による損失を削減するのに役立ちます。

I. リスク検出設定

リスクとは、開発上の欠陥、または API の管理および設定の不備によって引き起こされるセキュリティリスクや脆弱性を指します。セキュリティリスクとセキュリティイベントの違いは、セキュリティリスクが必ずしも攻撃が発生したことを示すわけではないのに対し、セキュリティイベントは攻撃によってトリガーされたアラートを示す点です。

組み込みポリシー設定

ポリシー設定の リスク検出の設定 タブで、設定済みのリスクポリシーを表示できます。組み込みポリシーはデフォルトで有効になっています。有効化ステータスを変更したり、リスクレベルを調整したりできます。ビジネスニーズに応じて、組み込みポリシーのリスクレベルを「低」、「中」、「高」に設定できます。

カスタムポリシー設定

組み込みポリシーに加えて、リスク検出設定では最大 20 個のカスタムポリシーを作成できます。カスタムポリシーの設定ルールは次のとおりです。

  1. API リクエストセキュリティ ページで、ポリシーの設定 > リスク検出の設定 タブを選択します。

  2. 左側のペインで、カスタムポリシーセクションの New をクリックして、設定ドロワーを開きます。次の表に、設定パラメーターを示します。

    パラメーター

    説明

    リスクステータス

    ポリシーのステータスを設定します。デフォルト値は「有効」です。

    リスク名

    カスタムリスクの名前を設定します。名前に漢字、大文字と小文字の英字、数字、ピリオド (.)、アンダースコア (_)、ハイフン (-) を使用できます。

    Suggestions

    ビジネスニーズに応じて、カスタムリスクポリシーの対処に関する提案を設定します。

    Risk Level

    リスクレベルを「低」、「中」、「高」に設定できます。

    検出の設定

    カスタムリスクポリシーの検出条件を設定します。最大 10 個の条件をサポートします。

    次の表に、論理演算子や一致コンテンツの例など、検出設定の詳細な構成を示します。

    説明
    • 最大 50 個の一致コンテンツ項目を入力し、Enter キーを押して確定できます。

    • リスク検出の設定 の一致コンテンツは、大文字と小文字を区別します。

    詳細な設定

    一致フィールド

    サブ条件 (入力/選択必須)

    論理演算子

    一致コンテンツの説明

    ドメイン名

    サポートされていません

    いずれかの値を含む

    いずれの値も含まない

    いずれかの値に等しい

    いずれの値とも等しくない

    複数の値を入力できます (最大 50 個)。Enter キーを押して確定します。

    API

    サポートされていません

    いずれかの値を含む

    いずれの値も含まない

    いずれかの値に等しい

    いずれの値とも等しくない

    複数の値を入力できます (最大 50 個)。Enter キーを押して確定します。

    リクエストメソッド

    サポートされていません

    いずれかの値に等しい

    いずれの値とも等しくない

    複数選択。GET、POST、DELETE、PUT などのリクエストメソッドを選択できます。

    User-Agent

    サポートされていません

    いずれかの値を含む

    いずれの値も含まない

    いずれかの値に等しい

    いずれの値とも等しくない

    複数の値を入力できます (最大 50 個)。Enter キーを押して確定します。

    Referer

    サポートされていません

    いずれかの値を含む

    いずれの値も含まない

    いずれかの値に等しい

    いずれの値とも等しくない

    複数の値を入力できます (最大 50 個)。Enter キーを押して確定します。

    プロトコル

    サポートされていません

    等しい

    リスト。HTTP または HTTPS を選択できます。

    リクエスト Content-Type

    サポートされていません

    いずれかの値を含む

    いずれの値も含まない

    複数の値を入力できます (最大 50 個)。Enter キーを押して確定します。

    リクエスト長

    サポートされていません

    等しい

    未満

    より大きい

    0 から 8192 までの整数。

    レスポンス Content-Type

    サポートされていません

    いずれかの値を含む

    いずれの値も含まない

    複数の値を入力できます (最大 50 個)。Enter キーを押して確定します。

    レスポンス長

    サポートされていません

    等しい

    未満

    より大きい

    0 から 8192 までの整数。

    レスポンスステータスコード

    サポートされていません

    いずれかの値に等しい

    いずれの値とも等しくない

    複数の値を入力できます (最大 50 個)。Enter キーを押して確定します。

    リクエストヘッダー

    カスタムヘッダー

    存在する

    存在しない

    長さが等しい

    指定長未満

    指定の長さより大きい

    いずれかの値を含む

    いずれの値も含まない

    Cookie パラメーター

    カスタム Cookie (完全一致)

    存在する

    存在しない

    長さが等しい

    指定長未満

    長さが次の値より大きい

    いずれかの値を含む

    いずれの値も含まない

    -

    GET パラメーター

    カスタムパラメーター

    存在する

    存在しない

    長さが等しい

    指定長未満

    長さが次より大きい

    いずれかの値を含む

    いずれの値も含まない

    -

    POST パラメーター

    カスタム Post-Arg

    存在する

    存在しない

    長さが等しい

    指定長未満

    長さ超過

    いずれかの値を含む

    いずれの値も含まない

    -

    レスポンスヘッダー

    レスポンスヘッダー

    存在する

    存在しない

    長さが等しい

    指定長未満

    長さが次の値より大きい

    いずれかの値を含む

    いずれの値も含まない

    -

    レスポンスパラメーター

    レスポンスパラメーター

    存在する

    存在しない

    長さが等しい

    長さが次より小さい

    長さが次より大きい

    いずれかの値を含む

    いずれの値も含まない

    -

    ビジネス目的

    サポートされていません

    いずれかの値を含む

    いずれの値も含まない

    ビジネス目的リスト。複数選択がサポートされています。

    説明

    ビジネス目的のタイプに関する詳細については、「API セキュリティは API のビジネス目的をどのように分類しますか」をご参照ください。

    サービスオブジェクト

    サポートされていません

    いずれかの値を含む

    いずれの値も含まない

    複数選択。サービスオブジェクトリスト。

    説明

    サービスオブジェクトのタイプに関する詳細については、「API セキュリティは API のサービスオブジェクトをどのように区別しますか」をご参照ください。

    認証

    サポートされていません

    等しい

    はい/いいえ

    リクエスト機密データタイプ

    サポートされていません

    いずれかの値を含む

    いずれの値も含まない

    型の数が次より大きい

    リストから機密データタイプを選択します。複数選択がサポートされています。「型の数が次より大きい」条件では、0 から 8192 までの整数を入力します。

    リクエスト機密データレベル

    サポートされていません

    いずれかの値を含む

    いずれの値も含まない

    S1~S4。複数選択がサポートされています。

    レスポンス機密データタイプ

    サポートされていません

    いずれかの値を含む

    いずれの値も含まない

    ~を超える種類数

    リストから機密データタイプを選択します。複数選択がサポートされています。「型の数が次より大きい」条件では、0 から 8192 までの整数を入力します。

    レスポンス機密データレベル

    サポートされていません

    いずれかの値を含む

    いずれの値も含まない

    S1~S4。複数選択がサポートされています。

    レスポンス機密データ

    リストからレスポンス機密データを選択します。複数選択がサポートされています。

    カウントが次より大きい

    0 から 8192 までの整数。

    ソース地理的位置

    サポートされていません

    等しい

    CN / NOT-CN

    IP アドレス

    サポートされていません

    所属する

    所属しない

    IP アドレスまたは IP/マスク (例:1.1.X.X/24) を入力します。正規表現はサポートされていません。最大 50 個のエントリをカンマ (,) で区切るか、Enter キーを押して確定できます。

    アカウント (セキュリティイベントのみ)

    サポートされていません

    いずれかの値に等しい

    いずれの値とも等しくない

    複数の値を入力できます (最大 50 個)。Enter キーを押して確定します。

  3. カスタム設定が完了したら、OK をクリックして設定を保存します。

II. セキュリティイベント設定

セキュリティイベントは、API が異常な呼び出しや攻撃動作を経験したことを示します。例えば、ログイン API へのブルートフォース攻撃や、SMS 送信 API を悪用した SMS 爆弾などです。組み込みのイベント検出では、IP アドレスとアカウントを検出ディメンションとして使用します。

組み込みポリシー設定

組み込みのセキュリティイベントポリシーがアラートをトリガーした場合、攻撃が継続しても新しいアラートは生成されません。ただし、既存のアラートの攻撃時間は更新され、攻撃量などの要因に基づいてアラートの深刻度レベルが変更されることがあります。

ポリシー設定の セキュリティイベントの設定 タブで、設定済みのセキュリティイベントポリシーを表示できます。組み込みポリシーはデフォルトで有効になっています。有効化ステータスを変更したり、リスクレベルを調整したりできます。

カスタムポリシー設定

組み込みポリシーに加えて、セキュリティイベント設定では最大 10 個のカスタムポリシーを作成できます。カスタムポリシーの設定ルールは次のとおりです。

  1. API リクエストセキュリティ ページで、ポリシーの設定 > セキュリティイベントの設定 タブを選択します。

  2. 左側のペインで、カスタムポリシーセクションの New をクリックして、設定ドロワーを開きます。次の表に、設定パラメーターを示します。

    パラメーター

    説明

    イベントステータス

    ポリシーのステータスを設定します。デフォルト値は「有効」です。

    Event Name

    カスタムイベントの名前を設定します。名前に漢字、大文字と小文字の英字、数字、ピリオド (.)、アンダースコア (_)、ハイフン (-) を使用できます。

    Suggestions

    ビジネスニーズに応じて、カスタムセキュリティイベントの対処に関する提案を設定します。

    Event Level

    リスクレベルを「低」、「中」、「高」に設定できます。

    一致条件

    カスタムセキュリティイベントポリシーの検出条件を設定します。最大 10 個の条件をサポートします。

    説明

    複数の条件が定義されている場合、すべての条件が満たされた場合にのみルールがトリガーされます。

    Rate Limiting

    Statistical Object を IP またはアカウントに設定し、統計期間 を分単位 (最大 15 分) で設定し、リクエスト数 を正の整数のみに設定します。

    データ統計

    カスタムセキュリティイベントポリシーの統計条件を設定します。最大 10 個の条件をサポートします。

    一致条件の詳細な設定 (対応する論理演算子や一致コンテンツの例を含む) については、リスク検出セクションの「詳細な設定」をご参照ください。

    説明
    • 最大 50 個の一致コンテンツ項目を入力し、Enter キーを押して確定できます。

    • セキュリティイベントの設定 の一致コンテンツは、大文字と小文字を区別します。

    次の表に、論理演算子や一致コンテンツの例など、データ統計の詳細な構成を示します。

    詳細な設定

    一致フィールド

    サブ条件 (入力/選択必須)

    論理演算子

    一致コンテンツの説明

    ステータスコード統計

    ステータスコード (100 から 600 までの整数)

    より大きい

    0 から 8192 までの整数。

    リクエストヘッダー

    カスタムヘッダー

    重複排除後のカウントが次より小さい

    重複排除後のカウントが等しい

    重複排除後のカウントが次より大きい

    0 から 8192 までの整数。

    Cookie パラメーター

    カスタム Cookie (完全一致)

    重複排除後のカウントが次より小さい

    重複排除後のカウントが等しい

    重複排除数超過

    0 から 8192 までの整数。

    GET パラメーター

    カスタムパラメーター

    重複排除後のカウントが次より小さい

    重複排除後のカウントが等しい

    重複排除後のカウントが次より大きい

    0 から 8192 までの整数。

    POST パラメーター

    カスタム ポスト引数

    重複排除後のカウントが次より小さい

    重複排除後のカウントが等しい

    重複排除後のカウントが次より大きい

    0 から 8192 までの整数。

    レスポンス機密データタイプ

    レスポンス機密データタイプを選択します。複数選択がサポートされています。

    重複排除後のカウントが次より大きい

    0 から 8192 までの整数。

    レスポンス機密データレベル

    レスポンス機密データレベルを選択します。複数選択がサポートされています。

    重複排除後のカウントが次より大きい

    0 から 8192 までの整数。

    ソース IP カウント統計

    ソース IP カウントのしきい値を設定します。

    より大きい

    0 から 8192 までの整数。

    説明

    Agentic API セキュリティにおけるレスポンス機密データ情報は、デフォルトでサンプリングを使用して分析されます。カスタムセキュリティイベントポリシーでレスポンス機密データタイプとレスポンス機密データレベルを設定する場合、保護対象のすべてのレスポンス機密データ情報が記録および分析されるようにするには、ポリシーの設定 > 有効オブジェクトの設定 で対応する保護対象の トレーサビリティ監査 スイッチを有効にする必要があります。

  3. カスタム設定が完了したら、OK をクリックして設定を保存します。

III. 機密データの設定

ポリシー設定の 機密データの設定 タブで、次の項目を表示および設定できます。

  • 機密データタイプの設定:システムには、ID 番号や携帯電話番号などの一般的な機密データタイプに対する組み込みの検出ロジックがあります。ビジネスニーズに応じて、機密データタイプをカスタマイズすることもできます。

  • API リアルタイムマスキング:AI ベースラインエンジンに基づくインテリジェント保護機能は、API 構造を自律的に学習し、機密データをリアルタイムで識別して、きめ細かな自動データマスキングを実現します。この機能は手動でフィールドを事前定義する必要がなく、複雑なビジネスシナリオに柔軟に対応して、国境を越えたデータ転送などのコンプライアンス要件を満たし、完全に自動化されたリアルタイム保護を実現します。

機密データタイプの設定

機密データの設定 タブで、左側のリストの 機密データタイプの設定 をクリックして、次の項目を表示および設定します。

組み込み機密データタイプ

組み込みのシステムポリシーはデフォルトで有効になっています。編集、変更、削除はできません。有効または無効にすることのみ可能です。

カスタム機密データタイプ

ビジネスで独自の機密データを定義している場合は、カスタムの機密データ検出ルールを設定できます。機密データに対して最大 20 個のカスタムポリシーを設定できます。

ポリシーの新規作成 をクリックして、表示されるドロワーページで設定を行います。現在、簡易モードエキスパートモード の 2 つのモードでカスタムポリシーを設定できます。

設定項目

説明

名前

ルールの名前を設定します。

モード

カスタムポリシーの検出モードを設定します。

  • 基本モード:使いやすさを考慮した簡略化された設定インターフェイスを提供します。

    簡易モード を選択した後、文字長さ を設定する必要があります。

    • 文字:数字、大文字、小文字の検出をサポートします。複数選択が可能です。

    • 長さ:サポートされる検出長の範囲は 6 から 64 で、開始値と終了値は整数でなければなりません。

  • エキスパートモード:検出用の正規表現を入力します。誤認を避けるため、一致する文字が 6 文字以上であることを確認してください。

レベル

検出された機密データの感度レベルを設定します。オプション:S1、S2、S3、S4。

説明

機密データタイプの詳細については、「API セキュリティが検出できる機密データ」をご参照ください。

マスキング表示

機密データ設定タブには、マスキング表示 スイッチがあります。デフォルトでは無効になっており、データはマスクされた形式で表示されません。

データマスキングを有効にすると、次の情報がマスクされます。

  • Risk DetailsAPI Details では、リクエストとレスポンスのサンプルのすべてのフィールドにある機密データが、デフォルトでプレースホルダー {{Phone}} に置き換えられます。

  • セキュリティイベントの Event Details では、機密データを含むリクエストとレスポンスのデータサンプルがマスクされ、{} として表示されます。

  • サンプル情報のリクエスト Cookie は {{Cookie}} としてマスクされ、トークンを含むリクエストヘッダーは {{XXXToken}} としてマスクされ、レスポンス SetCookie は {{SetCookie}} としてマスクされます。

データマスキング機能の効果範囲は次のとおりです。

  • Risk DetailsAPI Details:新しいリクエストとレスポンスのデータサンプル情報にのみ適用されます。

  • Event Details:新規および既存のリクエストとレスポンスのデータサンプル情報の両方に適用されます。

API リアルタイムマスキング

機密データの設定 タブで、左側のリストの API リアルタイムマスキング をクリックし、次に テンプレートの作成 をクリックしてマスキングテンプレートを設定します。

  • テンプレート名:認識しやすいテンプレート名を設定します。

  • マスキングルール設定ルールの作成 をクリックして、特定のマスキングルールを設定します。複数のルールを設定できます。

    • Rule Name:認識しやすいルール名を設定します。

    • Sensitive Data Type:マスクするデータタイプを選択します。組み込みの機密データタイプのみがサポートされています。

    • 一致条件:ルールをトリガーする HTTP 条件を設定します。0 から 5 個の条件を設定できます。条件が設定されていない場合、ルールはすべての HTTP リクエストに対してトリガーされます。

      説明

      ルールに複数の条件が含まれている場合、リクエストがすべての条件 (論理 AND) を満たした場合にのみルールがトリガーされます。一致フィールドと論理演算子の詳細な説明については、「一致条件」をご参照ください。

    • データ処理方式:次の 2 つの処理方法がサポートされています。

      • マスキング:データをマスクします。さらに、特定のマスキング Action を設定する必要があります。オプション:クリアマスク

      • 観察:データをマスクせず、ログのみを記録します。

  • 有効対象:ルールを適用する API 資産を指定します。高、中、または低の感度レベルを持つ資産のみがサポートされています。各対象オブジェクトには、1 つのマスキングテンプレートしか設定できません。

テンプレートが作成された後、新しく追加された対象オブジェクトに対してマスキングルールが有効になるまで 10 ~ 20 分待ちます。API マスキングログを表示するには、[セキュリティレポート] ページに移動します。

作成されたテンプレートでは、次の管理操作がサポートされています。

  • テンプレートとルールの有効化または無効化。

  • テンプレートへのルールの追加。

  • テンプレートとルール情報の編集。

  • テンプレートとルールの削除。

IV. 認証情報設定

ビジネスで非従来型のフィールドを認証フィールドとして使用している場合、または純粋な数字など特徴の弱い認証フィールド名を使用している場合は、カスタム認証情報を設定することをお勧めします。組み込みの認証情報検出に基づき、パラメーター名を指定して、組み込みモデルがリクエストに認証情報が含まれているかどうかを正確に識別するのを助け、API セキュリティと未認証リスク検出の精度を向上させます。

  1. API リクエストセキュリティ ページで、ポリシーの設定 > 権限付与の資格情報に関する設定 タブを選択します。

  2. ポリシーの新規作成 をクリックし、次の設定を完了してから OK をクリックします。

    設定項目

    説明

    名前

    ポリシーの名前を設定します。

    中国語文字、大文字と小文字のアルファベットがサポートされています。数字、ピリオド (.)、アンダースコア (_)、ハイフン (-) も使用できます。

    一致条件

    各条件は、マッチフィールド論理記号、および マッチコンテンツ で構成されます。最大 10 個の条件がサポートされています。設定時には、リクエストヘッダー、リクエスト Cookie、リクエストクエリ、またはリクエストボディに対して、少なくとも 1 つの一致条件を追加する必要があります。

    説明

    複数の条件が定義されている場合、すべての条件が同時に満たされた場合にのみルールがトリガーされます。

    一致条件の詳細な設定については、次の表で対応する論理演算子と一致コンテンツの例をご参照ください。

    説明
    • 最大 50 個の一致する値を入力し、Enter キーを押して確定できます。

    • 権限付与の資格情報に関する設定 の一致コンテンツは、大文字と小文字を区別します。

    詳細な設定

    一致フィールド

    サブ条件 (入力/選択必須)

    論理演算子

    一致コンテンツの説明

    ドメイン

    サポートされていません

    いずれかの値を含む

    いずれの値も含まない

    いずれかの値に等しい

    いずれの値とも等しくない

    複数の値を入力できます (最大 50 個)。Enter キーを押して確定します。

    API

    サポートされていません

    いずれかの値を含む

    いずれの値も含まない

    いずれかの値に等しい

    いずれの値とも等しくない

    複数の値を入力できます (最大 50 個)。Enter キーを押して確定します。

    リクエストヘッダー

    カスタムヘッダー

    存在する

    長さが等しい

    指定の長さ未満

    長さが次より大きい

    リクエスト Cookie

    カスタム Cookie (完全一致)

    存在する

    長さが等しい

    指定長未満

    長さが次より大きい

    リクエストクエリ

    カスタムパラメーター

    存在する

    長さが等しい

    指定長未満

    長さが次より大きい

    リクエストボディ

    カスタム Post-Arg

    存在する

    長さが等しい

    指定長未満

    長さが次より大きい

V. ビジネス目的設定

Agentic API セキュリティは、次の 2 種類のビジネス目的ポリシーを提供します。

組み込みポリシー設定

データ更新、データ共有、モバイル SMS 送信、情報送信など、複数のシナリオに対応する組み込みのビジネス目的ポリシーが提供されています。組み込みポリシーはデフォルトで有効になっており、変更や削除はできません。必要に応じて各ポリシーを有効または無効にできます。

カスタムポリシー設定

組み込みポリシーがビジネスニーズを満たさない場合は、URL の特徴とパラメーター名の特徴をカスタマイズして、特定のビジネスシナリオにおける API セキュリティの検出精度をさらに向上させることができます。

  1. API リクエストセキュリティ ページで、ポリシーの設定 > ビジネス用途の設定 タブを選択します。

  2. カスタムポリシー をクリックしてカスタムポリシー管理に入ります。ポリシーの新規作成 をクリックし、次の設定を完了してから OK をクリックして設定を保存します。

説明
  • 最大 50 個の一致する値を入力し、Enter キーを押して確定できます。

  • ビジネス用途の設定 の一致コンテンツは、大文字と小文字を区別します。

詳細な設定

一致フィールド

論理演算子

一致コンテンツ

ドメイン

いずれかの値を含む

いずれの値も含まない

いずれかの値に等しい

いずれの値とも等しくない

複数の値を入力できます (最大 50 個)。Enter キーを押して確定します。

API

いずれかの値を含む

いずれの値も含まない

いずれかの値に等しい

いずれの値とも等しくない

複数の値を入力できます (最大 50 個)。Enter キーを押して確定します。

リクエストヘッダーパラメーター名

いずれかの値に等しい

いずれかの値を含む

複数の値を入力できます (最大 50 個)。Enter キーを押して確定します。

リクエスト Cookie パラメーター名

いずれかの値に等しい

いずれかの値を含む

複数の値を入力できます (最大 50 個)。Enter キーを押して確定します。

リクエストクエリパラメーター名

いずれかの値に等しい

いずれかの値を含む

複数の値を入力できます (最大 50 個)。Enter キーを押して確定します。

リクエストボディパラメーター名

いずれかの値に等しい

いずれかの値を含む

複数の値を入力できます (最大 50 個)。Enter キーを押して確定します。

リクエスト機密データタイプ

いずれかの値に等しい

いずれかの値を含む

リクエスト機密データタイプリストから選択します。複数選択が可能です。

レスポンス機密データタイプ

いずれかの値に等しい

いずれかの値を含む

レスポンス機密データタイプリストから選択します。複数選択が可能です。

レスポンスパラメーター名

いずれかの値に等しい

いずれかの値を含む

複数の値を入力できます (最大 50 個)。Enter キーを押して確定します。

VI. ホワイトリスト設定

Agentic API セキュリティのホワイトリスト設定機能を使用すると、セキュリティイベントとリスク検出のホワイトリストをカスタマイズできます。これにより、オフィスのネットワークからの IP アドレスによって生成されたアラートなど、実際のビジネスシナリオに基づいて不要なアラートノイズを除外し、運用効率を向上させることができます。

  1. API リクエストセキュリティ ページで、ポリシーの設定 > ホワイトリストの設定 タブを選択します。

  2. ポリシーの新規作成 をクリックし、ポリシーの名前を入力し、ホワイトリストを設定したい機能タイプを選択します。現在、Risk DetectionSecurity Events のホワイトリストを設定できます。

  3. 選択した機能タイプに基づいて一致条件を設定します。

    説明
    • 最大 10 個の一致条件がサポートされています。

    • ホワイトリストの設定 の一致条件は、大文字と小文字を区別します。

    リスク検出ホワイトリストの一致条件

    一致フィールド

    論理演算子

    一致コンテンツ

    ドメイン

    いずれかの値を含む

    いずれの値も含まない

    いずれかの値に等しい

    いずれの値とも等しくない

    複数の値を入力できます (最大 50 個)。Enter キーを押して確定します。

    API

    いずれかの値を含む

    いずれの値も含まない

    いずれかの値に等しい

    いずれの値とも等しくない

    複数の値を入力できます (最大 50 個)。Enter キーを押して確定します。

    セキュリティイベントホワイトリストの一致条件

    一致フィールド

    論理演算子

    一致コンテンツ

    ドメイン

    いずれかの値を含む

    いずれの値も含まない

    いずれかの値に等しい

    いずれの値とも等しくない

    複数の値を入力できます (最大 50 個)。Enter キーを押して確定します。

    API

    いずれかの値を含む

    いずれの値も含まない

    いずれかの値に等しい

    いずれの値とも等しくない

    複数の値を入力できます (最大 50 個)。Enter キーを押して確定します。

    IP

    所属する

    所属しない

    IP アドレスまたは IP/マスク (例:1.1.X.X/24) を入力します。正規表現はサポートされていません。最大 50 個のエントリをカンマ (,) で区切るか、Enter キーを押して入力します。

  4. 除外するリスク検出またはセキュリティイベントのタイプを選択し、OK をクリックして設定を保存します。

    説明

    除外されるタイプは、組み込みオプションとカスタムオプションの両方をサポートし、複数選択が可能です。

VII. ライフサイクル管理

Agentic API セキュリティでは、1 日あたりの訪問数としきい値期間を設定することで、非アクティブな API を識別するための基準をカスタマイズできます。これにより、非アクティブな API の検出が実際のビジネス状況により適合するようになります。ライフサイクル管理は、カスタム基準を満たす非アクティブな API を識別するのに役立ち、タイムリーなアクションを取り、攻撃者が非アクティブな API を悪用するのを防ぎ、不要なビジネス損失を回避できます。

  1. API リクエストセキュリティ ページで、ポリシーの設定 > ライフサイクル管理 タブを選択します。

  2. 非アクティブな API を識別するための基準を設定した後、OK をクリックします。

    • 組み込みモデル をクリックします。

      これにより、組み込みの基準が使用されます。API は、過去 8 日間に訪問がない場合、またはトラフィックが大幅に減少した場合に非アクティブと見なされます。

    • カスタム をクリックし、1 日あたりの訪問数と期間 (最大 31 日) を設定します。

      API の 1 日あたりの訪問数が、カスタム期間にわたって指定されたしきい値を下回る場合、その API は非アクティブとして識別されます。

重要

資産の 最終アクティブ時間 が 30 日を超えると、システムは自動的にその資産と関連するリスクデータおよびセキュリティイベントの記録を削除します。

VIII. ログサブスクリプション設定

Log Service コンソールで作成した指定の LogStore に、資産情報、リスク情報、またはイベント情報のログサブスクリプションを有効にすると、配信条件が満たされたときにログが配信されます。これにより、Alibaba Cloud Log Service (SLS) の機能を使用してログを一元的に管理および操作できます。

説明

現在、中国本土の WAF インスタンスは中国本土の LogStore にのみログを配信でき、中国本土以外の WAF インスタンスは中国本土以外の LogStore にのみログを配信できます。中国本土と中国本土以外の間のリージョンをまたいだログ配信はサポートされていません。

サービスリンクロールの有効化

Web Application Firewall のサービスリンクロールをまだ有効にしていない場合は、Agentic API セキュリティのログサブスクリプションサービスを使用する前に有効にする必要があります。プロンプトに従ってロールを有効にし、WAF が他のクラウドリソースにアクセスすることを承認します。サービスリンクロールの詳細については、「サービスリンクロール」をご参照ください。WAF ログサービスなどの機能を有効にする際にすでに承認を完了している場合は、このステップをスキップしてください。

ログサブスクリプション設定

  1. Agentic API セキュリティのログサブスクリプションタスクを設定する前に、Log Service コンソールを開き、ログサブスクリプションを受け取る Project と LogStore を作成します。すでに対象の LogStore を作成し、その名前が命名規則に準拠していることを確認している場合は、次のステップに進んでください。

    説明

    ログサブスクリプション機能は現在、Log Service によって自動的に作成された Logstore、または「waf-logstore」、「wafng-logstore」、「wafnew-logstore」とカスタム名が付けられた Logstore をログサブスクリプションの宛先として選択することをサポートしていません。

  2. 作成後、ログサブスクリプションタブに戻り、資産情報、リスク情報、攻撃イベント情報のサブスクリプションを設定します。指定した LogStore に配信されたログを Log Service コンソールでクエリおよび分析したい場合は、まずインデックス作成を有効にします。詳細については、「インデックスの作成 — 変更手順」をご参照ください。

  3. サブスクリプションタスクのログタイプを選択し、設定 ボタンをクリックして設定ページに移動します。

  4. LogStore があるリージョン、Project 名、LogStore 名を選択し、OK ボタンをクリックして設定を保存します。設定が完了し、ログが生成されたら、Log Service コンソールの対応する LogStore に戻ってログをクエリおよび分析できます。データマスキングなどのログ処理を行いたい場合は、「データ処理」をご参照ください。

  5. ログサブスクリプションタスクを無効にし、既存のログが不要になった場合は、継続的な課金を避けるため、ログサブスクリプションの設定 タブでタスクを無効にした後、対応する LogStore を削除してください。 詳細については、「Log Service を無効にするか、課金を停止する方法」をご参照ください。

以下に、ログサブスクリプションタスクのトリガー条件と詳細なフィールド説明を示します。

重要
  • Log Service でのクラウドリソースの作成とインデックスの有効化には、Log Service プロダクトによる追加料金が発生します。課金項目と料金の詳細については、「Log Service の課金概要」をご参照ください。

  • プロジェクトや Logstore を作成した後、ログサブスクリプションタスクを有効にしていなくても、料金が発生することがあります。作成した Logstore が不要になった場合は、追加料金の発生を避けるため、速やかに削除してください。詳細については、「プロジェクトと Logstore のみを作成した場合に料金が発生する理由」をご参照ください。

資産情報ログ

ログサブスクリプションのトリガー条件:

  1. 新しい API 資産が追加されると、資産情報ログが直ちに配信されます。

  2. 新しい API 資産が追加されない場合、資産情報ログはデフォルトで 1 時間ごとに定期的に配信されます。

資産情報ログのフィールド

フィールド名

説明

フィールド形式

user_id

顧客 UID

string

123456

service_host

ドメイン

string

api.aliyun.com

api_format

API パス

string

/api/v1/getuserbyid/${param}

request_method

リクエストメソッド

string

GET

api_tag

ビジネス目的

object []

['QueryInfo']

api_type

サービス対象

object []

['PublicAPI']

auth_key

認証フィールド

object []

['id_token', 'access_token']

api_status

ライフサイクル

string

NewbornInterface

api_sensitive_level

API 感度レベル

string

L1

api_sensitive_req

機密データ型のリクエスト

object []

['1014', '1017', '1002']

api_sensitive_res

レスポンス機密データタイプ

object []

['1009', '1013', '1003', '1014', '1002']

farthest_ts

初回発見時刻

long

1713237135

lastest_ts

最終アクティブ時刻

long

1716452318

abnormal_num

リスク数

integer

1

event_num

イベント数

integer

2

struct_baseline

パラメーター構造

object

['{"key":"Trace-Id","location":"request_header","format":"string","required":"true"}', '{"key":"pageNum","location":"request_query","format":"integer","required":"true"}', '{"key":"tlogTraceId","location":"response_header","format":"integer","required":"true"}', '{"key":"Strict-Transport-Security","location":"request_header","format":"string","required":"true"}', '{"key":"X-Forwarded-ClientSrcPort","location":"request_header","format":"integer","required":"true"}', '{"key":"Trace-State","location":"request_header","format":"string","required":"true"}', '{"key":"auth","location":"request_header","format":"string","required":"true"}', '{"key":"Access-Control-Max-Age","location":"response_header","format":"integer","required":"true"}', '{"key":"Enterprise-Hash","location":"request_header","format":"string","required":"true"}', '{"key":"X-Request-ID","location":"request_header","format":"string","required":"true"}', '{"key":"postName","location":"request_query","format":"string","required":"true"}', '{"key":"pageSize","location":"request_query","format":"integer","required":"true"}']

matched_hosts

保護対象

object []

['*.aliyun.com-waf']

hosts

ドメイン

object []

['api.aliyun.com']

server_port

ポート

object []

['443']

server_location

オリジンサーバーの国

object []

['CN']

api_id

一意の API ID

string

af418cb31036015fddea71b48d06aa4b

log_type

ログタイプ

string

asset

request_header

リクエストヘッダー

JSON

{"Connection":"Keep-Alive","Host":"api.aliyun.com","eagleeye-rpcid":"0.1"}

querystring

リクエスト URL パラメーター

string

?token=7464f593205896e23b1286ba7532dcff

request_body

リクエストボディ

string

xxx=1

response_header

レスポンスヘッダー

JSON

{"Accept-Ranges":["bytes","bytes"],"Cache-Control":"private, max-age=21600, no-transform"}

response_body

レスポンスボディ

string

xxxx

example_timestamp

サンプルタイムスタンプ

long

1718546694

example_traceid

サンプルトレース ID

string

784e2ca717213678365778292e58de

リスク情報ログ

ログサブスクリプションのトリガー条件:新しいリスク情報が検出されると、リスク情報ログが指定された LogStore に配信されます。

リスク情報ログのフィールド

フィールド名

説明

フィールド形式

user_id

顧客 UID

string

123456

service_host

ドメイン

string

api.aliyun.com

api_format

API パス

string

/api/v1/login

request_method

リクエストメソッド

string

POST

api_tag

ビジネス目的

object []

['LoginAPI']

abnormal_tag

リスク名

string

Risk_DefaultPasswd

abnormal_type

リスクタイプ (カスタム/組み込み)

string

default

abnormal_level

リスクレベル

string

medium

abnormal_discover_ts

リスク発見時刻

long

1716343432

abnormal_info

リスク情報

object

{'default_passwd':'aliyun123'}

api_id

一意の API ID

string

2c0f97e10b586208039e60671150bd9b

abnormal_id

一意のリスク ID

string

8cfccc0e8c3d41aa1221e94a2fdeffe3

log_type

ログタイプ

string

risk

matched_hosts

保護対象

object []

['*.aliyun.com-waf']

request_header

リクエストヘッダー

JSON

{"Connection":"Keep-Alive","Host":"api.aliyun.com","eagleeye-rpcid":"0.1"}

querystring

リクエスト URL パラメーター

string

?token=7464f593205896e23b1286ba7532dcff

request_body

リクエストボディ

string

xxx=1

response_header

レスポンスヘッダー

JSON

{"Accept-Ranges":["bytes","bytes"],"Cache-Control":"private, max-age=21600, no-transform"}

response_body

レスポンスボディ

string

xxxx

example_timestamp

サンプルタイムスタンプ

long

1718546694

example_traceid

サンプルトレース ID

string

784e2ca717213678365778****58de

攻撃イベント情報ログ

ログサブスクリプションのトリガー条件:

  1. 新しい攻撃イベントが検出されると、新しい攻撃イベント情報ログが指定された LogStore に配信されます。

  2. 攻撃が継続する場合、攻撃イベント情報ログは 10 分間隔で継続的に指定された LogStore に配信されます。

攻撃イベント情報ログのフィールド

フィールド名

説明

フィールド形式

user_id

顧客 UID

string

123456

service_host

ドメイン

string

api.aliyun.com

matched_host

保護対象

string

api.aliyun.com-waf

host

ドメイン

string

api.aliyun.com

api_format

API パス

string

/api/admin/login

request_method

リクエストメソッド

string

POST

api_tag

ビジネス目的

object []

['AdminService', 'LoginService']

event_tag

イベント名

string

Event_LoginCollision

event_origin

イベントタイプ (カスタム/組み込み)

string

default

event_level

イベントレベル

string

high

start_ts

攻撃開始時刻

long

1713886210

end_ts

攻撃終了時刻

long

1713887817

attack_cnt

総攻撃数

integer

147

attack_ip_info

攻撃 IP 情報

object []

[{'ip':'103.44.XX.XXX', 'country_id':'HK', 'region_id':'-', 'cnt':'147'}]

api_id

一意の API ID

string

4dfc73b37d2d645fe2ca7f45c08f7398

event_id

イベント ID

string

f09f6802e9b57a58ebb9f1bea212027e

log_type

ログタイプ

string

event

request_data

サンプルリクエストデータ

JSON

{'1002':['Alice','Bob','Carl'],'1004':['13200000001','15200000002']}

response_data

サンプルレスポンスデータ

JSON

{'postarg.userId':['lisi111','zhangsan123'],'postarg.corpId':['wx1111111'],'postarg.externalUserid':['wm7_KpDgOm6Bm-BGA']}

ログサブスクリプションフィールド値の説明

ログの分析やクエリ中にフィールド値の意味を理解したり、コンソールに表示される名前との対応を確認したりする必要がある場合は、次の表をご参照ください。「説明」列には、Web Application Firewall コンソールに表示される各フィールド値に対応する名前が示されています。

ライフサイクル (api_status)

フィールド値

説明

NewbornInterface

新規

OfflineInterface

非アクティブ

normal

通常

サービス対象 (api_type)

フィールド値

説明

PublicAPI

パブリックサービス

ThirdpartAPI

サードパーティ連携

InternalAPI

社内オフィス

ビジネス目的 (api_tag)

フィールド値

説明

LoginByUserPasswd

ユーザー名とパスワードによるログイン

LoginByPhoneCode

SMS 認証コードによるログイン

LoginByMailCode

メール認証コードによるログイン

WeChatLogin

WeChat ログイン

AliPayLogin

Alipay ログイン

OAuthLogin

OAuth 認証

OIDCLogin

OIDC 認証

SAMLLogin

SAML 認証

SSOLogin

SSO 認証

LoginAPI

ログインサービス

LogoutAPI

ログアウト

RegisterByUserPasswd

ユーザー名とパスワードによる登録

RegisterByPhoneCode

SMS 認証コードによる登録

RegisterByMailCode

メール認証コードによる登録

WeChatRegister

WeChat 登録

AliPayRegister

Alipay 登録

RegisterAPI

登録サービス

SendSMS

SMS 送信

SendMail

メール送信

ResetPasswd

パスワードリセット

CheckVerifyCode

認証コードチェック

CheckStatus

ステータスチェック

QueryOrder

注文クエリ

ExportOrder

注文エクスポート

UpdateOrder

注文更新

PayOrder

注文支払い

QueryLog

ログクエリ

UploadLog

ログレポート

DownloadLog

ログエクスポート

LogService

ログサービス

GraphQL

GraphQL

SqlService

SQL サービス

FileUpload

ファイルアップロード

FileDownload

ファイルダウンロード

FileService

ファイルサービス

AdminService

管理者管理

DashBoard

ダッシュボード

MonitorService

監視サービス

SendInfo

データ送信

CheckInfo

データチェック

QueryInfo

データクエリ

UploadInfo

データアップロード

DownloadInfo

データダウンロード

AddInfo

データ追加

EditInfo

データ編集

UpdateInfo

データ更新

ShareInfo

データ共有

DeleteInfo

データ削除

SyncInfo

データ同期

SubmitInfo

データ送信

CopyInfo

データコピー

AuditInfo

データ監査

SaveInfo

データ保存

CancelOp

キャンセル

StartOp

開始

BatchOp

バッチ処理

PauseOp

一時停止

BindOp

バインド

DebugOp

デバッグ

SetOp

設定

ShutDown

シャットダウン

リクエスト機密データタイプ、レスポンス機密データタイプ (api_sensitive_req, api_sensitive_res)

フィールド値

説明

1000

ID カード番号 (中国本土)

1001

デビットカード

1002

名前 (簡体字中国語)

1003

住所 (中国本土)

1004

携帯電話番号 (中国本土)

1005

メール

1006

パスポート番号 (中国本土)

1007

香港・マカオ通行許可証

1008

ナンバープレート番号 (中国本土)

1009

電話番号 (中国本土)

1010

軍官証

1011

性別

1012

民族

1013

省 (中国本土)

1014

市 (中国本土)

1015

ID カード番号 (香港)

1016

名前 (繁体字中国語)

1017

名前 (英語)

1018

ID カード番号 (マレーシア)

1019

ID カード番号 (シンガポール)

1020

クレジットカード

1022

SWIFT コード

1023

SSN

1024

電話番号 (米国)

1025

宗教的信条

2000

IP アドレス

2001

MAC アドレス

2002

JDBC 接続文字列

2003

PEM 証明書

2004

秘密鍵

2005

AccessKey ID

2006

AccessKey Secret

2007

IPv6 アドレス

2009

日付

2010

IMEI

2011

MEID

2013

Linux パスワードファイル

2014

Linux シャドウファイル

2015

URL

4000

営業許可証番号

4001

税務登録証明書番号

4002

組織コード

4003

統一社会信用コード

4004

車両識別番号

リスクタイプ (risk)

フィールド値

説明

RiskType_Specification

セキュリティ仕様

Risk_UnsafeHttpMethod

安全でない HTTP メソッド

Risk_WeakSignAlgorithm

脆弱な JWT 署名アルゴリズム

Risk_UrlParam

パラメーターとしての URL

RiskType_Account

アカウントセキュリティ

Risk_PasswdUnencrypt

平文パスワード送信

Risk_WeakPasswd

脆弱なパスワードが許可されている

Risk_InternalWeakPasswd

内部アプリケーションの脆弱なパスワード

Risk_DefaultPasswd

デフォルトパスワードが存在する

Risk_PasswdResponse

平文パスワードが返される

Risk_PasswdCookie

Cookie に保存されたパスワード

Risk_LoginRestrict

ログイン API に制限がない

Risk_LoginPrompt

不合理なログイン失敗プロンプト

Risk_PasswdUrl

URL 経由で送信されるユーザー名とパスワード

RiskType_Control

アクセス制御

Risk_InternalAPI

パブリックネットワークからアクセス可能な内部アプリケーション

Risk_SourceRestrict

API がアクセス元を制限していない

Risk_ClientRestrict

API がアクセスツールを制限していない

Risk_SpeedRestrict

API がアクセスレートを制限していない

RiskType_Permission

権限管理

Risk_WeakToken

脆弱な認証情報

Risk_UnauthSensitive

認証なしの機密 API

Risk_UnauthInternalAPI

認証なしでアクセス可能な内部 API

Risk_TokenUrl

URL 経由で送信される認証情報

Risk_AkLeak

AK 情報の漏洩

RiskType_Sensitive

データ保護

Risk_SensitiveTypeExcessive

返される機密データの種類が多すぎる

Risk_SensitiveNumExcessive

返される機密データの量が多すぎる

Risk_InvalidDesensitize

機密データが効果的に匿名化されていない

Risk_ServerInfoLeak

サーバーの機密情報漏洩

Risk_InternalIPLeak

内部 IP アドレスの漏洩

Risk_SensitiveURL

URL 経由で送信される機密データ

RiskType_Design

API 設計

Risk_ParamTraverse

走査可能なリクエストパラメーター

Risk_PageSize

変更可能なレスポンスデータサイズ

Risk_SqlAPI

データベースクエリ

Risk_RceAPI

コマンド実行 API

Risk_SmsContent

任意の SMS コンテンツ送信

Risk_MailContent

任意のメールコンテンツ送信

Risk_SmsVerifyCodeLeak

SMS 認証コードの漏洩

Risk_MailVerifyCodeLeak

メール認証コードの漏洩

Risk_FileDownload

指定ファイルのダウンロード

Risk_ExceptionLeak

アプリケーション例外情報の漏洩

Risk_ExceptionSql

データベース例外情報の漏洩

イベントタイプ (event)

フィールド値

説明

Event_AbnormalFrequency

異常な高頻度アクセス

Event_ExceptionIPInvoke

異常な IP からの内部 API アクセス

Event_ExceptionRegionInvoke

異常なリージョンからの内部 API アクセス

Event_ExceptionClientInvoke

異常なツールによるアクセス

Event_ExceptionTimeInvoke

異常な時間帯のアクセス

Event_AbnormalParamValue

異常なパラメーター値でのアクセス

Event_InternalLoginWeakPasswd

内部アプリケーションの脆弱なパスワードでのログイン

Event_LoginAccountBruteForce

ユーザー名のブルートフォース

Event_LoginPasswdBruteForce

ログインパスワードのブルートフォース

Event_LoginCollision

クレデンシャルスタッフィング攻撃

Event_MobileVerifyBruteForce

SMS 認証コードのブルートフォース

Event_MailVerifyBruteForce

メール認証コードのブルートフォース

Event_AbnormalRegister

バッチ登録

Event_SMSInterfaceAbuse

悪意のある SMS リソース消費

Event_EmailInterfaceAbuse

悪意のあるメールリソース消費

Event_AbnormalExport

バッチダウンロード

Event_DataTraverse

API データトラバーサルとスクレイピング

Event_WebAttackAPI

API への悪意のある攻撃

Event_ObtainSensitiveUnauthorized

機密データへの不正アクセス

Event_ObtainSensitiveExcessive

大量の機密データへのアクセス

Event_CrossborderIPSensitiveExcessive

海外 IP からの大量の機密データアクセス

Event_ExceptionResponse

API レスポンスの異常なエラーメッセージ

Event_ExceptionSql

API レスポンスのデータベースエラーメッセージ

Event_SystemInfoResponse

API レスポンスのシステム機密情報

Event_AbnormalStatus

異常な API レスポンスステータス

IX. 対象オブジェクト設定

サブスクリプションベースの WAF

Agentic API セキュリティは、保護対象または保護対象グループレベルで 3 つの有効なスイッチを提供します。

  • 基本検査 スイッチ:デフォルトで有効。すべての組み込み検出メカニズムとカスタム検出ポリシーが有効になるかどうかを制御します。

  • コンプライアンス審査 スイッチ:デフォルトで無効。基本検査 スイッチが有効になった後にのみ有効にできます。コンプライアンス審査 機能が有効になるかどうかを制御します。

  • トレーサビリティ監査 スイッチ:デフォルトで無効。基本検査 スイッチが有効になった後にのみ有効にできます。トレーサビリティ監査 機能が有効になるかどうかを制御します。

従量課金制 WAF

Agentic API セキュリティは、保護対象または保護対象グループレベルで 1 つの有効なスイッチを提供します。

  • 基本検査 スイッチ:すべての組み込み検出メカニズムとカスタム検出ポリシーが有効になるかどうかを制御します。API セキュリティ機能を無効にするには、すべての保護対象と保護対象グループの 基本検査 スイッチを無効にします。