基于.NET 8与iText7的PDF外部容器数字签名实现咨询

一、实现IExternalSignatureContainer+自定义IExternalSignature的单步方案是否正确？ #

这个方案完全可行，iText7原生支持通过自定义IExternalSignatureContainer实现单步签名流程，核心是把哈希计算与签名生成逻辑整合在同一流程中，替代两步法的拆分操作。

实现时需注意几个关键要点：

• 自定义IExternalSignature时，必须准确实现GetSignatureAlgorithm()和GetDigestAlgorithm()，返回值要与实际使用的签名算法匹配（例如RSA-SHA256对应签名算法名SHA256withRSA，摘要算法SHA-256）。
• IExternalSignatureContainer的Sign方法中，需先读取传入的待签名数据流并转为字节数组，再完成摘要计算与签名生成，最后返回签名后的字节数组。
• 初始化PdfSigner时，要调用SignDetached方法传入自定义签名容器，而非SignDeferred，确保单步完成签名流程。

核心代码示例：

// 自定义IExternalSignature实现
public class CustomExternalSignature : IExternalSignature
{
    public string GetDigestAlgorithm() => "SHA-256";
    public string GetSignatureAlgorithm() => "SHA256withRSA";
    
    public byte[] Sign(byte[] message)
    {
        // 此处可直接调用签名逻辑，或后续迁移至签名服务
        using var sha256 = SHA256.Create();
        var digest = sha256.ComputeHash(message);
        // 假设_signer为RSA签名实例，持有私钥
        return _signer.SignHash(digest, HashAlgorithmName.SHA256, RSASignaturePadding.Pkcs1);
    }
}

// 自定义IExternalSignatureContainer实现
public class CustomSignatureContainer : IExternalSignatureContainer
{
    private readonly IExternalSignature _signature;
    
    public CustomSignatureContainer(IExternalSignature signature) => _signature = signature;

    public byte[] Sign(Stream data)
    {
        byte[] dataBytes;
        using (var ms = new MemoryStream())
        {
            data.CopyTo(ms);
            dataBytes = ms.ToArray();
        }
        return _signature.Sign(dataBytes);
    }

    public void ModifySigningDictionary(PdfDictionary signDic)
    {
        // 设置签名字典必要属性
        signDic.Put(PdfName.Filter, PdfName.Adobe_PPKLite);
        signDic.Put(PdfName.SubFilter, PdfName.Adbe_pkcs7_detached);
    }
}

// 单步签名调用逻辑
using var pdfReader = new PdfReader("input.pdf");
using var pdfWriter = new PdfWriter("output_signed.pdf");
var signer = new PdfSigner(pdfReader, pdfWriter, new StampingProperties());
signer.SetFieldName("SignatureField");
var customSignature = new CustomExternalSignature();
var signatureContainer = new CustomSignatureContainer(customSignature);
signer.SignDetached(signatureContainer, new[] { new X509Certificate2("cert.pfx", "password") }, null, null, null, 0, PdfSigner.CryptoStandard.CMS);

二、将GetSignedHash方法迁移至签名服务是否可行？ #

完全可行，这也是分布式场景下的最佳实践——将私钥托管在独立的签名服务中，避免私钥暴露在业务服务里。需要注意以下细节：

1. 数据传输安全：待签名的原始字节数组需通过HTTPS加密通道传输，防止数据被篡改或窃取。
2. 算法一致性：业务服务与签名服务必须使用完全一致的摘要算法和签名算法，否则签名验证会失败。
3. 服务职责单一：签名服务只需接收待签名字节数组，返回签名后的字节数组即可，无需处理PDF相关逻辑。

调整后的CustomExternalSignature示例：

public class CustomExternalSignature : IExternalSignature
{
    private readonly ISignatureService _signatureService;
    
    public CustomExternalSignature(ISignatureService signatureService) => _signatureService = signatureService;

    public string GetDigestAlgorithm() => "SHA-256";
    public string GetSignatureAlgorithm() => "SHA256withRSA";

    public byte[] Sign(byte[] message)
    {
        // 调用远程签名服务生成签名
        return _signatureService.GenerateSignature(message, GetDigestAlgorithm());
    }
}

三、签名服务需要做的调整 #

• 算法对齐：确保签名服务使用的摘要算法、签名算法与iText端配置完全匹配，比如iText指定SHA-256，服务端必须用SHA256计算摘要后再签名。
• 私钥安全管理：采用硬件安全模块（HSM）或密钥管理服务（KMS）存储私钥，避免私钥泄露。
• 自验证逻辑：在签名服务中加入签名结果自验证步骤，确保生成的签名可通过对应公钥验证，避免返回无效签名。
• 异常处理：增加网络超时、签名失败等场景的异常处理，返回明确错误信息，方便业务服务排查问题。

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