CQ9游戏 API 接口安全防护：MD5/HMAC 签名、时间戳校验与 IP 白名单
在在线游戏与包网平台系统的日常运营中，API 接口作为平台与游戏厂商进行数据交互的核心桥梁，往往面临着严峻的安全考验。诸如恶意篡改请求参数、重放攻击（Replay Attack）以及非法 IP 探测等威胁，随时可能导致平台资金受损、注单紊乱。
为了彻底保障系统资金安全与业务连续性，针对 NG包网 等架构体系，必须在 API 接口设计与部署中落实多维度的安全防护策略。
一、 数字签名机制（Sign）：防篡改的核心防线
在 API 调用过程中，任何明文传输的参数都存在被中间人截获并篡改的风险。为了确保请求在传输过程中的完整性与真实性，数字签名机制（Sign）必不可少。
- 参数排序与拼接： 请求发送方需要将所有参与签名的参数（通常排除
sign字段本身）按照参数名字母的 ASCII 码从小到大进行排序（Key-Value 键值对形式），并用&符号进行拼接。 - 引入密钥与加密算法： 在拼接好的字符串尾部直接或间接拼接平台与厂商约定的私密密钥（
SecretKey），随后采用 MD5 或 HMAC-SHA256 算法计算出最终的哈希值作为sign。 - 服务端校验： 接收方收到请求后，使用相同的规则对除
sign之外的参数进行本地计算，并将计算结果与请求中携带的sign进行比对。只有完全一致，请求才被认为是合法且未被篡改的。
二、 时间戳与防重放攻击（Anti-Replay）
即使攻击者无法篡改签名，如果截获了合法的请求报文，通过无限次重复发送相同的请求（例如重复扣款或加彩），依然会对平台造成毁灭性打击。因此，必须引入时间戳与随机数（Nonce）双重校验。
- Timestamp 校验： 要求所有 API 请求头（Header）中必须携带毫秒级或秒级的时间戳。服务端在收到请求时，会获取当前服务器时间进行对比，通常设定一个严格的时间窗口（如上下 5 分钟内）。超过该时间窗口的请求一律判定为过期失效。
- Nonce 随机数与 Redis 过滤： 结合请求中独一无二的随机字符串（
Nonce），服务端将其写入 Redis 缓存中，并设置与时间窗口相同的过期时间。如果 Redis 中已存在该Nonce，则直接判定为重复请求并予以拦截，从根源上杜绝了防重放攻击。
三、 网络边界防护：严格的 IP 白名单策略
除了应用层的加密与校验，网络层的边界访问控制同样是保障 API 安全的最后一道坚固防线。
- 对接官方 IP 白名单： 在服务器防火墙（如安全组、iptables、宝塔面板防火墙）及 Nginx/OpenResty 网关处，必须严格配置 CQ9 官方服务器的出口 IP 白名单策略。
- 拒绝未知来源： 仅放行授信的白名单 IP 访问 API 核心路由，任何非白名单来源的直接探测与恶意扫描请求将在网络边缘被直接阻断，大幅降低服务器暴露面。
