XLSM 文件签名难题：Signtool 与 OfficeSips 详解

XLSM 文件签名难题：OfficeSips 与 Signtool

在对启用宏的 Excel 文件（XLSM）进行数字签名时，一些开发者可能会遇到 “Signtool 无法识别文件格式” 的问题。 此问题通常源于签名工具无法正确识别 XLSM 文件的特殊结构。这篇博客将探讨常见原因及相应的解决措施。

常见问题原因分析

• OfficeSips 未正确安装或注册： Microsoft Office Signature Provider（OfficeSips） 是使 Signtool 可以识别并签名 Office 文件的关键组件。 若安装不当、注册缺失，或者文件路径配置有误，Signtool 便无法正确工作。
• 注册表设置错误： HKLM\SOFTWARE\Microsoft\VBA 路径下的 Vbe71DllPath 键用于告知 Office Sips 相关动态链接库的位置。 该键值若不正确或者缺失也会影响签名。
• SignTool 默认配置问题： SignTool 默认情况下可能不理解 XLSM 文件类型。 这需要额外的配置和设置才能顺利完成签名流程。

解决方案一：OfficeSips 手动注册和路径配置

正确的 OfficeSips 安装和注册是成功签名的前提。 以下步骤确保这些关键组件就位。

操作步骤：

1. 复制文件： 将 msosip.dll 和 msosipx.dll 复制到你的系统目录中 (例如， C:\Program Files\OfficeSips )，建议创建一个专门的目录存放。
2. 注册 DLL： 使用管理员权限打开命令提示符，切换到放置 dll 文件的目录。 执行以下命令分别注册这两个 DLL 文件：

regsvr32 msosip.dll
regsvr32 msosipx.dll

3. 创建注册表项： 若注册表中不存在 HKLM\SOFTWARE\Microsoft\VBA， 则手动创建。
4. 添加 Vbe71DllPath 键： 在 HKLM\SOFTWARE\Microsoft\VBA 路径下添加一个类型为 REG_SZ 的键值 Vbe71DllPath。
5. 设置键值： 将其键值设为 msosip.dll 的完整路径，例如： C:\Program Files\OfficeSips\msosip.dll。

原理说明:

此方案的关键在于，regsvr32 命令会注册 DLL 文件，让 Windows 操作系统知道这两个文件负责什么操作。同时，通过注册表项和 Vbe71DllPath ，为 OfficeSips 提供正确的库文件路径，使得它可以被加载。

解决方案二：指定 SignTool 的签名类型

一些情况下，默认的 SignTool 设置可能无法正确识别 XLSM 文件。 通过指定签名类型可以有效解决。

操作步骤：

1. 修改 SignTool 命令： 在调用 Signtool 时， 使用 -c 或 -v 参数显式指定要签名的文件的签名类型为 office 或者 -as指定签名类型。

   signtool sign /v /as "Office"  /f "path_to_your_certificate.pfx" /p "your_password" "path_to_your_xlsm_file.xlsm"
   

 signtool sign -v /c  "Office"  /f "path_to_your_certificate.pfx" /p "your_password" "path_to_your_xlsm_file.xlsm"

path_to_your_certificate.pfx: 你证书文件的路径；your_password: 证书文件的密码；path_to_your_xlsm_file.xlsm ： 你要签名的XLSM文件的路径。

原理说明：

Signtool sign /as "Office" 明确告诉 Signtool 使用 “Office” 签名类型，它对应的是 OfficeSips提供的签名能力。 -c 和 /v 可以打印一些更加详细的签名日志信息。 这有助于诊断签名过程中的问题。

安全提示

• 证书安全： 确保你的证书文件（ .pfx）存储在安全位置，防止未授权访问。
• 证书密码： 不要在命令行中直接明文传递证书密码，可以考虑使用环境变量或证书存储，增加安全性。
• 签名测试： 在签名大型发布版本前，请先在测试环境验证签名是否生效，避免潜在的问题。

以上方法基本可以解决 XLSM 文件签名难题。 如遇到其他特殊情况，可以查看相关的官方文档和社区讨论寻求帮助。希望以上方案可以帮助到你。