DescribeApisecEvents による API セキュリティ脅威の検出 - WAF - Alibaba Cloud - Web Application Firewall

API セキュリティイベントのリストを照会します。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

yundun-waf:DescribeApisecEvents

get

*All Resource

*

acs:ResourceGroupId

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
InstanceId	string	必須	WAF インスタンスの ID。説明 DescribeInstance を呼び出して、現在の WAF インスタンスの ID を取得できます。	waf_v2_public_cn-5y***d31
EventId	string	任意	API セキュリティイベントの ID。	18ba94fea9***e66ba0557b7b91
ApiFormat	string	任意	API オペレーション。	/apisec/v1/***.php
MatchedHost	string	任意	API オペレーションが属するドメイン名または IP アドレス。	a.***.com
EventTag	string	任意	イベントタイプ。説明 DescribeApisecRules を呼び出して、サポートされているイベントタイプを取得できます。	ObtainSensitiveUnauthorized
StartTs	integer	任意	クエリの開始時刻 (UNIX タイムスタンプ (協定世界時 (UTC)) フォーマット)。単位: 秒。	1683648000
EndTs	integer	任意	クエリの終了時刻 (UNIX タイムスタンプ (協定世界時 (UTC)) フォーマット)。単位: 秒。	1683703260
OrderKey	string	任意	ソートに使用するフィールドの名前。有効な値: allCnt: 攻撃数。 startTs: イベント開始時刻。 endTs: イベント終了時刻。	startTs
OrderWay	string	任意	ソート順序。有効な値: desc: 降順 (デフォルト)。 asc: 昇順。	desc
PageNumber	integer	任意	ページングクエリで返すページ番号。デフォルト値: 1 (最初のページを示します)。	1
PageSize	integer	任意	ページングクエリにおける 1 ページあたりのエントリ数。デフォルト値: 10 (1 ページあたり 10 エントリを示します)。	10
ApiTag	string	任意	API のビジネス目的。説明 DescribeApisecRules を呼び出して、サポートされているビジネス目的を取得できます。	SendMail
Origin	string	任意	イベントタイプのソース。有効な値: custom: カスタム。 default: デフォルト。	default
EventLevel	string	任意	イベントレベル。有効な値: high: 高リスク。 medium: 中間リスク。 low: 低リスク。	low
UserStatus	string	任意	イベントステータス。有効な値: toBeConfirmed: 未確認。 confirmed: 確認済み。 actioned: 対応済み。 ignored: 無視。	ignored
AttackIp	string	任意	攻撃元 IP アドレス。	42.224..
ApiId	string	任意	API の ID。	820b860***6205da93b935b28
ClusterId	string	任意	ハイブリッドクラウドクラスター ID。説明このパラメーターはハイブリッドクラウドシナリオにのみ適用されます。 DescribeHybridCloudClusters を呼び出して、ハイブリッドクラウドクラスター情報を取得できます。	428
RegionId	string	任意	WAF インスタンスがデプロイされているリージョン。有効な値: cn-hangzhou: 中国本土。 ap-southeast-1: 中国本土以外。	cn-hangzhou
ResourceManagerResourceGroupId	string	任意	Alibaba Cloud リソースグループ ID。	rg-acfm***q
EventScope	string	任意	セキュリティイベントのディメンション。列挙値: ip : (デフォルト) IP セキュリティイベント。 account : アカウントセキュリティイベント。	ip
Account	string	任意	アカウント情報。	1818743389962696

レスポンスフィールド

フィールド	型	説明	例
	object	応答。
TotalCount	integer	返されたエントリの総数。	3
RequestId	string	リクエスト ID。	12F4CC8F-7E9F-5E4D-BF7C-BD1EDDE0C282
Data	array<object>	セキュリティイベントのリスト。
	object	セキュリティイベント情報。
Origin	string	イベントタイプのソース。有効な値: custom: カスタム。 default: デフォルト。	custom
EventLevel	string	イベントレベル。有効な値: high: 高リスク。 medium: 中間リスク。 low: 低リスク。	medium
StartTs	integer	クエリの開始時刻 (UNIX タイムスタンプ (協定世界時 (UTC)) フォーマット)。単位: 秒。	1683648000
EventInfo `deprecated`	string	イベントの詳細。以下のパラメーターで構成される JSON オブジェクトから変換された文字列です: ip_info: 攻撃元 IP 情報。この API オペレーションのレスポンスパラメーター AttackIpInfo を参照してください。 rule_id: イベントに関連付けられたルール ID。 rule_tag: イベントに関連付けられたルール情報。	{ "ip_info": [ { "ip": "112.224.143.", "country_id": "CN", "region_id": "-", "cnt": "4" } ], "rule_id": "837", "rule_tag": "interface returns a large amount of sensitive information" }
ApiFormat	string	API オペレーション。	/apisec/v1/register.php
ApiTag	string	API のビジネス目的。説明 DescribeApisecRules を呼び出して、サポートされているビジネス目的を取得できます。	SendMail
UserStatus	string	イベントステータス。有効な値: toBeConfirmed: 未確認。 confirmed: 確認済み。 actioned: 対応済み。 ignored: 無視。	toBeConfirmed
Follow	integer	イベントがフォローされているかどうかを示します。有効な値: 1: フォロー中。 0: フォローしていない。	0
RequestData `deprecated`	string	API リクエストデータのサンプル。一連のパラメーターで構成される JSON オブジェクトから変換された文字列です。	{}
EventId	string	イベント ID。	c82cb276847e9c96f9597d9f4b0cdcff
AttackIp `deprecated`	string	攻撃元 IP アドレス。重要このパラメーターは非推奨です。代わりに AttackIps パラメーターを使用してください。	104.234.140.**
AttackIpInfo `deprecated`	string	攻撃元 IP 情報。以下のパラメーターで構成される JSON オブジェクトから変換された文字列です: ip: IP アドレス。 country_id: IP アドレスが属する国。 region_id: IP アドレスが属するリージョン。 cnt: 攻撃数。	[ { "ip": "72...119", "country_id": "US", "region_id": "", "cnt": "2100" } ]
EndTs	integer	クエリの終了時刻 (UNIX タイムスタンプ (協定世界時 (UTC)) フォーマット)。単位: 秒。	1683703260
AttackCntInfo `deprecated`	string	攻撃数情報。JSON オブジェクトから変換された文字列です。キーは秒単位のタイムスタンプ、値は攻撃数です。	{ "1717498320": 500, "1717498380": 529, "1717498440": 20 }
AllCnt	integer	攻撃の数。	10
RemoteRegion	string	攻撃元 IP アドレスが属するリージョン。	110000
ResponseData `deprecated`	string	API 応答データのサンプル。一連のパラメーターで構成される JSON オブジェクトから変換された文字列です。	{}
AttackClient	string	攻撃クライアント。	Chrome
EventTag	string	イベントタイプ。説明 DescribeApisecRules を呼び出して、サポートされているイベントタイプを取得できます。	ObtainSensitiveUnauthorized
MatchedHost	string	API オペレーションが属するドメイン名または IP アドレス。	a.***.com
Note	string	備考。	Notify
ApiId	string	セキュリティイベントに関連付けられた API の ID。	2ecc1cf67b91853bc55545052ccf06a8
RemoteCountry	string	攻撃元 IP アドレスが属する国。	US
AttackIps `deprecated`	array	攻撃元 IP アドレスのリスト。
	string	攻撃元 IP アドレス。	104.234.140.**
AttackerList	array	イベントに関連付けられた攻撃者リスト。
	string	イベントに関連付けられた攻撃者。説明 EventScope が ip に設定されている場合、この値は攻撃者の IP アドレスです。EventScope が account に設定されている場合、この値は攻撃者のアカウントです。	1.1.1.1

例

成功レスポンス

JSONJSON

{
  "TotalCount": 3,
  "RequestId": "12F4CC8F-7E9F-5E4D-BF7C-BD1EDDE0C282",
  "Data": [
    {
      "Origin": "custom",
      "EventLevel": "medium",
      "StartTs": 1683648000,
      "EventInfo": "{\n    \"ip_info\": [\n        {\n            \"ip\": \"112.224.143.**\",\n            \"country_id\": \"CN\",\n            \"region_id\": \"-\",\n            \"cnt\": \"4\"\n        }\n    ],\n    \"rule_id\": \"837**\",\n    \"rule_tag\": \"interface returns a large amount of sensitive information\"\n}\n",
      "ApiFormat": "/apisec/v1/register.php",
      "ApiTag": "SendMail",
      "UserStatus": "toBeConfirmed",
      "Follow": 0,
      "RequestData": "{}",
      "EventId": "c82cb276847e9c96f9597d9f4b0cdcff",
      "AttackIp": "104.234.140.**",
      "AttackIpInfo": "[\n    {\n        \"ip\": \"72.*.*.119\",\n        \"country_id\": \"US\",\n        \"region_id\": \"\",\n        \"cnt\": \"2100\"\n    }\n]",
      "EndTs": 1683703260,
      "AttackCntInfo": "{\n    \"1717498320\": 500,\n    \"1717498380\": 529,\n    \"1717498440\": 20\n}",
      "AllCnt": 10,
      "RemoteRegion": "110000",
      "ResponseData": "{}",
      "AttackClient": "Chrome",
      "EventTag": "ObtainSensitiveUnauthorized",
      "MatchedHost": "a.***.com",
      "Note": "Notify",
      "ApiId": "2ecc1cf67b91853bc55545052ccf06a8",
      "RemoteCountry": "US",
      "AttackIps": [
        "104.234.140.**\n"
      ],
      "AttackerList": [
        "1.1.1.1"
      ]
    }
  ]
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。