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

Web Application Firewall:API セキュリティポリシーの設定

最終更新日:May 21, 2026

このトピックでは、API セキュリティの組み込みポリシーとカスタムポリシー設定について説明します。組み込みの検出メカニズムに基づき、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 引数

    存在する

    存在しない

    長さが次と等しい

    長さが次より小さい

    長さが次より大きい

    次のいずれかの値を含む

    いずれの値も含まない

    -

    レスポンスヘッダー

    レスポンスヘッダー

    存在する

    存在しない

    長さが次と等しい

    長さが次より小さい

    長さが次より大きい

    次のいずれかの値を含む

    いずれの値も含まない

    -

    レスポンスパラメーター

    レスポンスパラメーター

    存在する

    存在しない

    長さが次と等しい

    長さが次より小さい

    長さが次より大きい

    次のいずれかの値を含む

    いずれの値も含まない

    -

    ビジネス目的

    サポートされていません

    次のいずれかの値を含む

    いずれの値も含まない

    ビジネス目的のリストです。複数選択が可能です。

    説明

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

    サービスオブジェクト

    サポートされていません

    次のいずれかの値を含む

    いずれの値も含まない

    サービスオブジェクトのリストから複数選択できます。

    説明

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

    認証

    サポートされていません

    次と等しい

    YES/NO

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

    サポートされていません

    次のいずれかの値を含む

    いずれの値も含まない

    タイプ数が次より大きい

    リストから機密データタイプを選択します。複数選択が可能です。「タイプ数が次より大きい」条件では、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 パラメーター

    カスタム POST 引数

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

    重複排除カウントが次と等しい

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

    0 ~ 8192 の整数。

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

    レスポンスの機密データタイプを選択します。複数選択が可能です。

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

    0 ~ 8192 の整数。

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

    レスポンスの機密データレベルを選択します。複数選択が可能です。

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

    0 ~ 8192 の整数。

    ソース IP カウント統計

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

    次より大きい

    0 ~ 8192 の整数。

    説明

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

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

III. [機密データの設定]

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

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

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

[機密データタイプの設定]

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

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

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

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

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

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

設定項目

説明

[名前]

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

[モード]

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

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

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

    • [文字]:数字、大文字、小文字を検出できます。複数選択が可能です。

    • [長さ]:検出可能な長さの範囲は 6~64 で、開始値と終了値は整数である必要があります。

  • [エキスパートモード]:検出用の正規表現を入力します。誤識別を避けるため、一致する文字数が 6 文字以上になるようにしてください。

[レベル]

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

説明

機密データタイプの詳細については、「API Security で検出可能な機密データ」をご参照ください。

[マスキング表示]

[機密データ関連設定] タブには マスキング表示 スイッチがあります。デフォルトでは無効になっており、データがマスクされずに表示されることを意味します。

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

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

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

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

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

  • Risk Details および API 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 引数

    存在する

    長さが等しい

    長さが次より短い

    長さが次より長い

V. ビジネス目的設定

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. 許可リスト設定

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. ライフサイクル管理

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 (WAF) のサービスリンクロールを有効化していない場合は、API セキュリティ ログのサブスクリプションサービスを使用する前に、ロールを有効化する必要があります。プロンプトに従ってロールを有効化すると、WAF が他のクラウド リソースにアクセスする権限が付与されます。サービスリンクロールの詳細については、「サービスリンクロール」をご参照ください。WAF ログサービスなどの機能を有効化する際にすでに権限付与を完了している場合は、このステップをスキップしてください。

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

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

    説明

    ログサブスクリプション機能では現在、Log Service によって自動作成された LogStore、またはカスタム名 "waf-logstore"、"wafng-logstore"、"wafnew-logstore" をログサブスクリプションの配信先として選択できません。

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

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

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

  5. ログサブスクリプションタスクを無効にし、既存のログが不要になった場合は、継続的な課金を回避するために、[Log Subscription] タブでタスクを無効化した後、該当する LogStore を削除してください。詳細については、「How to Disable Log Service or Stop Billing」をご参照ください。

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

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

  • Project または LogStore を作成したものの、ログサブスクリプションタスクを有効化していない場合でも、料金が発生することがあります。作成した LogStore が不要になったことを確認したら、追加料金を回避するために速やかに削除してください。詳細については、「Why Charges Accrue When Only a Project and LogStore Are Created」をご参照ください。

資産情報ログ

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

  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

latest_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

リスクタイプ (custom/built-in)

string

default

abnormal_level

リスクレベル

string

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

イベントタイプ (custom/built-in)

string

default

event_level

イベントレベル

string

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':['田中','鈴木','佐藤'],'1004':['090-1234-5678','080-9876-5432']}

response_data

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

JSON

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

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

ログの分析やクエリの際に、ログ内のフィールド値の意味を把握したり、その値がコンソール上の名称とどのように対応しているかを確認したりする必要がある場合は、次の表を参照してください。[説明] 列は、各フィールド値に対応する Web Application Firewall (WAF) コンソール上の名称を示します。

ライフサイクル (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

E メールアドレス

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

SQL API

Risk_RceAPI

コマンド実行 API

Risk_SmsContent

任意の SMS コンテンツの送信

Risk_MailContent

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

Risk_SmsVerifyCodeLeak

SMS 認証コードの漏洩

Risk_MailVerifyCodeLeak

E メール認証コードの漏洩

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. 対象オブジェクトの設定

サブスクリプション型 Web Application Firewall (WAF)

API セキュリティには、保護対象または保護対象グループレベルで 3 つの有効化スイッチがあります。

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

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

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

従量課金型 Web Application Firewall (WAF)

API セキュリティには、保護対象または保護対象グループレベルで 1 つの有効化スイッチがあります。

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