PyOpenSSL导出CA/客户端证书私钥为PKCS#12链报bad decrypt错误

问题复现代码 #

原有导出逻辑实现如下：

def pem_to_pfx(self, pem_ca_path, pem_path, encrypted_key_path, new_pw, p12_path):
    with open(encrypted_key_path, 'rb') as f:
        encrypted_key_file = f.read()
    with open(pem_ca_path, 'r') as f:
        ca_cert_file = f.read()
    with open(pem_path, 'r') as f:
        user_cert_file = f.read()
    ca_cert = crypto.load_certificate(crypto.FILETYPE_PEM, ca_cert_file)
    user_cert = crypto.load_certificate(crypto.FILETYPE_PEM, user_cert_file)
    encrypted_key = crypto.load_privatekey(crypto.FILETYPE_PEM, encrypted_key_file, passphrase=new_pw.encode('ascii'))
    p12 = OpenSSL.crypto.PKCS12()
    p12.set_privatekey(encrypted_key)
    p12.set_ca_certificates(ca_cert)
    p12.set_certificate(user_cert)
    open(p12_path, 'wb').write(p12.export(passphrase=new_pw))

运行时抛出错误：

line 54, in exception_from_error_queue
    raise exception_type(errors)
OpenSSL.crypto.Error: [('Provider routines', '', 'bad decrypt'), ('PKCS12 routines', '', 'pkcs12 cipherfinal error'), ('Provider routines', '', 'bad decrypt'), ('PKCS12 routines', '', 'pkcs12 cipherfinal error')]

已知前置条件：私钥为前置流程通过PKCS#8 AES-256-CBC算法生成的加密私钥。

故障原因 #

故障由两处核心参数错误导致：

• 私钥解密密码不匹配：代码加载加密私钥时，直接传入PFX文件的导出密码new_pw作为私钥的解密密码，但PKCS#8加密私钥的解密密码是生成私钥时独立设置的，和PFX导出密码不是同一个参数，密码错误直接触发bad decrypt报错。
• CA证书参数类型错误：set_ca_certificates方法要求传入X509证书对象的列表，即使只有1张CA证书也需要包装为序列传入，直接传入单个证书对象会导致内部序列化逻辑异常。
• 次要兼容问题：读取证书文件使用文本模式、密码编码使用ASCII、写文件未做上下文管理，在密码包含非ASCII字符、不同系统编码环境下可能触发额外异常。

修复方案 #

1. 函数新增私钥原始加密密码入参，加载私钥时传入该密码完成解密，PFX导出密码仅在最终导出p12文件时传入。
2. 将CA证书包装为列表后传入set_ca_certificates方法。
3. 统一文件读写为二进制模式，密码编码改用UTF-8，使用with语句管理文件IO避免资源泄漏。
4. 若使用OpenSSL 3.0+版本，可在导出时调高迭代次数，避免旧默认配置被安全策略拦截。

修复后可正常运行的代码：

from OpenSSL import crypto

def pem_to_pfx(self, pem_ca_path, pem_path, encrypted_key_path, key_pwd, pfx_pwd, p12_path):
    # 统一使用二进制模式读取所有PEM文件，避免编码兼容问题
    with open(encrypted_key_path, 'rb') as f:
        key_data = f.read()
    with open(pem_ca_path, 'rb') as f:
        ca_cert_data = f.read()
    with open(pem_path, 'rb') as f:
        user_cert_data = f.read()

    # 加载证书与私钥
    ca_cert = crypto.load_certificate(crypto.FILETYPE_PEM, ca_cert_data)
    user_cert = crypto.load_certificate(crypto.FILETYPE_PEM, user_cert_data)
    # 传入私钥本身的加密密码完成解密，无密码则传None
    private_key = crypto.load_privatekey(
        crypto.FILETYPE_PEM,
        key_data,
        passphrase=key_pwd.encode('utf-8') if key_pwd else None
    )

    # 组装PKCS12结构
    p12 = crypto.PKCS12()
    p12.set_privatekey(private_key)
    p12.set_certificate(user_cert)
    # CA证书必须以列表形式传入
    p12.set_ca_certificates([ca_cert])

    # 导出PFX文件，使用with管理写操作
    with open(p12_path, 'wb') as f:
        f.write(p12.export(passphrase=pfx_pwd.encode('utf-8'), iter=2048, maciter=2048))

额外说明 #

• 如果生成私钥时未设置独立密码，加载私钥时passphrase参数直接传None即可。
• 若修复参数后仍报解密错误，可将pyOpenSSL升级到22.0.0以上版本，低版本对PKCS#8格式的AES-256-CBC加密私钥兼容性较差。

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