必须包含时间戳和随机串；签名输入须含毫秒级timestamp与服务端可校验的nonce，服务端需校验时间偏移≤5分钟、nonce未重复使用且签名匹配，三者缺一不可。
签名生成必须包含时间戳和随机串
API网关的签名认证失效，往往不是算法写错了，而是漏掉了关键上下文。只对请求体或参数做哈希，攻击者截获后可无限重放。必须把 timestamp（当前毫秒时间戳）和 nonce（服务端可校验的唯一随机字符串）作为签名输入的一部分。
常见错误是把 nonce 存在客户端本地、用 UUID 生成后不传给服务端校验，或者时间戳精度用秒级导致 60 秒内可重放。正确做法是：
– 客户端生成 nonce（如 16 字节 base64 随机字符串），随请求发送
– 服务端记录该 nonce 并设置 5 分钟过期（Redis TTL）
– 时间戳用毫秒，服务端允许最多 ±300000ms 偏差（即 5 分钟窗口）
示例签名拼接逻辑（C++17）：
std::string sign_input = method + "\n" + path + "\n" + timestamp + "\n" + nonce + "\n" + body_hash;其中
body_hash 是请求体的 SHA256（空体则为 SHA256("")）
签名验证需严格校验时间偏移与 nonce 有效性
服务端收到请求后，不能只算一次 HMAC 就放行。必须按顺序执行三重检查：时间戳是否在有效窗口内、nonce 是否未被使用过、签名是否匹配。任一失败立即拒收，且不返回具体原因（避免信息泄露）。
立即学习“C++免费学习笔记（深入）”；
容易踩的坑：
– 直接用 std::chrono::system_clock::now() 和客户端时间比对，但没考虑 NTP 同步误差或客户端时钟漂移
– Redis 中用 SETNX 写 nonce 后忘记设 TTL，导致内存泄漏
– 对 GET 请求忽略 body_hash 计算，但实际某些网关会透传空 body，造成签名不一致
推荐验证流程：
– 解析 timestamp，转为 int64_t 毫秒值
– 检查 abs(now_ms - timestamp) <br>– Redis 执行 <code>SET nonce "used" EX 300 NX，返回 0 则拒绝（已存在）
– 最后才计算并比对 HMAC-SHA256(secret_key, sign_input)
C++中用 OpenSSL 实现 HMAC-SHA256 要避开 EVP 接口生命周期陷阱
很多 C++ 示例直接套用 OpenSSL 的 EVP 系列函数，但没释放上下文或复用 EVP_MD_CTX 导致内存异常或签名错乱。OpenSSL 1.1.1+ 要求每个签名操作必须独立初始化/清理，或显式重置上下文。
安全写法（RAII 包装可选，但至少保证成对）：
EVP_MD_CTX* ctx = EVP_MD_CTX_new();<br>EVP_DigestInit_ex(ctx, EVP_sha256(), nullptr);<br>EVP_DigestSignInit(ctx, nullptr, EVP_sha256(), nullptr, hmac_key);<br>EVP_DigestSignUpdate(ctx, sign_input.data(), sign_input.size());<br>size_t len = EVP_MD_size(EVP_sha256());<br>std::vector<uint8_t> sig(len);<br>EVP_DigestSignFinal(ctx, sig.data(), &len);<br>EVP_MD_CTX_free(ctx);漏掉
EVP_MD_CTX_free 会导致句柄泄漏；用 EVP_MD_CTX_reset 复用前必须确认 key 和 digest 类型未变。
防重放依赖存储层，别在内存里做 nonce 去重
单机内存（如 std::unordered_set<:string></:string>）存 nonce 看似快，但集群部署下完全失效——请求可能打到任意节点，重放检测形同虚设。必须用分布式存储，且操作要原子。
可行方案只有两个：
– Redis：用 SET key value EX 300 NX，返回 1 表示首次写入、允许通过；返回 0 表示重复，拒绝请求
– 数据库唯一索引：建表 api_nonce (nonce VARCHAR(32) UNIQUE, expire_at INT)，写入前先 DELETE FROM api_nonce WHERE expire_at ，再 <code>INSERT；但性能远低于 Redis，仅适合低频场景
注意点：
– Redis key 命名建议带业务前缀，如 gateway:nonce:{nonce}
– 不要用 GET+SET 两步操作判断 nonce，存在竞态条件
– 过期时间必须由 Redis 或 DB 控制，不能靠应用层定时清理
签名和防重放真正难的不是算法实现，是时间窗口、存储一致性、错误响应粒度这三者的耦合。哪怕 HMAC 写对了，只要 nonce 校验绕过或时间偏差放宽到 10 分钟，整个机制就退化成裸奔。
