- 满足 CA/B 规范密钥托管要求 密钥在 Azure 托管 HSM 内部生成,私钥无法导出,硬件模块满足 FIPS 140-2 Level 2 及以上标准,符合当前 OV、EV 代码签名证书的密钥管控规则,GlobalSign 签发证书时可正常通过合规校验。
- 无物理硬件依赖,适配弹性 CI 流水线 不需要 USB 安全令牌,不存在硬件插拔、识别异常、PIN 缓存超时、令牌丢失等运维问题;可直接在 GitHub Actions、Azure DevOps 一次性临时 Runner 中运行,支持构建节点弹性扩缩容。
- 密钥集中管控,权限体系精细 依托 Azure RBAC 与密钥访问策略,遵循最小权限原则分配签名权限;支持多证书、多产品线在同一个托管 HSM 内隔离存放,方便多团队共享签名能力;支持托管标识免密钥认证,减少静态凭据泄露风险Microsoft ...。
- 自带完整审计与密钥生命周期能力 Azure Key Vault 会记录每一次签名调用日志,可对接审计平台追溯调用方、时间;支持密钥版本管理、软删除、清除保护、备份恢复,便于企业落地代码签名审计流程,满足内控与合规审计要求。
- Azure 生态原生适配 和 Azure DevOps、Azure 虚拟机、容器服务等组件打通,使用 AzureSignTool 对接,命令风格贴近 signtool,开发人员学习成本低;支持私有端点接入,可在企业内网 VPC 内封闭访问 HSM,缩小密钥访问暴露面Microsoft ...。
- 高可用托管 HSM,降低硬件运维负担 HSM 集群由 Azure 负责维护、故障转移、补丁更新,企业不用自行部署、维护本地 HSM 硬件,规避单点故障风险,签名服务稳定性由云侧 SLA 保障Microsoft ...。
- 签名链路标准化,上手门槛平稳 沿用 Authenticode 签名流程,搭配 GlobalSign 官方 RFC3161 时间戳;签名后依旧使用 signtool 完成验签,原有基于 signtool 的发布流程改动较小。
- 密钥归属客户侧,管控自主性更强
私钥载体为客户自己 Azure 订阅内的托管 HSM,密钥生命周期由客户自主管理,区别于 GlobalSign CSC 方案(密钥存放在 GlobalSign HSM),适合对密钥属地、自主管控有要求的组织。
一、前期准备清单
- Azure 订阅,创建 Managed HSM(托管 HSM),不是普通 Key Vault;
- Azure AD 服务主体(用于 CI 调用),后续分配密钥签名权限;
- GlobalSign OV/EV 代码签名订单,选择外部提交 CSR 模式;
- 构建环境:.NET SDK(用于安装 AzureSignTool)、Windows SDK(signtool 用于验签);
- 网络出口:构建节点可访问 Azure Managed HSM 地址、GlobalSign 时间戳地址;
- 时间戳地址
- R45 根:
http://timestamp.globalsign.com/tsa/r45standard - R6 根:
http://timestamp.globalsign.com/tsa/r6advanced1
- R45 根:
二、步骤 1:在 Azure 托管 HSM 生成证书请求(CSR)
- 进入 Azure 托管 HSM 资源,左侧菜单选择【证书】→【生成 / 导入】
- 创建方式:生成;CA 类型选择:由非集成 CA 颁发的证书
- 填写:证书名称(HSM 内标识名,后续 AzureSignTool 要用)、主体(OV 代码签名填写企业规范主体信息)、密钥类型选择 RSA-HSM,密钥长度 4096
- 提交创建,证书状态变为 “待颁发”
- 进入【证书操作】页面,下载 CSR 文本(base64 格式)Microsoft ...
重点:密钥必须由 HSM 内部生成,不能本地生成密钥再导入,否则不满足 CA/B 基线规范。
三、步骤 2:提交 CSR 到 GlobalSign,完成证书审核签发
- 登录 GlobalSign 订单后台,新建 OV/EV 代码签名订单;
- 选择【上传 CSR】,粘贴从 Azure 托管 HSM 下载的 CSR 内容;
- 按 GlobalSign 要求完成企业身份验证、资料提交;
- 审核通过后,下载证书链(推荐下载 p7b 格式,包含证书 + 中间 CA)。
四、步骤 3:合并已签发证书到 Azure 托管 HSM
回到托管 HSM 对应证书条目 →【证书操作】→【合并已签名请求】,上传 GlobalSign 下发的 p7b 证书包; 合并完成后,证书状态变为已启用,公钥证书和 HSM 内私钥完成绑定。
五、步骤 4:配置 Azure 权限(服务主体最小权限)
- 在 Azure AD 新建应用注册(服务主体),记录:
ClientId、TenantId、ClientSecret; - 进入托管 HSM 访问策略,给该服务主体分配权限:
- 密钥权限:Sign(签名)、Get
- 证书权限:Get 不授予删除、导出密钥等权限,遵循最小权限原则GlobalSign;
- 可选:生产环境优先使用托管标识,免去静态 ClientSecret。
六、步骤 5:安装 AzureSignTool 签名工具
AzureSignTool 为.NET 全局工具,Windows、Linux(带.NET Runtime)均可安装
dotnet tool install --global AzureSignTool验证安装
azuresigntool --help七、步骤 6:执行签名命令
单文件签名
AzureSignTool sign ` -kvu "https://你的托管HSM名称.managedhsm.azure.net/" ` -kvc "HSM内证书名称" ` -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"批量签名(exe、msi、dll、sys)
AzureSignTool sign ` -kvu "https://你的托管HSM名称.managedhsm.azure.net/" ` -kvc "HSM内证书名称" ` -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参数说明
-kvu:Managed HSM URI,注意域名后缀是managedhsm.azure.net,不是vault.azure.net;-kvc:HSM 内证书名称,不是证书 CN;-tr:RFC3161 时间戳地址;禁止使用 signtool 旧版/t参数。
八、步骤 7:签名后校验(流水线必加)
普通程序验签
signtool verify /pa /v app.exe驱动 sys 文件验签(微软驱动策略)
signtool verify /kp /v app.sys校验成功输出
Successfully verified,代表签名、证书链、时间戳全部正常。九、接入 CI 流水线示例(GitHub Actions)
jobs: sign: runs-on: windows-latest env: VAULT_URI: ${{ secrets.MHSM_URI }} CERT_NAME: ${{ secrets.CERT_NAME }} CLIENT_ID: ${{ secrets.AZ_CLIENT_ID }} CLIENT_SECRET: ${{ secrets.AZ_CLIENT_SECRET }} TENANT_ID: ${{ secrets.AZ_TENANT_ID }} steps: - uses: actions/checkout@v4 - name: Setup .NET uses: actions/setup-dotnet@v4 with: dotnet-version: 8.0.x - name: Install AzureSignTool run: dotnet tool install --global AzureSignTool - name: Sign artifacts 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 - name: Verify signature run: signtool verify /pa /v dist/app.exe特性:支持一次性临时 Runner,不需要常驻机器、不需要 USB UKey。
十、运维与风险提示
- 凭证管控:ClientSecret 属于敏感信息,全部放入 CI Secret,禁止明文写入代码;生产环境优先托管标识;
- 日志审计:开启 Managed HSM 日志,接入 Log Analytics,记录每一次签名调用;
- 证书链问题:合并时尽量上传完整 p7b 证书包,缺少中间证书会出现信任异常;
- 时间戳匹配:R45 证书搭配 R45 时间戳地址,R6 证书搭配 R6 地址,不要混用;
- 格式限制:AzureSignTool 主打 Windows PE 文件签名(exe/msi/dll/sys),不原生支持 JAR 包签名;JAR 签名建议选用 GlobalSign CSC 或 UKey PKCS#11 方案;
- 费用:Azure 托管 HSM 会产生资源使用费与密钥操作调用费用。