使用 OpenAPI 規格檔進行掃描
您可以使用 OpenAPI 規格檔自動掃描 OpenAPI,讓您更新參數並包含所有端點,以提供更好的涵蓋範圍。這可確保掃描更加完整且準確。
開始之前
註: 如果參數值為上傳的檔案,請使用使用 Postman 集合來掃描。
程序
- 移至配置 > API。
-
選取 OpenAPI 規格檔,然後按一下新增規格檔。
註: AppScan Standard 不支援 OpenAPI 規格版本 '3.1.0'。
-
輸入 URL 或按一下瀏覽以從本端磁碟機中選擇檔案,然後按一下繼續。AppScan 僅接受 JSON 或 YAML 格式的規格檔。
AppScan 會解析規格檔,並在編輯其他參數表格中顯示偵測到的 API 參數。
- 若未自動填入,請配置基本 URL。
-
AppScan 在探索期間會自動偵測參數的值,但您可以手動更新參數,以在掃描期間無法自動偵測到值時獲得較佳效能。將參數值與其相關 URL 配對,以編輯參數值。
註: 如果參數名稱和值適用於所有端點,請在編輯參數對話方塊中勾選將此值套用至所有參數勾選框。建議更新參數以獲得更好的掃描涵蓋範圍,確保所有端點都涵蓋在內,並避免要求失敗。
- 視需要配置 API 鑑別。根據您的規格檔,配置 API 金鑰和/或配置基本鑑別 (HTTP) 鏈結會顯示以配置鑑別。如果沒有顯示鏈結,您可以透過 API 金鑰、HTTP 鑑別,或登入管理(記錄登入或使用自動登入)手動設定鑑別作業。
- 為避免在探索期間超出速率限制失敗,請調整通訊與 Proxy 標籤中的要求率上限。
-
配置完成後,您可以啟動掃描。
AppScan 會啟動自動掃描。註: 若您將本端檔案而非 URL 新增至配置,就無法將其匯出為 SCANT(範本)檔案,因為規格檔無法併入範本中。您必須移除規格檔,或將其儲存為 SCAN 檔案。