关于通知和 🔔 提醒

DefectDojo 通过多种方式让您随时掌握最新情况。系统可针对即将到来的测试活动、用户提及、SLA 到期以及软件中的其他事件发送通知。

本文概述了系统级和个人级两种层面的通知。

通知类型

DefectDojo 通过两种不同的方式处理通知:

  • 系统级通知会发送给所有用户。
  • 个人通知由各用户自行设置,会在系统级通知之外额外接收。

无论哪种情况,基于角色的访问控制规则都会生效,因此用户不会收到其无权访问的产品或产品类型(或其相关对象)的活动通知。

通知发送方式

DefectDojo 通知共有四种发送方式:

  • DefectDojo 可以发送**🔔 提醒**,以列表形式保存在 DefectDojo 界面中
  • DefectDojo 可以将通知发送到电子邮件地址
  • DefectDojo 可以将通知发送到 Slack的共享或个人频道
  • DefectDojo 还可以将通知发送到 Microsoft Teams 的共享频道

通知可以同时发送到多个目的地。

接收 Slack 和 Teams 通知需要您拥有可正常工作的集成。有关设置该集成的更多信息,请参阅我们的指南

应用内提醒

DefectDojo 的提醒系统可让您随时了解所有产品或系统活动。

提醒列表

提醒列表始终显示在 DefectDojo 右上角,以紧凑列表的形式展示通知。点击每条提醒都会直接带您进入 DefectDojo 中的相关页面。

您可以点击右上角的 🔔▼ 图标打开提醒列表:

image

如需查看所有通知及更多详细信息,可以点击查看所有提醒 > 按钮,打开提醒页面

您也可以在提醒列表中点击清除所有提醒 >

提醒页面

提醒页面保存了您在 DefectDojo 中的所有提醒及更多详细信息。在此页面上,您可以查看 DefectDojo 中每条提醒的描述,并在不再需要时将其从提醒队列中移除。

image

要从提醒页面中移除一条或多条提醒,请勾选其旁边的空复选框,然后点击页面右下角的移除所选按钮。

关于提醒的说明

  • 阅读某条提醒或打开提醒页面,都不会从铃铛图标旁的计数中移除任何提醒。这样您就可以方便地查看过去的提醒,将其用作提醒事项或个人活动日志。
  • 使用提醒菜单中的清除所有提醒 > 功能也会完全清空提醒页面,因此请谨慎使用此功能。
  • 移除一条提醒只会影响您自己的提醒列表,不会影响其他用户的提醒。
  • 移除一条提醒不会删除 DefectDojo 中的任何导入历史或活动日志。

缩小审核请求通知的范围(Pro)

如果向所有符合条件的审核者发起审核请求,该资产上所有符合条件的人都会收到通知。对于只负责您部分资产的审核者来说,这意味着大量邮件。

在 DefectDojo Pro 界面中,您可以缩小自己接收审核请求通知的范围。在您的通知设置页面的审核请求下:

  • 审核请求范围——全部(默认)会就您可见的所有内容通知您。已选择则将范围缩小到您所选的资产和资产类型。
  • 审核请求资产 / 审核请求资产类型——您希望收到通知的那部分资产范围。只要请求所涉及的资产或资产类型属于您所选范围之一,即视为匹配。

有两点需要明确:

  • 选择已选择但不选取任何内容,表示不通知任何内容,而不是通知全部。
  • 缩小范围只是抑制了通知,而不是抑制请求本身。您仍然是被请求的审核者,该请求仍会出现在您我的工作队列的等待我审核下——只是您不会收到相关消息提醒。这是有意为之的设计:队列是持久记录,通知只是提醒。

这种范围缩小的优先级也高于下文所述的系统级覆盖设置,因此即使 review_requested 被配置为优先于个人偏好,已将自己排除在范围之外的审核者仍不会收到通知。

范围缩小也可以通过通知端点的 API 进行设置,如果您需要一次性为多名审核者进行配置,这是更实用的方式。

工作分配通知(Pro)

当发现项被分配给您时,已分配工作通知会告诉您分配了多少项,并附有指向您“我的工作”队列的链接。

该通知是按人汇总的,而不是按发现项逐条发送:分配一百个发现项只会发送一条消息,而不是一百条。与审核请求一样,无论通知是否送达,分配情况都会显示在您的队列中。

开源版注意事项

特定覆盖设置

系统通知设置(scope: system)描述向超级管理员发送通知的方式。用户通知设置(scope: personal)描述向特定用户发送通知的方式。

但是,存在一种特定场景:用户决定禁用某些通知(以减少干扰),但系统设置会覆盖此行为。默认情况下,这些覆盖仅适用于 user_mentionedreview_requested

此设置的作用范围可自定义(参见环境变量 DD_NOTIFICATIONS_SYSTEM_LEVEL_TRUMP)。

有关此行为的更多信息,请参阅相关的拉取请求 #9699

Webhook(实验性)

DefectDojo 还支持 webhook,其触发事件与其他通知相同(可以在相同情况下收到通知)。有关设置的详细信息,请参阅相关页面