接口签名校验是保障java后端api安全的核心手段，客户端按规则生成hmac-sha256签名并放入请求头，服务端用相同逻辑重算比对；需校验timestamp时效性、nonce去重、url解码参数，并通过interceptor统一拦截处理，防时序攻击与信息泄露。
接口签名校验是保障Java后端API安全的核心手段之一，关键在于服务端能可靠验证请求是否来自合法客户端、内容未被篡改。核心思路是：客户端按约定规则生成签名，服务端用相同规则重新计算并比对。
签名生成与校验的基本流程
典型流程包括：客户端收集必要参数（如timestamp、nonce、appKey、业务参数等）→ 按字典序排序 → 拼接成规范字符串 → 使用密钥（如appSecret）进行HMAC-SHA256等算法加密 → 生成base64编码的签名 → 将签名放入请求头（如X-Signature）或参数中。服务端收到请求后，执行完全相同的步骤，比对结果是否一致。
注意点：
- 必须排除签名字段本身参与计算，否则无法验证
- timestamp需校验时效性（如5分钟内有效），防止重放攻击
- nonce（随机字符串）需服务端缓存短期去重，避免同一请求重复提交
- 所有参数值应做URL解码后再参与签名，避免编码差异导致验签失败
Spring Boot中拦截验签的实用实现
推荐使用Spring的HandlerInterceptor或Filter统一处理验签逻辑，避免在每个Controller里重复写。
立即学习“Java免费学习笔记（深入）”；
关键步骤：
- 提取请求头中的X-Timestamp、X-Nonce、X-AppKey、X-Signature
- 根据appKey查出对应appSecret（可从DB、Redis或本地缓存获取）
- 组装待签名字符串：将除X-Signature外的所有参与字段（含查询参数、JSON body中的非文件字段）按key升序拼接，格式为red">key1=value1&key2=value2&...
- 对拼接串执行
HmacUtils.hmacSha256(appSecret, signString).getBytes()，再base64编码 - 对比客户端签名与计算签名（建议用MessageDigest.isEqual防时序攻击）
常见坑与加固建议
实际落地中容易忽略细节导致验签失效或被绕过：
- GET请求参数和POST JSON体中的字段要统一纳入签名范围，不能只签URL参数
- JSON body需标准化：去除空格、统一字段顺序（建议用Jackson的ObjectMapper写为字符串，或按key排序后序列化）
- 敏感接口建议启用HTTPS，否则签名和密钥可能被中间人截获
- 验签失败应返回401且不透露具体原因（如不区分“签名错误”和“时间超时”），防止信息泄露
- appSecret绝不硬编码在客户端或前端代码中，仅后端可信环境持有
可扩展的签名策略设计
随着业务增长，可考虑分层签名策略：
- 基础层：所有接口强制timestamp+nonce+sign
- 敏感层（如支付、用户资料）：额外要求双向SSL证书或设备指纹绑定
- 灰度层：支持多版本签名算法（如v1用MD5，v2升级为HMAC-SHA256），通过请求头X-Sign-Version协商
- 审计层：记录每次验签日志（脱敏后的appKey、耗时、成功/失败），便于安全分析
