验证 Webhook 签名
根据 X-CalcLib-Signature 请求头构造字符串 t.body,用你的密钥计算 HMAC-SHA256,并在处理该推送之前先进行比对。
在 Webhooks 中添加的 webhook 端点,会在每次有人运行你的嵌入计算器时收到一个已签名的 POST 请求。每次推送都带有 X-CalcLib-Signature 请求头,格式为 t=<unix time>,v1=<signature>。
先验证,再解析
- 读取原始请求正文。如果先解析再重新序列化 JSON,字节会发生变化,签名就永远无法匹配。
- 从请求头中取出
t,并构造字符串t.body:时间戳、一个点,然后是原始正文。 - 用你的端点密钥对该字符串计算 HMAC-SHA256,结果为十六进制。
- 以恒定时间方式将它与每个
v1值进行比对。在轮换密钥期间,请求头中可能带有两个v1值,任何一个匹配即可。 - 如果
t与你的系统时钟相差超过 5 分钟,请拒绝该推送。
推送失败时
系统会在 1 分钟、5 分钟、30 分钟、2 小时和 8 小时后重试。如果某个端点连续失败 20 次,就会被停用,并且我们会给你发邮件,邮件受通知中的产品开关控制。