Linux/FreeBSD下调用HSM密钥签名Authenticode PE文件方案咨询

核心思路是将Authenticode签名流程彻底解耦，把「PE结构解析、待签内容哈希计算、签名结构组装、签名写入PE」和「私钥签名哈希」两个环节完全拆分，全程不需要签名工具直接访问私钥，仅在哈希签名环节调用你已有的Python HSM对接工具即可，完全不需要依赖Windows环境或Thales Windows版工具。

可选落地路径 #

路径1：改造现有开源签名工具（改动量最小，稳定性最高） #

你提到的几款开源工具里，优先选uefisign或osslsigncode做二次改造，不需要从零实现PE解析和签名结构逻辑：

• 若仅需签名UEFI Secure Boot场景的EFI二进制，优先选uefisign：该工具本身为EFI PE签名设计，代码量小、逻辑耦合度低，你仅需要定位到代码中调用OpenSSL执行私钥签名的函数，将逻辑替换为：
  • 将函数入参中已经计算好的待签哈希写入临时管道/文件
  • 调用你已有的Python HSM对接脚本，传入哈希值、签名算法参数
  • 读取脚本返回的裸签名二进制内容，作为函数返回值交还给后续签名组装流程
    整体代码改动量通常不超过100行，不需要改动PE解析、哈希计算、签名写入的核心逻辑。
• 若需要支持双签名、RFC3161时间戳、Catalog签名等高级Authenticode特性，选2.x版本的osslsigncode：该版本已经将签名流程拆分为哈希计算、签名生成、签名嵌入三个独立模块，你既可以通过修改签名回调函数接入HSM签名逻辑，也可以直接复用它的哈希计算输出能力，单独完成签名注入。

不建议选择sbsign/pesign作为改造基础，这两个工具和NSS证书库绑定深度高，拆分签名逻辑的改动量远大于前两个工具。

路径2：纯Python实现全流程（和现有HSM对接逻辑适配性最好） #

如果不想维护C代码改造，可以直接用Python生态库实现全流程，和你已有的HSM对接Python代码无缝衔接：

• PE结构解析直接用pefile库，该库对EFI使用的PE32+格式支持成熟，不需要自行实现PE头、节表、数据目录的解析逻辑。
• 按照微软Authenticode规范计算待签哈希：计算范围需要排除PE可选头的CheckSum字段、Certificate Table数据目录条目本身、以及PE文件末尾追加的签名数据，其余内容按顺序逐块计算哈希即可。
• 用cryptography库组装PKCS#7 SignedData结构中的Authenticated Attributes集合，填入Authenticode签名OID、PE文件哈希、签名时间等必要属性后做DER编码，对编码结果再做一次哈希，这个最终哈希值就是需要传给HSM签名的内容。
• 调用你已有的HSM对接Python脚本，传入上述哈希值和对应签名算法，拿到HSM返回的裸签名值。
• 回到cryptography库组装完整的PKCS#7 SignedData结构：将签名证书链填入证书字段，将HSM返回的签名值填入SignerInfo的签名字段，不需要执行任何私钥操作。
• 最后通过pefile库更新PE可选头的Certificate Table目录项偏移和长度，将组装好的PKCS#7签名结构按8字节对齐追加到PE文件末尾，重新计算PE校验和写回可选头，即完成签名。

关键避坑点 #

• EFI使用的PE32+格式和普通32位PE的哈希排除范围一致，但要注意节表加载后的内存对齐和文件对齐差异，必须按文件偏移计算哈希，不能按内存偏移计算，否则UEFI固件验签会失败。
• 调用HSM签名时必须显式指定和哈希计算阶段一致的签名算法：比如用SHA256计算的哈希，必须指定SHA256withRSA或SHA256withECDSA（匹配你的密钥类型），不能使用HSM默认签名算法，否则组装后的PKCS#7结构无法通过验签。
• 若需要添加RFC3161时间戳，全程不需要访问私钥：仅需对HSM返回的签名值计算哈希，发送给公共/私有时间戳服务拿到时间戳令牌，将令牌填入PKCS#7结构的非授权属性字段即可。
• 签名完成后可以先用sbverify工具在Linux环境下做本地验签，确认签名结构合法后再做UEFI启动测试，减少调试成本。

最小验证流程 #

你可以先拿测试EFI文件走通最小闭环验证流程正确性：

1. 用改造后的工具或Python脚本输出待签哈希值
2. 手动调用现有HSM Python工具完成哈希签名，拿到签名二进制
3. 将签名值注入签名结构写入PE文件
4. 执行sbverify --cert 你的签名公钥证书.crt test.efi，如果返回验签通过，说明整个流程逻辑正确。

该方案下私钥全程不离开HSM，所有组件均可运行在Linux/FreeBSD平台，不需要额外采购Windows授权，也不需要适配Thales的Windows端工具。

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