密码学与证书 / 系统课时

排查签名与验签失败

排查签名与验签失败

验签返回 false 时,先核对发送端和接收端参与签名的实际字节,再检查算法参数、公钥与签名编码。按这个顺序留存最小证据,可以定位 JSON 序列化、PSS 参数或 SM2 用户 ID 等不一致问题。

学习目标

  • 比较双方最终待签名字节的 SHA-256,定位规范化差异。
  • 核对公钥指纹、签名编码以及 ECDSA、SM2、RSA-PSS 的关键参数。
  • 用可运行示例复现失败,并建立可复核的联调日志。

对比待签名字节的摘要

验签失败时,不要第一时间认定“公钥错了”。更常见的原因是双方签的根本不是同一串字节。发送方对实际传给签名 API 的字节计算 SHA-256;接收方对实际传给验签 API 的字节做同样计算,并交换十六进制摘要。

如果摘要不同,优先核查签名覆盖范围、字段顺序、空值与缺失值、JSON 空白和转义、URL 编码、UTF-8、换行,以及时间戳的时区与精度。例如 {"a":1,"b":2} 与 {"b":2,"a":1} 语义相近,但字节不同。先按协议统一规范化规则,再继续排查密钥。

复现字段顺序引起的失败

以下示例使用 JDK 11+ 的 RSASSA-PSS。发送端签署一段 JSON 字节,接收端重排字段后验签;双方使用同一公钥和完全相同的 PSS 参数。将代码保存为 SignatureDebug.java,执行 javac SignatureDebug.java && java SignatureDebug。

java
import java.nio.charset.StandardCharsets;
import java.security.*;
import java.security.spec.MGF1ParameterSpec;
import java.security.spec.PSSParameterSpec;
import java.util.Arrays;

public class SignatureDebug {
    static boolean verify(PublicKey key, byte[] message, byte[] signature,
                          PSSParameterSpec params) throws Exception {
        Signature verifier = Signature.getInstance("RSASSA-PSS");
        verifier.setParameter(params);
        verifier.initVerify(key);
        verifier.update(message);
        return verifier.verify(signature);
    }

    public static void main(String[] args) throws Exception {
        // 内容相同但字段顺序不同,待签名字节也不同。
        byte[] sent = "{\"amount\":100,\"currency\":\"CNY\"}".getBytes(StandardCharsets.UTF_8);
        byte[] received = "{\"currency\":\"CNY\",\"amount\":100}".getBytes(StandardCharsets.UTF_8);
        // 摘要、MGF1 摘要和盐长必须在两端保持一致。
        PSSParameterSpec pss = new PSSParameterSpec("SHA-256", "MGF1",
                MGF1ParameterSpec.SHA256, 32, 1);
        KeyPairGenerator generator = KeyPairGenerator.getInstance("RSA");
        generator.initialize(2048);
        KeyPair pair = generator.generateKeyPair();

        Signature signer = Signature.getInstance("RSASSA-PSS");
        signer.setParameter(pss);
        signer.initSign(pair.getPrivate());
        signer.update(sent);
        byte[] signature = signer.sign();

        MessageDigest sha256 = MessageDigest.getInstance("SHA-256");
        System.out.println("hashEqual=" + Arrays.equals(
                sha256.digest(sent), sha256.digest(received)));
        System.out.println("verifyBefore=" + verify(
                pair.getPublic(), received, signature, pss));
        // 修正验签输入字节,不需要更换公钥或重签。
        System.out.println("verifyAfter=" + verify(
                pair.getPublic(), sent, signature, pss));
    }
}

预期输出:

text
hashEqual=false
verifyBefore=false
verifyAfter=true

verifyBefore=false 是输入字节不一致导致的正常结果;统一字节后即通过。这里用临时密钥演示,生产环境不要把私钥输出到日志,也不要为通过验签而跳过错误检查。

确认密钥和算法

如果双方待签名字节摘要相同,再核对 algorithm、keyId、公钥指纹和签名编码。公钥指纹可统一定义为公钥 SubjectPublicKeyInfo DER 编码的 SHA-256;交换指纹即可判断是否拿错版本,不需要传生产私钥。还应检查签名是否在 Base64、Base64URL 或二进制传输中被错误解码、截断。

签名验签失败从消息摘要到密钥参数的排查树

对齐 ECDSA 与 SM2 编码

ECDSA 常见签名表示有 ASN.1 DER 编码的 SEQUENCE(INTEGER r, INTEGER s),以及固定长度的 r || s。例如 P-256 原始格式通常为 64 字节,而 DER 因整数符号补零长度可变;不能直接把 DER 字节平分成两半。

SM2 也需要确认协议采用 DER 还是原始拼接格式,并核对双方使用的用户 ID、ZA 计算规则、曲线及公钥。即使原始消息的 SHA-256 相同,用户 ID 不同也会使 SM2 验签失败。不要将 SM2 当作只换了曲线的 ECDSA。

核对 RSA-PSS 的完整参数

RSA-PSS 不只是一个算法名字。两端必须一致地指定消息摘要(如 SHA-256)、MGF1 摘要、盐长度(如 32 字节)与尾字段;还要区分 PSS 和 SHA256withRSA 所代表的 PKCS#1 v1.5 签名模式。

如果字节与公钥一致但仍失败,逐项对照这些参数,并确认签名字节未被改写。不要通过随意缩短盐长或自动回退算法掩盖联调错误。

保存最小联调日志

建议双方按同一个 requestId 记录算法、keyId、规范化字节摘要、公钥指纹、签名编码、签名长度及验签结果。例如 2048 位 RSA 签名的原始长度应为 256 字节:

json
{
  "requestId": "<ID>",
  "algorithm": "RSASSA-PSS",
  "keyId": "<ID>",
  "canonicalSha256": "<SHA256-HEX>",
  "publicKeySpkiSha256": "<SHA256-HEX>",
  "signatureEncoding": "Base64",
  "signatureLength": 256,
  "verifyResult": false
}

这是日志结构示例,尖括号字段需要替换成实际值。联调环境确需排查传输错误时,可按权限临时保留签名 Base64;生产日志优先只留长度和摘要,不记录敏感 canonical 原文。对照双方同一请求的日志,按“字节摘要→算法参数→公钥→签名编码”的顺序复验,能明确定位失败环节。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

排查签名与验签失败

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通