Sentry の Webhook 配信の仕組み

Sentry は生のリクエストボディに HMAC-SHA256 で署名し、署名対象にタイムスタンプを含めません。検証済みの署名形式と Node の検証コードを掲載しています。

配信の挙動

プロバイダーの公式ドキュメントから読み取っています(最終確認 2026-08-06)。プロバイダーが数値を示していない項目には、この表も数値を載せていません。

応答期限プロバイダーは未公表
リトライプロバイダーは未公表
打ち切りプロバイダーは未公表

署名

ドキュメントを読んだだけではなく、テストスイートで裏付けた動作する検証コードで確認しています。最終検証日は 2026-08-20 です。

アルゴリズムHMAC-SHA256
署名対象raw body, no timestamp
エンコードhex
ヘッダーsentry-hook-signature
許容範囲適用なし

検証する

JSON としてパースする前の生のリクエストボディを、バイト単位でそのまま使います。フレームワークがペイロードを再シリアライズした時点で、このページのどの方式も検証に失敗します。

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);

落とし穴

署名対象には期限切れになるものが何もありません。タイムスタンプがないため、傍受されたリクエストは 1 か月後でも、届いた当時と同じように検証を通ります。リプレイ攻撃で送り直されたリクエストが副作用を再実行するのを防げるのは、受信側の冪等性だけです。

あわせて読む

AnyHook は、Sentry から受信するエンドポイントの手前に入ります。約 1 秒で応答し、サーバーがダウンしていれば独自のスケジュールでリトライします。すべてのイベントは再送できる状態で保存されます。 変えるのは URL 1 つだけで、コードはそのままです。

仕組みを見る →