Web & 认证

Webhook 签名校验器

在浏览器本地验证 GitHub、Stripe、Slack 和自定义 API 集成中的 SHA-256 HMAC webhook 签名。

免费使用 无需注册 浏览器本地运行

工具操作区

用共享密钥校验 webhook 的 HMAC 签名。

什么是Webhook 签名校验器?

Webhook 签名验证器用于将接收到的第三方回调请求签名与根据原始请求体(Raw Body)和共享密钥(Secret)计算出的 HMAC 摘要进行比对。在排查 GitHub、Stripe、Slack 或自建 Webhook 接口验签失败问题时,无需临时编写脚本,即可快速验证是否是请求体被网关格式化、密钥配置错误或签名前缀格式不匹配所致。

如何使用Webhook 签名校验器

  1. 1粘贴 webhook 的原始请求体与收到的签名值,并在密钥框中填入服务方提供的共享密钥。
  2. 2确认使用的签名方案与来源平台的请求头格式一致。
  3. 3对比计算出的摘要与收到的签名,再决定是否调整接入代码或轮换密钥。

Webhook 签名校验器的常见使用场景

本地复现与排查 Webhook 验签失败

当 Stripe、GitHub、Slack 或自建服务的 Webhook 请求在测试环境被拒收时,粘贴抓到的原始请求体与签名头,验证 HMAC 摘要是否匹配。

对接新第三方事件通知前的联调验证

在将签名校验中间件写入生产代码前,先用供应商文档提供的示例 Payload、Signing Secret 和 Header 验证算法与前缀格式。

定位网关或框架改写 Body 导致的摘要不符

对比原始 JSON 字符串与经过框架重新序列化后的字符串算出的签名差异,快速确认是否因空格/字段顺序变动导致验签失败。

常见问题

验证 Webhook 签名必须准备哪三项输入?

需要提供未做任何格式化修改的原始请求体(Raw Request Body)、请求头中携带的签名字符串(Signature Header)以及双方约定的共享签名密钥(Webhook Secret)。

为什么把 JSON 请求体美化缩进后再算签名就匹配不上了?

HMAC 签名是对请求体的原始字节流逐字节计算的,哪怕多一个空格、换行符或调整了键顺序,算出的哈希摘要都会完全不同;验签时务必使用原始 Raw Body。