跳到主要内容
Comodo SSL证书

Sectigo OV 代码签名证书实战:USB Token 签发、signtool 签名、时间戳与排错

问题背景与根因:为什么还要买 OV 代码签名证书

用户双击 EXE 时看到“未知发布者”,或 SmartScreen 拦截下载,本质是 Windows 无法确认发布者身份与文件完整性。代码签名用私钥对 PE 文件的 Authenticode 哈希签名,把“企业身份 + 文件哈希”封装进 PKCS#7 结构;系统用证书公钥验签,再用时间戳证明“签名发生在证书有效期内”。Sectigo OV 代码签名证书验证企业法定名称、地址、电话等组织信息,适合桌面软件、MSI 安装包、DLL 和 PowerShell 脚本。

2023-06-01 起,CA/Browser Forum 代码签名基线要求私钥必须存放在 FIPS 140-2 Level 2 或同等 CC EAL4+ 的硬件令牌/HSM 中,禁止导出 PFX;因此 Sectigo 以 USB Token 交付,私钥不可导出。证书有效期上限为 460 天,不是 TLS 证书的 398 天,也不是 Let’s Encrypt 的 90 天。SHA-1 已被 Windows 拒绝,签名必须使用 SHA-256;时间戳让证书过期后旧安装包仍保持有效。忽略这些根因,就会出现“签名成功但过期失效”“Token 拔掉后 CI 失败”等问题。

OV 与 EV 的差异不在加密强度,而在验证深度和用途:OV 可满足普通软件分发,内核驱动仍需 EV 证书并提交 Microsoft Partner Center。Sectigo OV 通常 1-5 个工作日签发,支持 RSA 2048/3072/4096 与 ECC P-256/P-384,有效期内可重新签发,但新证书仍受 460 天上限约束。下面按“准备 CSR → Token 收证 → signtool 签名 → 验证 → 排错”落地。

签发前准备:企业材料、USB Token 与 CSR 生成

准备营业执照或登记证明、企业法定名称(必须与执照一致)、注册地址、可接听的电话、管理员邮箱。CA 会做组织验证(OV),可能电话回拨;个人/个体可走 IV 验证。向 Sectigo 下单后不要急着导出私钥:代码签名私钥必须在令牌内生成,CSR 只包含公钥和主题信息。先安装令牌驱动(SafeNet Authentication Client 或厂商工具),修改默认 PIN,并确认系统能识别 CSP。

certutil -csplist
certutil -store -user My

第一条列出加密服务提供程序,第二条查看当前用户个人存储中的证书。编写 request.inf,ProviderName 必须与令牌 CSP 一致;SafeNet eToken 5110 常见为 eToken Base Cryptographic Provider,其他令牌用 certutil -csplist 的输出替换。

[NewRequest]
Subject = "CN=Your Company Ltd,O=Your Company Ltd,L=Shanghai,S=Shanghai,C=CN"
KeySpec = 1
KeyLength = 2048
Exportable = FALSE
MachineKeySet = FALSE
ProviderName = "eToken Base Cryptographic Provider"
ProviderType = 1
HashAlgorithm = SHA256
KeyUsage = 0x80

[EnhancedKeyUsageExtension]
OID = 1.3.6.1.5.5.7.3.3

执行 certreq -new -f request.inf request.req,过程中输入令牌 PIN。把 request.req 提交给 Sectigo,私钥始终留在令牌。收到证书后导入当前用户存储:certutil -user -addstore My sectigo_ov.cer,再用 certutil -store -user My 确认证书含 Code Signing EKU(1.3.6.1.5.5.7.3.3)。若 CSR 对应的密钥容器丢失,只能重新签发,不能恢复私钥。

完整实操:用 signtool 签名 EXE、DLL、MSI 与脚本

