Documenso项目关于PKCS12证书AES-256-CBC加密算法的兼容性问题分析

问题背景

在Documenso电子签名系统中，用户报告了一个与PKCS12格式数字证书相关的兼容性问题。该问题主要出现在使用OpenSSL 3.x版本生成的证书文件上，具体表现为系统无法正确处理采用AES-256-CBC作为PBE(基于密码的加密)算法的PKCS12证书。

技术细节解析

PKCS12是一种常见的证书存储格式，它使用PBE算法来保护私钥和证书数据。随着OpenSSL从1.x升级到3.x版本，默认的加密算法发生了变化：

• OpenSSL 1.x版本默认使用RC2-40-CBC算法
• OpenSSL 3.x版本默认升级为更安全的AES-256-CBC算法

Documenso当前版本(1.5.3和1.5.4-rc.3)的签名功能在处理采用AES-256-CBC加密的PKCS12证书时会出现"Failed to get private key bags"错误，导致文档签名过程失败。

问题重现

用户可以通过以下方式重现该问题：

1. 使用OpenSSL 3.x生成PKCS12证书：

openssl pkcs12 -export -out cert-aes256cbc.p12 -inkey private.key -in certificate.crt -keypbe aes-256-cbc -certpbe aes-256-cbc

2. 在Documenso系统中使用该证书进行文档签名时，系统会报错并无法完成签名过程。

临时解决方案

目前有两种可行的临时解决方案：

1. 在生成PKCS12证书时使用-legacy参数强制使用旧版加密方式：

openssl pkcs12 -export -out cert.p12 -inkey key.pem -in cert.pem -legacy

2. 使用OpenSSL 1.x版本生成证书（如CentOS 7系统），该版本默认使用兼容的RC2-40-CBC算法。

长期解决方案建议

从技术发展角度看，Documenso项目应考虑升级其证书处理模块，以支持更现代的AES-256-CBC加密算法。这涉及到底层加密库的更新和测试工作。

对于项目维护者而言，建议：

1. 在文档中明确说明当前版本对PKCS12加密算法的支持情况
2. 将支持AES-256-CBC算法纳入后续版本开发计划
3. 考虑使用更现代的证书处理库，以保持与最新安全标准的兼容性

影响范围评估

该问题主要影响：

• 使用现代Linux发行版（如RHEL9、Fedora 39等）的用户
• 从商业CA机构（如Sectigo）获取的采用新标准加密的证书
• 任何使用OpenSSL 3.x版本工具生成PKCS12证书的场景

对于Documenso项目而言，随着操作系统和加密工具的不断升级，这个问题的影响面可能会逐步扩大，因此及时解决具有重要性。