Sentry 如何傳遞 Webhook

Sentry 用 HMAC-SHA256 對原始請求主體簽章,簽章內容不含時間戳記。附經驗證的格式與 Node 驗證程式。

傳遞行為

取自服務商自己的文件,最後檢查於 2026-08-06。服務商沒寫數字的地方,這張表也不填。

回應時限服務商未公開
重試服務商未公開
放棄服務商未公開

簽章

用一個經測試套件證明可運作的驗證程式核對過,不是照文件抄來的。最後驗證於 2026-08-20。

演算法HMAC-SHA256
簽章內容raw body, no timestamp
編碼hex
標頭sentry-hook-signature
容許時間差不強制

驗證簽章

要用原始請求主體(raw body),逐位元組原封不動,並在任何 JSON 解析之前取得。框架只要重新序列化 payload,這頁上的每一種機制就會立刻失效。

const crypto = require("node:crypto");

// hex(HMAC-SHA256(client secret, raw body)) — no timestamp anywhere
const expected = crypto
  .createHmac("sha256", clientSecret) // Settings → Developer Settings
  .update(rawBody)
  .digest("hex");
const received = Buffer.from(req.headers["sentry-hook-signature"] ?? "");
const wanted = Buffer.from(expected);
// timingSafeEqual throws on a length mismatch, so check that first.
const valid =
  received.length === wanted.length && crypto.timingSafeEqual(received, wanted);

容易踩的坑

簽章內容裡沒有任何會過期的東西:沒有時間戳記,代表一個被截取的請求,一個月後驗證起來跟當下一樣順利。你這邊的冪等性,是擋在被重放的截取請求和重複執行的副作用之間的唯一防線。

延伸閱讀

AnyHook 架在接收 Sentry Webhook 的端點前面:大約 1 秒就回應,伺服器當機時依自己的排程重試,並讓每個事件都能重播。 換一個網址,程式碼不用動。

運作方式 →