密码学与证书 / 技术文章

HMAC 接口签名为什么还要防重放

支付回调、开放 API 做完 HMAC 验签,并不代表请求就可以直接执行。攻击者不需要知道密钥,只要截获一条完全合法的请求并原样再次发送,就可能造成重复扣款、退款或发货。

HMAC 证明的是“消息和共享秘密匹配”

HMAC 使用发送方与接收方共享的 secret。双方对同一份规范化消息计算认证码,结果一致时,可以确认消息内容没有被改,并且请求来自掌握该 secret 的一方。

一个常见待签名结构可以包含:

text
POST
/api/refund
<TIMESTAMP>
<REQUEST_ID>
<BODY_SHA256>

真正协议应固定字段顺序、字符集、换行和编码规则,不能让两端临时各自拼接。

应对实际接收到的原始 Body 字节计算摘要,再按固定规则构造签名串。JSON 反序列化后重新序列化,可能改变键顺序、空格或数字表示,导致两端得到不同签名。path 是否包含查询参数、如何编码查询参数,也必须明确;未纳入签名的业务参数仍可能被修改。

合法签名也可以被重放

攻击者只需要截获:

text
request + timestamp + requestId + HMAC

然后在有效窗口里原样再发一次。如果服务器逻辑只有“验签成功就执行业务”,第二次仍然可能通过。

合法 HMAC 请求被截获并重放,以及服务器的防重放检查

timestamp 只能限制重放时间

服务端可以规定请求只在一个很短的时间窗内有效。这样攻击者不能把今天抓到的请求留到几天后继续使用。

但时间窗不能阻止窗口内部的重复发送,所以还需要唯一请求标识。

例如协议约定服务端时间与签名 timestamp 的差值最多为 300 秒,必须同时拒绝过旧和过于超前的请求,并统一秒或毫秒单位。去重记录的保留期要覆盖请求剩余的可接受时间:如果允许前后各 300 秒,某个超前 300 秒的合法请求第一次到达后,最坏还可以被接受 600 秒。部署方还需要考虑时钟偏差及边界余量,并监控服务器时间同步。

requestId 或 nonce 要做原子去重

如果业务已有稳定唯一的 requestId,它通常比额外随机 nonce 更有业务价值。服务端可以在验签后原子占位。

先验签,再写去重缓存,防止未认证请求随意占用合法 requestId。缓存键应至少包含调用方身份,例如 replay:merchant-42:R202600001;否则两个商户各自生成相同 ID,会互相误伤。比较认证码应使用密码库提供的常量时间比较接口,避免自写逐字符比较。

Redis 命令语义示例:

text
SET replay:R202600001 1 NX EX 600

预期结果:

text
第一次执行:OK
相同 key 再次执行:nil

不同 Redis 客户端对空返回的表示可能不同,但核心语义是:只有第一次占位成功。

NX 与 EX 在同一条命令里完成“仅当不存在时写入”和“设置过期时间”,避免进程在 SETNX 与后续 EXPIRE 之间退出,留下永不过期的键。示例的 600 秒只有在覆盖协议的整个可接受窗口时才合适;实际配置应按前面的时间策略确定,并留出边界余量。命令语义见 Redis SET 文档。

HMAC 还要绑定请求上下文

如果只签 Body,同一份 Body 可能被搬到别的路径复用。更稳妥的签名输入通常会绑定:

  • HTTP method;
  • path;
  • timestamp;
  • requestId 或 nonce;
  • body hash;
  • 调用方身份。

这样 /pay 的签名不能直接复制到 /refund。

防重放最终还要靠业务幂等

密码层防止的是同一签名请求被再次利用,业务层还要防止同一个业务动作被多次执行。

例如网络重试可能产生不同 requestId,但同一订单仍然不能被重复扣款。真正安全的资金接口通常需要:

text
HMAC
+ 时间窗
+ 唯一请求标识
+ 原子去重
+ 业务状态机

因此“验签成功”应该理解为进入业务校验的前置条件,而不是最终放行条件。

还要处理“占位成功,但业务执行失败”的情况。单个 Redis 标记无法把缓存写入与数据库扣款变成同一事务:服务可能在两步之间崩溃,也可能在扣款成功后丢失响应。稳妥做法是在业务数据库中对订单或操作 ID 建立唯一约束,并保存执行状态和结果;客户端重试同一操作时返回已完成的结果或明确的处理中状态,不再次扣款。

验收至少覆盖三种请求:原样重放相同签名,应被防重放层拒绝;更换 requestId 并重新合法签名,但业务订单相同,应被业务幂等层拦下;两条完全并发的同一操作,最终只出现一次业务效果。Redis 故障时也要有明确策略:对资金操作应拒绝或依赖同等可靠的数据库保护,不能把“缓存没连上”当作允许跳过去重的理由。

目录与阅读设置

记录一个想法

HMAC 接口签名为什么还要防重放

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通