1、安恒明鑒Web漏洞掃描接口說(shuō)明一、訪問(wèn)方式接口的開(kāi)發(fā)采用Webservice技術(shù),能使得運(yùn)行在不同機(jī)器上的不同應(yīng)用無(wú)須借助附加的、專門(mén)的第三方軟件或硬件,就可相互交換數(shù)據(jù)或集成。采用的協(xié)議：SOAP（用來(lái)描述傳遞信息的格式，基于XML協(xié)議）,WSDL(WebServicesDescriptionLanguage,用來(lái)描述如何訪問(wèn)具體的接口)。二、控制接口功能要求1.下發(fā)掃描任務(wù)：POSThttps:/WEBSERIVCE-SERVER/rpc/create-task輸入信息：字段類(lèi)型說(shuō)明必需默認(rèn)值methodstring首頁(yè)請(qǐng)求發(fā)送的方式（GET/POST）否-GETurlstring首頁(yè)訪問(wèn)

2、是-postDatastring首頁(yè)請(qǐng)求body信息否-taskNamestring任務(wù)名否-scanPolicystring使用的掃描策略ID列表，逗號(hào)分隔是-optionsstring掃描任務(wù)的參數(shù)列表，名值對(duì)，分號(hào)分隔否userstring用戶名，加密傳輸是-passwordstring密碼，加密傳輸是返回信息：字段類(lèi)型說(shuō)明retint操作狀態(tài)碼：0-成功，其他-失敗idint當(dāng)前創(chuàng)建成功的任務(wù)id號(hào)statusstring任務(wù)下發(fā)結(jié)果：失敗原因，描述等2.獲取掃描任務(wù)狀態(tài)POSThttps:/WEBSERIVCE-SERVER/rpc/get-taskstatus輸入信息：字段類(lèi)型說(shuō)明

3、必需默認(rèn)值idint掃描任務(wù)的id是-userstring用戶名，加密傳輸是-passwordstring密碼，加密傳輸是返回結(jié)果：字段類(lèi)型說(shuō)明totalUrlint總url數(shù)目exploredUrlint完成爬行的url數(shù)量testedUrlint完成測(cè)試的url數(shù)量taskStatusstring任務(wù)狀態(tài)（等待調(diào)度、正在掃描、掃描完畢、掃描停止等）taskProgressint任務(wù)進(jìn)度（1100的整數(shù)）startTimedate任務(wù)開(kāi)始時(shí)間endTimedate任務(wù)結(jié)束時(shí)間errorMessagestring錯(cuò)誤信息掃描任務(wù)控制POSThttps:/WEBSERIVCE-SERVER/rp

4、c/control-task輸入信息：字段類(lèi)型說(shuō)明必需默認(rèn)值idint掃描任務(wù)的id是-actionint控制任務(wù)的狀態(tài)碼，0,1,2,3分別代表任務(wù)啟動(dòng)、重新開(kāi)始、任務(wù)暫停、任務(wù)停止是-userstring用戶名，加密傳輸是-passwordstring密碼，加密傳輸是返回結(jié)果：字段類(lèi)型說(shuō)明retint操作狀態(tài)碼：0-成功，其他-失敗statusstring操作結(jié)果：失敗原因，描述等.獲取掃描任務(wù)結(jié)果：POSThttps:/WEBSERIVCE-SERVER/rpc/get-scanresult輸入信息：字段類(lèi)型說(shuō)明必需默認(rèn)值idint掃描任務(wù)的id是-userstring用戶名，加密傳輸是

5、-passwordstring密碼，加密傳輸是返回結(jié)果：字段類(lèi)型說(shuō)明resultstringXML格式，XML中需包含：url、漏洞等數(shù)據(jù).獲取掃描任務(wù)列表：POSThttps:/WEBSERIVCE-SERVER/rpc/get-tasklist輸入信息：字段類(lèi)型說(shuō)明必需默認(rèn)值userstring用戶名，加密傳輸是-passwordstring密碼，加密傳輸是返回結(jié)果：字段類(lèi)型說(shuō)明resultstring包含任務(wù)列表，每個(gè)任務(wù)包含：id，名稱，首頁(yè)URL，所屬用戶名稱，狀態(tài)，安全狀況等2.系統(tǒng)查詢接口獲取掃描策略列表：POSThttps:/WEBSERIVCE-SERVER/rpc/get-

6、policy-table輸入信息：字段類(lèi)型說(shuō)明必需默認(rèn)值userstring用戶名，加密傳輸是-passwordstring密碼，加密傳輸是返回結(jié)果：字段類(lèi)型說(shuō)明resultstring包含任務(wù)列表，每個(gè)策略包含：id，名稱，危害級(jí)別，所屬類(lèi)型，相關(guān)知識(shí)庫(kù)等內(nèi)容獲取掃描配置項(xiàng)列表：POSThttps:/WEBSERIVCE-SERVER/rpc/get-option-table輸入信息：字段類(lèi)型說(shuō)明必需默認(rèn)值userstring用戶名，加密傳輸是-passwordstring密碼，加密傳輸是返回結(jié)果：字段類(lèi)型說(shuō)明resultstring包含配置列表，每個(gè)配置項(xiàng)包含：key，名稱，數(shù)據(jù)類(lèi)型，取值

7、范圍，輸入校驗(yàn)表達(dá)式，默認(rèn)值等獲取系統(tǒng)版本信息查詢接口POSThttps:/WEBSERIVCE-SERVER/rpc/get-sys-version輸入信息：字段類(lèi)型說(shuō)明必需默認(rèn)值userstring用戶名，加密傳輸是-passwordstring密碼，加密傳輸是返回結(jié)果：字段類(lèi)型說(shuō)明softwareVersionstring軟件版本號(hào)policyVersionstring策略庫(kù)版本號(hào)policyUpdatedate策略庫(kù)更新時(shí)間獲取系統(tǒng)狀態(tài)信息：POSThttps:/WEBSERIVCE-SERVER/rpc/get-sys-status輸入信息：字段類(lèi)型說(shuō)明必需默認(rèn)值userstring用戶名