使用DescribeApisecAbnormals查詢API安全風險列表-Web Application Firewall-阿里雲 - Web Application Firewall

查詢 API 安全風險清單。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

yundun-waf:DescribeApisecAbnormals

get

*All Resource

*

acs:ResourceGroupId

無

請求參數

名稱	類型	必填	描述	樣本值
InstanceId	string	是	WAF 執行個體 ID。說明您可以呼叫 DescribeInstance 操作來查詢 WAF 執行個體的 ID。	waf_v2_public_cn-z***9g301
ApiId	string	否	風險對應的 API ID。	bd9efb8ad******d9ca6
ApiFormat	string	否	風險對應的 API 介面。	/api/users/login
MatchedHost	string	否	API 介面所屬的網域或 IP。	a.aliyun.com
StartTime	string	否	查詢的開始時間，格式為 Unix 時間戳記（UTC 時間），單位為秒。	1684252800
EndTime	string	否	查詢的結束時間，格式為 Unix 時間戳記（UTC 時間），單位為秒。	1684382100
OrderKey	string	否	排序欄位的名稱。取值： discoverTime：表示風險首次偵測時間（預設）。 abnormalLevel：表示風險等級。 latestDiscoverTime：表示風險最近偵測時間。	firstTime
OrderWay	string	否	排序的方式。取值： desc：表示降序（預設）。 asc：表示升序。	desc
AbnormalLevel	string	否	風險等級。取值： high：表示高危。 medium：表示中危。 low：表示低危。	medium
AbnormalTag	string	否	風險類型。說明您可以呼叫 DescribeApisecRules 取得支援的風險類型。	LackOfSpeedLimit
AbnormalId	string	否	風險 ID。	29c6401****99a2bad3943e26d8
UserStatus	string	否	風險狀態。取值： toBeConfirmed：表示待確認。 confirmed：表示已確認。 toBeFixed：表示待修復。 fixed：表示已修復（人工驗證）。 ignored：表示忽略。 toBeVerified：表示待系統驗證。 notFixed：表示驗證未修復。 systemFixed：表示已修復（系統驗證）。	Confirmed
PageNumber	integer	否	分頁查詢時，返回第幾頁資料。預設值為 1，表示返回第 1 頁資料。	2
PageSize	integer	否	分頁查詢時，每頁包含多少筆結果。預設值為 10，表示每頁包含 10 筆結果。	10
Origin	string	否	風險類型的來源。取值： custom：表示自訂。 default：表示內建。	custom
ApiTag	string	否	API 的業務用途。說明您可以呼叫 DescribeApisecRules 取得支援的業務用途。	RegisterAPI
ClusterId	string	否	混合雲叢集 ID。說明僅適用於混合雲情境，您可以呼叫 DescribeHybridCloudClusters 取得混合雲叢集資訊。	546
RegionId	string	否	WAF 執行個體所屬地域。取值： cn-hangzhou：表示中國內地。 ap-southeast-1：表示非中國內地。	cn-hangzhou
ResourceManagerResourceGroupId	string	否	阿里雲資源群組 ID。	rg-acfm***q

返回參數

名稱	類型	描述	樣本值
	object	請求結果。
TotalCount	integer	返回結果的總數。	5
RequestId	string	請求 ID。	9469646C-F2CC-5F0F-8401-C53***4F46
Data	array<object>	風險清單。
	object	風險資訊。
