Python给PDF添加可见与隐藏数字签名实战教程

脚本专家

在处理合同、发票或报告时，数字签名能验证文档的完整性与签署人身份。相比手动在Acrobat里逐份签署，用Python批量处理更适合自动化流程。本文基于Spire.PDF for Python，详细介绍如何为PDF添加可见签名、隐藏签名、带时间戳的签名，以及验证签名有效性。

环境准备
首先安装依赖库：

2. pip install Spire.Pdf

复制代码

还需要一个数字证书文件（.pfx或.p12格式）及对应的密码。测试阶段可使用自签名证书（如通过OpenSSL生成），生产环境应由CA签发。

添加可见的数字签名
可见签名会在PDF页面上绘制一个签名框，显示签署人、原因、位置等信息。核心是PdfOrdinarySignatureMaker对象，它负责加载证书并执行签署运算；签名外观通过PdfSignatureAppearance单独配置。

2. from spire.pdf import *
4. doc = PdfDocument()
5. doc.LoadFromFile("SampleB_1.pdf")
7. signatureMaker = PdfOrdinarySignatureMaker(doc, "Jerry.pfx", "e-iceblue")
8. signature = signatureMaker.Signature
9. signature.Name = "Jerry"
10. signature.ContactInfo = "028-12345678"
11. signature.Location = "Chengdu"
12. signature.Reason = "文档负责人签署"
14. appearance = PdfSignatureAppearance(signature)
15. appearance.NameLabel = "签署人: "
16. appearance.ContactInfoLabel = "联系方式: "
17. appearance.LocationLabel = "地点: "
18. appearance.ReasonLabel = "原因: "
19. appearance.SignatureImage = PdfImage.FromFile("logo.png")
20. appearance.GraphicMode = GraphicMode.SignImageAndSignDetail
22. signatureMaker.MakeSignature("Signer:", doc.Pages.get_Item(0), 90.0, 550.0, 270.0, 90.0, appearance)
23. doc.SaveToFile("DigitalSignature.pdf")
24. doc.Dispose()

复制代码

关键点：
- Name、Reason、Location等信息写入签名对象，PDF阅读器可读取。
- GraphicMode设置签名框显示内容：SignImageAndSignDetail同时显示Logo和文字，也可只选图片或文字。
- MakeSignature坐标参数以点（point）为单位，原点在页面左下角（左下为(0,0)），四个数值依次为左边界、下边界、宽度、高度。

添加隐藏签名
若只需在文档层面完成完整性校验而不显示可见框，可创建不带外观的隐藏签名。同样使用PdfOrdinarySignatureMaker，只传签名字段名称即可。

2. from spire.pdf import *
3. doc = PdfDocument()
4. doc.LoadFromFile("SampleB_1.pdf")
5. signatureMaker = PdfOrdinarySignatureMaker(doc, "Jerry.pfx", "e-iceblue")
6. signatureMaker.MakeSignature("signName")
7. doc.SaveToFile("AddInvisibleSignature.pdf")
8. doc.Dispose()

复制代码

隐藏签名仍具备防篡改能力，PDF阅读器可在签名面板中检测到它，但页面无任何显示。

添加带时间戳的签名
数字证书有有效期，若需证明签署发生在证书有效期内，需引入可信时间戳服务（TSA）。Security_PdfSignature提供ConfigureTimestamp方法指定TSA地址。

2. from spire.pdf import *
3. doc = PdfDocument()
4. doc.LoadFromFile("SampleB_1.pdf")
5. signature = Security_PdfSignature(doc, doc.Pages.get_Item(0), "Jerry.pfx", "e-iceblue", "signature")
6. signature.Bounds = RectangleF(PointF(90.0, 550.0), SizeF(180.0, 90.0))
7. signature.NameLabel = "Digitally signed by: Jerry"
8. signature.Reason = "确保文档真实性"
9. signature.DocumentPermissions = PdfCertificationFlags.AllowFormFill.value | PdfCertificationFlags.ForbidChanges.value
10. signature.ConfigureTimestamp("https://freetsa.org/tsr")
11. doc.SaveToFile("SignedByTimestamp.pdf")
12. doc.Dispose()

复制代码

DocumentPermissions属性以证书化签名方式限定签署后允许的操作。示例组合表示“允许继续填写表单字段，但禁止其他改动”，适合审批后仍需收集信息且防止篡改的表单类文档。

验证已签名的文档
遍历PDF表单中的签名字段，调用VerifySignature方法检查文档完整性。

2. from spire.pdf import *
3. doc = PdfDocument()
4. doc.LoadFromFile("SignedDocument.pdf")
5. formWidget = PdfFormWidget(doc.Form)
6. if formWidget.FieldsWidget.Count > 0:
7.     for i in range(formWidget.FieldsWidget.Count):
8.         field = formWidget.FieldsWidget.get_Item(i)
9.         if isinstance(field, PdfField):
10.             signatureField = PdfSignatureFieldWidget(field)
11.             valid = doc.VerifySignature(signatureField.FullName)
12.             print("签名有效" if valid else "签名无效")
13. doc.Dispose()

复制代码

VerifySignature会重新计算文档摘要并与签名中的记录比对：若文档被修改，返回无效。

实用建议
- 证书密码不要硬编码：应通过环境变量或密钥管理服务读取。
- 坐标系统：签名框原点在页面左下角，y轴向上为正，与屏幕坐标相反，注意换算。
- 签名顺序：多签名时后续签名会包含先前签名内容，影响验证逻辑。
- 及时释放资源：处理完后调用Dispose()，避免批量任务文件句柄占用。

以上即为Python自动化添加PDF数字签名的完整实现。基于此，可进一步结合表单字段、长期验证（LTV）等构建合同管理、审批流转的自动签署方案。

热心网友1

很实用的教程，最近刚好在找给PDF批量签名的方案。请问自签名证书和CA签发的证书在功能上有哪些区别？除了信任问题外，在代码层面是否需要做不同处理？

热心网友1

好实用的教程！Spire.PDF 这个库的可见/隐藏签名、时间戳绑定这些功能都讲得很清楚，坐标原点在左下角这个细节很多人会踩坑，楼主特意标出来太贴心了。要是能补充一下自签名证书用 OpenSSL 生成的具体命令就更完美了，感谢分享！

热心网友1

谢谢分享，这篇教程非常实用，把可见签名、隐藏签名和带时间戳的签名的完整流程都讲清楚了，尤其是坐标原点在左下角这个细节，新手很容易忽略。想问下自签名证书用 OpenSSL 生成时，有没有推荐的参数设置，避免在验证时被识别为“不受信任”？另外，文中的时间戳服务 `freetsa.org` 是免费的吧，长期生产环境是否建议用固定的商业 TSA？