签名迁 RSA-PSS:双端填充合同与兼容窗口

签名迁 RSA-PSS:双端填充合同与兼容窗口

Hello,我是小兔大白糖。 静态扫描一报:「PKCS#1 v1.5 签名弱,改用 RSA-PSS。」——听起来像改五个字母的 Sign API;真正贵的是双端同时换垫、盐与哈希对齐、旧客户端怎么过发布窗口。写成这篇,给要在客户端 / 服务端之间做应用层 RSA 签名填充迁移调研的初中级后端同学:业界工程心智模型,不是某 App 设备指纹工单。

说明:下文「模式 A/B/C」是切流分析框架,不是某厂 SLA。标准与库行为以公开文档为准;不编造「官方内部就是这样」。示例为教学脱敏示意。本文只管应用层 RSA 签名字节合同,不展开证书体系与 TLS 握手。

估计阅读时间:10 分钟


目录


为什么现在要关心

硬规则:签与验是一对合同;只改一端 → 全量验签失败。

扫描告警把「换填充」说得很轻,现场成本几乎都在合同边界外:

你以为在改实际合同
「换一个 Sign 函数」客户端库 + 服务端 Verify + 文档示例 + 测试向量
「更安全就完事」扫描告警降级;业务层仍要防重放、绑定关键字段
「PSS 更随机所以更好测」同明文多次签名不同——测试勿写死期望十六进制

四条可复述硬规则(删掉比喻后仍成立):

  1. 签与验一对合同:只改一端,旧签名字节对新验签路径无效。
  2. PSS 参数要对齐:哈希(如 SHA-256)与 salt length(盐长度)两端一致;库里的 nil / AUTO 含义要核对该语言官方文档,不要假设「同名即同义」。
  3. 发布窗口要有兼容策略:短期双模式验签,或强制双端同步发版;「只改后端」不是策略。
  4. 迁移解决的是填充方案,不是密钥轮换本身:密钥对可以不变,但旧签名字节流与新填充不兼容。

方向性说明:签名场景下当代公开指南与扫描器更常推动 PSS;换垫不等于自动合规,对口标准与审计口径另核。salt length 的「常见默认 = 哈希输出长度」也须对照目标库文档,勿跨语言猜同名。


心智模型:锁芯与钥匙齿形

密钥对像锁与钥匙坯料;填充方案(v1.5 / PSS)像齿形标准——换齿形不必换锁芯,但旧齿打不开新锁。

概念类比工程含义
RSA 密钥对锁芯与钥匙坯料可不变;轮换是另一项工作
PKCS#1 v1.5 / RSA-PSS齿形标准决定签名字节怎么「垫」再模幂
客户端 Sign + 服务端 Verify配对的钥匙与锁必须同一齿形标准
salt / 哈希参数齿距与齿数约定一端 AUTO、一端写死却未核对 → 间歇性全挂

类比局限:解释不了证书体系、TLS 握手、证书透明度;只管「应用层 RSA 签名字节」。门锁类比也解释不了业务防重放——那是协议字段与时效,不是填充方案的职责。

密钥对与填充方案:锁芯与齿形对照
密钥对与填充方案:锁芯与齿形对照 · 点击查看 SVG 原图

问题空间:你以为在改什么

扫描降风险 ≠ 业务防伪完备;换 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 作默认调研起点——不是因为「永远正确」,而是在「存量客户端」与「扫描催迁」之间最常被选中的折中。代价先说清:窗口越长,弱路径留得越久;没有监控与关闸日的兼容,等于永久不迁。

RSA-PSS 切流三种模式对照
RSA-PSS 切流三种模式对照 · 点击查看 SVG 原图

验签漏斗(教学示意):

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 的验签漏斗
先 PSS 再可选 v1.5 的验签漏斗 · 点击查看 SVG 原图

顺序选择(先 PSS 再 v1.5)是常见工程偏好:新流量优先走目标方案,旧字节走回退。若你们监控显示旧端仍占绝大多数,也可短期对调——合同是「窗口内双路径可达 + 有关闸」,不是某一种 if 顺序的宗教。


可复述检查清单

把「参数对齐 + 非确定性测试 + 关闸指标」写进发布检查表,比再贴一段 Sign 示例更值钱。

  1. 服务端 Sign / Verify 改 PSS,选项与客户端一致(哈希、salt length)。
  2. 客户端库改 PSS;注意 salt AUTO vs 显式长度——按公开文档核对,勿跨语言猜同名。
  3. 文档、SDK 示例、内部 wiki 同步,避免复制粘贴旧的 PKCS1v15 调用。
  4. 测试用「验签通过 / 失败」断言,不写死期望签名 hex(PSS 非确定性)。
  5. 指标:旧填充占比、验签失败率;窗口结束关掉 v1.5 回退。
  6. 密钥轮换另开一项;本次可以只换填充——但换垫后旧签名仍全部失效。

教学向伪流程(脱敏,非生产 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

全文代码围栏仅上两段示意,合计远小于分享向上限;删掉代码后,上表六条清单仍应能独立复述。


反模式

从合同视角看,下面几条会把「换五个字母」做成全站验签事故或永久弱路径。

  1. 只改服务端
    客户端仍发 v1.5 字节 → 若服务端已关回退,全量失败;若从未开双模式,上线即炸。

  2. 盐长度一端 AUTO、一端固定却未核对
    「本地单测绿、联调红」的经典形态。跨语言 / 跨 SDK 时先对文档,再对测试向量。

  3. 用固定 hex 当 PSS 金测
    同明文第二次签名就红。断言应是 Verify(msg, sig) == true,或对确定性方案另测。

  4. 无限期保留 v1.5「兼容」
    扫描告警形式上「已支持 PSS」,弱路径从未关闸——迁移叙事破产。

  5. 把「换了 PSS」当成设备防伪 / 业务防伪已完备
    填充方案不管字段绑定、防重放、密钥保管与吊销。那些仍是协议与密钥生命周期问题。


选型结论

  1. PSS 迁移是双端填充合同,不是单文件重构;密钥可不变,旧签名字节仍全失效。
  2. 默认规划双模式窗口 + 监控旧占比 + 关闸日;大爆炸仅适合可强制升级的用户面;长尾用「仅新装」要接受更长弱路径。
  3. 参数对齐(哈希、salt length)写进发布检查表;AUTO / nil 以各库公开文档为准。
  4. 测试策略随非确定性签名调整:验通过,不锁 hex。
  5. 换垫 ≠ 防伪完备:重放、绑定字段、密钥轮换与保管仍要单独设计。