EWP API互通下RSA-SHA256签名与多端校验结果不一致排查
EWP RSA-SHA256 签名双向不兼容问题排查方向
一、先排查核心RSA实现里的显性Bug
对照你给出的两段代码,先找能直接复现的问题:
- 签名和校验的逻辑边界错位
你当前的实现本身是自洽的:- 客户端用
SignData方法对签名字符串的UTF8字节签名,方法内部自动完成SHA256哈希计算、填充RSA-PKCS1 v1.5的DigestInfo结构、私钥加密生成签名 - 服务端把原始签名字符串转UTF8字节算SHA256哈希,再调用
VerifyHash校验,计算流程是完全匹配的
但需要确认代码迭代时有没有改错过:比如某次升级把客户端的SignData换成了直接对哈希值做SignHash,但服务端还是按原来的校验逻辑走,就会出现偶发的验签失败。
- 客户端用
- 公钥解析的格式问题
你现在硬拼PEM前后缀的公钥解析逻辑,藏了很多不报错的坑:- 从EWP注册表拉到的公钥字符串,有没有按标准PEM格式要求每64字符加一个
\n换行?如果拿到的是无换行的连续Base64串直接硬拼前后缀,BouncyCastle的PemReader不是在所有长度下都能正常解析,部分场景下会返回一个截断的、数值不对的公钥,不会抛明确异常,最终表现就是“密钥看起来对,验签就是过不了”。 - 拉取公钥时的编码错配:如果注册表返回的公钥是二进制DER格式,你误按UTF8解码成字符串再拼PEM头,遇到非ASCII字节会直接替换成乱码,公钥内容损坏。这种损坏不会触发解析错误,只会让公钥数值不对,刚好对应你说的“部分合作方公钥能验过、部分不行”的现象。
- 有没有把公钥字符串前后的引号、首尾空白一起拼进PEM内容?这些冗余字符会直接让解析出的公钥和实际公钥不一致。
你之前怀疑的字符编码问题,就是这类场景里最高发的原因。
- 从EWP注册表拉到的公钥字符串,有没有按标准PEM格式要求每64字符加一个
二、双向不兼容的核心诱因
你遇到的「2个接口只认官方校验器、3个接口(含自己写的API)只认你的客户端」的奇怪现象,和RSA算法本身完全没关系,本质是双方对签名字符串的拼接规则理解不一致,最容易踩的坑有三个:
- 头域排序规则的版本差异
EWP用的HTTP签名规范在过去两年经历过版本迭代:- 旧版要求按头域在请求中的实际出现顺序拼接签名字符串
- 新版要求按头域名称的字典序排序后再拼接
现在的问题状态大概率是: - 2个只认官方校验器的合作方已经升级到了新的排序规则,你的客户端还是按旧顺序拼接,两边拼出来的字符串顺序不一样,哪怕所有头的键值完全相同,签名也不可能匹配;而官方校验器是严格按新规则排序的,所以能正常通过
- 3个只认你的客户端的合作方(包括你自己的服务端)还在用旧的排序规则——两周前官方校验器没改规则的时候两边是匹配的,刚好赶上官方换了新的排序逻辑,你的服务端没同步更新,自然就通不过。
- 换行符的隐形差异
规范要求所有参与签名的头行必须用\n(LF)做分隔,且最后一行不能带末尾换行。实际开发里常犯的错是某一端用了\r\n(CRLF)做分隔:
这种差异不会让代码报错,只会让拼出来的字符串多/少几个不可见的回车符,最终导致签名不匹配。排查日志的时候如果不对字符串做逐字节对比,很容易误以为两边的内容完全一致。 - 头域取值的隐形差异
- Host头要不要带端口:规范要求取请求的原始值,如果你拼的时候自动把端口剥掉了,而服务端是从反向代理拿到带端口的Host值,两边取值不一致就会验签失败
- Date头的格式:RFC规范要求的GMT时间是固定格式,不带毫秒、用固定缩写的月份,如果你拼的时候用了本地时区、带毫秒的时间字符串,而服务端从请求头拿到的是被反向代理自动修正后的标准格式值,两边字符串就对不上
- Digest头的大小写:请求体的SHA256哈希转Base64后,如果你拼的时候用了小写,服务端拿到的是大写的Base64值,哪怕哈希内容完全正确,字符串不一致也会验签失败
三、官方换密钥后突然不通的排查点
官方说只换了密钥对、你存的公钥是正确的,这里有个很容易被忽略的问题:
- 本地公钥缓存过期:你是不是从两周前开始就把拉到的公钥存在本地,没有每次请求前从注册表刷新?如果官方换了新密钥后,你本地缓存的还是旧公钥,用旧公钥校验新私钥签的内容肯定过不了。这种情况下你把日志发给对方,对方可能只核对了keyId是不是对应正确的公钥版本,没发现你本地存的是旧缓存,就会误以为你用的公钥是对的。
- 新密钥的长度不兼容:如果官方换的新密钥是1024位的RSA,而你的RSA实现是按2048位密钥的逻辑写的,导入密钥时参数不全,就会出现校验失败的情况。
内容的提问来源于stack exchange,提问作者Joep Demey
相关产品推荐
相关产品推荐

