
Hello,我是小兔大白糖。 静态扫描一报:「PKCS#1 v1.5 签名弱,改用 RSA-PSS。」——听起来像改五个字母的 Sign API;真正贵的是双端同时换垫、盐与哈希对齐、旧客户端怎么过发布窗口。写成这篇,给要在客户端 / 服务端之间做应用层 RSA 签名填充迁移调研的初中级后端同学:业界工程心智模型,不是某 App 设备指纹工单。
说明:下文「模式 A/B/C」是切流分析框架,不是某厂 SLA。标准与库行为以公开文档为准;不编造「官方内部就是这样」。示例为教学脱敏示意。本文只管应用层 RSA 签名字节合同,不展开证书体系与 TLS 握手。
估计阅读时间:10 分钟
目录
为什么现在要关心
硬规则:签与验是一对合同;只改一端 → 全量验签失败。
扫描告警把「换填充」说得很轻,现场成本几乎都在合同边界外:
| 你以为在改 | 实际合同 |
|---|---|
| 「换一个 Sign 函数」 | 客户端库 + 服务端 Verify + 文档示例 + 测试向量 |
| 「更安全就完事」 | 扫描告警降级;业务层仍要防重放、绑定关键字段 |
| 「PSS 更随机所以更好测」 | 同明文多次签名不同——测试勿写死期望十六进制 |
四条可复述硬规则(删掉比喻后仍成立):
- 签与验一对合同:只改一端,旧签名字节对新验签路径无效。
- PSS 参数要对齐:哈希(如 SHA-256)与 salt length(盐长度)两端一致;库里的
nil/AUTO含义要核对该语言官方文档,不要假设「同名即同义」。 - 发布窗口要有兼容策略:短期双模式验签,或强制双端同步发版;「只改后端」不是策略。
- 迁移解决的是填充方案,不是密钥轮换本身:密钥对可以不变,但旧签名字节流与新填充不兼容。
方向性说明:签名场景下当代公开指南与扫描器更常推动 PSS;换垫不等于自动合规,对口标准与审计口径另核。salt length 的「常见默认 = 哈希输出长度」也须对照目标库文档,勿跨语言猜同名。
心智模型:锁芯与钥匙齿形
密钥对像锁与钥匙坯料;填充方案(v1.5 / PSS)像齿形标准——换齿形不必换锁芯,但旧齿打不开新锁。
| 概念 | 类比 | 工程含义 |
|---|---|---|
| RSA 密钥对 | 锁芯与钥匙坯料 | 可不变;轮换是另一项工作 |
| PKCS#1 v1.5 / RSA-PSS | 齿形标准 | 决定签名字节怎么「垫」再模幂 |
| 客户端 Sign + 服务端 Verify | 配对的钥匙与锁 | 必须同一齿形标准 |
| salt / 哈希参数 | 齿距与齿数约定 | 一端 AUTO、一端写死却未核对 → 间歇性全挂 |
类比局限:解释不了证书体系、TLS 握手、证书透明度;只管「应用层 RSA 签名字节」。门锁类比也解释不了业务防重放——那是协议字段与时效,不是填充方案的职责。
问题空间:你以为在改什么
扫描降风险 ≠ 业务防伪完备;换 PSS 只换填充合同。
PKCS#1 v1.5(常写作 PKCS1v15)与 RSA-PSS(Probabilistic Signature Scheme,概率签名方案)都是 RSA 上的填充 / 编码路径,再交给同一类模幂运算。对应用层同学,最要紧的不是背公式,而是:
- 两端库调用的方案名一致;
- 哈希与 salt length 一致;
- 发布期旧字节流怎么处理。
PSS 引入随机盐 → 同消息多次签名通常得到不同字节。这是特性,不是 bug;测试策略必须跟着变(见下文清单)。
切流模式对照
默认调研起点:双模式验签窗口;窗口结束关掉 v1.5 回退——推荐方案必带代价。
| 模式 | 做法 | 适合 | 代价 |
|---|---|---|---|
| A. 大爆炸双端同发 | 客户端与服务端同日切 PSS | 可控用户、可强制升级 | 未升级旧端全挂 |
| B. 双模式验签窗口(常见) | 服务端先 VerifyPSS,失败再 VerifyPKCS1v15;客户端先发 PSS | 有存量旧端 | 窗口期保留较弱填充路径;要监控旧占比并设关闸日 |
| C. 仅新装 PSS | 新版本走 PSS;老端继续 v1.5 至自然淘汰 | 长尾很长、难强制升级 | 弱路径窗口更长;文档与示例易双轨混乱 |
实践叙事:B 作默认调研起点——不是因为「永远正确」,而是在「存量客户端」与「扫描催迁」之间最常被选中的折中。代价先说清:窗口越长,弱路径留得越久;没有监控与关闸日的兼容,等于永久不迁。
验签漏斗(教学示意):
verify(msg, sig, pub):
if VerifyPSS(pub, SHA256, msg, sig, salt=hashLen): return ok
if compat_window and VerifyPKCS1v15(...): return ok # 过渡期
return fail顺序选择(先 PSS 再 v1.5)是常见工程偏好:新流量优先走目标方案,旧字节走回退。若你们监控显示旧端仍占绝大多数,也可短期对调——合同是「窗口内双路径可达 + 有关闸」,不是某一种 if 顺序的宗教。
可复述检查清单
把「参数对齐 + 非确定性测试 + 关闸指标」写进发布检查表,比再贴一段 Sign 示例更值钱。
- 服务端 Sign / Verify 改 PSS,选项与客户端一致(哈希、salt length)。
- 客户端库改 PSS;注意 salt
AUTOvs 显式长度——按公开文档核对,勿跨语言猜同名。 - 文档、SDK 示例、内部 wiki 同步,避免复制粘贴旧的 PKCS1v15 调用。
- 测试用「验签通过 / 失败」断言,不写死期望签名 hex(PSS 非确定性)。
- 指标:旧填充占比、验签失败率;窗口结束关掉 v1.5 回退。
- 密钥轮换另开一项;本次可以只换填充——但换垫后旧签名仍全部失效。
教学向伪流程(脱敏,非生产 API;说明「新路径优先 → 兼容窗口 → 失败」):
# 教学示意:双模式验签窗口
on_verify(msg, sig, pub, compat_window):
if pss_ok(pub, hash=SHA256, salt_len=32, msg, sig):
return Accept(scheme=PSS)
if compat_window and pkcs1v15_ok(pub, hash=SHA256, msg, sig):
record_metric("legacy_pkcs1v15")
return Accept(scheme=PKCS1v15)
return Reject全文代码围栏仅上两段示意,合计远小于分享向上限;删掉代码后,上表六条清单仍应能独立复述。
反模式
从合同视角看,下面几条会把「换五个字母」做成全站验签事故或永久弱路径。
-
只改服务端
客户端仍发 v1.5 字节 → 若服务端已关回退,全量失败;若从未开双模式,上线即炸。 -
盐长度一端 AUTO、一端固定却未核对
「本地单测绿、联调红」的经典形态。跨语言 / 跨 SDK 时先对文档,再对测试向量。 -
用固定 hex 当 PSS 金测
同明文第二次签名就红。断言应是 Verify(msg, sig) == true,或对确定性方案另测。 -
无限期保留 v1.5「兼容」
扫描告警形式上「已支持 PSS」,弱路径从未关闸——迁移叙事破产。 -
把「换了 PSS」当成设备防伪 / 业务防伪已完备
填充方案不管字段绑定、防重放、密钥保管与吊销。那些仍是协议与密钥生命周期问题。
选型结论
- PSS 迁移是双端填充合同,不是单文件重构;密钥可不变,旧签名字节仍全失效。
- 默认规划双模式窗口 + 监控旧占比 + 关闸日;大爆炸仅适合可强制升级的用户面;长尾用「仅新装」要接受更长弱路径。
- 参数对齐(哈希、salt length)写进发布检查表;
AUTO/nil以各库公开文档为准。 - 测试策略随非确定性签名调整:验通过,不锁 hex。
- 换垫 ≠ 防伪完备:重放、绑定字段、密钥轮换与保管仍要单独设计。