BentoPDF 数字签名验证实战:在浏览器中校验 PDF 签名完整性、证书有效期与信任链

原创2026-09-21 14:31:211,628 阅读
文章标签:前端

BentoPDF 数字签名验证实战:在浏览器中校验 PDF 签名完整性、证书有效期与信任链

本文以 BentoPDF(Privacy First PDF Toolkit)的 Validate Signature 工具为对象,讲解如何在上传签名 PDF 后自动提取全部数字签名、识别签署人、检查证书有效期、判断文档是否在签署后被修改,并通过自定义信任证书校验签名链。读完本文,你将掌握 PDF 数字签名的解析原理、三态判定逻辑(Valid / Invalid / Unverified)、不安全摘要算法的处理策略,以及如何结合 validate-signature-pdf.ts 的源码级实现理解验证链路。所有处理均在浏览器本地完成,文档与证书不会离开设备。

工具概览:上传即验证的本地签名校验

BentoPDF 的 Validate Signature 工具对应的页面为 validate-signature-pdf.html,页面逻辑由 validate-signature-pdf-page.ts 驱动。整个工作流非常直接:

  1. 上传一份已签名的 PDF 文件,验证自动开始,无需点击任何"开始"按钮;
  2. 工具在顶部显示摘要:共找到多少个签名、其中多少个有效(有效判定同时要求签名通过密码学验证、覆盖全文且证书未过期);
  3. 每个签名生成一张独立详情卡片,展示签署人名称、签发机构、签署时间、证书有效期与状态;
  4. 可选上传信任证书(.pem、.crt、.cer、.der 格式),以特定信任锚点校验签名链,重新验证自动触发。

页面接收的证书格式在源码中通过 validExtensions 白名单限定,与页面 accept=".pem,.crt,.cer,.der" 的输入约束保持一致(见 validate-signature-pdf-page.ts 与 validate-signature-pdf.html)。

检查内容拆解:四个层次的验证

工具对每个签名执行四类检查,从"解析出来"到"密码学可证",逐层递进。

签名解析(Signature Parsing)

工具从 PDF 中提取 PKCS#7 签名对象,解码其 ASN.1 结构,取出签署人的 X.509 证书以及签名内嵌的证书链。在源码实现中,extractSignatures 通过正则 /\/Type\s*\/Sig\b/g 定位所有 /Type /Sig 签名对象,再在对象上下文内匹配 /ByteRange(签名覆盖的字节区间)与 /Contents(十六进制编码的 PKCS#7 内容),并顺带解析 /Reason、/Location、/ContactInfo、/Name 和 /M(签署时间戳)等签名字典字段(见 validate-signature-pdf.ts)。

证书有效性(Certificate Validity)

  • 有效期(Expiration):判断证书当前是否处于合法日期范围内,即 now > validTo || now < validFrom;
  • 自签名检测(Self-signed detection):判断证书是否自己签发自己,即 signerCert.isIssuer(signerCert);
  • 信任链(Trust chain):当提供了信任证书时,判断签署人证书是否能链回到该信任锚点(见 validate-signature-pdf.ts)。

证书字段的提取聚焦于 X.509 主题与签发者中的 CN(通用名)、O(组织)与 E/emailAddress(邮箱),这些字段最终展示在签名卡片的"Signed By"与"Issuer"区域。

密码学验证(Cryptographic Verification)

这是工具的核心环节,对应源码中的 performCryptoVerification(validate-signature-pdf.ts),其完整流程为:

  1. 依据签名的 /ByteRange(四元组 [start1, len1, start2, len2])重建被签名覆盖的字节:拼接第一段与第二段区间,并做越界检查;
  2. 使用签署人声明的摘要算法对重建内容取哈希;
  3. 在签名内的 authenticated attributes 中查找 messageDigest 属性,将两者比对——不一致即判定文档在签署后被修改;
  4. 将 signed attributes 重新序列化为 DER SET,作为实际被签名的字节;
  5. 用签署人证书的公钥对该字节集验证签名。

只有当以上全部通过时,签名才被报告为 Valid。 若 PDF 字节在签署后被修改,或内嵌签名与签署人密钥不匹配,状态显示为 "Invalid — Cryptographic Verification Failed" 并附带具体原因。若存在 messageDigest 缺失、ByteRange 越界、签名字节为空等异常,也会返回带具体原因的失败结果。

支持的签名算法(Supported Signature Algorithms)

