• 覆盖 228 个目的地
  • 始终无需 KYC
  • 支持 Bitcoin、Monero、USDT 等 7 种币种

API 与集成

HMAC 签名(Webhook)

HMAC 签名是使用与端点共享的密钥,对 Webhook 时间戳和正文计算的带密钥哈希(HMAC-SHA256),用于验证事件来自网关且未被篡改。

任何得知你的 Webhook URL 的人都能向它发送请求,因此要靠签名来区分网关发出的事件和伪造的请求。HMAC 由 RFC 2104 定义,它把密钥与哈希函数(这里是 SHA-256)结合起来,生成只有持有该密钥的人才能计算出的认证码。网关用端点的密钥为每个事件签名;你的处理程序对相同的字节重新计算认证码,只有两者一致时才接受该事件。签名证明的是来源和完整性,但它并不隐藏内容;那是 HTTPS 的职责。

有两个细节让这一方案十分稳健。其一,被签名的字符串包含时间戳、分隔符和原始正文,因此截获的请求无法在之后被重放:时间戳会对照允许误差进行检查,而修改时间戳又会破坏签名。其二,比较以恒定时间进行,这样响应耗时就不会泄露有多少个字符相匹配。

示例

假设攻击者截获了一个真实的 message.failed 事件,一小时后把其中的状态改为 delivered 再重新发送。被篡改的正文与签名不再匹配。如果原样重发,它携带的是一小时前的时间戳,超出允许误差,无法通过检查。无论哪种情况,处理程序都会拒绝它。

常见错误

  • 验证重新序列化后的正文:解析再重新编码 JSON 会改变空白字符和键的顺序,导致认证码永远对不上。应先验证,再解析。
  • 使用 API 密钥,而不是端点的签名密钥。
  • 用普通的字符串相等判断进行比较。
  • 在密钥轮换期间拒绝事件;在新旧密钥的重叠期结束之前,应同时用两个密钥进行检查。

在 SMSMeteor:X-Meteor-Signature 的格式为 t=…,v1=…,其中 v1 是以端点密钥为键、对时间戳、一个点号和原始正文计算出的十六进制 HMAC-SHA256;X-Meteor-Timestamp 以 Unix 秒数携带时间戳。五分钟是合理的允许误差。密钥可在控制面板中轮换,新旧密钥在 24 小时内同时有效。重放的事件会获得新的时间戳和签名;测试密钥触发的 Webhook 与正式密钥一样签名。详情见 Webhook 文档和安全页面。

深入了解

在实践中了解这个术语。一个电子邮箱地址即可开户,费率公开,支持加密货币付款,测试密钥免费。
开始发送