安装 Windows SDK 后,signtool 通常在 C:\Program Files (x86)\Windows Kits\10\bin\版本\x64\signtool.exe。先插入 Token,确认证书在 CurrentUser\My。签名 EXE/DLL 的核心参数:/fd SHA256 指定文件摘要算法;/td SHA256 指定时间戳摘要;/tr 使用 RFC3161 时间戳;/a 自动选合适证书;/n 按主题选证书;/sha1 按指纹精确选证书,避免多证书误选。

signtool sign /fd SHA256 /td SHA256 /tr http://rfc3161timestamp.sectigo.com /a /n "Your Company Ltd" /d "YourApp" /du "https://example.com" dist\YourApp.exe
signtool sign /fd SHA256 /td SHA256 /tr http://rfc3161timestamp.sectigo.com /sha1 0123456789ABCDEF0123456789ABCDEF01234567 dist\Setup.msi

签名时令牌会弹 PIN,不要把 PIN 写进命令行或脚本。MSI 与 EXE 命令相同;DLL 也相同。PowerShell 脚本用 Set-AuthenticodeSignature,时间戳服务器可用 http://timestamp.sectigo.com:

$cert = Get-ChildItem Cert:\CurrentUser\My -CodeSigningCert | Where-Object {$_.Subject -like '*Your Company*'}
Set-AuthenticodeSignature -FilePath .\deploy.ps1 -Certificate $cert -TimestampServer http://timestamp.sectigo.com -HashAlgorithm SHA256

批量签名可用 for 循环;每个文件单独时间戳。若 RFC3161 地址被防火墙拦截,可临时改用 /t http://timestamp.sectigo.com 做 Authenticode 时间戳,但优先 /tr。签名顺序:先签 DLL,再签依赖它们的 EXE,最后签安装包;避免签完 MSI 后又改内部文件导致哈希失效。

配置示例:certreq INF、批处理、PowerShell 与 CI 签名

把 request.inf 放进版本库时不要包含私钥;私钥只在令牌。下面是一个可复用的批处理,遍历 dist 目录的 EXE/DLL,使用指纹选证书,失败即退出,便于 CI 发现“Token 未插入”或“时间戳不可达”。

@echo off
setlocal
set CERT_SHA1=0123456789ABCDEF0123456789ABCDEF01234567
set TS=http://rfc3161timestamp.sectigo.com
for %%f in (dist\*.exe dist\*.dll) do (
  signtool sign /fd SHA256 /td SHA256 /tr %TS% /sha1 %CERT_SHA1% /d "YourApp" "%%f"
  if errorlevel 1 exit /b 1
)
signtool verify /pa /v dist\YourApp.exe

PowerShell 版本更适合取证书对象并签脚本:

$sha1 = '0123456789ABCDEF0123456789ABCDEF01234567'
$cert = Get-ChildItem Cert:\CurrentUser\My | Where-Object Thumbprint -eq $sha1
Get-ChildItem .\dist -Include *.exe,*.dll -Recurse | ForEach-Object {
  signtool sign /fd SHA256 /td SHA256 /tr http://rfc3161timestamp.sectigo.com /sha1 $sha1 /d 'YourApp' $_.FullName
  if ($LASTEXITCODE -ne 0) { throw "sign failed: $($_.FullName)" }
}

CI 中不要把 USB Token 直接插在构建机上长期无人值守;推荐 Sectigo Cloud HSM 或内网签名代理,由代理调用 signtool 并做权限审计。若必须用物理令牌,构建机需允许交互式 PIN 输入或使用厂商的远程令牌方案,并在流水线中设置超时与重试。所有签名日志保留证书序列号、时间戳 URL、文件 SHA-256,便于追溯。

对比表格:OV、EV、自签名与云 HSM 怎么选

选择不是“加密等级”越高越好,而是看验证深度、私钥保护、有效期和分发场景。下表按 2024 年后常见规则整理;注意代码签名证书上限 460 天,TLS 证书上限 398 天,Let’s Encrypt 为 90 天,三者不要混淆。

