このトピックでは、Agentic API セキュリティの組み込みポリシーとカスタムポリシーの設定について説明します。Agentic API セキュリティは、組み込みの検出メカニズムに基づき、お客様のビジネス特性に合わせたカスタム検出ポリシーをサポートします。リスク検出、セキュリティイベント、機密データ、認証情報、ビジネス目的、ホワイトリスト、ライフサイクル管理、ログサブスクリプション、および対象オブジェクトを設定することで、識別された API データを実際のビジネスシナリオにより適合させることができます。これにより、API セキュリティ検出の精度と再現率がさらに向上し、ビジネスニーズに基づいた適切なアクションを実行し、API ビジネス資産への攻撃による損失を削減するのに役立ちます。
I. リスク検出設定
リスクとは、開発上の欠陥、または API の管理および設定の不備によって引き起こされるセキュリティリスクや脆弱性を指します。セキュリティリスクとセキュリティイベントの違いは、セキュリティリスクが必ずしも攻撃が発生したことを示すわけではないのに対し、セキュリティイベントは攻撃によってトリガーされたアラートを示す点です。
組み込みポリシー設定
ポリシー設定の リスク検出の設定 タブで、設定済みのリスクポリシーを表示できます。組み込みポリシーはデフォルトで有効になっています。有効化ステータスを変更したり、リスクレベルを調整したりできます。ビジネスニーズに応じて、組み込みポリシーのリスクレベルを「低」、「中」、「高」に設定できます。
カスタムポリシー設定
組み込みポリシーに加えて、リスク検出設定では最大 20 個のカスタムポリシーを作成できます。カスタムポリシーの設定ルールは次のとおりです。
API リクエストセキュリティ ページで、 タブを選択します。
左側のペインで、カスタムポリシーセクションの New をクリックして、設定ドロワーを開きます。次の表に、設定パラメーターを示します。
パラメーター
説明
リスクステータス
ポリシーのステータスを設定します。デフォルト値は「有効」です。
リスク名
カスタムリスクの名前を設定します。名前に漢字、大文字と小文字の英字、数字、ピリオド (.)、アンダースコア (_)、ハイフン (-) を使用できます。
Suggestions
ビジネスニーズに応じて、カスタムリスクポリシーの対処に関する提案を設定します。
Risk Level
リスクレベルを「低」、「中」、「高」に設定できます。
検出の設定
カスタムリスクポリシーの検出条件を設定します。最大 10 個の条件をサポートします。
次の表に、論理演算子や一致コンテンツの例など、検出設定の詳細な構成を示します。
説明最大 50 個の一致コンテンツ項目を入力し、Enter キーを押して確定できます。
リスク検出の設定 の一致コンテンツは、大文字と小文字を区別します。
カスタム設定が完了したら、OK をクリックして設定を保存します。
II. セキュリティイベント設定
セキュリティイベントは、API が異常な呼び出しや攻撃動作を経験したことを示します。例えば、ログイン API へのブルートフォース攻撃や、SMS 送信 API を悪用した SMS 爆弾などです。組み込みのイベント検出では、IP アドレスとアカウントを検出ディメンションとして使用します。
組み込みポリシー設定
組み込みのセキュリティイベントポリシーがアラートをトリガーした場合、攻撃が継続しても新しいアラートは生成されません。ただし、既存のアラートの攻撃時間は更新され、攻撃量などの要因に基づいてアラートの深刻度レベルが変更されることがあります。
ポリシー設定の セキュリティイベントの設定 タブで、設定済みのセキュリティイベントポリシーを表示できます。組み込みポリシーはデフォルトで有効になっています。有効化ステータスを変更したり、リスクレベルを調整したりできます。
カスタムポリシー設定
組み込みポリシーに加えて、セキュリティイベント設定では最大 10 個のカスタムポリシーを作成できます。カスタムポリシーの設定ルールは次のとおりです。
API リクエストセキュリティ ページで、ポリシーの設定 > セキュリティイベントの設定 タブを選択します。
左側のペインで、カスタムポリシーセクションの New をクリックして、設定ドロワーを開きます。次の表に、設定パラメーターを示します。
パラメーター
説明
イベントステータス
ポリシーのステータスを設定します。デフォルト値は「有効」です。
Event Name
カスタムイベントの名前を設定します。名前に漢字、大文字と小文字の英字、数字、ピリオド (.)、アンダースコア (_)、ハイフン (-) を使用できます。
Suggestions
ビジネスニーズに応じて、カスタムセキュリティイベントの対処に関する提案を設定します。
Event Level
リスクレベルを「低」、「中」、「高」に設定できます。
一致条件
カスタムセキュリティイベントポリシーの検出条件を設定します。最大 10 個の条件をサポートします。
説明複数の条件が定義されている場合、すべての条件が満たされた場合にのみルールがトリガーされます。
Rate Limiting
Statistical Object を IP またはアカウントに設定し、統計期間 を分単位 (最大 15 分) で設定し、リクエスト数 を正の整数のみに設定します。
データ統計
カスタムセキュリティイベントポリシーの統計条件を設定します。最大 10 個の条件をサポートします。
一致条件の詳細な設定 (対応する論理演算子や一致コンテンツの例を含む) については、リスク検出セクションの「詳細な設定」をご参照ください。
説明最大 50 個の一致コンテンツ項目を入力し、Enter キーを押して確定できます。
セキュリティイベントの設定 の一致コンテンツは、大文字と小文字を区別します。
次の表に、論理演算子や一致コンテンツの例など、データ統計の詳細な構成を示します。
カスタム設定が完了したら、OK をクリックして設定を保存します。
III. 機密データの設定
ポリシー設定の 機密データの設定 タブで、次の項目を表示および設定できます。
機密データタイプの設定:システムには、ID 番号や携帯電話番号などの一般的な機密データタイプに対する組み込みの検出ロジックがあります。ビジネスニーズに応じて、機密データタイプをカスタマイズすることもできます。
API リアルタイムマスキング:AI ベースラインエンジンに基づくインテリジェント保護機能は、API 構造を自律的に学習し、機密データをリアルタイムで識別して、きめ細かな自動データマスキングを実現します。この機能は手動でフィールドを事前定義する必要がなく、複雑なビジネスシナリオに柔軟に対応して、国境を越えたデータ転送などのコンプライアンス要件を満たし、完全に自動化されたリアルタイム保護を実現します。
機密データタイプの設定
機密データの設定 タブで、左側のリストの 機密データタイプの設定 をクリックして、次の項目を表示および設定します。
組み込み機密データタイプ
組み込みのシステムポリシーはデフォルトで有効になっています。編集、変更、削除はできません。有効または無効にすることのみ可能です。
カスタム機密データタイプ
ビジネスで独自の機密データを定義している場合は、カスタムの機密データ検出ルールを設定できます。機密データに対して最大 20 個のカスタムポリシーを設定できます。
ポリシーの新規作成 をクリックして、表示されるドロワーページで設定を行います。現在、簡易モード と エキスパートモード の 2 つのモードでカスタムポリシーを設定できます。
設定項目 | 説明 |
名前 | ルールの名前を設定します。 |
モード | カスタムポリシーの検出モードを設定します。
|
レベル | 検出された機密データの感度レベルを設定します。オプション:S1、S2、S3、S4。 説明 機密データタイプの詳細については、「API セキュリティが検出できる機密データ」をご参照ください。 |
マスキング表示
機密データ設定タブには、マスキング表示 スイッチがあります。デフォルトでは無効になっており、データはマスクされた形式で表示されません。
データマスキングを有効にすると、次の情報がマスクされます。
Risk Details と API 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 セキュリティと未認証リスク検出の精度を向上させます。
API リクエストセキュリティ ページで、ポリシーの設定 > 権限付与の資格情報に関する設定 タブを選択します。
ポリシーの新規作成 をクリックし、次の設定を完了してから OK をクリックします。
設定項目
説明
名前
ポリシーの名前を設定します。
中国語文字、大文字と小文字のアルファベットがサポートされています。数字、ピリオド (.)、アンダースコア (_)、ハイフン (-) も使用できます。
一致条件
各条件は、マッチフィールド、論理記号、および マッチコンテンツ で構成されます。最大 10 個の条件がサポートされています。設定時には、リクエストヘッダー、リクエスト Cookie、リクエストクエリ、またはリクエストボディに対して、少なくとも 1 つの一致条件を追加する必要があります。
説明複数の条件が定義されている場合、すべての条件が同時に満たされた場合にのみルールがトリガーされます。
一致条件の詳細な設定については、次の表で対応する論理演算子と一致コンテンツの例をご参照ください。
説明最大 50 個の一致する値を入力し、Enter キーを押して確定できます。
権限付与の資格情報に関する設定 の一致コンテンツは、大文字と小文字を区別します。
V. ビジネス目的設定
Agentic API セキュリティは、次の 2 種類のビジネス目的ポリシーを提供します。
組み込みポリシー設定
データ更新、データ共有、モバイル SMS 送信、情報送信など、複数のシナリオに対応する組み込みのビジネス目的ポリシーが提供されています。組み込みポリシーはデフォルトで有効になっており、変更や削除はできません。必要に応じて各ポリシーを有効または無効にできます。
カスタムポリシー設定
組み込みポリシーがビジネスニーズを満たさない場合は、URL の特徴とパラメーター名の特徴をカスタマイズして、特定のビジネスシナリオにおける API セキュリティの検出精度をさらに向上させることができます。
API リクエストセキュリティ ページで、ポリシーの設定 > ビジネス用途の設定 タブを選択します。
カスタムポリシー をクリックしてカスタムポリシー管理に入ります。ポリシーの新規作成 をクリックし、次の設定を完了してから OK をクリックして設定を保存します。
最大 50 個の一致する値を入力し、Enter キーを押して確定できます。
ビジネス用途の設定 の一致コンテンツは、大文字と小文字を区別します。
VI. ホワイトリスト設定
Agentic API セキュリティのホワイトリスト設定機能を使用すると、セキュリティイベントとリスク検出のホワイトリストをカスタマイズできます。これにより、オフィスのネットワークからの IP アドレスによって生成されたアラートなど、実際のビジネスシナリオに基づいて不要なアラートノイズを除外し、運用効率を向上させることができます。
API リクエストセキュリティ ページで、ポリシーの設定 > ホワイトリストの設定 タブを選択します。
ポリシーの新規作成 をクリックし、ポリシーの名前を入力し、ホワイトリストを設定したい機能タイプを選択します。現在、Risk Detection と Security Events のホワイトリストを設定できます。
選択した機能タイプに基づいて一致条件を設定します。
説明最大 10 個の一致条件がサポートされています。
ホワイトリストの設定 の一致条件は、大文字と小文字を区別します。
リスク検出ホワイトリストの一致条件
一致フィールド
論理演算子
一致コンテンツ
ドメイン
いずれかの値を含む
いずれの値も含まない
いずれかの値に等しい
いずれの値とも等しくない
複数の値を入力できます (最大 50 個)。Enter キーを押して確定します。
API
いずれかの値を含む
いずれの値も含まない
いずれかの値に等しい
いずれの値とも等しくない
複数の値を入力できます (最大 50 個)。Enter キーを押して確定します。
セキュリティイベントホワイトリストの一致条件
一致フィールド
論理演算子
一致コンテンツ
ドメイン
いずれかの値を含む
いずれの値も含まない
いずれかの値に等しい
いずれの値とも等しくない
複数の値を入力できます (最大 50 個)。Enter キーを押して確定します。
API
いずれかの値を含む
いずれの値も含まない
いずれかの値に等しい
いずれの値とも等しくない
複数の値を入力できます (最大 50 個)。Enter キーを押して確定します。
IP
所属する
所属しない
IP アドレスまたは IP/マスク (例:1.1.X.X/24) を入力します。正規表現はサポートされていません。最大 50 個のエントリをカンマ (,) で区切るか、Enter キーを押して入力します。
除外するリスク検出またはセキュリティイベントのタイプを選択し、OK をクリックして設定を保存します。
説明除外されるタイプは、組み込みオプションとカスタムオプションの両方をサポートし、複数選択が可能です。
VII. ライフサイクル管理
Agentic API セキュリティでは、1 日あたりの訪問数としきい値期間を設定することで、非アクティブな API を識別するための基準をカスタマイズできます。これにより、非アクティブな API の検出が実際のビジネス状況により適合するようになります。ライフサイクル管理は、カスタム基準を満たす非アクティブな API を識別するのに役立ち、タイムリーなアクションを取り、攻撃者が非アクティブな API を悪用するのを防ぎ、不要なビジネス損失を回避できます。
API リクエストセキュリティ ページで、ポリシーの設定 > ライフサイクル管理 タブを選択します。
非アクティブな 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 ログサービスなどの機能を有効にする際にすでに承認を完了している場合は、このステップをスキップしてください。
ログサブスクリプション設定
Agentic API セキュリティのログサブスクリプションタスクを設定する前に、Log Service コンソールを開き、ログサブスクリプションを受け取る Project と LogStore を作成します。すでに対象の LogStore を作成し、その名前が命名規則に準拠していることを確認している場合は、次のステップに進んでください。
説明ログサブスクリプション機能は現在、Log Service によって自動的に作成された Logstore、または「waf-logstore」、「wafng-logstore」、「wafnew-logstore」とカスタム名が付けられた Logstore をログサブスクリプションの宛先として選択することをサポートしていません。
作成後、ログサブスクリプションタブに戻り、資産情報、リスク情報、攻撃イベント情報のサブスクリプションを設定します。指定した LogStore に配信されたログを Log Service コンソールでクエリおよび分析したい場合は、まずインデックス作成を有効にします。詳細については、「インデックスの作成 — 変更手順」をご参照ください。
サブスクリプションタスクのログタイプを選択し、設定 ボタンをクリックして設定ページに移動します。
LogStore があるリージョン、Project 名、LogStore 名を選択し、OK ボタンをクリックして設定を保存します。設定が完了し、ログが生成されたら、Log Service コンソールの対応する LogStore に戻ってログをクエリおよび分析できます。データマスキングなどのログ処理を行いたい場合は、「データ処理」をご参照ください。
ログサブスクリプションタスクを無効にし、既存のログが不要になった場合は、継続的な課金を避けるため、ログサブスクリプションの設定 タブでタスクを無効にした後、対応する LogStore を削除してください。 詳細については、「Log Service を無効にするか、課金を停止する方法」をご参照ください。
以下に、ログサブスクリプションタスクのトリガー条件と詳細なフィールド説明を示します。
Log Service でのクラウドリソースの作成とインデックスの有効化には、Log Service プロダクトによる追加料金が発生します。課金項目と料金の詳細については、「Log Service の課金概要」をご参照ください。
プロジェクトや Logstore を作成した後、ログサブスクリプションタスクを有効にしていなくても、料金が発生することがあります。作成した Logstore が不要になった場合は、追加料金の発生を避けるため、速やかに削除してください。詳細については、「プロジェクトと Logstore のみを作成した場合に料金が発生する理由」をご参照ください。
資産情報ログ
ログサブスクリプションのトリガー条件:
新しい API 資産が追加されると、資産情報ログが直ちに配信されます。
新しい API 資産が追加されない場合、資産情報ログはデフォルトで 1 時間ごとに定期的に配信されます。
リスク情報ログ
ログサブスクリプションのトリガー条件:新しいリスク情報が検出されると、リスク情報ログが指定された LogStore に配信されます。
攻撃イベント情報ログ
ログサブスクリプションのトリガー条件:
新しい攻撃イベントが検出されると、新しい攻撃イベント情報ログが指定された LogStore に配信されます。
攻撃が継続する場合、攻撃イベント情報ログは 10 分間隔で継続的に指定された LogStore に配信されます。
ログサブスクリプションフィールド値の説明
ログの分析やクエリ中にフィールド値の意味を理解したり、コンソールに表示される名前との対応を確認したりする必要がある場合は、次の表をご参照ください。「説明」列には、Web Application Firewall コンソールに表示される各フィールド値に対応する名前が示されています。
IX. 対象オブジェクト設定
サブスクリプションベースの WAF
Agentic API セキュリティは、保護対象または保護対象グループレベルで 3 つの有効なスイッチを提供します。
基本検査 スイッチ:デフォルトで有効。すべての組み込み検出メカニズムとカスタム検出ポリシーが有効になるかどうかを制御します。
コンプライアンス審査 スイッチ:デフォルトで無効。基本検査 スイッチが有効になった後にのみ有効にできます。コンプライアンス審査 機能が有効になるかどうかを制御します。
トレーサビリティ監査 スイッチ:デフォルトで無効。基本検査 スイッチが有効になった後にのみ有効にできます。トレーサビリティ監査 機能が有効になるかどうかを制御します。
従量課金制 WAF
Agentic API セキュリティは、保護対象または保護対象グループレベルで 1 つの有効なスイッチを提供します。
基本検査 スイッチ:すべての組み込み検出メカニズムとカスタム検出ポリシーが有効になるかどうかを制御します。API セキュリティ機能を無効にするには、すべての保護対象と保護対象グループの 基本検査 スイッチを無効にします。