Alibaba Cloud Web Application Firewall (WAF) の API セキュリティ機能は、API に関する「リスク」と「セキュリティイベント」という 2 種類の検出結果をレポートします。これらの統計の確認、検出リストからの特定レコードの検索、処理ステータスの変更、個別レコードの詳細分析、およびさらなる分析のためのデータエクスポートが可能です。
リスクとセキュリティイベントの違い
リスクとは、開発上の欠陥、または管理・設定上の欠陥に起因する API のセキュリティリスクやセキュリティ上の脆弱性のことです。リスクは、必ずしも攻撃が発生したことを示すものではありません。リスクタイプについての詳細は、「API セキュリティでサポートされる API リスクタイプ」をご参照ください。
セキュリティイベントとは、ログイン API へのブルートフォース攻撃や、SMS 送信 API を悪用した迷惑メールの送信など、API に対する異常な呼び出しや攻撃動作のことです。セキュリティイベントは、攻撃が発生したことによって生成されるアラートです。API セキュリティが検出できるセキュリティイベントについての詳細は、「API セキュリティでサポートされる異常イベントタイプ」をご参照ください。
API セキュリティは、セキュリティイベントを2つのディメンションでレポートします。IPセキュリティイベント は IP ディメンション別に統計を提供し、アカウントセキュリティイベント はアカウントディメンション別に統計を提供します。
前提条件
保護対象にアカウントの抽出が構成されています。この構成は、アカウントセキュリティイベントを表示するために必須です。詳細については、「アカウント抽出を構成する」をご参照ください。
リスク検出データの表示
API リクエストセキュリティ ページの リスク検出 タブには、API リスクの検出と分析に関する統計および条件付き検索が表示されます。タブを開くには、Risk Detection をクリックするか、リスクが存在するサイトの統計 テーブルの右上隅にある More をクリックします。
このタブには、リスク統計、左側のリスクタイプペイン、API リスク詳細の 3 つの機能モジュールが含まれています。
リスク統計
リスク統計モジュールは、以下の 2 つの部分で構成されています。
リスクによる影響の統計:リスクのあるドメイン、リスクのある API エントリ、高リスク、中リスク、低リスクのそれぞれの数と、その日次新規カウント。
リスクステータスの統計:「要確認」、「要修正」、「確認済み」、「修正済み」、および「無視」の各ステータスにあるリスクの数です。
API Risk Detailsモジュール内の任意の数値をクリックすると、 で一致するリスクレコードが表示されます。
左側のリスクタイプペイン
左側のリスクタイプペインには、お客様が所有する API アセットのリスクタイプと、対応する件数が表示されます。リスクタイプをクリックすると、API Risk Details でこのリスクタイプに該当する API エントリを表示できます。
API リスク詳細
API Risk Details モジュールには、検出された API リスクが一覧表示されます。この一覧から、特定のリスクを検索し、リスクのステータスを変更し、リスクの詳細ページを開き、リスクデータをエクスポートできます。
API リスクの管理
対象の API リスクを特定した後、そのステータスを変更したり、リスクに関わる API 資産を表示したり、リスクの詳細を表示したりすることができます。
API リスクのステータス変更
API リスクの初期ステータスは確認待ちです。以下のいずれかの場所でステータスを変更します。
API Risk Details リストで、ステータス 列の
アイコンをクリックし、変更するリスクステータスを選択して、OK をクリックします。「リスク詳細」ページで、ステータスを確認済み、修復待機中、システム検証待ち、修正済み(手動検証)、または無視に設定し、備考情報を入力します。
無視修正済み
リスクステータスをシステム検証待ちに設定すると、システムはリスクが修正されたかどうかを自動的に識別します。以下のいずれかの条件が満たされた場合、ステータスは修正済み(システム検証)に設定されます。それ以外の場合、ステータスは未修復(検証済み)に設定されます。
「機密性の高いインターフェイスのため権限が付与されていません」リスクの場合、その API は認証済み、または機密データを送信していないと検出されます。
内部インターフェイスには承認なしでアクセスすることができます リスクの場合、API は内部 API ではない、または認証済みであると検出されます。
その他のリスクの場合、最後の検出日時 は 7 日より前であり、API は過去 7 日以内にアクセスされています。
その他のリスクについては、最後の検出日時 が 1 日以上前であり、かつ本日のアクセスボリュームが 100 を超えています。
リスクに関わる API 資産の表示
対象リスクのソース API をクリックすると、API 詳細ページで API 資産を表示できます。API 詳細ページについての詳細は、「API 詳細」をご参照ください。
API リスク詳細の表示
対象のリスク ID の 操作 列にある 詳細 をクリックすると、リスク詳細ページが開きます。このページには、次のタブがあります。
基本情報 — API、リスク ID、初回検出時刻、リスクの説明、対処の提案、ドメイン名、ビジネス目的、ステータス、AI 分析などの情報を表示します。
リスクステータスの説明 — 利用可能なリスクステータスを表示し、リスクのステータスを設定します。
リスク検証 — リクエストサンプルを表示します。また、以下の操作を実行できます:
ブラウザ`で開く をクリックすると、ブラウザで直接 GET リクエストが開きます。
コマンドライン をクリックして、リクエストサンプルをコマンドラインに変換します。ワンクリックコピー をクリックして、手動でリクエストにアクセスします。
コードのコピー をクリックしてリクエストサンプルをコピーします。
操作レコード — リスクイベントの処理レコードを表示します。
セキュリティイベントデータの表示
API セキュリティ ページの Security Events タブには、API 攻撃イベント分析の統計と条件付き検索が表示されます。タブを開くには、セキュリティイベント をクリックするか、攻撃されたサイトの統計 テーブルの右上隅にある More をクリックします。
このタブには IPセキュリティイベント タブと アカウントセキュリティイベント タブがあります。どちらのタブにも、攻撃影響の統計、左側のイベントタイプペイン、API セキュリティイベントの詳細という同じ 3 つの機能モジュールが含まれています。統計項目と利用可能な検索フィールドは、ディメンションによって異なります。
攻撃影響統計
攻撃影響統計モジュールの項目は、タブによって異なります。
IP セキュリティイベント:攻撃されたドメイン名の数、攻撃された API の数、ならびに High-Risk Events、Moderate-Risk Events、および Low-Risk Events の数 (それぞれに New Events Today 数を含む)。
アカウントセキュリティイベント: リスクアカウント、高リスクイベント、中リスクイベント、低リスクイベントの数、およびそれぞれの今日の新規イベント数。
Details of API Security Events
左側のイベントタイプペイン
左側のイベントタイプペインには、所有する API アセットのイベントタイプと対応する件数が表示されます。イベントタイプをクリックすると、Details of API Security Events でそのタイプのイベントを表示できます。
API セキュリティイベント詳細
Details of API Security Events モジュールには、検出されたセキュリティイベントが一覧表示されます。このリストから、特定のイベントを検索して、その詳細ページを開くことができます。また、イベントのステータスの変更、ソース IP アドレスまたはアカウントのホワイトリストへの追加、ソース IP アドレスのブロック、イベントデータのエクスポートを行うこともできます。
API セキュリティイベントの管理
対象の API セキュリティイベントを特定した後、そのステータスを変更したり、送信元 IP アドレスやアカウントをホワイトリストに追加したり、送信元 IP アドレスをブロックしたり、イベントの詳細を表示したりすることができます。
API セキュリティイベントのステータス変更
対象のセキュリティイベント ID を特定し、ステータス 列の
アイコンをクリックし、変更先のイベントステータスを選択して、OK をクリックします。
IP アドレスまたはアカウントのホワイトリストへの追加
対象のイベントの操作列でホワイトリストに追加をクリックすると、現在のイベントを生成した IP アドレスまたはアカウントがワンクリックでホワイトリストに追加されます。デフォルトでは、このアクションの結果は次のとおりです。
現在のイベントのルールタイプは検出されなくなります。
イベントのステータスが確認済みに変更されます。
IP アドレスのブロック
対象のイベントの 操作 列で ブロックされた IP をクリックすると、現在のイベントの IP アドレスがワンクリックで拒否リストに追加されます。デフォルトでは、イベントステータスは 処理済み に変更されます。
API セキュリティイベント詳細の表示
対象のイベントの操作列で詳細をクリックして、イベント詳細ページを開きます。このページには、次の情報が表示されます。
基本情報:イベント ID、開始時刻と終了時刻、ステータス、およびその他の情報を表示します。また、セキュリティイベントのステータスを変更することもできます。ステータスを 確認済み、処理済み、または 無視 に設定すると、備考情報を入力できます。
攻撃の詳細 — データサンプル、イベントの傾向などの情報を表示します。
IP セキュリティイベントについては、攻撃元の分析 の 操作 列にある ログクエリ をクリックして、ログをクエリします。
アカウントセキュリティイベントのログをクエリするには、アクセスAPI分布 の 操作 列にある ログクエリ をクリックします。
対処の提案 — セキュリティイベントの対処に関する提案を表示します。
操作記録 — セキュリティイベントの処理記録を表示します。
API リスクとセキュリティイベントの検索
API Risk Details リストと Details of API Security Events リストは、同じ 2 つの検索方法をサポートしています。簡易検索を使用して 1 つのフィールドで単一のレコードを検索するか、詳細検索を使用して複数の条件でレコードを絞り込みます。
簡易検索
リストの上部にある検索ボックスで
アイコンをクリックして検索フィールドを選択し、対応する API 名、ID、IP アドレス、またはアカウントを入力した後、Search をクリックしてクエリを実行します。 あいまい検索がサポートされています。
利用可能な検索フィールドはリストによって異なります。
| リスト | 検索フィールド |
| API リスク詳細 | API 操作 または Risk Item ID |
| API セキュリティイベントの詳細、[IP セキュリティイベント] タブ | [IP]、[API 操作]イベント ID |
| API セキュリティイベントの詳細、[アカウントセキュリティイベント] タブ | アカウント、API 操作、または イベント ID |
詳細検索
その他のフィルターをクリックして検索条件を設定してから、Searchをクリックしてクエリを実行します。
次の図は、詳細検索の条件を示しています。

次の表では、各検索条件と、その条件が利用可能なリストについて説明します。
| 条件 | 説明 | 利用可能 |
| 時間 | クエリの時間範囲。過去 15 分、過去 30 分、過去 1 時間、過去 24 時間、今日、昨日、過去 7 日間などのクイッククエリがサポートされています。カスタム時間クエリの最小粒度は 10 分です。 | すべてのリスト |
| Risk Level | 複数選択がサポートされています。 | API リスク詳細 |
| Event Level | 複数選択がサポートされています。 | API セキュリティイベントの詳細 |
| ステータス | 複数選択がサポートされています。 | すべてのリスト |
| Purpose | API のビジネス目的。複数選択がサポートされています。 | API リスク詳細および [IP セキュリティイベント] タブ |
| Domain Name | 単一選択。 | すべてのリスト |
| Type | 単一選択。 | すべてのリスト |
ビジネス目的タイプについての詳細は、「API セキュリティが API のビジネス目的を分類する方法」をご参照ください。
リストの表示項目の変更
リストの右上隅にあるアイコンをクリックし、リストに表示するデータフィールドを選択します。
リスクおよびセキュリティイベントデータのエクスポート
エクスポートはタスクとして実行されます。API セキュリティがまずファイルを生成し、その後エクスポート記録からダウンロードします。以下の両方のステップを完了してください。
API リスクの詳細 または Details of API Security Events の右上隅にある
アイコンをクリックします。API セキュリティがエクスポートタスクを作成します。API セキュリティ ページの右上隅にある レコードのエクスポート をクリックします。ダウンロードするファイルを見つけ、操作 列の Download をクリックします。
クエリ条件を設定した場合、エクスポートされるファイルにはクエリされたデータのみが含まれます。それ以外の場合、ファイルにはすべてのデータが含まれます。
エクスポートされたファイルが生成されると、WAF コンソールに一時的に保存され、3 日後に有効期限が切れます。有効期限が切れたファイルはダウンロードできません。有効期間内にファイルをダウンロードしてください。
ダウンロードされたファイルは、ブラウザのデフォルトのダウンロード場所に保存されます。デフォルトの場所に移動して、ダウンロードしたファイルを表示できます。
統計期間、保持期間、およびデフォルトのクエリ範囲
API セキュリティは、統計モジュール、保存されたレコード、および詳細リストに異なる時間範囲を適用します。統計の数値とリストの結果が一致しない場合は、これらの違いを考慮してください。
統計モジュール — リスク統計と攻撃影響統計は、デフォルトで過去 1 年間の統計期間を使用します。
リスクアラートレコード — リスク検出によって生成されたリスクアラートレコードは 1 年間保持され、自動的に消えることはありません。
詳細リスト — API Risk Details と Details of API Security Events は、デフォルトで、昨日までの丸 30 日間と、クエリ実行時までの本日分のレコードからなる過去 30 日間のデータを返します。