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