代码签名证书实战指南:从 EV 申请到 signtool 签名、时间戳与故障排查
问题背景与根因:为什么下载的 .exe 总被 SmartScreen 拦截
很多软件发布后遇到的现象不是“网站证书错误”,而是用户下载 .exe 时 Windows 弹出“Windows 已保护你的电脑”,发布者显示“未知”,或企业终端直接拦截。根因通常不是服务器 SSL 证书,而是可执行文件没有 Authenticode 代码签名,或签名后没有加可信时间戳。代码签名证书用于对 32/64 位用户模式文件(.exe、.cab、.dll、.ocx、.msi、.cat)和内核模式驱动(.sys)做数字签名,验证发布者身份与文件完整性;它和部署在网站上的 SSL/TLS 证书是两套体系。
需要修正一个常见过时说法:398 天规则针对公共 TLS/SSL 证书,不适用于代码签名证书。代码签名证书按 CA/B Forum Code Signing BR 与 CA 策略签发,常见有效期为 1–3 年,上限为 39 个月(以最新 BR 和 CA 条款为准);自 2023-06-01 起,公共可信代码签名私钥必须存放在 FIPS 140-2 Level 2 或 Common Criteria EAL4+ 的硬件令牌/HSM 中,不能再导出 PFX 随意复制。EV 代码签名还要经过更严格的扩展验证,常用于内核驱动、WHQL 和需要更快建立 SmartScreen 信誉的发行商。
根因拆解:签名、哈希、时间戳与信任链
Authenticode 签名不是把证书“贴”在文件上,而是对 PE 文件计算摘要,再用私钥生成 PKCS#7 签名结构,并把证书链、签名时间和 RFC3161 时间戳一起写入。Windows 验证时检查四件事:文件哈希是否与签名后一致、证书是否含 Code Signing EKU(1.3.6.1.5.5.7.3.3)、证书链是否能到受信任根、时间戳是否证明“签名发生在证书有效期内”。缺少时间戳时,证书一过期,已分发软件会显示签名无效;加了可信时间戳,即使证书到期,旧签名仍可验证。
先确认证书是否进入当前用户或计算机存储:certutil -store My;PowerShell 可按 EKU 过滤:Get-ChildItem Cert:CurrentUserMy | Where-Object {$_.EnhancedKeyUsageList.ObjectId -contains '1.3.6.1.5.5.7.3.3'} | Format-List Subject,Thumbprint,NotAfter。签名算法统一用 SHA256,不要再使用 SHA1;时间戳使用 RFC3161 的 /tr 与 /td SHA256。如果证书链缺中间证书,signtool verify 会报根不受信任,后文给出处理。
申请前准备:主体材料、密钥与硬件令牌
标准版代码签名证书通常做组织身份验证:营业执照/登记证明、组织法定名称、注册地址、电话回拨、申请人邮箱和授权文件。EV 代码签名会增加扩展验证:核实成立年限、邓白氏编码或律师/会计师证明、电话实地验证等,签发周期常见 3–5 个工作日,EV 可能更长。提交前统一发布者名称,后续签名中的 Subject 必须与软件“发布者”一致;公司更名要先更新证书,否则 SmartScreen 信誉会分散。
密钥环节是重点。新规下不能把可导出的 PFX 当长期方案;应使用 CA 提供的硬件令牌、云 HSM(如 DigiCert KeyLocker)或本机 FIPS 140-2 Level 2 令牌。CSR 可在令牌内生成,私钥不出硬件。检查令牌:certutil -store My;查看证书有效期和指纹:certutil -store -v My。如果服务商提供“VIP 安装服务”,要确认其代签环境使用 HSM/KeyLocker、有操作审计,不能把私钥明文交给第三方。CI/CD 不要把 PFX 和密码写入仓库变量,改用自托管 Runner 插令牌,或调用云签名 API。
完整实操:用 signtool 完成签名与时间戳
安装 Windows SDK 后,signtool 通常在 C:/Program Files (x86)/Windows Kits/10/bin/10.0.22621.0/x64/signtool.exe。插入硬件令牌,确认证书指纹:certutil -store My。签名命令如下,<THUMBPRINT> 替换为证书指纹,/fd SHA256 指定文件摘要,/td SHA256 指定时间戳摘要,/tr 使用 RFC3161 时间戳:
signtool sign /fd SHA256 /td SHA256 /tr http://timestamp.digicert.com /sha1 <THUMBPRINT> /a MyApp.exe
如果证书在计算机存储而不是当前用户存储,加 /sm;批量签名可一次传多个文件:
signtool sign /fd SHA256 /td SHA256 /tr http://timestamp.digicert.com /sha1 <THUMBPRINT> /a dist/*.exe dist/*.dll
签名后立即验证:signtool verify /pa /v MyApp.exe;PowerShell 检查:Get-AuthenticodeSignature ./MyApp.exe | Format-List Status,StatusMessage,SignerCertificate,TimeStamperCertificate。正常结果 Status 为 Valid,TimeStamperCertificate 不为空。若时间戳服务器超时,可换 http://timestamp.sectigo.com 或 http://timestamp.globalsign.com/tsa/r6advanced1,但必须保留 /tr 和 /td SHA256。签名完成后不要再修改版本资源、图标或嵌入清单,否则哈希变化会导致签名失效。
配置示例:标准版、EV 与内核驱动签名
标准版和 EV 的 signtool 命令基本一致,差别在证书验证强度、硬件令牌和 SmartScreen 信誉。EV 常用命令:signtool sign /fd SHA256 /td SHA256 /tr http://timestamp.digicert.com /n <公司法定名称> /a MyApp.exe;如果同名证书多,仍建议用 /sha1 指纹精确定位。CI 示例(Windows 自托管 Runner,令牌已插好):
- name: Sign artifacts
run: signtool sign /fd SHA256 /td SHA256 /tr http://timestamp.digicert.com /sha1 $env:CERT_THUMBPRINT /a dist/app.exe
内核驱动不要误以为“有 EV 证书就能直接加载”。Windows 10 64 位在 Secure Boot 下,公开分发的内核驱动通常需要 Microsoft Attestation Signing 或 WHQL 签名;EV 证书用于注册 Partner Center 和提交 HLK/WHQL。本地测试可先 bcdedit /set testsigning on 并重启,再对 .sys/.cat 签名:
Inf2Cat /driver:C:/driver /os:10_X64
signtool sign /fd SHA256 /td SHA256 /tr http://timestamp.digicert.com /sha1 <THUMBPRINT> /a C:/driver/driver.cat
signtool sign /fd SHA256 /td SHA256 /tr http://timestamp.digicert.com /sha1 <THUMBPRINT> /a C:/driver/driver.sys
生产驱动还要把 CAB 提交到 Microsoft Partner Center 做 attestation/WHQL,不能只靠本地签名。原页面“支持 Windows 10 内核驱动签名”应理解为配合微软签名流程,而不是单张证书绕过系统强制策略。
对比表格:标准版与 EV 代码签名证书怎么选
选择时不要只看价格。标准版适合普通桌面软件、内部工具、安装包和 .dll 分发;EV 适合面向公众下载、需要更快建立 SmartScreen 信誉、参与 WHQL/内核驱动、金融或企业采购要求扩展验证的场景。两者都必须使用 SHA256、可信时间戳和硬件私钥保护。原页面所列 4200 元、6500 元等为历史渠道参考价,实际以 CA 或代理商当期报价、年限和令牌数量为准。
| 维度 | 标准版代码签名 | EV 代码签名 |
|---|---|---|
| 身份验证 | 组织验证,材料相对简化 | 扩展验证,成立年限、电话、地址等更严格 |
| 私钥保护 | 硬件令牌/HSM,禁止导出 PFX | 硬件令牌/HSM,合规要求相同 |
| 签名对象 | .exe、.dll、.msi、.cab、.cat 等 | 同左,内核驱动/WHQL 场景更常用 |
| SmartScreen | 可消除“未知发布者”,信誉需积累 | 有助于更快建立发布者信誉,但不承诺 100% 免拦截 |
| 时间戳 | 必须使用 RFC3161 | 必须使用 RFC3161 |
| 算法 | SHA256/SHA384,淘汰 SHA1 | SHA256/SHA384,淘汰 SHA1 |
| 有效期 | 常见 1–3 年,按 BR/合同 | 常见 1–3 年,按 BR/合同 |
再次强调:398 天是公共 TLS 证书规则,不是代码签名证书规则;代码签名证书上限按 Code Signing BR 执行,当前常见上限为 39 个月。采购时应确认是否含硬件令牌、是否支持 KeyLocker/云 HSM、是否含时间戳服务和技术支持。
常见错误排查:真实报错与处理
报错 1:SignTool Error: No certificates were found that met all the given criteria. 原因是指纹错误、令牌未插入、证书过期或 EKU 不是 Code Signing。处理:certutil -store My 看证书是否存在;计算机存储加 /sm;用 Get-ChildItem Cert:CurrentUserMy 核对 Thumbprint;确认 NotAfter 未过期。
报错 2:SignTool Error: A certificate chain processed, but terminated in a root certificate which is not trusted by the trust provider. 原因是缺中间证书或根证书过旧。处理:安装 CA 提供的中间证书 certutil -addstore CA intermediate.cer,更新 Windows 根证书,再执行 signtool verify /pa /v /all MyApp.exe。
报错 3:SignTool Error: The signer's certificate is not valid for signing. 常见于证书没有 Code Signing EKU、已吊销或已过期。处理:重新签发正确类型证书,检查吊销状态,不要用 SSL 证书签 .exe。
报错 4:SignTool Error: An error occurred while attempting to timestamp: 0x80072EE7 是网络/代理无法连接时间戳服务器。处理:curl -I http://timestamp.digicert.com 测试连通性,放行 80 端口或换 RFC3161 地址;命令必须同时有 /tr 和 /td SHA256。
报错 5:PowerShell 显示 HashMismatch 或驱动出现 Code 52。前者是签名后又改文件,需重新签名;后者是 Windows 无法验证驱动签名,需 Microsoft attestation/WHQL,Secure Boot 下本地测试证书通常无效。
效果验证与上线检查
签名完成后按清单验收:1)signtool verify /pa /v /all MyApp.exe 返回 Successfully verified;2)Get-AuthenticodeSignature ./MyApp.exe | Format-List * 中 Status 为 Valid,SignerCertificate.Subject 与公司名一致,TimeStamperCertificate 不为空;3)Get-FileHash -Algorithm SHA256 ./MyApp.exe 记录发布哈希,上传 CDN 后再次比对;4)在干净 Windows 虚拟机下载安装,观察 UAC 发布者、SmartScreen 提示和驱动加载;5)检查证书链 certutil -store My 与中间证书是否完整。
上线后不要随意更换发布者名称;版本升级重新签名并加时间戳;证书到期前 30–60 天续签并更新令牌/KeyLocker。EV 也不能保证所有用户立即无提示,SmartScreen 信誉与下载量、签名一致性、时间戳、文件声誉有关。最后,代码签名证书不是 SSL 证书:网站 HTTPS 用 TLS 证书,软件分发用 Authenticode 代码签名证书;两者有效期规则、密钥保护和验证方式都不同。
常见问题
代码签名证书有效期是 398 天吗?
不是。398 天是公共 TLS/SSL 证书的最长有效期规则,代码签名证书按 CA/B Forum Code Signing BR 和 CA 合同执行,常见 1–3 年,当前上限常见为 39 个月。采购时以 CA 最新条款为准,不要套用 TLS 规则。
Let’s Encrypt 能签发代码签名证书吗?
不能。Let’s Encrypt 主要签发 90 天有效期的 TLS/SSL 证书,不提供公共可信的代码签名证书。免费自签名证书只能用于内部测试,不能被 Windows SmartScreen 和普通用户环境信任。
标准版和 EV 代码签名证书必须选 EV 吗?
不一定。普通桌面软件、内部工具可先用标准版;面向公众下载、内核驱动、WHQL、企业采购要求扩展验证时选 EV。两者都要 SHA256、时间戳和硬件私钥保护,EV 的优势主要在验证强度和信誉建立。
签名必须加时间戳吗?
必须。没有时间戳,证书到期后已分发软件的签名会失效;加 RFC3161 时间戳后,即使证书过期,旧签名仍可证明签名发生在有效期内。命令中使用 /tr 与 /td SHA256。
证书过期后已签名的软件还能运行吗?
加了可信时间戳的已签名文件通常仍可验证;没有时间戳则会显示签名无效。证书过期不影响已经生成的时间戳签名,但续签后新版本必须用新证书重新签名。
可以把 PFX 放进 CI/CD 变量吗?
不建议,也不符合新规。自 2023-06-01 起公共可信代码签名私钥应在 FIPS 140-2 Level 2 或 EAL4+ 硬件中。CI 应使用自托管 Runner 插硬件令牌,或调用 KeyLocker/云 HSM 签名 API,避免导出 PFX。