代码签名证书申请与配置实战:标准版与 EV 版选型、signtool 签名、时间戳与报错排查
一、问题背景与根因:为什么你的 exe 会被 Windows 拦截
用户双击下载的安装包,SmartScreen 弹出“Windows 已保护你的电脑”,UAC 提示“未知发布者”,浏览器下载栏显示“此文件可能有危险”。这不是误报,而是缺少 Authenticode 数字签名时的默认行为:操作系统无法把二进制文件与一个经 CA 验证的法人实体关联,只能按零信誉处理。
根因可以拆成三层:
- 无签名即无身份链。Windows 通过 WinVerifyTrust 校验 PE 文件中的 PKCS#7 签名块,签名缺失时 Subject 为空,界面只能显示“未知发布者”,用户放弃安装的概率大幅上升。
- 无签名即无信誉。SmartScreen 依据“证书主体 + 文件哈希 + 下载量”建立信誉库,新证书从零开始累积;EV 代码签名证书验证等级更高,能更快获得初始信任。
- 内核驱动更严格。Windows 10 1607 之后,内核模式驱动必须经 Microsoft Partner Center attestation 签名或 WHQL 认证,仅购买一张 EV 代码签名证书并不能直接让 .sys 加载。
还有两条常被旧文章写错的事实:自 2023-06-01 起,CA/B Forum 把代码签名证书最长有效期压缩到 460 天(不再是 39 个月),并且私钥必须存放在 FIPS 140-2 Level 2 或 CC EAL4+ 的硬件(USB Token / 云 HSM)中,标准版也不能随意导出 .pfx。这与 TLS 证书 398 天上限、Let’s Encrypt 90 天是两套完全不同的规则,不要混用。
二、申请前准备:验证材料与 CSR 生成
GlobalSign 标准版代码签名证书走组织验证(OV),需要营业执照扫描件、申请人身份证、可接通的固定电话(CA 会电话回访核实),以及企业邮箱域名所有权验证;EV 版额外要求 3 年以上经营历史、法人或授权代表身份核验、注册地址核验,并通过快递寄送硬件 Token。
CSR 的 Subject 必须与营业执照英文名称严格一致,CN 通常写组织全称而不是个人姓名(个人开发者证书除外):
openssl genrsa -out codesign.key 3072
openssl req -new -key codesign.key -sha256 -out codesign.csr
-subj "/C=CN/ST=Guangdong/L=Shenzhen/O=Example Tech Co., Ltd./OU=IT/CN=Example Tech Co., Ltd./emailAddress=dev@example.com"
openssl req -in codesign.csr -noout -text -verify
输出末尾必须出现 verify OK,并确认 Signature Algorithm: sha256WithRSAEncryption、Public-Key: (3072 bit)。RSA 2048 仍可用,但 3072 位是当前更稳妥的选择。
如果购买 EV 版,私钥不能离开 Token,CSR 必须在 Token 内生成。用 SafeNet Authentication Client 初始化 Token 后生成密钥对与 CSR;也可用 certreq 指定 CSP:
certreq -new codesign.inf codesign.req
其中 inf 的 ProviderName 填 eToken Base Cryptographic Provider,KeyContainer 填 Token 内新建的容器名,Exportable 必须为 FALSE。生成的 .req 直接提交给 CA,私钥永远不会以文件形式保存。
三、完整实操:从导入证书到签名成功
以下流程以 Windows + Windows SDK 的 signtool 为例,工具路径通常是 C:Program Files (x86)Windows Kits10bin10.0.22621.0x64signtool.exe。
第 1 步:导入证书。标准版若以 .pfx 交付(部分 CA 的历史订单),导入当前用户存储:
certutil -f -p "PfxPassword" -importpfx codesign.pfx
第 2 步:确认证书与 EKU。代码签名 EKU 的 OID 是 1.3.6.1.5.5.7.3.3,缺这个 OID 的证书无法用于签名:
Get-ChildItem Cert:CurrentUserMy | Where-Object { $_.EnhancedKeyUsageList.ObjectId -eq "1.3.6.1.5.5.7.3.3" } | Format-List Subject,Thumbprint,NotAfter
第 3 步:单文件签名(PFX 方式)。必须同时指定 /fd sha256(文件摘要算法)与 /td sha256 /tr(RFC 3161 时间戳):
signtool sign /fd sha256 /td sha256 /tr http://timestamp.digicert.com /a /f codesign.pfx /p "PfxPassword" /d "Example App" .distMyApp.exe
第 4 步:Token 方式签名(EV / 新版标准版)。用 /n 按主体名选证书,用 /csp 与 /kc 指定硬件密钥容器和 PIN,容器名以 SafeNet 工具中显示的为准:
signtool sign /fd sha256 /td sha256 /tr http://timestamp.globalsign.com/tsa/r6advanced1 /n "Example Tech Co., Ltd." /csp "eToken Base Cryptographic Provider" /kc "[{{PIN}}]=123456" .distMyApp.exe
第 5 步:批量签名。安装包通常包含主程序、DLL 与卸载器,逐个签才不会被拦截:
signtool sign /fd sha256 /td sha256 /tr http://timestamp.digicert.com /n "Example Tech Co., Ltd." /csp "eToken Base Cryptographic Provider" /kc "[{{PIN}}]=123456" .dist*.exe .dist*.dll
第 6 步:Linux 构建机。用 osslsigncode 复刻同样的签名与时间戳,输出文件必须另存再替换:
osslsigncode sign -pkcs12 codesign.p12 -pass "PfxPassword" -h sha256
-n "Example App" -i https://example.com -ts http://timestamp.digicert.com
-in MyApp.exe -out MyApp-signed.exe
四、配置示例:把签名接入 CI 流水线
手工签名只适合发版,长期做法是接入流水线。注意:EV 证书私钥不可导出,CI 机器要么直连 Token(USB 签名代理机 / 签名服务器),要么改用云签名服务(GlobalSign Atlas、DigiCert KeyLocker、Azure Trusted Signing)。
GitHub Actions(Windows runner + 挂载 Token 的签名代理机):
- name: Sign binaries
shell: pwsh
run: |
$signtool = "C:Program Files (x86)Windows Kits10bin10.0.22621.0x64signtool.exe"
Get-ChildItem dist*.exe, dist*.dll | ForEach-Object {
& $signtool sign /fd sha256 /td sha256 /tr http://timestamp.digicert.com `
/n "Example Tech Co., Ltd." /csp "eToken Base Cryptographic Provider" `
/kc "[{{PIN}}]=$env:TOKEN_PIN" /d "Example App" $_.FullName
if ($LASTEXITCODE -ne 0) { throw "sign failed: $($_.Name)" }
}
env:
TOKEN_PIN: ${{ secrets.TOKEN_PIN }}
Linux 构建机用 jsign,可直接对接云 HSM 或 PKCS#12 密钥库:
jsign --keystore codesign.p12 --storepass "$PFX_PASS" --alias codesign
--alg SHA-256 --tsaurl http://timestamp.digicert.com dist/MyApp.exe
常用 RFC 3161 时间戳地址如下,务必使用 /tr 而非已淘汰的 /t 老接口:
| CA | 时间戳 URL | 说明 |
|---|---|---|
| DigiCert | http://timestamp.digicert.com | 通用,支持 SHA-256 |
| GlobalSign | http://timestamp.globalsign.com/tsa/r6advanced1 | GlobalSign 证书推荐 |
| Sectigo | http://timestamp.sectigo.com | 备用 |
| Entrust | http://timestamp.entrust.net/TSS/RFC3161sha2TS | 备用 |
流水线里还有两个工程细节:签名必须在打包(如 Inno Setup、MSIX 封包)之后执行,否则外层安装包仍是无签名状态;签名失败要让构建直接失败,不能 continue-on-error,否则会发出无签名版本。
五、标准版与 EV 代码签名证书对比表
选型的核心不是价格,而是分发场景与信誉诉求。下表以 GlobalSign 标准版与 EV 版为例,其他 CA 的规则基本一致。
| 对比项 | 标准版代码签名证书 | EV 代码签名证书 |
|---|---|---|
| 验证等级 | 组织验证 OV:营业执照 + 电话回访 | 扩展验证 EV:+ 3 年经营历史、法人身份与地址核验 |
| 签发周期 | 1–3 个工作日 | 3–7 个工作日(含 Token 邮寄) |
| 私钥存储 | FIPS 140-2 L2 硬件 / 云 HSM,不可导出 .pfx | 强制硬件 Token 或云 HSM,私钥不可导出 |
| 最长有效期 | 460 天 | 460 天 |
| SmartScreen 初始信誉 | 无,需累积下载量 | 有,签名后能较快消除警告 |
| 内核驱动 | 不支持 | 可作为 Partner Center / WHQL 提交的前置条件,.sys 仍需 Microsoft 签名 |
| 签名算法 | SHA-256(SHA-1 已淘汰) | SHA-256 |
| 时间戳 | 必须(RFC 3161) | 必须(RFC 3161) |
| 典型场景 | 内部工具、企业分发、脚本与安装包 | 面向公众发行、需要快速建立信任 |
结论:面向公众分发的商业软件优先 EV,内部或低频分发用标准版即可;无论选哪种,都要在流水线里固定 /fd sha256 /td sha256 /tr 三件套。
六、常见错误排查:真实报错与修复
- SignTool Error: No certificates were found that met all the given criteria.
/n的主体名与证书 Subject 不完全一致,或证书装在 LocalMachine 而 signtool 默认读 CurrentUser。用certutil -store My核对 Subject,或加/sm切换到计算机存储。 - SignTool Error: The specified timestamp server either could not be reached or returned an invalid response. 出网 80 端口被拦、用了 https 而服务器只开 http,或误用
/t老接口。改用/tr http://timestamp.digicert.com /td sha256,并确认代理放行。 - SignTool Error: A certificate chain processed, but terminated in a root certificate which is not trusted by the trust provider. 缺中间证书。安装 GlobalSign Root R6 / Intermediate R6 到“受信任的根证书颁发机构”:
certutil -addstore -f Root root.cer。 - SignTool Error: ISignedCode::Sign returned error: 0x80090016 (NTE_BAD_KEYSET) Keyset does not exist. Token 未插入、SafeNet 驱动未启动,或
/kc中容器名/PIN 写错。用certutil -key -csp "eToken Base Cryptographic Provider"列出真实容器名。 - 0x800B0101 CERT_E_EXPIRED:证书已过期,新签名会被拒绝;请在 460 天有效期内续期,历史版本靠时间戳保活。
- osslsigncode: Failed to load PKCS12 或
Timestamp failed: 0x80072EE7:密码错误或构建机访问不到时间戳服务器,先curl -I http://timestamp.digicert.com验证连通性。 - 签名正确但 SmartScreen 仍拦截:这是信誉问题而非签名问题,标准版需累积下载量,EV 见效更快;同时确保安装包内每个可执行文件都已签名。
- 设备管理器报“Windows 无法验证此设备所需的驱动程序的数字签名(代码 52)”:.sys 需经 Microsoft Partner Center 签名,EV 证书只是提交前置条件。
七、效果验证:确认签名、时间戳与发布者信息
签名完成后必须做三重验证,缺一不可。
1. signtool 校验(最严格)。/pa 表示按 Authenticode 策略校验,/all 校验文件中的全部签名:
signtool verify /pa /all /v .distMyApp.exe
成功输出应包含 Successfully verified: .distMyApp.exe、The signature is timestamped: 2025-03-01 10:20:31,以及完整证书链 Issued to: Example Tech Co., Ltd.。
2. PowerShell 读取签名对象。
Get-AuthenticodeSignature .distMyApp.exe | Format-List Status,StatusMessage,SignerCertificate,TimeStamperCertificate
Status 应为 Valid,TimeStamperCertificate 不能为空——为空说明只签名未打时间戳,证书一过期所有旧版本都会失效。
3. 跨平台与人工确认。Linux 侧执行 osslsigncode verify -in MyApp-signed.exe;Windows 上右键文件 → 属性 → 数字签名,应看到“签名者名称 = 公司名”与一条时间戳记录;Sysinternals 的 sigcheck -a -h -i MyApp.exe 可打印证书链与哈希算法。最后从浏览器真实下载一次,确认 UAC 弹窗显示公司名而非“未知发布者”,SmartScreen 不再拦截。
常见问题
按 CA/B Forum 规定,2023-06-01 起签发的代码签名证书最长有效期 460 天,且私钥必须存放在 FIPS 140-2 Level 2 或 CC EAL4+ 硬件中,不能导出为 .pfx 文件,续期需重新走验证流程。
面向公众分发、希望尽快消除 SmartScreen 警告或需要配套驱动发布,选 EV;内部工具、企业分发、预算有限选标准版。两者都用 SHA-256 与 RFC 3161 时间戳,区别在验证深度和初始信誉。
能。只要签名时附加了 RFC 3161 时间戳,验证方会以时间戳时间点判断证书有效性,证书过期后旧版本仍有效。没有时间戳的签名在证书到期当天即失效,必须重新签名。
三种做法:把 Token 插在常驻签名代理机上,通过 signtool 的 /csp 与 /kc 参数调用;使用 CA 的云签名服务(GlobalSign Atlas、DigiCert KeyLocker);或改用 Azure Trusted Signing 等云签名方案。
不能。Windows 代码签名证书基于 Authenticode,只能签 PE 格式(exe、dll、sys、ps1 等)。Android 用 apksigner 与自有密钥,macOS 用 Apple Developer ID 证书并做公证(notarization),三者互不通用。