如何将已有的数字签名（byte[]）添加至PDF的Signature Dictionary

要把生成的签名字节数组写入PDF的Signature Dictionary，核心是遵循PDF规范操作其底层结构，以下是具体步骤（可根据你使用的PDF处理库调整细节）：

1. 定位或创建Signature Dictionary #

• 若预先为PDF创建了签名域，直接找到对应预留的Signature Dictionary；若没有，则创建一个符合规范的签名字典。
• 字典必须包含这些必填键：
  • /Type：值为/Sig，标识这是签名字典
  • /Filter：签名处理程序名称，比如/Adobe.PPKLite（对应PKCS#7签名）
  • /SubFilter：签名内容格式，比如/adbe.pkcs7.detached（分离式PKCS#7签名，最常用类型）
  • /Contents：用于填充签名数据的字段，初始通常是预留的空字节占位符

2. 处理签名字节数组 #

• PDF的/Contents字段要求数据为Base64编码的字节流，所以先把你的byte[]签名数据转换成Base64字符串。
• 若为分离式签名，/Contents只需包含PKCS#7签名数据即可，无需嵌入原文哈希（哈希已在签名过程中写入PKCS#7结构）。

3. 填充/Contents字段 #

• 找到Signature Dictionary中的/Contents键，将其值替换为编码后的Base64字符串。
• 若之前预留了固定长度的占位符，要确保Base64编码后的长度与预留长度匹配；使用成熟PDF库的话，这一步会自动处理对象偏移和长度适配。

4. 更新PDF结构合法性 #

• 修改签名字典后，需要更新该对象在PDF交叉引用表（Xref Table）中的偏移量条目。
• 最后更新文件尾（Trailer）中的/Size（若新增了对象）和/Root等字段，保证PDF结构完整可解析。

代码示例（伪代码，以Java iText 7为例） #

// 假设已获取签名数据byte[] signatureBytes
PdfDocument pdfDoc = new PdfDocument(new PdfReader("original.pdf"), new PdfWriter("signed.pdf"));
// 获取目标签名域的签名字典
PdfAcroForm form = PdfAcroForm.getAcroForm(pdfDoc, false);
PdfSignatureField sigField = form.getSignatureField("MySignature");
PdfDictionary sigDict = sigField.getPdfObject();

// 转Base64并写入/Contents
String base64Sig = Base64.getEncoder().encodeToString(signatureBytes);
sigDict.put(PdfName.Contents, new PdfString(base64Sig).setHexWriting(false));

// 关闭文档时自动更新xref表和trailer
pdfDoc.close();

关键注意事项 #

• 必须严格遵循ISO 32000（PDF规范）中Signature Dictionary的定义，缺少必填键会导致签名不被校验工具认可。
• 若手动处理PDF底层（不依赖库），要遵守PDF对象格式：每个对象以obj开头、endobj结尾，示例如下：

  12 0 obj
  <<
    /Type /Sig
    /Filter /Adobe.PPKLite
    /SubFilter /adbe.pkcs7.detached
    /Contents (Base64EncodedSignatureData)
  >>
  endobj
  

• 签名后要保证PDF结构完整，xref表偏移错误会导致PDF无法打开或签名失效。

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