Welcome
参考
查看 HCL® AppScan® Source 的参考信息，包括使用实用程序、插件和 API。
AppScan® Source Data Access API
Data Access API 提供对 AppScan® Source 所生成的评估结果（包括结果和结果详细信息）的访问权。它还提供对评估度量值如分析日期和时间、代码行、V-Density 和结果数的访问权。
Ounce/Maven 插件
此部分描述 Ounce/Maven 插件，它使用 Maven（一种 Apache 构建工具）将 AppScan® Source 集成到 Maven 工作流程中。
Ounce/Maven 目标
ounce:report

欢迎
欢迎阅读 HCL® AppScan® Source 文档。
新增功能
探索 AppScan® Source 中新增的功能，并了解此版本中弃用的功能和特性。
正在安装
了解如何安装、升级和激活 HCL® AppScan® Source。
配置
了解如何在 HCL® AppScan® Source 中配置应用程序、文件夹和项目，以及设置特性和属性。
管理
了解如何管理用户帐户和许可权、审计用户活动以及管理 HCL® AppScan® Source 中的集成。
扫描
本部分说明如何在 HCL® AppScan® Source 中扫描源代码和管理评估。
筛选和分析
通过对相似发现结果进行分组，安全分析人员或 IT 审计员可以对源代码问题进行分段和分类。此部分说明如何将 AppScan® Source 评估分类和对结果进行分析。
报告
安全分析人员和风险管理员可以访问对选定结果的报告，或一系列用于度量与软件安全最佳做法和法规要求是否一致的审计报告。本部分说明如何创建对聚集结果数据的报告。
扩展产品功能
了解如何扩展产品，以满足特定开发需求。
参考
查看 HCL® AppScan® Source 的参考信息，包括使用实用程序、插件和 API。
- Ounce/Make 构建实用程序
  Ounce/Make 是一种从使用 makefile 的构建环境自动将配置信息导入 AppScan® Source 的工具。通过使用 Ounce/Make 方法，将无需手动从 makefiles 导入配置信息；这是用于配置这些项目的推荐方法。
- AppScan® Source 命令行界面 (CLI)
  CLI 是核心 AppScan® Source 功能的界面。
- Ounce/Ant 构建工具
  此部分描述如何使用 Ounce/Ant，它是用于集成 AppScan® Source 和 Apache Ant 的 AppScan Source 构建实用程序。将 Ounce/Ant 与 Ant 环境集成有助于将构建和代码评估自动化。
- AppScan® Source Data Access API
  Data Access API 提供对 AppScan® Source 所生成的评估结果（包括结果和结果详细信息）的访问权。它还提供对评估度量值如分析日期和时间、代码行、V-Density 和结果数的访问权。
  - Data Access API 对象模型
  - 使用 Data Access API
    您可以在 <install_dir>\sdk\sample\com\ouncelabs\sdk\sample（其中 <install_dir> 是您的AppScan® Source安装位置）包含的 SamplePublished.java 和 SampleSdk.java 文件中找到许多 Data Access API 方案的完整示例。
  - Data Access API 类和方法
  - Ounce/Maven 插件
    此部分描述 Ounce/Maven 插件，它使用 Maven（一种 Apache 构建工具）将 AppScan® Source 集成到 Maven 工作流程中。
    - 安装 Ounce/Maven
    - 使用 Ounce/Maven
      通过 Ounce/Maven 插件，您可以使用 Ounce/Maven 来创建 AppScan® Source 项目和应用程序，扫描应用程序，发布所生成的评估，并生成 AppScan Source 报告。与对任何其他 Maven 插件一样指定 Ounce/Maven 目标和参数。
    - Ounce/Maven 方案
    - Ounce/Maven 目标
  - AppScan® Source for Automation
    通过 Automation Server (ounceautod)，您可以在软件开发生命周期 (SDLC) 过程中使 AppScan® Source 工作流程的关键方面自动化，并且将安全性集成到构建环境中。通过 Automation Server，您可以将扫描和发布评估的请求进行排队，并生成有关应用程序代码安全性的报告。
  - Framework for Frameworks 处理 API
    AppScan® Source 提供了一组 Java™ API，使您可以添加对您应用程序中使用的框架的支持。在这些 API 中提供的类和方法使您可以处理没有提供内置支持的框架。
  - AppScan® Source 客户机组件错误消息
  - AppScan® Source for Analysis 样本
    AppScan® Source for Analysis 包含了可用于帮助您熟悉产品的样本应用程序样本应用程序。
  - AppScan® Source for Analysis 工作环境
    要充分利用 AppScan® Source，您应该了解 AppScan Source for Analysis 工作环境背后的基本概念以及如何使用最适合于您的工作流程的选项。
  - 视图和窗口
    AppScan® Source for Development 视图和窗口提供对结果的备选表示法，支持代码编辑并使您能够在工作台中浏览信息。视图可能单独显示，或者与其他视图以堆栈化方式显示在选项卡式笔记本中。您可以通过打开和关闭视图以及将其悬停在“工作台”窗口中的不同位置来更改透视图的布局或窗口布局。
  - CWE 支持
    常见缺陷枚举（CWE）是一个行业标准列表，为公众已知的软件缺陷提供通用名称。本主题列出了AppScan® Source当前版本中受支持的 CWE ID。
- 术语表
  了解该产品的通用术语。
故障诊断和技术支持
在使用 HCL® AppScan® Source 时可帮助您进行问题故障排除的自助信息、资源和工具。

`ounce:report`

描述

ounce:report 目标从评估生成报告。如果不指定现有评估，那么ounce:report 在生成报告之前将运行 ounce:scan。从命令行运行 ounce:report。

指定 reportType 值和 reportOutputType 值中描述的报告参数。如果指定 reportType，则还必须指定 reportOutputType 和 reportOutputPath。您还可以选择在报告中包含修复信息。

`reportType` 值

发现结果报告：
- 发现结果
- 按修复组分类的发现结果
- 发现结果（按类型）
- 发现结果（按分类）
- 发现结果（按文件）
- 发现结果（按 API）
- 发现结果（按束）
- 按 CWE 分类的发现结果
AppScan® Source报告：
- 2024 CWE 最危险的 25 大软件缺陷
- 2025 CWE 最危险的 25 大软件缺陷
- DISA Application Security and Development STIG V5R3
- DISA Application Security and Development STIG V6R3
- 2023年OWASP API安全十大
- 2019 年 OWASP 十大 API 安全风险
- OWASP Mobile Top 10
- 2021 年 OWASP 前 10 位
- OWASP 十大（2025）
- PCI Data Security Standard V4.0
- 软件安全概要文件
定制报告（如果可用）。

`reportOutputType` 值

为此报告指定以下某种格式：
- html：将报告生成为 HTML 并将其在线显示。
- zip：创建包含所有 HTML 报告组件的 ZIP 文件。
对于 PDF 格式的报告，可以指定详细级别：
- pdf-summary：包含每个定制报告组的计数
- pdf-detailed：包含对各漏洞属性的每个 API 的计数
- pdf-comprehensive：包含由各 API 的每个结果组成的表
- pdf-annotated：包含所有结果、结果附带的任何说明以及指定的代码片段
- pdf-annotated：将已注释的报告生成为 PDF 文件。

修复信息

在发现结果修复报告中包括如何修复信息：

命令行变量：
```
-Dounce.includeHowToFix
```
示例：
```
-Dounce.includeHowToFix=true
```