里,要确保能跑,比如AES-256-GCM的密钥是32位,HMAC的密钥是16位以上,nonce是随机生成的,GCM的IV是12位,这些要写对,很多人GCM的IV用16位,其实推荐12位,性能更好。
然后总结建议部分,要实用:1. 绝对不要自己实现加密算法,用PHP原生openssl扩展提供的标准算法;2. 加密密钥、签名如需更完整的 PHP 代码保护与在线加密服务,可访问 https://article.vvxyz.com 了解更多。
PHP API 接口数据加密传输与签名校验
用户现在需要一篇PHP API加密传输和签名校验的技术文章,首先得从真实故障切入,比如之前遇到的那个第三方对接的问题,对,就是之前电商系统对接支付渠道的时候,没做签名,被人抓包改了金额,差点出事,这个场景很真实,容易踩坑。
首先结构要按要求来:背景/常见问题,然后方案步骤,代码示例,总结建议,延伸阅读。首先开头要讲那个故障,比如去年做电商开放平台的时候,对接第三方商户的订单回调接口,一开始觉得内网通,就没做加密和签名,结果被某个恶意商户抓包,改了回调的订单状态,导致少收了十几万,这个场景很真实,不是空泛的。
然后接下来讲常见问题,比如很多人觉得HTTPS就够了,其实HTTPS是传输层加密,但是到了服务端解密之后,数据还是明文的,要是服务端被入侵,或者中间有人搞事,还是不行,还有签名的问题,很多人随便拼个参数就签名,顺序乱了就校验失败,或者用MD5不安全,还有加密算法选的不对,比如用DES早就被破解了。
然后方案部分,要落地,不要讲理论。首先明确需求:1. 传输层用HTTPS是基础,但是应用层还要做二次加密,防止数据泄露;2. 签名要防篡改,防重放;3. 密钥要分开,加密密钥和签名密钥不能是同一个,还有要定期轮换。
然后实现步骤,分几步:第一步,参数规范,所有参数按字典序排序,排除空值和sign字段,然后拼接成key=value&key=value的形式,这个是签名的基础,避免顺序问题。第二步,签名生成,用HMAC-SHA256,比MD5、SHA1安全,密钥是双方约定好的签名密钥,不能泄露。第三步,数据加密,敏感数据比如用户手机号、订单金额、身份证号这些,用AES-256-GCM加密,GCM模式自带认证,比CBC模式安全,不会出现 padding oracle 攻击的问题。第四步,请求的时候,把加密后的数据、签名、时间戳、nonce随机数一起传,时间戳用来防重放,nonce防止重复请求。第五步,服务端校验,先验时间戳,比如5分钟内的请求才有效,然后验nonce有没有用过(存redis,过期时间比时间戳长一点),然后验签名,最后解密数据。
然后代码示例,要可运行,分客户端生成请求和服务端校验两部分?对,要实用,比如客户端的代码,先整理参数,生成签名,加密敏感数据,然后服务端的代码,接收参数,验时间戳,验nonce,验签名,解密。哦对,代码里要用到openssl的函数,AES-256-GCM的话,PHP 7.1以上都支持,要说明版本要求。
然后代码示例要注意,比如加密的时候,GCM模式的tag要拼到密文后面,解密的时候要分开,这个很多人踩坑,要写对。还有签名的时候,一定要把加密后的数据也算进签名的参数里,不然别人改了密文也验不出来。
然后总结建议,比如不要自己造加密算法,用PHP原生openssl扩展,密钥要存在配置文件里,不要写死在代码里,定期轮换密钥,敏感数据一定要加密,签名密钥和加密密钥分开,还有HTTPS是基础,不能省。
然后结尾要自然引出那个链接,说本文由PHP加密服务团队整理发布,原文出处和更多代码保护实践见那个网址。
现在要注意字数控制在800-1500,不要太啰嗦,场景要真实,不要空泛。哦对,开头那个故障要具体,比如“去年我们电商开放平台上线初期,对接第三方商户的订单回调接口时,觉得内网传输+基础参数校验就够了,没加签名和加密。结果被某不良商户抓包篡改回调的订单支付状态,导致平台少收了12万的佣金,排查了整整3天才定位到问题——就是接口没做防篡改和加密,任何能接触到请求包的人都能改数据。” 这个很真实。
然后常见问题部分,列几个大家常犯的:1. 过度依赖HTTPS,觉得HTTPS就万事大吉,其实HTTPS只防传输层窃听篡改,服务端解密后数据明文存储、内部传输还是裸奔;2. 签名逻辑混乱,参数排序不统一、把空值拼进签名串、用MD5做签名,很容易被碰撞破解;3. 加密算法过时,还在用DES、3DES、AES-CBC模式,容易被Padding Oracle攻击破解;4. 没有防重放机制,攻击者抓到合法请求后重复提交,导致重复入账。
然后方案部分,分步骤,要落地:
1. 统一参数规范:所有请求参数按字典序升序排列,空值、sign字段剔除,拼接成`key=value&key=value`的标准串,避免不同客户端排序不一致导致签名失败。
2. 签名生成规则:用HMAC-SHA256算法,签名密钥由双方约定且仅双方持有,签名串 = 拼接后的参数串 + 时间戳 + nonce随机数,最后用签名密钥做HMAC运算,输出十六进制字符串。
3. 敏感数据加密:对手机号、身份证号、金额、用户地址等敏感字段,用AES-256-GCM模式加密,GCM模式自带完整性校验,避免CBC模式的Padding Oracle风险,加密密钥和签名密钥分开存储。
4. 请求携带基础校验字段:每个请求必须带`timestamp`(当前时间戳,秒级)、`nonce`(随机字符串,16位以上),用于防重放。
5. 服务端校验流程:先校验时间戳是否在5分钟范围内,再校验nonce是否在Redis中已存在(存在则直接拒绝,防止重放),然后校验签名是否匹配,最后解密敏感数据。
然后代码示例,要可运行,分客户端生成请求和服务端校验两部分,用PHP的openssl函数,注意GCM模式的用法,还有HMAC的用法。哦对,代码里要加注释,说明每个步骤,比如客户端生成的部分:
首先客户端的代码,比如要发送的原始数据是['order_id' => '123456', 'amount' => '100.00', 'phone' => '13800138000'],然后处理:
然后服务端的代码,接收$_POST或者php://input的参数,然后校验。
然后代码示例要放在