利用C#在PDF文档中添加电子签名的实现流程

Install-Package Spire.PDF

using Spire.Pdf;
using Spire.Pdf.Interactive.DigitalSignatures;
using System;
using System.Security.Cryptography.X509Certificates;

namespace PdfDigitalSignature
{
    class BasicSignatureDemo
    {
        static void Main(string[] args)
        {
            try
            {
                // 1. 加载待签名的 PDF 文档
                using (PdfDocument pdfDoc = new PdfDocument())
                {
                    pdfDoc.LoadFromFile("Input.pdf"); // 替换为实际文件路径

                    // 2. 加载数字证书（指定密钥存储策略，适配服务器/客户端环境）
                    string certPath = "certificate.pfx"; // 替换为证书实际路径
                    string certPassword = "abc123"; // 替换为证书密码
                    X509Certificate2 cert = new X509Certificate2(
                        certPath,
                        certPassword,
                        // 关键标志：适配服务器环境+避免密钥持久化，提升安全性
                        X509KeyStorageFlags.MachineKeySet | X509KeyStorageFlags.EphemeralKeySet
                    );

                    // 3. 初始化签名器并执行签名
                    PdfOrdinarySignatureMaker signMaker = new PdfOrdinarySignatureMaker(pdfDoc, cert);
                    // 签名名称：用于后续识别/验证签名，建议唯一
                    signMaker.MakeSignature("Basic_Signature_001");

                    // 4. 保存签名后的文档
                    pdfDoc.SaveToFile("Signed_Basic.pdf");
                    Console.WriteLine("不可见签名添加成功！");
                }
            }
            catch (Exception ex)
            {
                Console.WriteLine($"签名失败：{ex.Message}");
                // 进阶：记录异常详情（如堆栈）便于排查
                Console.WriteLine($"异常详情：{ex.StackTrace}");
            }
        }
    }
}

using Spire.Pdf;
using Spire.Pdf.Interactive.DigitalSignatures;
using System;
using System.Drawing;
using System.Security.Cryptography.X509Certificates;

namespace PdfDigitalSignature
{
    class AdvancedSignatureDemo
    {
        static void Main(string[] args)
        {
            try
            {
                // 1. 加载 PDF 文档（using 自动释放资源）
                using (PdfDocument pdfDoc = new PdfDocument())
                {
                    pdfDoc.LoadFromFile("Input.pdf");

                    // 2. 加载数字证书
                    string certPath = "certificate.pfx";
                    string certPassword = "abc123";
                    X509Certificate2 cert = new X509Certificate2(
                        certPath,
                        certPassword,
                        X509KeyStorageFlags.MachineKeySet | X509KeyStorageFlags.EphemeralKeySet
                    );

                    // 3. 初始化签名器
                    PdfOrdinarySignatureMaker signMaker = new PdfOrdinarySignatureMaker(pdfDoc, cert);
                    PdfSignature signature = signMaker.Signature;

                    // 4. 配置签名元信息（将显示在签名外观中）
                    signature.Name = "XX科技有限公司";       // 签名者名称
                    signature.ContactInfo = "010-12345678"; // 联系信息
                    signature.Location = "中国·北京";        // 签名地点
                    signature.Reason = "确认文档内容合规有效";// 签名原因

                    // 5. 配置签名可视化外观
                    PdfSignatureAppearance appearance = new PdfSignatureAppearance(signature);
                    // 自定义标签文本
                    appearance.NameLabel = "签名主体：";
                    appearance.ContactInfoLabel = "联系电话：";
                    appearance.LocationLabel = "签署地点：";
                    appearance.ReasonLabel = "签署原因：";
                    // 添加签名图片（支持 PNG/JPG 等格式）
                    PdfImage signImage = PdfImage.FromFile("signature.png"); // 替换为签名图片路径
                    appearance.SignatureImage = signImage;
                    // 布局模式：图片 + 文本（可选：SignImageOnly/仅图片；SignDetailOnly/仅文本）
                    appearance.GraphicMode = GraphicMode.SignImageAndSignDetail;

                    // 6. 绑定外观并添加到指定位置
                    signMaker.SignatureAppearance = appearance;
                    // 获取目标页面（示例：最后一页）
                    PdfPageBase targetPage = pdfDoc.Pages[pdfDoc.Pages.Count - 1];
                    // MakeSignature 参数说明：签名名称、目标页面、X坐标、Y坐标、宽度、高度、外观
                    signMaker.MakeSignature("Advanced_Signature_001", targetPage, 
                        54.0f, 330.0f, 280.0f, 90.0f, appearance);

                    // 7. 保存文档
                    pdfDoc.SaveToFile("Signed_Advanced.pdf");
                    Console.WriteLine("可视化签名添加成功！");
                }
            }
            catch (Exception ex)
            {
                Console.WriteLine($"签名失败：{ex.Message}");
                Console.WriteLine($"异常详情：{ex.StackTrace}");
            }
        }
    }
}