算法 验证路径
RSA (PKCS#1 v1.5) node-forge publicKey.verify,Web Crypto 兜底
RSA-PSS (RSASSA-PSS) Web Crypto verify({name: 'RSA-PSS', saltLength})
ECDSA P-256/P-384/P-521 Web Crypto verify({name: 'ECDSA', hash}),先做 DER → IEEE P1363 签名转换

算法方案检测在 detectSigScheme 中完成(validate-signature-pdf.ts),覆盖 RSA PKCS#1(含 SHA-1/SHA-256/SHA-384/SHA-512 变体)、RSA-PSS(从 ASN.1 参数中解析哈希算法与 saltLength,见 parsePssParams)与 ECDSA 各哈希组合。ECDSA 验证前,ecdsaDerToP1363 会把 DER 编码的 (r, s) 签名转换为 Web Crypto 要求的 IEEE P1363 固定长度拼接格式,并通过 curveFromSpki 从证书公钥 SPKI 中识别曲线(P-256/P-384/P-521 对应 OID 映射在源码中逐一列出)。

如果签名使用了此列表之外的算法(例如 Ed25519、SM2,或带异常摘要 OID 的 RSA),卡片以黄色显示 "Unverified — Unsupported Signature Algorithm",并给出具体 OID 或原因。这是一个刻意的三态区分设计:

  • Valid — 签名已用签署人公钥完成密码学验证;
  • Invalid — 验证已执行但结果为否(字节被改、密钥不匹配);
  • Unverified — 该算法无法执行验证。证书元数据仍会展示,但应将此签名视为"未知",建议用 Adobe Acrobat 或 openssl cms -verify 人工复核。

不安全摘要算法(Insecure Digest Algorithms)

  • 使用 MD5 或 SHA-1 的签名会被直接判为无效,并标记 "Insecure Digest" 状态——两者均已有公开的碰撞攻击,对 SHA-1 或 MD5 哈希的签名无法提供完整性保证。源码中以 INSECURE_DIGEST_OIDS 集合硬编码这两个算法的 OID(1.2.840.113549.2.5 为 MD5、1.3.14.3.2.26 为 SHA-1)进行拦截(validate-signature-pdf.ts);
  • SHA-224、SHA-256、SHA-384、SHA-512 均被接受,其 OID 映射见 getDigestAlgorithmName。

需要注意的是,isValid 的最终判定为 cryptoVerified && coverageStatus === 'full' && !usesInsecureDigest(validate-signature-pdf.ts),三项缺一不可。

文档覆盖率(Document Coverage)

  • Full coverage(完整覆盖):签名覆盖整个 PDF 文件,说明签署后没有任何字节被追加或修改;
  • Partial coverage(部分覆盖):签名只覆盖文件的一部分,可能意味着签署后有修改——但不一定是恶意的,增量保存(如追加第二个签名)同样会产生部分覆盖。

源码中的判定逻辑为:比较 ByteRange 第二区间的结束位置 start2 + len2 与整个 PDF 字节数,相等则为 full,小于则为 partial(validate-signature-pdf.ts)。卡片上分别以绿色 "Full Coverage" 与黄色 "Partial Coverage" 标签展示。

签名详情卡片:字段与含义

每个签名卡片展示以下信息(渲染逻辑见 validate-signature-pdf-page.ts):

  • Signed By:签署人证书中的通用名、组织与邮箱;
  • Issuer:签发签署人证书的证书颁发机构(CA);
  • Signed On:签名内嵌的时间戳(优先取签名字典的 /M,其次从 PKCS#7 authenticated attributes 的 signingTime 属性解析,支持 UTCTime 与 GeneralizedTime);
  • Valid From / Valid Until:证书有效期区间;
  • Reason:签署文档的原因(若提供);
  • Location:签署地点(若提供);
  • Coverage Status:Full 或 Partial;
  • Trust Badge:Trusted 或 Not in trust chain(仅在提供了自定义信任证书时出现)。

展开 Technical Details 区域还可以看到:

  • 签署人证书的序列号(Serial Number);
  • 摘要算法(SHA-256、SHA-512 等);
  • 签名算法(RSA with SHA-256、ECDSA with SHA-256 等);
  • 无效签名的具体错误消息。

卡片的顶层状态图标依据三态与附加条件分层渲染:算法不支持显示黄色 "Unverified";部分覆盖且密码学通过显示红色 "Modified After Signing (partial coverage)";密码学验证失败显示 "Cryptographic Verification Failed";不安全摘要显示 "Insecure Digest (MD5 / SHA-1)";证书过期显示黄色 "Certificate Expired";未提供信任证书时则提示 "Signer Identity Not Verified"。

自定义信任证书:验证组织级信任链

工具本身不内置任何 CA 列表,因此仅凭自身只能确认签名完好,无法确认证书背后的身份。要获得信任链验证,请上传你的组织根证书或中间证书(.pem、.crt、.cer、.der),验证会自动重跑。

证书解析逻辑见 validate-signature-pdf-page.ts:PEM 文本(含 -----BEGIN CERTIFICATE-----)走 forge.pki.certificateFromPem,DER 二进制走 ASN.1 解码。信任判定在 validate-signature-pdf.ts 中实现,采用两条路径的并集:

  1. 证书逐字节相同:certificateToPem(signerCert) === certificateToPem(trustedCert);
  2. 加密级签发关系:遍历签名证书链(签署人证书 + 签名内嵌证书),若 trustedCert.verify(cert) 成功,则判定该证书由信任锚点签发。

通过信任校验的签名获得绿色 "Trusted" 徽章,否则显示 "Not in trust chain";摘要区会额外显示 "Trust verification: x/y signatures verified against custom certificate"。

需要明确的能力边界:该工具不执行吊销检查——不查询 OCSP 响应者,也不检索证书吊销列表(CRL)。若需吊销验证,请在可联网的桌面工具中复核文件。

使用场景

  • 在**会签(countersigning)**之前验证已数字签署的合同;
  • 审计已签署文档,确认未被篡改;
  • 检查文档签署后证书是否已过期(注意:有效期以当天日期为基准判定,若签署时证书有效但现已过期,会显示 "Certificate Expired" 状态,此时应对比卡片的 Signed On 与 Valid From/Until 判断签署时刻的有效性);
  • 针对组织根证书验证签名;
  • 检查政府或法律文书的签署详情。

使用提示

  • 自签名证书不代表签名无效——它只说明签署人身份无法通过受信任的第三方验证,这在内部文档中很常见;
  • Partial coverage 不总是篡改的证据。许多 PDF 工作流会追加增量更新(例如第二个签名),从而产生部分覆盖;此时只有最后一个添加的签名才能覆盖整个文件。应将其视为"检查新增内容"的信号,而非定论;
  • 上传组织根证书或中间证书作为信任证书,即可获得信任链验证,摘要区也会据此重新统计有效签名数量。

相关工具

登录后查看全文
bentopdf