您可以通过工作空间 webhook 将扫描事件发送到自己控制的服务。例如,扫描结束时可以更新安全仪表板,扫描结果发生变化时可以更新工单。每个目标都会接收整个 ChatGPT 工作空间中您为该目标选定的事件。
添加工作空间 webhook
-
在 Daybreak 中,前往设置 > 通知,然后选择添加。
-
输入名称和端点 URL。请使用可从公网访问的 HTTPS 端点,该端点必须能在 443 端口接收
POST请求。 -
选择要接收的事件。
- 扫描结束(
scan.finished)会在扫描完成、失败或取消时发送通知。 - 扫描已更新(
scan.updated)会在扫描结果后续发生变化时发送通知,例如验证结果或严重程度发生变化时。
- 扫描结束(
-
选择添加。复制签名密钥并妥善保管。Daybreak 只会显示一次完整密钥。
-
在目标的菜单中选择发送测试通知,然后选择发送测试。Daybreak 会发送一个带有
is_test: true的scan.finished示例事件。当端点返回2xx响应时,Daybreak 会显示投递成功。
验证并处理收到的事件
Daybreak 发送使用 HMAC-SHA256 签名的 JSON POST 请求。签名涵盖 webhook-id、webhook-timestamp 和原始请求体。在处理事件之前,请使用 webhook-signature 请求头验证请求。将请求体的原始字节传给验证程序,以免空白字符或 JSON 格式发生变化导致签名验证失败。有关详细信息,请参阅 Standard Webhooks 规范。有关各编程语言的验证库,请参阅 Standard Webhooks 参考实现。
在触发生产环境的工作流之前,请检查 is_test。可以使用事件载荷中的 id 识别重复投递,并根据 data.scan_id 将同一次扫描的事件归为一组。Daybreak 每次尝试投递时最多等待 10 秒,测试投递也遵循这一时限。服务接受事件后,请在该时限内返回 2xx 响应。如果处理耗时较长,请先将事件存入队列并返回响应,然后再处理事件。
管理目标并轮换密钥
在目标的菜单中选择编辑。您可以更改 URL、重新选择要接收的事件,或关闭启用开关以暂停投递。选择轮换密钥可更换签名密钥。复制新密钥,并更新接收端的配置。如果接收端需要时间切换密钥,请在轮换时选择让当前密钥继续生效 24 小时。在此期间,Daybreak 会同时使用新旧两个密钥签名,接收端使用任一密钥都可以验证收到的请求。如果选择立即轮换,请先更新接收端,再发送新的测试通知。