项目 Sectigo OV 代码签名 EV 代码签名 自签名证书 云 HSM 代码签名
身份验证 企业组织验证 OV,核验执照、电话、地址 扩展验证,审核更严,费用更高 无第三方验证 取决于底层证书,通常 OV/EV
私钥存储 USB Token,FIPS 140-2 Level 2,不可导出 Token/HSM,不可导出 本地文件,可导出 云端 HSM,签名服务调用
有效期上限 460 天 460 天 自定,但不受公共信任 随证书,460 天
时间戳 必须加 RFC3161 时间戳 必须加 通常不加 由服务自动加
SmartScreen 可建立信誉,但新证书不立即免拦截 同样需积累信誉,不再“秒过” 外部用户会提示未知发布者 同底层证书
内核驱动 不适合直接签内核驱动 配合 Microsoft Partner Center 提交 不可用于公开分发 看证书类型
适用场景 桌面软件、MSI、DLL、脚本 驱动、企业品牌要求高 内网测试 CI/CD、无人值守构建

如果只是内网测试,自签名足够;对外分发优先 OV;涉及 Windows 内核驱动或微软硬件门户,按微软要求使用 EV 并完成提交。预算有限但构建频繁,选 OV + 云 HSM 签名服务,比把 Token 插在构建机上更稳定。

常见错误排查:真实报错与修复命令

1. SignTool Error: No certificates were found that met all the given criteria. 原因:Token 未插入、证书不在 CurrentUser\My、/n 主题不匹配、证书缺少 Code Signing EKU。执行 certutil -store -user My 查看;用 /sha1 指纹替代 /n;确认 EKU 含 1.3.6.1.5.5.7.3.3。

2. SignTool Error: A certificate chain processed, but terminated in a root certificate which is not trusted by the trust provider. 原因:中间 CA 未安装或系统根证书过旧。导入 Sectigo 中间链:certutil -user -addstore CA sectigo_chain.p7b;再 signtool verify /pa /v 文件。不要在签名机上关闭证书链校验。

3. SignTool Error: The specified timestamp server either could not be reached or returned an invalid response. 原因:代理、防火墙、DNS 或时间戳 URL 不可达。测试 curl -I http://rfc3161timestamp.sectigo.com;改用 /tr http://rfc3161timestamp.sectigo.com /td SHA256;失败时临时 /t http://timestamp.sectigo.com。企业网需放行 80 端口。

4. SignTool Error: The signer’s certificate is not valid for signing. 原因:证书过期、EKU 不是代码签名、系统时间错误。检查证书 NotBefore/NotAfter 与客户端时间;用 certutil -store -user My 序列号查看。证书过期后不能补签,只能重签并重新时间戳。

5. SignTool Error: The specified PFX password is not correct. 原因:试图把 Token 私钥导出成 PFX,或 CI 使用了错误 PFX。硬件令牌私钥不可导出,CI 应使用云 HSM/签名代理;不要从令牌“导出”PFX,这违反 CA 策略且通常无法完成。

6. 0x80070057 参数错误。 常见于路径含空格未加引号、/tr 与 /t 混用、/td 缺失。给文件路径加引号,RFC3161 必须同时写 /tr 和 /td SHA256。把 signtool 输出重定向到日志,定位到具体文件。

效果验证:签名、时间戳与证书链一次查清

签名后不要只看“成功”字样。先用 signtool 验证 Authenticode 策略:/pa 使用默认验证策略,/v 输出详细链,/tw 按 Windows 驱动策略检查(驱动场景)。

signtool verify /pa /v dist\YourApp.exe
signtool verify /pa /v /tw dist\YourDriver.sys

输出应包含“Successfully verified”“Signing Certificate Chain”“Timestamp Verified by”。若时间戳缺失,证书过期后验证会失败。PowerShell 可批量检查:

