ScanFolder

說明

掃描指定的資料夾以及執行與掃描相關的其他動作。

語法

ounceauto ScanFolder
-folder_path <資料夾路徑>
[-name <評量名稱>]
[-scanconfig <掃描配置名稱>]
[-waitforlicense <等待時間>]
[-save <檔案名稱>]
[-caller <呼叫者>]
[-publish]
[-clearcache]
[-report <報告類型> <輸出格式> <輸出位置>]
[-export <匯出類型> <輸出位置>]
[-classificationDefinitive]
[-classificationSuspect] 
[-classificationCoverage]
[-includeSrcBefore <n>]
[-includeSrcAfter <n>]
[-includeTraceDefinitive]
[-includeTraceSuspect]
[-includeTraceCoverage]
[-includeHowToFix]
[-enablesecrets <true/false>]
[-secretsonly <true/false>]
[-sourcecodeonly <true/false>]
[-severityHigh]
[-severityMedium] 
[-severityLow] 
[-severityInfo] 

• -folder_path <資料夾路徑>：必要。要掃描的現有資料夾路徑。
• -name <評量名稱>：選用。評量的名稱。
• -scanconfig <掃描配置名稱>：選用。指定要用於掃描的掃描配置名稱。如果未指定掃描配置，掃描時會使用預設掃描配置。
• -waitforlicense <等待時間>：選用。指定等待時間（以分鐘為單位），當 AppScan® Source for Automation 授權不可用時，掃描將等待該時間。若沒有使用 -waitforlicense 指示等待時間，則會從 CLI.ozsettings 取得預設值。可以透過將值設定為 0 來停用等待時間。
• -save <檔案名稱>：選用。將評量結果儲存到這個檔案。
• -caller <caller>：選用。將呼叫者指派至該作業。呼叫者可以是實際使用者的名稱，但這不是必要的。呼叫者名稱會寫入 ounceauto 日誌檔。
• -publish：選用。在掃描之後發佈評量。
• -clearcache：選用。掃描之前，移除漏洞分析快取和自訂規則簽章資料。
• -report：選用。在掃描之後產生報告。
  • 必要的 -report 指令選項：
    • <report type>：報告類型。報告類型包括發現項目報告、AppScan® Source 報告及自訂報告。請參閱 GenerateReport 中的選項。
    • <output format>：指定報告格式。請參閱 GenerateReport 中的選項。
    • <output location>：儲存報告的位置。
  • 選用的 -report 指令選項：
    • -classificationDefinitive：過濾確定的發現項目。
    • -classificationSuspect：過濾可疑的發現項目。
    • -classificationCoverage：過濾掃描涵蓋範圍的發現項目。
    • -includeSrcBefore <n>：每個發現項目之前要包含的原始碼行數。
    • -includeSrcAfter <n>：每個發現項目之後要包含的原始碼行數。
    • -includeTraceDefinitive：在報告中包含確定性發現項目的追蹤資訊（請參閱「分類」以瞭解發現項目分類）。
    • -includeTraceSuspect：在報告中包含可疑發現項目的追蹤資訊。
    • -includeTraceCoverage：在報告中包含掃描涵蓋範圍發現項目的追蹤資訊。
    • -severityHigh：篩選高嚴重性發現項目。
    • -severityMedium：篩選中嚴重性發現項目。
    • -severityLow：篩選低嚴重性發現項目。
    • -severityInfo：篩選參考資訊嚴重性發現項目。

• -export：選用。將掃描發現項目匯出至 CSV 或 SARIF 檔。如果使用，則需要下列指令選項。
  • <export type>：匯出報告的格式，可以是 CSV 或 SARIF。
  • <output location>：用來儲存報告的路徑和檔名。

• -includeHowToFix：選用。包括有關如何處理和更正發現項目的諮詢資訊。
• -enablesecrets <true/false>：選用。指定以使用秘密掃描器及其他相關掃描器來掃描原始檔。有效值為 true 和 false。
• -secretsonly <true/false>：選用。指定以僅使用秘密掃描器來掃描原始檔。有效值為 true 和 false。
• -sourcecodeonly <true/false>：選用。請指定只掃描原始檔，並忽略其他支援的檔案類型（.dll、.exe）。有效值為 true 和 false

注意： -enablesecrets 與 -secretsonly 互斥。此兩者不能同時為 true。

返回值

如果成功，則為 Request ID；如果請求提交失敗，則為 -1。

範例

• 掃描 WebGoat 資料夾：

  ounceauto scanfolder -folder_path "C:\WebGoat"

• 掃描 WebGoat 資料夾，並在 C:\WebGoat 目錄中建立發現項目報告。在報告中，包含明確發現項目的追蹤資訊：

  ounceauto scanfolder -folder_path "C:\WebGoat" -report Findings html "C:\WebGoat\MyReport.html" -includeTraceDefinitive