投递行为
取自该平台的官方文档,最近核对于 2026-08-06。平台没有给出数字的地方,这张表也不填。
| 响应时限 | 平台未公布 |
|---|---|
| 重试 | 平台未公布 |
| 放弃 | 平台未公布 |
签名
用一个经测试套件证明的可运行验证器核对,不是照着文档读来的。最近核对于 2026-08-20。
| 算法 | HMAC-SHA1 |
|---|---|
| 待签名串 | raw body |
| 编码 | hex |
| 请求头 | x-hub-signature = sha1=hex |
| 时间容差 | 无强制要求 |
验证签名
要用原始请求体,逐字节一致,并且在任何 JSON 解析之前。框架一旦重新序列化请求体,本页的每一种方案都会失效。
const crypto = require("node:crypto");
// x-hub-signature: "sha1=" + hex(HMAC-SHA1(client secret, raw body))
const expected =
"sha1=" +
crypto.createHmac("sha1", clientSecret).update(rawBody).digest("hex");
const received = Buffer.from(req.headers["x-hub-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);容易踩的坑
请求头是 x-hub-signature,也就是最初的 SHA-1 版本,而不是 GitHub 的 x-hub-signature-256。按前缀自动识别的代码必须核对完整的请求头名称,否则就会用错误的算法和错误的编码去验证。
延伸阅读
AnyHook 挡在接收 Intercom Webhook 的端点前面:约 1 秒应答,你的服务器宕机时按自己的计划重试,并且每个事件都可以重放。 只改一个 URL,代码不用动。