不能只校验 timestamp 和 signature，因为攻击者可截获合法请求并在时间窗口内重放；必须将随机 nonce 纳入签名原文并用 Redis 原子去重，同时严格校验 timestamp 偏差（≤300 秒）、标准化 header 拼接顺序，并在 c.Next() 前完成全部校验并 abort。
签名认证为什么不能只校验 timestamp 和 signature？
因为单纯比对 timestamp 和 signature 会导致重放攻击——攻击者截获一次合法请求，稍作延时重发，只要还在时间窗口内，服务端就会放行。必须把「不可预测的随机值」和「严格递增或一次性使用的请求标识」纳入签名原文，否则签名机制形同虚设。
实际做法是：在请求头中强制携带 X-Request-ID（服务端生成并返回给客户端缓存）或 X-Nonce（客户端生成、服务端需去重缓存），同时要求 timestamp 精确到秒且与服务端时间偏差 ≤ 300 秒。签名原文应为：method:uri:body:timestamp:nonce（GET 请求 body 为空字符串）。
-
nonce必须用 Redis 的SET key value EX 300 NX去重，失败即拒收 - 不要用
time.Now().Unix()直接比对，先转成 UTC 时间再计算偏差 - 签名密钥不能硬编码，建议从环境变量读取，并用
crypto/hmac计算 SHA256
Gin 中间件如何安全提取并验证签名参数？
别在 c.Request.URL.Query() 或 c.PostForm() 里拼签名原文——它们会自动解码 URL 编码，导致签名原文和客户端不一致。必须用 c.Request.URL.RawQuery（查询参数）和 c.Request.Body 原始字节（POST/PUT）参与签名计算。
实操要点：
立即学习“go语言免费学习笔记（深入）”；
- 用
c.Request.Header.Get("X-Signature")取签名值，c.Request.Header.Get("X-Timestamp")取时间戳 - 用
ioutil.ReadAll(c.Request.Body)读一次 body 后，用io.NopCloser(bytes.NewReader(bodyBytes))重置 Body，否则后续 handler 读不到数据 - 对 GET 请求，签名原文中的 body 固定为空字符串；对其他方法，必须使用原始未解码的 body 字节
- 验证失败统一返回
401 Unauthorized，且不透露具体失败原因（比如不区分 nonce 失效还是签名错）
怎么避免 HMAC 密钥泄露和签名被篡改？
密钥一旦写死在代码里或配置文件中，容器镜像一发布就等于密钥公开。更危险的是，如果签名只覆盖部分参数（比如漏掉 Content-Type 或忽略 header 大小写），中间人可篡改 header 绕过校验。
安全边界必须拉满：
- 密钥通过
os.Getenv("API_SECRET_KEY")读取，启动时检查是否为空，为空 panic - 签名原文必须包含标准化的 header 子集：
X-Timestamp、X-Nonce、Content-Type（小写归一化），且按字母序拼接 - 禁止客户端传
X-Signature到后端服务，网关验证通过后应清除该 header 再转发 - 所有敏感 header（如
Authorization）必须在签名验证前被剥离或显式拒绝
为什么 Gin 的 c.Next() 之后不能再写 response？
因为签名中间件必须在路由匹配前完成校验——如果放到 c.Next() 后面，意味着请求已经进到业务 handler，可能已修改状态、触发 DB 写入甚至发消息，此时再拒绝就晚了。正确位置是在 c.Next() 前做校验并直接 c.Abort()。
典型错误写法：
func badMiddleware() gin.HandlerFunc {
return func(c *gin.Context) {
c.Next() // ❌ 校验放这里，业务逻辑已执行
if !valid { c.AbortWithStatus(401) }
}
}
正确写法：
func validSignature() gin.HandlerFunc {
return func(c *gin.Context) {
if !verify(c) { // ✅ 全部校验逻辑在此完成
c.AbortWithStatusJSON(401, gin.H{"error": "unauthorized"})
return
}
c.Next() // 仅当校验通过才继续
}
}
签名验证是网关的第一道门，不是装饰器。它必须阻断非法请求于业务层之外，且不能依赖后续任何中间件的状态。
