提交 HCL AppScan Source 評量至 Cloud 進行分析

appscan package -d <save_path> -f <assessment_file> -n <file_name>

或在 Linux™ 及 macOS 上發出此指令：

appscan.sh package -d <save_path> -f <assessment_file> -n <file_name>

• -d：指定 -d <save_path>，其中 <save_path> 是您想要儲存 IRX 檔案的目錄。
• -f：指定 -f <assessment_file>，其中 <assessment_file> 是您要包裝以進行掃描的 .ozasmt 檔案。如果 <assessment_file> 檔案不在現行目錄中，請使用此選項來指定評量檔案路徑及檔名。
  註： 只有在符合下列其中一個或兩個陳述式時，才需要此選項：

  • 當您從包含多個評量檔的目錄中發出指令。如果目錄只包含一個評量檔，則未使用 -f 選項時，將會包裝該檔案。
  • 當您從未包含評量檔的目錄中發出指令。在此情況下，必須使用 -f 選項來指定要包裝的評量檔所在路徑及檔名。
• -n：指定 -n <file_name>，其中 <file_name> 是 IRX 檔名。指定檔名時不一定要有 .irx 副檔名。如果您指定的檔案名稱沒有副檔名，系統會在產生檔案時自動為您新增副檔名。

在 配置指令 (Windows™) 或 配置指令 （Linux™ 及 macOS） 中，會提供此指令的其他相關資訊，包括使用範例。

• HCL Cloud Marketplace：
  在 Windows™ 上發出此指令：

  appscan api_login -P <password> -u <user_name> -persist

  或在 Linux™ 及 macOS 上發出此指令：

  appscan.sh api_login -P <password> -u <user_name> -persist

  這些引數是必要的：

  • -P：指定 -P <password>，其中 <password> 是您登錄 ASoC 服務時指定的密碼。
  • -u：指定 -u <user_name>，其中 <user_name> 是您登錄 ASoC 服務時指定的電子郵件位址。

  此引數是選用的：

  • -persist：在登入記號檔到期時，自動嘗試重新接受服務的鑑別。

• 在 Windows™ 上發出此指令：

  appscan queue_analysis -a <app_id> -f <file> -n <scan_name>

  或在 Linux™ 及 macOS 上發出此指令：

  appscan.sh queue_analysis -a <app_id> -f <file> -n <scan_name>

  這些引數是必要的：

  • -f：指定 -f <file>，其中 <file> 是您要提交以進行掃描的 IRX 檔案或非 IRX 封存。如果檔案不在現行目錄中，請使用此選項來指定檔案路徑及檔名。
    註： 只有在符合下列其中一個或兩個陳述式時，才需要此選項：

    • 您是從包含多個目標檔案的目錄中發出指令。如果目錄只包含一個目標檔案，則未使用 -f 選項時，將會提交該檔案。
    • 您是從未包含目標檔案的目錄中發出指令。在此情況下，必須使用 -f 選項來指定要提交的檔案的路徑及檔名。
  • -a：您提交進行分析的檔案（IRX 檔案或非 IRX 封存）必須與現有 AppScan on Cloud 應用程式相關聯。在這個選項中，指定 -a <app_id>，其中 <app_id> 是要產生關聯之應用程式的 ID。如果要判斷 ID，請使用 list_apps 指令。
• 當指令完成時，將顯示分析工作的 ID。如果您要使用 CLI 來接收 AppScan on Cloud 分析報告，您需要在 appscan get_result (Windows™) 或 appscan.sh get_result （Linux™ 及 macOS） 指令中併入此工作 ID - 您應記下此 ID。如果您使用 CLI 來接收分析報告，您可以選擇接收包含 .ozasmt 檔的封存 (.zip)，就能在 AppScan Source 中開啟分析報告。如果只有興趣查看 HTML 報告，您可以使用 CLI 或 AppScan on Cloud Web 用戶端來下載報告。

分析指令 (Windows™) 或 分析指令 （Linux™ 及 macOS） 中會提供使用此指令的相關詳細資料。

appscan get_result -d <file_path> -i <job_id> -t <type>

或在 Linux™ 及 macOS 上發出此指令：

appscan.sh get_result -d <file_path> -i <job_id> -t <type>

此引數是必要的：

• -i：指定 -i <job_id>，其中 <job_id> 是分析工作的 ID。

這些引數是選用的：

• -d：指定 -d <file_path>，其中 <file_path> 是目的地檔案的完整路徑及/或目的地檔案的檔名。如果未指定檔名，則檔名將根據掃描工作名稱。如果未指定路徑，則會將檔案儲存至現行目錄。如果未包括此選項，則會使用根據掃描工作名稱的檔名，將檔案儲存至現行目錄。
• -t：指定 -t <type>，其中 <type> 是 html 或 zip。結果會儲存為 HTML 檔，或儲存為包含 HTML 結果的 .zip 檔案。如果未包括此選項，則會將結果儲存為 HTML 檔案。

  如果掃描結果是針對 package 指令所產生 IRX 檔案，則指定 -t zip 所儲存的結果會包含新的 .ozasmt 檔案，而可供載入 AppScan 9.0 版或更新版本產品中。

結果指令(Windows™) 或 結果指令 （Linux™ 及 macOS） 中會提供使用此指令的相關詳細資料。