跳转到主要内容
Cert Spotter 是 SSLMate 的证书监控服务，它持续检查证书透明度（Certificate Transparency）日志。发现为您的监控域名签发、但您事先不知道的证书（未知证书）时，Cert Spotter 可以调用 Webhook。本集成把每张未知证书转成一条 Flashduty 告警。

在 Flashduty On-call

您可通过以下两种方式获取集成推送地址，任选其一即可。

使用专属集成

  1. 进入 Flashduty 控制台，选择 协作空间，打开一个协作空间
  2. 选择 配置 → 集成数据 → 专属集成，点击 新增集成
  3. 选择 Cert Spotter，点击 保存
  4. 打开生成的集成卡片，复制 推送地址

使用共享集成

  1. 进入 Flashduty 控制台，选择 集成中心 → 告警事件
  2. 选择 Cert Spotter，填写集成名称
  3. 配置默认路由并选择协作空间；创建后可在 路由 中增加更多规则
  4. 点击 保存，复制生成的 推送地址

在 Cert Spotter 中配置

Webhook 通知从 Cert Spotter 的 Startup 套餐开始提供，Hobbyist 套餐只能收邮件。
1

在 Cert Spotter 中添加 Webhook

操作路径：SSLMate › Cert Spotter › Settings › 通知设置填写后保存设置。Flashduty 通过地址中的 integration_key 识别集成，请像保管密钥一样保管推送地址。
2

在 Flashduty 中开启超时自动关闭

操作路径：Flashduty 控制台 › 协作空间（接收这些告警的空间）未知证书是一次性事件：证书被吊销、过期或被您确认后，Cert Spotter 不会再发送任何通知。请在接收这些告警的协作空间中开启 超时自动关闭：故障关闭时，关联的告警一并关闭。
3

验证

Cert Spotter 没有发送测试推送的按钮。可以为一个已在监控中的子域名签发一张新证书（例如用 Let’s Encrypt），证书进入 CT 日志后，Cert Spotter 会把它作为未知证书推送，Flashduty 中出现一条对应的告警。

推送内容

Cert Spotter 的证书到期提醒和安装问题只通过邮件、Slack 发送，不经过 Webhook，因此不会进入本集成。

Alert Key

Flashduty 使用证书签发记录的 ID（Webhook 中的 id）作为 Alert Key。网络问题可能让同一个请求重复送达，重复的请求带有相同的 id，会合并到同一条告警；不同的证书会产生不同的告警。 缺少 id 且 dns_name 也为空的推送会被拒绝（HTTP 400）；缺少 id 但带有 dns_name 的推送是 New Endpoint 事件，返回 200，不创建告警。

状态和告警等级

Cert Spotter 不提供严重程度，所有未知证书都以 Warning 等级触发。证书是否已被吊销记录在 revoked 标签中，不影响等级。

标签

告警标题为 Unknown certificate for <第一个域名>，覆盖多个域名时追加 (+N more)。域名优先取 endpoints 中的 dns_name，endpoints 为空时取 issuance.dns_names；两者都为空时标题为 Unknown certificate <id>。

常见问题

Cert Spotter 只通知未知证书。通过 Cert Spotter 授权接口 登记过的证书被视为已知证书，不会调用 Webhook。
Webhook 必须在 15 秒内返回 2xx，且不跟随重定向。失败时 Cert Spotter 不会自动重试，而是发邮件通知您，可按需请 SSLMate 重发。请确认推送地址完整、包含 integration_key。
Cert Spotter 没有恢复事件。请开启协作空间的超时自动关闭，或在 Flashduty 中手动关闭该告警。
更多字段含义请参阅 Cert Spotter Webhooks。