ThinkPHP接口安全防护教程 使用sign签名与MD5加盐防止数据篡改

签名验证这事儿，很多开发者容易陷入一个误区：以为只要给参数做个MD5加盐就万事大吉了。其实，真正的安全防线，远不止一个哈希算法那么简单。核心在于构建一个从请求入口就开始的、环环相扣的验证闭环，而不仅仅是“加不加盐”的问题。

这个闭环的关键，在于四个要素的紧密配合：时间戳、随机串、参数归一化，以及原始数据的字节级拼接。缺了任何一环，都可能给攻击者留下可乘之机。

签名必须在中间件统一校验

把签名验证逻辑写在控制器里，就好比把门锁装在卧室——等请求走到这一步，它早就已经“登堂入室”了。恶意参数可能已经触发了数据库写入、信息发送甚至库存扣减等业务操作，为时已晚。

ThinkPHP 6+ 框架提供了清晰的中间件机制，特别是 beforeAction 钩子，非常适合用来做统一的请求拦截。所有携带 sign 参数的请求，都应该在这里被精准地“卡”住。

• 中间件路径：建议放在 app/middleware/SignCheckMiddleware.php。
• 注册位置：在 app/middleware.php 中全局启用，或者针对特定路由组启用。
• 失败响应：一旦验签失败，必须立即终止请求流，返回统一的错误信息，例如：return json(['code'=>401,'msg'=>'Unauthorized'])->send(); exit;。

原始数据必须字节级一致，别用 param() 取参

这是最容易踩坑的地方。客户端严格按照UTF-8编码拼接出待签名字符串，但如果服务端图省事，直接用 $this->request->param() 获取参数，麻烦就来了。这个方法内部会自动进行 trim、urldecode、类型转换等处理，比如把空格变成 + 号，这会导致两端拼接出的原始字符串在字节层面不一致，签名自然对不上。

正确的做法是分情况处理：

• 表单请求（application/x-www-form-urlencoded）：分别用 $this->request->get() 和 $this->request->post() 获取原始GET和POST参数，合并后使用 ksort() 排序。
• JSON请求（application/json）：先判断请求头，然后用 $this->request->getContent() 读取原始请求体，json_decode($raw, true) 解析后再排序。
• 统一处理：所有参数值建议统一做一次 trim() 和 mb_convert_encoding($val, 'UTF-8', 'UTF-8') 来强制编码，确保编码一致。
• 排除字段：像 sign、signature、sign_type 这类签名相关的参数，必须在拼接签名原文前就从参数数组中移除（unset）。

签名原文拼接规则不能松动

MD5加盐只是最后一步，前面拼接的“原文”才是签名的灵魂。这个原文必须包含动态因子、业务参数和私钥，并且顺序固定、不可预测。

• 必含三要素：当前时间戳（timestamp，精确到秒）、一个16位的随机字符串（nonce）、以及服务端独有的密钥（secret）。
• 业务参数处理：将所有非排除字段的键（key）按字典序升序排列，然后使用 http_build_query($params, '', '&', PHP_QUERY_RFC3986) 进行标准化拼接，这样可以确保空格等特殊字符被正确编码。
• 完整签名原文：格式通常为 拼接后的业务参数 & timestamp=xxx & nonce=yyy，最后再追加上密钥 secret。
• 哈希计算：推荐使用 strtoupper(md5($raw_string . $secret))。注意，客户端和服务端对签名结果的大小写约定必须严格一致。

防重放和防暴力的关键配套措施

如果只校验签名本身，那这套机制依然很脆弱。没有配套的防御措施，攻击者完全可以截获一个合法的请求包，反复重放。因此，时间窗口、随机串去重和请求限流这三道屏障必不可少。

• timestamp 校验：只接受服务器当前时间前后300秒（可配置）内的请求，超时的直接拒绝，防止请求被延迟重放。
• nonce 去重：将每次请求的随机串存入Redis，键名可设计为 "nonce:{$app_id}:{$nonce}"，并设置300秒的TTL。如果发现同一个随机串在有效期内再次出现，则判定为重放攻击。
• 请求限流：针对同一个 app_id 或IP地址，如果在短时间内（如10分钟）连续出现5次验签失败，则触发限流机制，暂时阻止其后续请求。
• 错误提示：验签失败时，永远返回统一的、模糊的错误信息，如 {"code":401,"msg":"Unauthorized"}，不要暴露是时间戳不对、签名错误还是随机串重复等具体原因，避免给攻击者提供调试信息。
• 日志脱敏：记录请求日志时，务必过滤掉 password、token、id_card 等敏感字段，防止敏感信息泄露。