在C#与iText 7中使用X509Certificate2创建IExternalSignature遇错求助

我完全理解你的困扰——iText 7移除了旧版本里好用的X509Certificate2Signature类，而直接用BouncyCastle提取私钥的方式对智能卡证书根本不生效，毕竟智能卡的私钥是存硬件里的，根本没法导出成普通的私钥对象。下面给你一套经过验证的解决方案：

核心问题拆解 #

智能卡/读卡器里的X509Certificate2，其私钥是硬件托管的，你没法通过DotNetUtilities.GetKeyPair拿到可操作的BouncyCastle私钥对象。这时候得绕开BouncyCastle的私钥处理，直接调用Windows Crypto API来完成签名操作。

自定义IExternalSignature实现 #

我们自己写一个适配X509Certificate2的IExternalSignature实现，直接调用证书的硬件私钥做签名：

using System;
using System.Security.Cryptography;
using System.Security.Cryptography.X509Certificates;
using iText.Signatures;

public class X509Certificate2Signature : IExternalSignature
{
    private readonly X509Certificate2 _cert;
    private readonly string _hashAlgorithm;
    private readonly string _encryptionAlgorithm;

    public X509Certificate2Signature(X509Certificate2 certificate, string hashAlgorithm)
    {
        _cert = certificate ?? throw new ArgumentNullException(nameof(certificate));
        if (!_cert.HasPrivateKey)
            throw new InvalidOperationException("证书不包含私钥");

        // 统一哈希算法格式，适配iText要求
        _hashAlgorithm = DigestAlgorithms.GetDigest(DigestAlgorithms.GetAllowedDigest(hashAlgorithm));
        _encryptionAlgorithm = GetEncryptionAlgorithm(certificate);
    }

    public string GetHashAlgorithm() => _hashAlgorithm;
    public string GetEncryptionAlgorithm() => _encryptionAlgorithm;

    public byte[] Sign(byte[] message)
    {
        // 优先处理RSA密钥
        using var rsa = _cert.GetRSAPrivateKey();
        if (rsa != null)
        {
            return rsa.SignData(message, 
                new HashAlgorithmName(_hashAlgorithm.Replace("-", "")), 
                RSASignaturePadding.Pkcs1);
        }

        // 处理ECDSA密钥（如果是国密或椭圆曲线证书）
        using var ecdsa = _cert.GetECDsaPrivateKey();
        if (ecdsa != null)
        {
            return ecdsa.SignData(message, 
                new HashAlgorithmName(_hashAlgorithm.Replace("-", "")));
        }

        throw new InvalidOperationException("不支持的私钥类型");
    }

    private string GetEncryptionAlgorithm(X509Certificate2 cert)
    {
        if (cert.PublicKey.Oid.FriendlyName.Equals("RSA", StringComparison.OrdinalIgnoreCase))
            return "RSA";
        
        if (cert.PublicKey.Oid.Value.Equals("1.2.840.10045.2.1", StringComparison.OrdinalIgnoreCase) ||
            cert.PublicKey.Oid.FriendlyName.Equals("ECC", StringComparison.OrdinalIgnoreCase))
            return "ECDSA";

        throw new InvalidOperationException("不支持的密钥算法");
    }
}

修改你的签名代码 #

把原来代码里创建IExternalSignature的部分替换成这个自定义类就行：

// 删掉原来的这两行：
// var pk = Org.BouncyCastle.Security.DotNetUtilities.GetKeyPair(certificate.PrivateKey).Private;
// IExternalSignature externalSignature = new PrivateKeySignature(pk, "SHA-1");

// 改成下面的代码，推荐用SHA-256（SHA-1已经被淘汰了）
IExternalSignature externalSignature = new X509Certificate2Signature(certificate, "SHA-256");

关键注意事项 #

• 哈希算法选型：别再用SHA-1了，现在PDF签名的主流要求是SHA-256及以上，兼容性和安全性都更好。
• 智能卡权限：运行程序时会弹出智能卡PIN输入框，要确保当前用户有访问智能卡的权限，且智能卡没有被锁定。
• BouncyCastle依赖：还是要保留BouncyCastle库，iText 7的证书链处理、CMS封装等逻辑依然依赖它，我们只是把私钥签名的部分交给Windows API处理了。

替换后你的签名流程应该就能正常工作了，不需要导出私钥，直接调用智能卡的硬件签名能力。

内容的提问来源于stack exchange，提问作者Josh S.M.