在 Flashduty On-call
您可通过以下两种方式获取集成推送地址,任选其一即可。使用专属集成
- 进入 Flashduty 控制台,选择 协作空间,打开一个协作空间
- 选择 配置 → 集成数据 → 专属集成,点击 新增集成
- 选择 SecurityScorecard,点击 保存
- 打开生成的集成卡片,复制 推送地址
使用共享集成
- 进入 Flashduty 控制台,选择 集成中心 → 告警事件
- 选择 SecurityScorecard,填写集成名称
- 配置默认路由并选择协作空间;创建后可在 路由 中增加更多规则
- 点击 保存,复制生成的 推送地址
在 SecurityScorecard 中配置
Rule Builder 需要 SecurityScorecard 付费套餐,每个用户最多创建 25 条规则。1
新建规则
操作路径:SecurityScorecard › Automation › Rule Builder › Create Rule(旧版界面:右上角头像 › My Settings › Rules)
2
添加 Send a web request 动作
操作路径:SecurityScorecard › Automation › Rule Builder › Create Rule
检查规则后点击 Save。SecurityScorecard 没有恢复通知,无需配置恢复项。保存后,规则每次触发都会向该地址发送一次 POST,请求体为包含
trigger、execution_id、scorecard_id、domain 的 JSON。3
在 SecurityScorecard 中触发一次事件并验证
操作路径:SecurityScorecard › Automation › Rule BuilderRule Builder 没有发送测试请求的按钮。SecurityScorecard 每天评估一次评分卡事件,规则在事件满足条件后运行。要立即验证,可以使用 SecurityScorecard API 的 Simulate Actions(请求中带上规则的
rule_id)模拟一次事件,确认 Flashduty 收到对应告警。模拟会产生一条真实告警,验证后请手动关闭。Alert Key
Flashduty 使用execution_id、scorecard_id 和 trigger.type 计算 Alert Key。SecurityScorecard 的 Rule Builder: Webhooks 说明,execution_id 是一次规则执行的唯一标识,请求失败重试时保持不变。因此同一次执行的重试会合并到同一条告警,不同的规则执行各自成为独立告警。
请求中缺少 execution_id 时,Flashduty 生成随机 Alert Key,每个请求都是一条新告警。缺少 trigger.type 时返回参数错误。
状态和告警等级
字段映射
请求中的
retries 和 webhooks(前序 Webhook 的响应)不写入告警。SecurityScorecard 将该请求体标注为 beta,问题和泄露详情的结构变化时,Flashduty 忽略无法解析的部分,仍然创建告警。
告警不会恢复
评分变化、新问题和数据泄露都是一次性事件,SecurityScorecard 不会发送恢复通知。请在接收该集成的协作空间中开启 超时自动关闭,建议 24 小时,并按团队处理安全评级事件的时效调整。排查问题
规则触发了但没有收到告警
规则触发了但没有收到告警
确认规则的动作是 Send a web request,URL 是完整的推送地址且以
https:// 开头。SecurityScorecard 每天评估一次事件,规则不会在评分卡变化的当下立即运行。只有分数变化超过规则设置的分值时才会触发,等于该分值不触发。收到 [Action Required] Failed Webhook Request 邮件
收到 [Action Required] Failed Webhook Request 邮件
SecurityScorecard 在网络错误或 5xx 响应时重试,36 小时后仍失败会给规则所有者发送该邮件。请检查推送地址是否完整、集成是否已被删除。
Flashduty 返回参数错误
Flashduty 返回参数错误
请求体必须是不超过 1 MiB 的 JSON,且
trigger.type 非空。推送地址中的 integration_key 必须属于一个 SecurityScorecard 集成。