Get-AuthenticodeSignature .\dist\YourApp.exe | Format-List Status,StatusMessage,SignerCertificate,TimeStamperCertificate
Get-ChildItem .\dist -Include *.exe,*.dll -Recurse | ForEach-Object {
  $s = Get-AuthenticodeSignature $_.FullName
  [PSCustomObject]@{File=$_.Name;Status=$s.Status;TimeStamp=($null -ne $s.TimeStamperCertificate)}
}

期望 Status 为 Valid,StatusMessage 为 Signature verified,TimeStamperCertificate 非空。若 Status 为 NotTrusted,检查中间链和根证书;UnknownError 常见于时间戳或文件被修改;HashMismatch 说明签名后文件被替换。还可在资源管理器右键文件 → 属性 → 数字签名查看签名者和时间戳。Sysinternals sigcheck -a -h 文件可输出 SHA-256 与签名信息,便于发布前抽检。

证书生命周期:460 天、续期、重签与吊销

Sectigo OV 代码签名证书有效期不超过 460 天。到期前 30-60 天启动续期,不要等最后一周:CA 要重新做组织验证,Token 可能需更换或新增密钥容器。续期通常生成新 CSR、新私钥和新序列号;旧安装包只要带可信时间戳,证书过期后仍可验证,但不能再用于新签名。时间戳不是“永久有效”的魔法,它证明签名时刻在有效期内,因此每个发布文件都必须加时间戳。

重新签发(reissue)在有效期内通常不限制次数,但新证书仍受 460 天上限,且可能重置 SmartScreen 对发布者证书的信誉积累。丢失 Token 应立即在 Sectigo 后台吊销旧证书,吊销后新签名会因 CRL/OCSP 检查失败;已发布时间戳文件在吊销后也可能被标记为不信任。保留 Token 的序列号、证书指纹、吊销密码和采购邮箱,交接给至少两人。

密钥轮换建议每次续期使用新密钥容器;不要为了省事复制旧容器。吊销检查依赖 CRL/OCSP 网络,离线环境要确认缓存策略。若企业有多个产品线,可用同一 OV 证书签多个 EXE,但建议按产品记录签名日志;一旦私钥泄露,吊销影响面较大。最后,证书和 Token 不要存放在构建机公共目录,签名服务账号最小权限。

常见问题

OV 代码签名证书能签 Windows 内核驱动吗?

不能直接满足微软内核驱动要求。内核驱动需 EV 代码签名证书,并通过 Microsoft Partner Center 做 WHQL/Attestation 提交;OV 适合普通 EXE、MSI、DLL 和脚本。

证书过期后,已经签名的软件还能安装吗?

只要签名时加了可信时间戳,证书过期后仍可验证签名;若没有时间戳,过期后验证会失败。用 signtool verify /pa /v 查看 Timestamp Verified by。

为什么用了 OV 或 EV 证书,SmartScreen 还提示?

SmartScreen 的信誉按文件哈希、证书和下载量逐步积累,EV 也不再保证立即免拦截。新证书需要持续发布、下载和提交误报,必要时向 Microsoft 提交样本申诉。

USB Token 里的私钥能导出成 PFX 给 CI 用吗?

不能。2023 年后代码签名私钥必须存放在 FIPS 140-2 Level 2 硬件中且不可导出。CI 应使用云 HSM 或内网签名代理,不要把 PFX 放进仓库或流水线变量。

代码签名证书有效期是 398 天吗?

不是。398 天是 TLS/SSL 证书上限,Let’s Encrypt 是 90 天;代码签名证书按 CSC 基线上限为 460 天。两者规则不同,不要混用。

签名时报“找不到证书”先查什么?

先查 Token 是否插入、驱动是否正常、证书是否在 CurrentUser\My、是否含 Code Signing EKU,再用 /sha1 指纹精确选择证书。

内容审核

长期从事 SSL/TLS 证书部署与 HTTPS 运维,负责本站证书选型、安装配置与故障排查内容的编写与审核。