使用 OpenAPI 規格檔進行掃描

您可以使用 OpenAPI 規格檔自動掃描 OpenAPI,讓您更新參數並包含所有端點,以提供更好的涵蓋範圍。這可確保掃描更加完整且準確。

開始之前

註: 如果參數值為上傳的檔案,請使用使用 Postman 集合來掃描

程序

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

下一步

掃描完成後,您可以在自動表單填入頁面上檢視掃描期間找到的參數,並在資料頁面上檢視送出的要求和找到的參數。