如何使用HSM中存储的私钥完成HLKX包签名

报错根因说明 #

调用官方示例Sign方法触发System.Security.Cryptography.CryptographicException: 'Cannot locate the selected digital certificate.'属于预期报错：

• 官方HLK签名逻辑默认要求签名证书必须安装到Windows证书存储，且绑定可被系统直接访问的私钥句柄（私钥要么存本地，要么直连当前机器的CSP/CNG KSP可直接枚举调用）
• 你的场景中本地仅持有公钥证书，私钥在无直连的HSM中，系统无法获取私钥访问入口，自然会抛出证书找不到的异常
• 不需要折腾自定义CSP DLL方案：该方案仅适用于HSM直连签名机的场景，需要实现完整的CNG KSP接口规范，还要配置证书与私钥容器的映射关系，对接离线Vault场景开发维护成本极高，投入产出比极低，完全没必要走这条路。

HLKX签名适配逻辑 #

HLKX是标准OPC（Open Packaging Conventions）格式包，和Appx、Office Open XML格式结构完全一致，签名逻辑不是对单文件做Authenticode签名，而是对包内所有指定部件生成哈希，将签名元数据、签名值写入包内固定路径的签名节点，完全可以复用你之前signtool离线签名的「生成摘要-外部签名-回填签名值」三段式流程，不需要依赖官方封装的Sign方法。

具体实现步骤 #

1. 提取HLKX待签名摘要 #

直接使用系统内置的System.IO.Packaging类库实现包解析，不需要手动处理ZIP结构和签名规则：

// 以读写模式打开HLKX包
using Package package = Package.Open("target.hlkx", FileMode.Open, FileAccess.ReadWrite);
PackageDigitalSignatureManager sigMgr = new PackageDigitalSignatureManager(package)
{
    // 配置公钥证书嵌入签名块，和官方签名行为对齐
    CertificateOption = CertificateEmbeddingOption.InSignaturePart,
    // 强制使用SHA256，Win11 22H2及以上版本HLK已拒绝SHA1签名
    HashAlgorithm = HashAlgorithmName.SHA256
};
// 获取所有需要签名的包内部件列表，自动排除已存在的签名相关部件
List<Uri> partsToSign = sigMgr.GetPartsToSign().Select(p => p.Uri).ToList();
// 生成待签名的原始摘要值
byte[] signDigest = sigMgr.ComputeSignatureDigest(partsToSign, HashAlgorithmName.SHA256);

拿到的signDigest就是需要传递给HSM签名的哈希原文，直接对接Hashicorp Vault的签名接口即可，注意签名时配置：

• 哈希算法指定为SHA256，不要让Vault对传入值做二次哈希
• 签名填充规则使用PKCS#1 v1.5，匹配Windows代码签名标准格式

2. 获取HSM签名结果 #

复用你之前对接Vault做二进制离线签名的现有逻辑即可，将返回的base64格式签名值解码为原始字节数组备用，不需要做额外格式转换。

3. 回填签名值到HLKX包 #

不要调用会主动查找私钥的Sign()重载方法，直接传入外部生成的签名值完成写入：

// 加载本地持有的公钥证书文件
X509Certificate2 signCert = new X509Certificate2("sign_cert_public.cer");
// 直接传入外部生成的签名值完成签名注册
PackageDigitalSignature finalSig = sigMgr.Sign(
    partsToSign,
    signCert,
    // 传入上一步从Vault/HSM拿到的签名值字节数组
    hsmSignatureBytes,
    // 签名关系类型使用官方默认的数字签名关系
    PackageRelationship.GetRelationshipTypesBySemantic("digital-signature").First()
);
// 如需加时间戳，直接调用sigMgr.AddTimeStamp(finalSig, "你的时间戳服务地址")即可，时间戳请求无需访问私钥
// 保存修改后的包
package.Close();

验证方式：签名完成后直接用HLK管理器打开包，只要签名证书链受信任、签名值匹配摘要，就会被识别为有效签名，和本地私钥直接签名的效果完全一致。

避坑提示 #

• 不要尝试开发自定义CSP/KSP对接离线HSM：CNG KSP接口需要实现20+个导出函数，还要处理证书与私钥容器的绑定映射，离线场景还要额外做请求转发，稳定性差维护成本极高，上述纯应用层实现方案无系统组件依赖，适配成本极低。
• 本地生成摘要的哈希算法必须和HSM签名时指定的哈希算法完全一致，否则会出现签名验证失败。
• 不要修改HLKX包内任何非签名相关的部件内容，否则会破坏哈希校验导致签名失效。

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