合规报告

查看有关群组的违反合规和合规框架的报告。

违反合规报告

  • 引入于 12.8 版本，名为合规看板。
  • 重命名为合规报告于 14.2 版本。
  • 替换为合并请求违规于 14.6 版本，功能标志为 compliance_violations_report。默认禁用。
  • GraphQL API 引入于 14.9 版本。
  • 一般可用于 14.10 版本。删除功能标志 compliance_violations_report。
  • 重命名为违反合规报告于 15.9 版本。
  • 创建/编辑合规性框架的功能引入于 16.0 版本。

通过违反合规报告，您可以查看群组中所有项目的合并请求活动的高级视图。

当您在合规报告中选择一行时，将出现一个折叠菜单，其中包括：

  • 项目名称和合规框架标记。
  • 指向引入违规的合并请求的链接。
  • 合并请求的分支路径，格式为 [source] into [target]。
  • 对合并请求提交变更的用户列表。
  • 对合并请求发表评论的用户列表。
  • 批准合并请求的用户列表。
  • 合并合并请求的用户。

查看群组的违反合规报告

先决条件：

  • 您必须是管理员或具有该群组的所有者角色。

查看违反合规报告：

  1. 在顶部栏上，选择 主菜单 > 群组 并找到您的群组。
  2. 在左侧边栏中，选择 安全与合规 > 合规报告。

您可以对报告进行排序：

  • 严重性级别。
  • 违规类型。
  • 合并请求标题。

选择一行，查看违规的详细信息。

严重性级别

每个违规行为都具有严重性级别，如下表所述。

图标 严重性级别
Critical
High
Medium
Low
Info

违规类型

从 14.10 版本开始，报告包含以下违规类型。

违规行为 严重性级别 类别 描述
作者批准了合并请求 High 职责分离 合并请求的作者批准了他们自己的合并请求。有关详细信息，请参阅阻止作者批准。
提交者批准了合并请求 High 职责分离 合并请求的提交者批准了他们贡献的合并请求。有关详细信息，请参阅阻止添加提交的用户进行批准。
少于两次批准 High 职责分离 合并请求合并时，获得的批准数少于两个。有关详细信息，请参阅合并请求批准规则。

报告不包含以下违规行为：

违规行为 严重性级别 类别 描述
流水线失败 Medium 流水线结果 合并请求流水线失败，合并请求被合并。
流水线通过但有警告 Info 流水线结果 合并请求流水线通过时包含警告，合并请求被合并。
代码覆盖率下降超过 10% High 代码覆盖率 合并请求的代码覆盖率报告表明覆盖率降低了 10% 以上。
代码覆盖率下降 5% 到 10% Medium 代码覆盖率 合并请求的代码覆盖率报告表明覆盖率降低了 5% 到 10%。
代码覆盖率下降 1% 到 5% Low 代码覆盖率 合并请求的代码覆盖率报告表明覆盖率降低了 1% 到 5%。
代码覆盖率下降不到 1% Info 代码覆盖率 合并请求的代码覆盖率报告表明覆盖率下降不到 1%。

职责分离

极狐GitLab 支持创建合并请求的用户，和批准合并请求的用户之间的职责分离策略。职责分离标准是：

监管链报告

  • 引入于 13.3 版本。
  • 使用邮件发送监管链报告功能引入于 15.3 版本，功能标志为 async_chain_of_custody_report。默认禁用。
  • 一般可用于 15.5 版本。删除功能标志 async_chain_of_custody_report。
  • 监管链报告包括所有提交（不仅仅是合并提交）引入于 15.9 版本，功能标志为 all_commits_compliance_report。默认禁用。
  • 一般可用于 15.9 版本。删除功能标志 all_commits_compliance_report。

监管链报告提供了一个 1 个月的跟踪窗口，其中包含对群组下项目的所有提交。

要为所有提交生成报告，极狐GitLab：

  1. 获取群组下的所有项目。
  2. 对于每个项目，获取最近 1 个月的提交。每个项目的上限为 1024 次提交。如果在 1 个月的窗口中有超过 1024 次提交，它们将被截断。
  3. 将提交写入 CSV 文件。该文件被截断为 15 MB，因为报告是作为电子邮件附件发送的（15.5 及更高版本）。

该报告包括：

  • 提交 SHA
  • 提交作者
  • 提交者
  • 提交日期
  • 群组
  • 项目

如果提交有相关的合并提交，则还包括以下内容：

  • 合并提交 SHA。
  • 合并请求 ID。
  • 合并合并请求的用户。
  • 合并日期。
  • 流水线 ID。
  • 合并请求批准者。

生成监管链报告

要生成监管链报告：

  1. 在顶部栏中，选择 主菜单 > 群组 并找到您的群组。
  2. 在左侧边栏中，选择 安全与合规 > 合规报告。
  3. 选择 所有合并提交的列表。

根据您的极狐GitLab 版本，监管链报告可以通过电子邮件发送或可供下载。

