将 HCL AppScan Source 评估提交到云以进行分析

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> 是要关联的应用程序的标识。要确定标识，请使用 list_apps 命令。
• 命令完成时，将显示分析作业的标识。如果要使用 CLI 接收 AppScan on Cloud 分析报告，将需要在 appscan get_result (Windows™) 或 appscan.sh get_result （Linux™ 和 macOS） 命令中包含此作业标识，并应记下标识。如果使用 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> 是分析作业的标识。

以下参数是可选的：

• -d：指定 -d <file_path>，其中 <file_path> 是目标文件的标准路径和/或目标文件的文件名。如果未指定文件名，则文件名将基于扫描作业名。如果未指定路径，则文件将保存到当前目录。如果未包含该选项，则文件将以基于扫描作业名的文件名保存到当前目录。
• -t：指定 -t <type>，其中 <type> 为 html 或 zip。结果将另存为 HTML 文件或包含 HTML 结果的 .zip 文件。如果未包含该选项，结果将另存为 HTML 文件。

  如果扫描结果是针对 package 命令所生成的 IRX 文件，则指定 -t zip 会保存包含新 .ozasmt 文件的结果，该文件可以装入到 AppScan V9.0 或更高产品版本中。

有关使用该命令的详细信息，请参阅 结果命令 (Windows™) 或 结果命令 （Linux™ 和 macOS）。