项目级作用域

​

Web3 Actions

trigger:
  type: alert
  alert: {}

​

Webhooks

​

Webhook 的要求：

• 它 必须 可通过 webhook URL 访问：添加 webhook 时，Tenderly 会发送一个 GET 请求来验证可达性。任何 HTTP 响应都能通过验证；只有传输层错误（DNS、TCP、TLS 或 2 秒内无响应）才会导致验证失败。
• 它 必须 在同一 webhook URI 上公开一个 POST 方法。webhook 将收到下文描述的负载。
• 除非 webhook 在 10 秒 内以 2xx 状态响应，否则该次投递视为失败。
• 强烈建议 webhook URL 使用 HTTPS。

• Success: 表示 webhook 已成功执行，并将事件投递到指定的 URL
• Failed: 表示由于错误（例如连接问题、URL 问题或其他原因）导致 webhook 无法执行（请检查响应内容以了解错误原因，或联系我们的支持）
• Pending: 表示 webhook 正在执行中，尚未完成
• Retry: 表示 webhook 执行失败并将被重试；每个事件总共最多尝试 5 次 投递，之后状态定格为 Success 或 Failed
• Skipped: 表示 webhook 未被执行，因为它已被禁用

​

Webhook 负载

• id：String, 所有已投递告警事件中唯一的 ID（UUID）。
• event_type：TEST | ALERT, webhook 事件类型。
• alert_id：String, 其规则触发了此事件的告警 ID。TEST 事件时为空。
• transaction：Object, 表示触发告警和 webhook 执行的未解码事务对象。

​

保护 Webhook

1. 完整的 webhook 请求负载；
2. 时间戳（来自请求的 Date 头部）。

func isValidSignature(
  signature string,
  payload []byte,
  timestamp string,
) bool {
  h := hmac.New(sha256.New, []byte(signingKey))
  h.Write(payload)
  h.Write([]byte(timestamp))
  digest := hex.EncodeToString(h.Sum(nil))
  return digest == signature
}

function isValidSignature(signature, payload, timestamp) {
  // Create a HMAC SHA256 hash using the signing key
  const hmac = crypto.createHmac("sha256", signingKey);

  // Update the hash with the request body using utf8
  hmac.update(payload.toString(), 'utf8');

  // Update the hash with the request timestamp
  hmac.update(timestamp);
  const digest = hmac.digest("hex");
  return crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(digest))
}

def isValidSignature(signature: string, payload: bytes, timestamp: string):
    h = hmac.new(str.encode(signingKey), payload, hashlib.sha256)
    h.update(str.encode(timestamp))
    digest = h.hexdigest()
    return hmac.compare_digest(signature, digest)

​

调试 Webhook 执行