如何在C#中使用BouncyCastle与PgpCore管理多私钥解密GPG文件

核心思路 #

GPG加密文件中会嵌入收件人公钥的密钥ID，我们可以先从加密文件中提取该ID，再与本地存储的私钥ID匹配，自动选择对应私钥完成解密。

实现步骤 #

1. 定义私钥元数据结构 #

创建类存储私钥关键信息，方便统一管理：

public class PrivateKeyEntry
{
    // 私钥的密钥ID（十六进制字符串，如"1234ABCD"）
    public string KeyId { get; set; }
    // 初始化完成的EncryptionKeys实例
    public EncryptionKeys Keys { get; set; }
}

2. 加载所有私钥并构建私钥列表 #

批量加载本地私钥，提取每个私钥的ID并存储：

// 构建私钥列表，建议从安全配置（如加密配置文件、密钥管理服务）读取路径和密码
var privateKeys = new List<PrivateKeyEntry>
{
    new PrivateKeyEntry
    {
        KeyId = GetKeyIdFromPrivateKey(new FileInfo("key1.asc"), "password1"),
        Keys = new EncryptionKeys(new FileInfo("key1.asc"), "password1")
    },
    new PrivateKeyEntry
    {
        KeyId = GetKeyIdFromPrivateKey(new FileInfo("key2.asc"), "password2"),
        Keys = new EncryptionKeys(new FileInfo("key2.asc"), "password2")
    },
    new PrivateKeyEntry
    {
        KeyId = GetKeyIdFromPrivateKey(new FileInfo("key3.asc"), "password3"),
        Keys = new EncryptionKeys(new FileInfo("key3.asc"), "password3")
    }
};

// 辅助方法：从私钥文件提取密钥ID
private static string GetKeyIdFromPrivateKey(FileInfo privateKeyFile, string password)
{
    using var stream = privateKeyFile.OpenRead();
    var keys = new EncryptionKeys(stream, password);
    // 将密钥ID转为大写十六进制字符串，统一匹配格式
    return keys.PrivateKey.KeyId.ToString("X8");
}

3. 从加密文件提取收件人密钥ID #

读取加密文件元数据，获取加密时使用的公钥对应的密钥ID：

private static string GetRecipientKeyIdFromEncryptedFile(FileInfo encryptedFile)
{
    using var inputStream = encryptedFile.OpenRead();
    var pgpObjectFactory = new PgpObjectFactory(PgpUtilities.GetDecoderStream(inputStream));
    
    PgpObject pgpObj;
    while ((pgpObj = pgpObjectFactory.NextPgpObject()) != null)
    {
        if (pgpObj is PgpEncryptedDataList encryptedDataList)
        {
            foreach (PgpPublicKeyEncryptedData encryptedData in encryptedDataList.GetEncryptedDataObjects())
            {
                // 返回收件人公钥的密钥ID（大写十六进制）
                return encryptedData.KeyId.ToString("X8");
            }
        }
    }
    throw new InvalidOperationException("无法从加密文件中提取收件人密钥ID");
}

4. 匹配私钥并执行解密 #

结合上述方法自动匹配私钥，完成解密操作：

// 目标加密文件与解密后输出文件
var inputFile = new FileInfo("file2.gpg");
var decryptedFile = new FileInfo("file2.txt");

// 获取加密文件对应的收件人密钥ID
string recipientKeyId = GetRecipientKeyIdFromEncryptedFile(inputFile);

// 匹配本地私钥
var matchedKey = privateKeys.FirstOrDefault(k => k.KeyId.Equals(recipientKeyId, StringComparison.OrdinalIgnoreCase));
if (matchedKey == null)
{
    throw new InvalidOperationException($"未找到匹配密钥ID {recipientKeyId} 的私钥");
}

// 使用匹配到的私钥解密
PGP pgp = new PGP(matchedKey.Keys);
await pgp.DecryptFileAsync(inputFile, decryptedFile);

额外优化建议 #

• 安全存储：禁止硬编码私钥路径与密码，优先使用环境变量、本地加密配置或专业密钥管理服务读取敏感信息。
• 缓存复用：对已加载的EncryptionKeys实例进行缓存，避免重复解析私钥文件提升性能。
• 异常处理：添加解密失败的重试逻辑，或批量处理时跳过无法匹配/解密失败的文件，避免流程中断。

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