DigiCert OV 代码签名证书实战:企业验证、SHA-256 签名与常见报错排查
问题背景与根因
DigiCert OV 代码签名证书用于 Windows Authenticode 等代码签名,不是 HTTPS 的 SSL/TLS 证书。原文把“加密等级”写成“一般”、把哈希写成“SHA1&SHA2”,这两点已过时:公共 CA 已不再签发 SHA-1 代码签名证书,DigiCert 目前按 SHA-256 签发;自 2021-06-01 起,代码签名私钥必须存放在 FIPS 140-2 Level 2 或 Common Criteria EAL4+ 硬件令牌/HSM 中,证书最长有效期 39 个月。很多“签名后仍被 SmartScreen 拦截”的根因不是证书没买对,而是没有做 RFC3161 时间戳、证书链不完整、使用 SHA-1 或私钥导出成 .pfx。OV 验证的是企业合法存在、地址电话和申请人授权,签发通常 1-3 个工作日,复杂材料可到 5-7 个工作日;有效期内可重新签发,但需重新走验证和 CSR/令牌流程。$1,000,000 是依赖方保障,不是对软件漏洞的赔偿。TLS 证书最长 398 天、Let’s Encrypt 为 90 天,与代码签名证书规则不同。
signtool verify /pa /v /all ./MyApp.exe
Get-AuthenticodeSignature ./MyApp.exe | Format-List Status,StatusMessage,SignerCertificate,TimeStamperCertificate
certutil -verify -urlfetch codesign.cer
若 Status 不是 Valid 或 TimeStamperCertificate 为空,先排查时间戳与链,而不是重复购买证书。
申请前准备与 OV 企业验证
OV 企业验证需要:营业执照/注册证明、实际办公地址、可接听的座机或官方电话、申请人身份与授权文件。DigiCert 可能通过公开数据库和电话核验,邓白氏编码不是强制但可加速。代码签名证书没有“服务器许可”概念,原文“不适用”正确。准备一个 FIPS 140-2 Level 2 以上 USB 令牌,私钥必须在令牌内生成,不能导出 .pfx。
openssl version
certutil -csptest
certutil -csp "eToken Base Cryptographic Provider" -key
若 certutil -csptest 看不到令牌 Provider,先装 SafeNet Authentication Client 并换 USB 口。测试 CSR 可用 OpenSSL 生成,但生产 CSR 应在 DigiCert Certificate Utility for Windows 中选择令牌后生成:
openssl req -new -newkey rsa:2048 -nodes -keyout codesign.key -out codesign.csr -subj '/C=CN/O=Example Co., Ltd./CN=Example Code Signing'
提交 CSR 时 O 字段必须与营业执照一致,否则 OV 验证会退回。私钥长度按 DigiCert 实际签发,一般为 RSA 2048 位及以上。材料不齐或电话核验失败时,签发周期会从 1-3 个工作日延长到 5-7 个工作日。
完整实操步骤
顺序是:完成 OV 验证 → 在令牌内生成 CSR → 提交 DigiCert → 下载并安装证书 → 用 signtool 签名并加时间戳 → 验证。证书安装优先用 DigiCert Certificate Utility,把公钥证书关联到令牌私钥;中间证书导入 CA 存储。
- 在 DigiCert Certificate Utility 选择令牌生成 CSR,提交订单并等待签发。
- 下载 .cer 后安装到令牌关联的证书存储,导入 DigiCert 中间证书。
- 签名必须同时指定文件摘要和时间戳摘要。
certutil -addstore -f CA DigiCertCA.crt
certutil -store My CERT_THUMBPRINT
signtool sign /fd SHA256 /tr http://timestamp.digicert.com /td SHA256 /sha1 CERT_THUMBPRINT /sm ./MyApp.exe
signtool verify /pa /v /all ./MyApp.exe
若证书在用户存储而不是本地计算机存储,去掉 /sm。 /fd SHA256 指定文件摘要,/td SHA256 指定时间戳摘要,二者不能省。签名后不要再用编辑工具修改 exe,否则签名失效。重新签发在有效期内可申请,但仍需令牌和验证,不能把旧私钥导出复用。
配置示例
USB 令牌不能直接挂到 GitHub Actions 托管 runner;要么用带令牌的自托管 Windows runner,要么用 DigiCert KeyLocker/HSM 远程签名。下面脚本适合自托管 runner,失败即退出。
$ErrorActionPreference = 'Stop'
$thumb = $env:CODESIGN_THUMBPRINT
$files = Get-ChildItem ./dist -Filter *.exe -Recurse
foreach ($f in $files) {
& signtool sign /fd SHA256 /tr http://timestamp.digicert.com /td SHA256 /sha1 $thumb /sm $f.FullName
if ($LASTEXITCODE -ne 0) { throw "签名失败: $($f.FullName)" }
& signtool verify /pa /v /all $f.FullName
if ($LASTEXITCODE -ne 0) { throw "验证失败: $($f.FullName)" }
}
MSBuild 可在 AfterBuild 调 SignTool,但不要把指纹写死到仓库;用环境变量或密钥管理。示例配置只保留参数骨架:
<PropertyGroup>
<SignToolPath>signtool.exe</SignToolPath>
<TimestampUrl>http://timestamp.digicert.com</TimestampUrl>
</PropertyGroup>
<Target Name='AfterBuild' AfterTargets='Build'>
<Exec Command='$(SignToolPath) sign /fd SHA256 /tr $(TimestampUrl) /td SHA256 /sha1 $(CodesignThumbprint) /sm $(TargetPath)' />
</Target>
CI 日志要保留 signtool verify 输出,便于审计。若用 KeyLocker,命令改为对应远程签名工具,仍使用 /fd SHA256 /tr … /td SHA256 参数。
OV、EV、自签名与 TLS 证书对比
下表把 DigiCert OV 代码签名与 EV、自签名、TLS OV 区分开。注意代码签名证书最长 39 个月,TLS/SSL 公共证书最长 398 天,Let’s Encrypt 为 90 天,两者不能混用。
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
- SSL域名证书申请 · 小程序证书 · 国外SSL证书
- Wildcard 通配符 SSL 证书安装部署续费申请
- NGINX / APACHE / TOMCAT / IIS 证书配置 · SSL证书安装
- SSL证书安装服务 · 腾讯云 HTTPS 部署 · 证书过期更新
- 服务器维护 · 网站代维护 · 服务器托管代维
| 项目 | DigiCert OV 代码签名 | EV 代码签名 | 自签名证书 | TLS OV/SSL |
|---|---|---|---|---|
| 验证方式 | 企业 OV 验证 | 扩展/增强验证 | 无第三方验证 | 域名+企业 OV |
| 典型签发 | 1-3 个工作日,复杂 5-7 个工作日 | 通常更长 | 即时 | 分钟到数个工作日 |
| 最长有效期 | 39 个月 | 39 个月 | 自定义 | 398 天 |
| 私钥存储 | FIPS 140-2 Level 2 硬件令牌/HSM | 硬件令牌/HSM | 文件 | 服务器/HSM |
| 哈希算法 | SHA-256 | SHA-256 | 可自定义 | SHA-256 |
| SmartScreen | 需积累信誉 | 通常更快但不保证 | 基本无效 | 不适用 |
| 保障 | $1,000,000 依赖方保障 | 以合同为准 | 无 | 以合同为准 |
| 用途 | Windows exe/msi/ps1 签名 | 高信誉代码签名 | 内部测试 | HTTPS 加密 |
| 服务器许可 | 不适用 | 不适用 | 不适用 | 按服务器/域名授权 |
原文“加密等级 一般”应理解为 OV 组织验证,不是加密强度;实际强度由 RSA 2048+ 和 SHA-256 决定。重新签发无限制需遵守 CA 策略,不是绕过私钥保护。
常见错误排查
以下报错在 signtool 中最常见。先看错误码,再按顺序查令牌、证书存储、链、时间戳。
| 报错 | 原因 | 处理 |
|---|---|---|
| SignTool Error: No certificates were found that met all the given criteria. | 指纹错误、令牌未插、证书不在 My 存储、/sm 不匹配 | 运行 certutil -store My CERT_THUMBPRINT;确认 /sm;换 USB 口 |
| SignTool Error: A certificate chain could not be built to a trusted root authority. | 缺少 DigiCert 中间证书或根证书不受信 | certutil -addstore -f CA DigiCertCA.crt;用 certutil -verify -urlfetch 检查 |
| SignTool Error: The specified timestamp server either could not be reached or returned an invalid response. | 网络/代理阻断、时间戳 URL 错误 | 改用 http://timestamp.digicert.com,检查代理和防火墙 |
| 0x800B0101 CERT_E_EXPIRED | 证书过期或未加时间戳导致验证时间点过期 | 重新签发并在签名时加 /tr 与 /td |
| SignTool Error: The signer’s certificate is not valid for signing. | 用了 TLS 证书或 EKU 不含 Code Signing | 确认 EKU 为 1.3.6.1.5.5.7.3.3 |
链错误用 certutil -verify -urlfetch codesign.cer 查;时间戳错误换网络或改用 DigiCert RFC3161 地址;不要用 TLS 证书签 exe。若签名后文件被压缩包解压、资源修改或二次打包,也会出现 HashMismatch。
效果验证
签名完成后至少做三层验证:文件签名、证书链、时间戳。signtool verify /pa /v /all ./MyApp.exe 应输出 Successfully verified;Get-AuthenticodeSignature 的 Status 应为 Valid,TimeStamperCertificate 不为空。
signtool verify /pa /v /all ./MyApp.exe
signtool verify /pa /v /tw ./MyApp.exe
Get-AuthenticodeSignature ./MyApp.exe | Format-List Status,StatusMessage,SignerCertificate,TimeStamperCertificate
certutil -verify -urlfetch codesign.cer
若 Status 为 NotSigned,检查是否签错文件;UnknownError 多为链或时间戳;HashMismatch 说明签名后文件被改动。SmartScreen 不是签名后立即放行,OV 证书仍需下载信誉积累;EV 通常更快但不保证。发布前在干净 Windows 虚拟机联网/断网各验一次,并保留签名日志、证书指纹和时间戳服务器响应。
常见问题
DigiCert OV 代码签名证书有效期多久?
按 CA/B 规则最长 39 个月,具体以订单为准;它不是 TLS 证书的 398 天,也不是 Let’s Encrypt 的 90 天。
为什么原文写 SHA1&SHA2?
该信息已过时。公共 CA 不再签发 SHA-1 代码签名证书,DigiCert 当前使用 SHA-256,Windows 也可能拒绝 SHA-1 签名。
签发真的要一周吗?
通常 1-3 个工作日;材料复杂、电话核验失败或地址证明不足时可延长到 5-7 个工作日,不是固定一周。
可以把 .pfx 导出给 CI 使用吗?
不可以。代码签名私钥必须存放在 FIPS 140-2 Level 2 以上硬件令牌/HSM;CI 应使用自托管 runner 插令牌,或使用 DigiCert KeyLocker 等远程签名服务。
重新签发真的无限制吗?
有效期内通常可多次重新签发,但仍需重新验证、CSR 和令牌流程,并受 CA 策略约束,不能导出旧私钥复用。
$1,000,000 保障赔什么?
它是依赖方保障,用于特定依赖场景,不是对软件漏洞、业务损失或代码缺陷的赔偿,具体以 DigiCert 合同为准。