183
阿裏雲 技術社區[雲棲]
漏洞掃描接口__漏洞掃描API_API手冊_移動安全-阿裏雲
請求參數
| 名稱 |
父節點 |
類型 |
是否必須 |
描述 |
|---|
| AppInfo |
|
String（JSON格式的字符串） |
是 |
待漏洞掃描的應用信息 |
| dataType |
AppInfo |
Number |
否 |
APP數據類型 1-App URL，2-App MD5 |
| data |
AppInfo |
String |
否 |
APP數據：dataType=1時填寫 App包的下載地址；dataType=2時填寫 App包的md5值 |
| md5 |
AppInfo |
String |
否 |
APP包的MD5值,dataType=1時必填,用於文件校驗 |
| size |
AppInfo |
Number |
否 |
APP包大小(單位:字節),dataType=1時必填,用於文件校驗 |
| callbackUrl |
AppInfo |
String |
否 |
任務處理完成後的反向通知回調地址，dataType=1時必填，通知為GET請求，請求URL: callbackUrl+”?item_id=xxx&task_status=1”； item_id為漏洞掃描接口返回的任務ID；task_status為任務狀態：1-已完成，2-處理中，3-處理出錯，4-處理超時；對於漏洞掃描，如果task_status為1，3，4均可通過對應查詢接口查詢到結果，但不包括失敗的掃描項的結果 |
| appOsType |
AppInfo |
Number |
否 |
app 類型，1-apk, 2-ipa（暫不支持） |
| ExtParam |
|
String |
否 |
額外的信息，根據具體業務定 |
請求示例
https://jaq.aliyuncs.com/?Format=JSON&AccessKeyId=accessKeyId&Action=ScanVuln&SignatureMethod=HMAC-SHA1&ExtParam=xxx&RegionId=cn-hangzhou&AppInfo=%7B%22appOsType%22%3A1%2C%22callbackUrl%22%3A%22http%3A%2F%2Faaa.com%2Fcallback%22%2C%22data%22%3A%22http%3A%2F%2Fg01.alibaba-inc.com%2Ftfscom%2FLB1PaMeKXXXXXX8XFXXXXXXXXXX.tfsprivate1446115983140-375%22%2C%22dataType%22%3A1%2C%22md5%22%3A%22ce86f08da845d0af6d9df2a958de17b0%22%2C%22size%22%3A1713656%7D&SignatureNonce=4a733057-2adc-4f7f-b530-fd73fb6ad079&SignatureVersion=1.0&Version=2016-04-12&Signature=sVQVNw38rOCJdn6Nq8YN6CT9jTg%3D&Timestamp=2016-06-05T07%3A16%3A04Z
返回參數
| 名稱 |
父節點 |
描述 |
|---|
| Data |
|
返回結果 |
| itemId |
Data |
任務唯一標識 |
| progress |
Data |
任務處理進度: 1-處理完成（可立即通過對應的查詢接口查詢處理結果）， 2-異步處理中（需等待app_info.callback_url接收到反向通知後再查詢結果）；對於app_info.data_type為1目前都是異步處理，此字段返回2；對於app_info.data_type為2目前都是同步處理，此字段返回1 |
返回示例
JSON格式
{ "Data": { "ItemId": "adef0394-3370-4e94-82c6-07af0d15a9cd", "Progress": 2 }, "ErrorMsg": "Success", "ErrorCode": 0}
XML格式
<?xml version='1.0' encoding='UTF-8'?><ShieldResponse> <Data> <ItemId>e112d1ba-d058-4a96-ac1e-4b9f4986cf2e</ItemId> <Progress>2</Progress> </Data> <ErrorMsg>Success</ErrorMsg> <ErrorCode>0</ErrorCode></ShieldResponse>
最後更新：2016-11-23 16:04:13