Skip to main content

自定义自动分类规则以确定 Dependabot 警报的优先级

可以创建自己的 自动分类规则 来控制哪些警报被忽略或延迟提醒,以及哪些警报要 Dependabot 创建拉取请求。

谁可以使用此功能?

  • 组织所有者
  • 安全管理员
  • 具有“管理员”访问权限的用户(可以启用、禁用和查看存储库的 自动分类规则,以及创建 自定义自动分类规则)****

GitHub 预设**** 适用于所有存储库类型。

自定义自动分类规则 可用于以下存储库类型:

  • GitHub.com 上的公共存储库
  • 启用了 GitHub Team 的 GitHub Enterprise Cloud 或 GitHub Code Security 上的组织拥有的存储库

关于 自定义自动分类规则

您可以根据警报元数据创建自己的 Dependabot 自动分类规则。 可以选择无限期地自动消除警报,或推迟警报,直到修补程序可用,并且可以指定要为其打开拉取请求的Dependabot alertsDependabot。 在发送警报通知之前应用规则,因此创建自定义规则,自动消除低风险警报将降低未来的通知干扰。

由于创建的任何规则都适用于将来和当前警报,因此还可以用于 自动分类规则 批量管理警报。

存储库管理员可以为其存储库创建 自定义自动分类规则 。 对于专用或内部存储库,这需要 GitHub Code Security。

组织所有者和安全经理可以在组织级别设置 自定义自动分类规则 ,然后选择是否在组织中所有公共和专用存储库中强制执行或启用规则。

  • 强制执行: 如果组织级规则为“强制执行”,则存储库管理员无法编辑、禁用或删除规则。
  • 已启用: 如果组织级规则为“已启用”,则存储库管理员仍可禁用其存储库的规则。

注意

如果组织级规则和存储库级规则指定冲突行为,则组织级规则阐述的操作优先。 解除规则始终在触发 Dependabot 拉取请求的规则之前执行。

你可以使用以下元数据创建规则来定位警报:

  • CVE标识符
  • CWE
  • 依赖项范围(devDependencyruntime
  • 生态系统
  • GHSA 标识符
  • 清单路径(仅适用于存储库级的规则)
  • 包名称
  • 修补程序可用性
  • Severity
  • EPSS 分数

了解自定义自动分类规则和Dependabot security updates的交互方式

注意

Dependabot 将仅打开拉取请求以解析 Dependabot alerts,而不是 Dependabot malware alerts。

您可以使用 自定义自动分类规则 定制哪些 Dependabot alerts 会为 Dependabot 打开拉取请求。 但是,要使“打开拉取请求”规则生效,必须确保 Dependabot security updates 为应应用规则的存储库(或存储库) 禁用

为存储库启用后 Dependabot security updates , Dependabot 将自动尝试打开拉取请求,以解决具有可用修补程序 的每个 打开 Dependabot 警报。 如果希望使用规则自定义此行为,则必须保持 Dependabot security updates 禁用状态。

有关为存储库启用或禁用 Dependabot security updates 的详细信息,请参阅 配置 Dependabot 安全更新

将 自定义自动分类规则 添加到您的存储库

注意

在公共预览版期间,您最多可以为存储库创建 10 个自定义自动分类规则。

  1. 在 GitHub 上,导航到存储库的主页面。

  2. 在仓库名称下,单击 “Settings”****。 如果看不到“设置”选项卡,请选择“”下拉菜单,然后单击“设置”。

    存储库标头的屏幕截图,其中显示了选项卡。 “设置”选项卡以深橙色边框突出显示。

  3. 在边栏的“Security”部分中,单击“ Advanced Security”****。

  4. 在“Dependabot”部分,单击“Dependabot 规则”右侧的

  5. 单击“新建规则”。

  6. 在“规则名称”下,描述此规则要执行的操作。

  7. 在“状态”下,使用下拉菜单选择是应为存储库启用或禁用规则。

  8. 在“目标警报”下,选择要用于筛选警报的元数据。

  9. 在“规则”下,选择要对符合元数据的警报执行的操作:

    • 选择“消除警报”以自动消除符合元数据的警报。**** 可以选择无限期或在修补程序可用前消除警报。

    • 如果要**** 建议更改以解决与目标元数据匹配的警报,请选择Dependabot。 请注意,如果已选择无限期关闭警报的选项或在 Dependabot security updates 存储库设置中启用,则此选项不可用。

      注意

      Dependabot 将仅打开拉取请求以解析 Dependabot alerts,而不是 Dependabot malware alerts。

  10. 单击“创建规则”。

将 自定义自动分类规则 添加到您的组织中

您可以为组织中所有符合条件的存储库添加 自定义自动分类规则。 有关详细信息,请参阅“配置组织的全局安全设置”。

编辑或删除 自定义自动分类规则 存储库

  1. 在 GitHub 上,导航到存储库的主页面。

  2. 在仓库名称下,单击 “Settings”****。 如果看不到“设置”选项卡,请选择“”下拉菜单,然后单击“设置”。

    存储库标头的屏幕截图,其中显示了选项卡。 “设置”选项卡以深橙色边框突出显示。

  3. 在边栏的“Security”部分中,单击“ Advanced Security”****。

  4. 在“Dependabot”部分,单击“Dependabot 规则”右侧的

  5. 在“存储库规则”下,在要编辑或删除的规则右侧,单击

  6. 要编辑规则,请对相应的字段进行任何更改,然后单击“保存规则”。

  7. 要删除规则,请单击“危险区域”下的“删除规则”。****

  8. 在“确定要删除此规则吗?” 对话框中,查看信息,然后单击“删除规则”。****

编辑或删除您的组织的自定义自动分类规则

可以编辑或删除 自定义自动分类规则 组织中所有符合条件的存储库。 有关详细信息,请参阅“配置组织的全局安全设置”。