iText 8 PDF延迟签名验证报错及文档篡改提示问题求助

问题核心场景 #

基于Java + iText 8.0.3实现第三方密钥签名流程：准备待签PDF→生成带空签名的临时PDF→提取摘要并Base64编码送第三方CompanyA签名→嵌入签名生成最终文件。先后遇到两个验证错误：

1. Error during signature verification. ASN.1 parsing error: Error encountered while BER decoding:
2. 更新PreSignatureContainer后，提示Document has been altered or corrupted

针对ASN.1解析错误的解决方案 #

这个错误的本质是嵌入的签名数据不符合PKCS#7/CMS标准格式，常见原因及修复：

• 确认第三方返回的签名类型：
  iText的PDF签名要求嵌入完整的CMS签名容器（包含签名值、证书链、算法标识等），如果CompanyA返回的是纯RSA/EC裸签名（仅签名值字节），必须自行封装为CMS结构。可借助BouncyCastle或iText内置工具类完成封装：

  // 示例：用BouncyCastle将裸签名封装为CMS
  CMSSignedDataGenerator generator = new CMSSignedDataGenerator();
  // 添加证书链
  for (X509Certificate cert : certificateChain) {
      generator.addCertificate(new JcaX509CertificateHolder(cert));
  }
  // 添加签名算法和裸签名值
  AlgorithmIdentifier sigAlgId = new DefaultSignatureAlgorithmIdentifierFinder().find("SHA256withRSA");
  generator.addSignerInfoGenerator(
      new JcaSignerInfoGeneratorBuilder(
          new JcaDigestCalculatorProviderBuilder().build())
          .build(sigAlgId, new JcaContentSignerBuilder("SHA256withRSA").build(privateKey), new JcaX509CertificateHolder(certificateChain[0])));
  // 生成CMS数据
  CMSSignedData signedData = generator.generate(new CMSProcessableByteArray(hash), false);
  byte[] cmsBytes = signedData.getEncoded();
  

• 检查Base64编解码正确性：
  发送给CompanyA的摘要Base64、返回的签名Base64必须是无冗余字符（无换行、空格）的纯编码串，使用Base64.getDecoder().decode()而非带格式的解码器。

针对"文档篡改"提示的解决方案 #

这个错误说明预签名时计算的哈希范围与最终验证时的哈希范围不匹配，核心修复点：

1. 确保预签名容器的签名字典配置正确 #

PreSignatureContainer的签名字典必须严格符合PDF签名规范，不能随意修改会影响文档哈希的字段：

public class CustomPreSignatureContainer extends ExternalBlankSignatureContainer {
    private final String digestAlg;

    public CustomPreSignatureContainer(String digestAlg) {
        super(PdfName.Adobe_PPKLite, PdfName.Adbe_pkcs7_detached);
        this.digestAlg = digestAlg;
    }

    @Override
    public void modifySigningDictionary(PdfDictionary signDic) {
        signDic.put(PdfName.Type, PdfName.Sig);
        signDic.put(PdfName.Filter, PdfName.Adobe_PPKLite);
        signDic.put(PdfName.SubFilter, PdfName.Adbe_pkcs7_detached);
        signDic.put(PdfName.DigestAlgorithm, new PdfName(digestAlg));
        // 仅添加必要字段，禁止修改文档结构相关的键值
    }
}

2. 正确提取待签名的字节范围 #

必须使用iText提供的getRangeStream()获取预签名后需要计算哈希的字节流，而不是直接读取临时PDF文件的全部内容：

// 生成预签名PDF后，提取待签名字节流
byte[] contentToSign = signer.getRangeStream().toByteArray();
MessageDigest digest = MessageDigest.getInstance("SHA-256");
byte[] hash = digest.digest(contentToSign);
String base64Hash = Base64.getEncoder().encodeToString(hash);

3. 确保预签名与最终签名的文档状态一致 #

生成临时PDF后，禁止对其做任何修改（包括打开后重新保存、修改元数据等），否则文档哈希会发生变化，导致验证时提示篡改。

4. 匹配摘要算法与签名算法 #

确保你计算摘要的算法（如SHA-256）与CompanyA签名使用的算法（如SHA256withRSA）完全匹配，算法不匹配会导致验证时哈希校验失败。

内容的提问来源于stack exchange，提问作者aaa111