生成特定提交的监管链报告

  • 引入于 13.6 版本。
  • 对所有提交而不仅仅是合并提交的支持添加于 15.10 版本。

您可以为特定的提交 SHA 生成特定于提交的监管链报告。此报告仅提供提交 SHA 的详细信息。

要生成特定于提交的监管链报告：

  1. 在顶部栏中，选择 主菜单 > 群组 并找到您的群组。
  2. 在左侧边栏中，选择 安全与合规 > 合规报告。
  3. 在合规报告的顶部，在 所有提交列表 的右侧，选择向下箭头（）。
  4. 输入提交 SHA，然后选择 导出提交监管报告。

根据您的极狐GitLab 版本，监管链报告可以通过电子邮件发送或可供下载。

或者，使用直接链接：https://jihulab.com/groups/<group-name>/-/security/merge_commit_reports.csv?commit_sha={optional_commit_sha}，将可选值传递给 commit_sha 查询参数。

合规框架报告

引入于 15.10 版本。

通过合规框架报告，您可以查看应用于群组中项目的合规框架。报告的每一行显示：

  • 项目名称。
  • 项目路径。
  • 合规框架标记（如果项目已分配）。

群组的默认框架有一个默认徽章。

查看群组的合规框架报告

先决条件：

  • 您必须是管理员或具有群组的所有者角色。

查看合规框架报告：

  1. 在顶部栏中，选择 主菜单 > 群组 并找到您的群组。
  2. 在左侧边栏中，选择 安全与合规性 > 合规报告。
  3. 在页面上，选择 框架 选项卡。

将合规框架应用于群组中的项目

  • 使用批量操作添加合规框架的功能引入于 15.11 版本。
  • 在不使用批量操作的情况下添加合规框架的功能引入于 16.0 版本。

您可以将合规框架应用于群组中的项目。

先决条件：

  • 您必须具有群组的所有者角色。

将合规框架应用于群组中的一个项目：

  1. 在顶部栏中，选择 主菜单 > 群组 并找到您的群组。
  2. 在左侧边栏中，选择 安全与合规 > 合规报告。
  3. 在页面上，选择 框架 选项卡。
  4. 在您要添加合规框架的项目旁边，选择 添加框架。
  5. 选择一个现有的合规框架或创建一个新的合规框架。

将合规性框架应用于群组中的多个项目：

  1. 在顶部栏中，选择 主菜单 > 群组 并找到您的群组。
  2. 在左侧边栏中，选择 安全与合规 > 合规报告。
  3. 在页面上，选择 框架 选项卡。
  4. 选择多个项目。
  5. 从 选择一个批量操作 下拉列表中，选择 将框架应用到所选项目。
  6. 选择要应用的框架。
  7. 选择 应用。

从群组的项目中删除合规框架

  • 使用批量操作删除合规框架的功能引入于 15.11 版本。
  • 在不使用批量操作的情况下删除合规框架的功能引入于 16.0 版本。

您可以从群组的项目中删除合规框架。

先决条件：

  • 您必须具有群组的所有者角色。

从群组的一个项目中删除合规框架：

  1. 在顶部栏中，选择 主菜单 > 群组 并找到您的群组。
  2. 在左侧边栏中，选择 安全与合规 > 合规报告。
  3. 在页面上，选择 框架 选项卡。
  4. 在要从项目中删除的合规框架旁边，选择框架标签上的 。

从群组的多个项目中删除合规框架：

  1. 在顶部栏中，选择 主菜单 > 群组 并找到您的群组。
  2. 在左侧边栏中，选择 安全与合规 > 合规报告。
  3. 在页面上，选择 框架 选项卡。
  4. 选择多个项目。
  5. 从 选择一个批量操作 下拉列表中，选择 从所选项目中删除框架。
  6. 选择 删除。

导出群组中项目的合规框架报告

引入于 16.0 版本。

导出适用于群组中项目的合规框架报告。

  • 框架报告不使用过滤器。
  • 报告被截断为 15 MB，因此电子邮件附件太大。

先决条件：

  • 您必须是管理员或具有群组的所有者角色。

要导出群组中项目的合规框架报告：

  1. 在顶部栏中，选择 主菜单 > 群组 并找到您的群组。
  2. 在左侧边栏中，选择 安全与合规 > 合规报告。
  3. 在页面上，选择 框架 选项卡。
  4. 在 框架 选项卡上，选择右上角的 导出为 CSV 操作。

报告将被编译并作为附件发送到您的电子邮件收件箱。

过滤合规框架报告

引入于 15.11 版本。

要过滤合规框架列表：

  1. 在顶部栏中，选择 主菜单 > 群组 并找到您的群组。
  2. 在左侧边栏中，选择 安全与合规 > 合规报告。
  3. 在页面上，选择 框架 选项卡。
  4. 在搜索栏中：
    1. 选择您要过滤的属性。
    2. 选择一个操作符。
    3. 从选项列表中选择或输入搜索文本。
  5. 选择 搜索（）。

重复此过程，可以按多个属性进行过滤。