一、方案概述
GlobalSign OV、EV 代码签名证书支持将密钥部署在 Azure Key Vault 托管 HSM 内,属于客户侧托管 HSM 方案,硬件 HSM 资源由客户在 Azure 订阅中自行准备GlobalSign。 整体流程:在 Azure Key Vault 内生成 RSA 密钥对并导出 CSR,CSR 提交 GlobalSign 完成证书审核签发,之后将签发后的证书链合并回 Azure Key Vault,密钥与证书绑定存储在 Azure HSM。 签名链路依托 Azure 密钥接口,主流工具为 AzureSignTool,适配 CI/CD 流水线,无需物理 UKey 硬件。 配套 RFC3161 时间戳地址:
- R45 标准根:
http://timestamp.globalsign.com/tsa/r45standard - R6 高级根:
http://timestamp.globalsign.com/tsa/r6advanced1
适用场景:已经深度使用 Azure 云体系、需要弹性 CI(GitHub 托管 Runner、Azure DevOps 临时 Agent)、多团队集中管控签名凭证、不想维护大量 USB 硬件令牌的团队。 不适用场景:无 Azure 订阅、严格内网隔离且无法出站访问 Azure Key Vault 服务。
和前面 UKey PKCS#11 方案核心差异:UKey 是本地硬件芯片运算;Azure Key Vault 方案是文件摘要上传至 Azure 云端 HSM 完成签名运算;二者都不属于 GlobalSign 自有 HSM。
二、完整工作流程
- 在 Azure Key Vault(托管 HSM 类型)创建密钥,选择 RSA-HSM 类型,由 Azure HSM 内部生成密钥对,输出 CSR;
- 将 CSR 提交 GlobalSign 订单,完成 OV/EV 身份审核;
- 审核通过后下载证书以及中间 CA 证书链,回到 Azure Key Vault 执行【合并已签名请求】,把公钥证书绑定到 HSM 内私钥;
- 在 Azure AD 创建服务主体,分配 Key Vault【密钥签名权限】,获取 TenantId、ClientId、ClientSecret;
- CI 构建节点安装 AzureSignTool,使用服务主体凭证调用 Azure Key Vault 接口;
- AzureSignTool 本地计算文件摘要,调用 Azure Key Vault 签名接口,由 Azure HSM 完成签名运算;
- 取回签名结果,附加 GlobalSign RFC3161 时间戳,封装 Authenticode 签名结构;
- 流水线执行验签步骤,校验签名、证书链、时间戳有效性。
三、环境准备清单
- Azure 订阅,创建托管 HSM Key Vault(普通标准 Key Vault 不满足 CA/B 硬件密钥要求);
- Azure AD 服务主体,授予
Microsoft.KeyVault/vaults/keys/sign/action权限; - GlobalSign OV/EV 代码签名证书订单,使用 Azure 生成的 CSR 提交;
- 签名工具:AzureSignTool(.NET 工具);验签工具:signtool.exe;
- 网络:构建节点可访问 Azure Key Vault 域名、GlobalSign 时间戳服务;
- 敏感信息:Key Vault URI、证书名称、TenantId、ClientId、ClientSecret,统一放在 CI Secret 管理。
四、AzureSignTool 安装与签名命令(Windows CI 主推)
安装 AzureSignTool
dotnet tool install --global AzureSignTool
基础签名命令
AzureSignTool sign `
-kvu "https://你的vault名称.vault.azure.net/" `
-kvc "证书在KeyVault内的名称" `
-kvi "Azure AD Client ID" `
-kvs "Azure AD Client Secret" `
--azure-key-vault-tenant-id "Tenant ID" `
-tr http://timestamp.globalsign.com/tsa/r45standard `
-td sha256 `
-fd sha256 `
-v `
"app.exe"
批量签名
AzureSignTool sign `
-kvu "https://你的vault名称.vault.azure.net/" `
-kvc "证书在KeyVault内的名称" `
-kvi "Azure AD Client ID" `
-kvs "Azure AD Client Secret" `
--azure-key-vault-tenant-id "Tenant ID" `
-tr http://timestamp.globalsign.com/tsa/r45standard `
-td sha256 `
-fd sha256 `
-v `
*.exe *.msi *.dll *.sys
签名后验签(signtool)
signtool verify /pa /v app.exe
驱动类 sys 文件验签:
signtool verify /kp /v app.sys
五、Linux 环境适配说明
AzureSignTool 原生基于.NET,Linux 环境可以安装.NET Runtime 后运行;但 Linux 下 AzureSignTool 仅支持 Authenticode PE 文件签名,不原生支持 JAR。 JAR 包签名场景,该方案没有开箱即用的 jarsigner PKCS#11 链路;JAR 签名优先考虑 GlobalSign CSC 接口或者 UKey PKCS#11 方案。
六、CI 流水线配置要点(Azure DevOps / GitHub Actions)
该方案支持一次性托管 Runner,不需要常驻构建机、不需要挂载 USB 硬件,是对比 UKey 方案优势。 示例 GitHub Actions 片段:
- name: Install AzureSignTool
run: dotnet tool install --global AzureSignTool
- name: Sign artifact
env:
VAULT_URI: ${{ secrets.VAULT_URI }}
CERT_NAME: ${{ secrets.CERT_NAME }}
CLIENT_ID: ${{ secrets.AZ_CLIENT_ID }}
CLIENT_SECRET: ${{ secrets.AZ_CLIENT_SECRET }}
TENANT_ID: ${{ secrets.AZ_TENANT_ID }}
run: |
AzureSignTool sign `
-kvu $env:VAULT_URI `
-kvc $env:CERT_NAME `
-kvi $env:CLIENT_ID `
-kvs $env:CLIENT_SECRET `
--azure-key-vault-tenant-id $env:TENANT_ID `
-tr http://timestamp.globalsign.com/tsa/r45standard `
-td sha256 `
-fd sha256 `
-v `
dist/app.exe
权限管控提示:
- 生产环境不建议长期使用 ClientSecret;可改用 Azure 托管标识,在 Azure DevOps、Azure 虚拟机内免密钥认证;
- 权限遵循最小权限原则,服务主体仅授予签名权限,禁止授予密钥导出、删除权限;
- 可以开启 Key Vault 日志审计,记录每一次签名调用来源与时间。
七、方案可参考优势
- 无物理硬件依赖,适配弹性临时 CI Runner,流水线扩缩容友好;
- 密钥集中托管在 Azure HSM,支持权限 RBAC、操作审计、软删除、密钥版本管理;
- 一套 Key Vault 内可存放多枚 GlobalSign 代码签名证书,方便多产品线隔离;
- 签名能力标准化,Azure 生态打通,Azure DevOps、VM、容器环境都可接入;
- 不存在 UKey 掉线、USB 识别、PIN 缓存超时这类硬件运维问题。
八、需要留意的局限
- 依赖 Azure Key Vault 服务可用性,签名链路需要出站访问 Azure;内网完全隔离场景不适合;
- 托管 HSM 属于 Azure 付费资源,会产生 Key Vault 存储与密钥操作费用;
- EV 证书使用该方案时,仍需要满足 CA/B 对 EV 的身份管控、操作人审计要求;
- 对 JAR、其他非 PE 格式文件签名支持弱,主要面向 Windows 可执行程序;
- 凭证泄露风险:服务主体凭据如果泄露,他人可调用 HSM 执行签名,需要严格保管。
九、和 GlobalSign UKey PKCS#11、GlobalSign CSC 方案简要对照
- Azure Key Vault HSM 方案:私钥在 Azure HSM,AzureSignTool 调用;无硬件、适合弹性云 CI;密钥由客户 Azure 侧管理;
- UKey PKCS#11 方案:私钥在本地 USB 令牌芯片;常驻构建机;签名运算本地完成;
- GlobalSign CSC 云签名方案:私钥在 GlobalSign 自有 HSM;标准 CSC 接口;GlobalSign 侧管控密钥与凭证。
十、常见排错提示
- 普通 Key Vault(非托管 HSM)生成的密钥不满足 CA/B 规范,证书审核会被驳回;必须选择 RSA-HSM 密钥类型;
- CSR 生成位置必须在 Azure HSM 内部,本地生成 CSR 再导入密钥不满足规范;
- 证书合并操作失败:检查证书链是否完整,必须包含 GlobalSign 中间证书;
- 签名返回权限拒绝:核对服务主体密钥 sign 权限、网络出站策略;
- 时间戳信任报错:核对证书归属根链,R45 与 R6 时间戳地址不要混用。