AbnormalId	string	風險 ID。	7c1431f27ae7e9c8cc64095***68e
Origin	string	風險類型的來源。取值： custom：表示自訂。 default：表示內建。	custom
LastestTime	integer	API 資產最近存取時間，格式為 Unix 時間戳記（UTC 時間），單位為秒。	1684252800
FirstTime	integer	API 資產首次發現時間，格式為 Unix 時間戳記（UTC 時間），單位為秒。	1701138088
AbnromalStatus	string	風險狀態。	unresolved
ApiFormat	string	風險對應的 API 介面。	/api/login
ApiTag	string	API 的業務用途。說明您可以呼叫 DescribeApisecRules 取得支援的業務用途。	SendMail
DiscoverTime	integer	風險的首次偵測時間，格式為 Unix 時間戳記（UTC 時間），單位為秒。	1684252800
UserStatus	string	風險狀態。取值： toBeConfirmed：表示待確認。 confirmed：表示已確認。 toBeFixed：表示待修復。 fixed：表示已修復（人工驗證）。 ignored：表示忽略。 toBeVerified：表示待系統驗證。 notFixed：表示驗證未修復。 systemFixed：表示已修復（系統驗證）。	Confirmed
IgnoreTime	integer	使用者標記的忽略時間，格式為 Unix 時間戳記（UTC 時間），單位為秒。	1684252800
Follow	integer	是否關注。取值： 1：表示關注。 0：表示未關注（預設）。	0
MatchedHost	string	API 介面所屬的網域或 IP。	a.aliyun.com
Note	string	備註資訊。	Strict
AbnormalEventNumber	integer	風險關聯的事件數量。	2
AbnormalTag	string	風險類型。說明您可以呼叫 DescribeApisecRules 取得支援的風險類型。	LackOfSpeedLimit
AbnormalInfo	string	風險詳細資訊，以一系列參數建構的 JSON 格式轉化成字串。包括： rule：表示風險對應的規則。 data_type：表示敏感資料類型。 custom_rule_name：表示自訂規則名稱。 rule_name：表示內建規則名稱。	{ "data_type": ["1005","1004"], "rule": { "parent": "RiskType_Permission", "code": "Risk_UnauthSensitive", "level": "high", "origin": "default", "name": "Risk_UnauthSensitive" } }
ApiId	string	風險對應的 API ID。	09559c0d71ca2ffc996b81***836d8
AbnormalLevel	string	風險等級。取值： high：表示高危。 medium：表示中危。 low：表示低危。	high
LatestDiscoverTime	integer	風險的最近偵測時間，格式為 Unix 時間戳記（UTC 時間），單位為秒。	1684252800
Examples `deprecated`	array	風險對應的範例清單。
	string	範例資訊，以一系列參數建構的 JSON 格式轉化成字串。包括： param_num：表示 API 參數數量。 request_method：表示請求方式。 protocol：表示請求通訊協定。 api_url：表示請求 URL。 poc_payload：表示請求。 request：表示請求範例。 response：表示回應範例。 param：表示請求參數。	{ "request": {"referer": "-","content_type": "-","cookie": "-","method": "GET","param": [],"host": "test.cn"}, "protocol": "https", "api_url": "https://test.cn:443/index.php", "param": [], "response": {"param": [], "sensitive_type": {}, "header": {},"body": "", "status": 405 }, "request_method": "GET", "poc_payload": "curl -X GET -H 'Accept: /' -H 'Connection: keep-alive' -H 'User-agent: python-requests/2.32.3' -H 'X-forwarded-for: {{IPv6 Address}}' -H 'Host: test.cn' -H 'Accept-encoding: gzip, deflate' 'https://test.cn:443/index.php'", "param_num": 0 }

樣本

正常返回樣本

JSON格式

{
  "TotalCount": 5,
  "RequestId": "9469646C-F2CC-5F0F-8401-C53***4F46",
  "Data": [
    {
      "AbnormalId": "7c1431f27ae7e9c8cc64095***68e",
      "Origin": "custom",
      "LastestTime": 1684252800,
      "FirstTime": 1701138088,
      "AbnromalStatus": "unresolved",
      "ApiFormat": "/api/login",
      "ApiTag": "SendMail",
      "DiscoverTime": 1684252800,
      "UserStatus": "Confirmed",
      "IgnoreTime": 1684252800,
      "Follow": 0,
      "MatchedHost": "a.aliyun.com",
      "Note": "Strict",
      "AbnormalEventNumber": 2,
      "AbnormalTag": "LackOfSpeedLimit",
      "AbnormalInfo": "{\n    \"data_type\": [\"1005\",\"1004\"],\n    \"rule\": {\n        \"parent\": \"RiskType_Permission\",\n        \"code\": \"Risk_UnauthSensitive\",\n        \"level\": \"high\",\n        \"origin\": \"default\",\n        \"name\": \"Risk_UnauthSensitive\"\n    }\n}",
      "ApiId": "09559c0d71ca2ffc996b81***836d8",
      "AbnormalLevel": "high",
      "LatestDiscoverTime": 1684252800,
      "Examples": [
        "{\n    \"request\": {\"referer\": \"-\",\"content_type\": \"-\",\"cookie\": \"-\",\"method\": \"GET\",\"param\": [],\"host\": \"test.cn\"},\n    \"protocol\": \"https\",\n    \"api_url\": \"https://test.cn:443/index.php\",\n    \"param\": [],\n    \"response\": {\"param\": [], \"sensitive_type\": {}, \"header\": {},\"body\": \"\", \"status\": 405 },\n    \"request_method\": \"GET\",\n    \"poc_payload\": \"curl -X GET -H 'Accept: */*' -H 'Connection: keep-alive' -H 'User-agent: python-requests/2.32.3' -H 'X-forwarded-for: {{IPv6 Address}}' -H 'Host: test.cn' -H 'Accept-encoding: gzip, deflate' 'https://test.cn:443/index.php'\",\n    \"param_num\": 0\n}"
      ]
    }
  ]
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。