跳到主要内容
Comodo SSL证书

Sectigo EV 代码签名证书实战指南:从硬件令牌申请到 signtool 时间戳签名

Sectigo EV 代码签名证书实战指南:从硬件令牌申请到 signtool 时间戳签名 — Sectigo EV 代码签名证书实战指南:从硬件令牌申请到 signtool 时间戳签名

一、问题背景:为什么普通签名挡不住 SmartScreen 拦截

把一个刚编译好的 EXE 交给客户,对方双击后弹出蓝色的“Windows 已保护你的电脑”,UAC 对话框里发布者显示“未知发布者”——这类投诉几乎都指向同一个根因:文件没有有效的 Authenticode 签名,或者签名证书的身份强度不足以建立发布者信誉。Windows 对可执行文件的校验分两层:第一层是 PKCS#7 签名与证书链能否验证通过,决定文件是否被篡改;第二层是 SmartScreen / Application Reputation 对“发布者是谁、下载量多少、是否长期稳定签名”的信誉评分。自签名证书只能过第一层,第二层永远拿不到分;OV 代码签名证书能过第一层,但信誉要从零慢慢累积;EV 代码签名证书由 CA 完成扩展验证,把企业法人身份、D-U-N-S 编号、对外电话回拨全部核实一遍,因此在 Windows 上建立信誉的起点明显更高。

更关键的是三个容易被忽略的规则变化,直接决定你买的证书能不能用满:

  • 私钥必须硬件化:按 CA/Browser Forum 代码签名基线要求(CSBR),2021-06-01 起签发的代码签名证书,私钥必须存放在 FIPS 140-2 Level 2 或 Common Criteria EAL4+ 以上的硬件密码模块中且不可导出。这就是 Sectigo EV 只交付 USB 令牌、不再提供 PFX 文件的原因。
  • 有效期缩短到 460 天:2023-06-01 起,代码签名证书最长有效期由 39 个月压缩为 460 天(约 15 个月),到期必须重新签发;作为对照,公开信任的 TLS/SSL 证书最长有效期为 398 天,Let’s Encrypt 仍为 90 天。
  • SHA-1 已被淘汰:Windows 10/11 与内核驱动签名只接受 SHA-256,旧资料里“SHA1&SHA2”的说法已经作废。

还有一个纯运维层面的坑:签名时如果没打 RFC 3161 时间戳,证书一到期,你过去两年发布的所有安装包签名会同时失效,用户重装旧版本就会看到红色警告。时间戳服务是免费的,但必须显式加上。

二、Sectigo EV 代码签名证书的规格与合规基线

Sectigo(原 Comodo CA)的 EV 代码签名证书属于“扩展验证 + 硬件密钥”型产品,采购前先确认下表参数与你的交付形态匹配。

项目 规格
证书类型 EV Code Signing Certificate(扩展验证代码签名)
适用对象 合法注册的企业/组织,个人不可申请
验证方式 EV 扩展验证:工商注册信息、D-U-N-S 核验、申请人身份、电话回拨
签发周期 材料齐全后 1–5 个工作日(旧资料“一周”已偏保守)
有效期 最长 460 天,到期重新签发
密钥算法 RSA 2048 / 3072,摘要 SHA-256
私钥存储 SafeNet eToken 5110 等 USB 硬件令牌,FIPS 140-2 Level 3,密钥不可导出
时间戳 RFC 3161,http://timestamp.sectigo.com
重新签发 有效期内不限次数(令牌丢失需先吊销)
可签对象 EXE、DLL、MSI、CAB、OCX、PowerShell 脚本、ClickOnce 清单;内核驱动还需 Microsoft Attestation/WHQL

三个采购时最常被问到的点:其一,EV 与 OV 在密码学算法上没有区别,区别在验证深度与私钥保护方式,EV 的硬件令牌是强制的;其二,令牌里存的是私钥,签名机必须能插 USB,纯云端 CI 需要额外方案(见第五节);其三,460 天有效期意味着一年至少要做一次续签与全量重新签名,建议把“证书到期前 60 天触发续签”写进运维日历。

三、申请与签发实操:从令牌初始化到证书导入

EV 代码签名证书的私钥从生成那一刻起就不能离开硬件令牌,因此申请流程与 SSL/TLS 证书“生成 CSR → 签发 → 部署到服务器”的路径不同:CSR 必须在令牌内部生成。完整步骤如下。

  1. 准备 EV 验证材料:营业执照或同等注册文件、D-U-N-S 编号(CA 会通过 D&B 核验)、法人或授权签署人身份证件、企业对外公示电话(必须能接听 CA 回拨)、企业域名邮箱。
  2. 初始化令牌:安装 SafeNet Authentication Client(SAC)10.x,插入 eToken,立即修改出厂密码(默认多为 12345678),建议 12 位以上并双人分管——忘记密码只能吊销重签。可先用下列命令确认令牌与证书存储状态:
    # Windows:查看令牌与当前用户证书存储
    certutil -scinfo
    certutil -user -store My
    
    # Linux:确认 eToken 是否被 PC/SC 识别
    pcsc_scan
    opensc-tool -l
  3. 在令牌内生成密钥对并导出 CSR:在 Sectigo CertCentral 订单页下载代码签名注册工具,选择令牌并生成 RSA 2048/3072 密钥,工具输出 request.csr(PEM)。私钥始终留在令牌内,磁盘上不会出现 .key 文件。
  4. 提交 CSR 并完成验证:上传 CSR,等待 Sectigo 完成企业验证与电话回拨,通常 1–5 个工作日。
  5. 导入证书与中间证书:签发后通过同一工具把 .crt 写入令牌;手动导入时执行:
    certutil -addstore -user My sectigo_ev_codesigning.crt
    certutil -addstore -f "CA" SectigoPublicCodeSigningCAR36.crt

    中间证书必须装进“中间证书颁发机构”,否则后续签名验证会报 0x800B0109。

四、Windows 下用 signtool 完成签名与 RFC 3161 时间戳

signtool.exe 随 Windows SDK 分发,通常位于 C:Program Files (x86)Windows Kits10bin10.0.xxxxx.x64signtool.exe。EV 令牌插在签名机上时,用证书指纹选证书最稳妥。

# 1) 找到代码签名证书(EKU 1.3.6.1.5.5.7.3.3)
Get-ChildItem Cert:CurrentUserMy |
  Where-Object { $_.EnhancedKeyUsageList.ObjectId -contains '1.3.6.1.5.5.7.3.3' } |
  Format-List Subject, Thumbprint, NotAfter

# 2) 签名 + RFC 3161 时间戳
signtool sign /v /sha1 A1B2C3D4E5F6... /fd sha256 /td sha256 /tr http://timestamp.sectigo.com /d "MyApp" .distapp.exe

# 3) 内核驱动需要交叉证书与 /kp
signtool sign /v /sha1 A1B2C3D4E5F6... /fd sha256 /td sha256 /tr http://timestamp.sectigo.com /ac MSCV-VSClass3.cer /kp .drivermydriver.sys

# 4) 立即验证
signtool verify /pa /v /tw .distapp.exe
参数 作用 常见坑
/fd sha256 文件摘要算法 用 sha1 会被 Windows 11 拒绝
/td sha256 时间戳摘要算法 必须与 /tr 成对出现
/tr RFC 3161 时间戳 URL 老写法 /t 是 Authenticode 时间戳,已不推荐
/sha1 按指纹精确选证书 令牌内有多张证书时最稳
/a 自动选最合适的证书 同令牌混装 TLS 证书时可能选错
/d 写入描述信息 显示在 UAC 与文件属性中
/ac 附加交叉证书 驱动签名必需
/kp 内核模式签名策略 与 /ac 配合使用

五、Linux 与 CI 流水线:osslsigncode、jsign 与远程签名

EV 令牌不能插进云端的 GitHub Actions / GitLab SaaS Runner,这是落地时最大的障碍。三条可行路径:

路径 A:自建签名机(最常用)。一台插着令牌的 Windows 机器注册为 self-hosted runner,只给带 codesign 标签的 job 使用,构建产物经内网传到签名机,签完再回传。

路径 B:CA 云签名。Sectigo 的云签名 / 密钥托管方案把私钥放在 HSM,CI 通过 API 调用,全程不接触私钥;Azure Trusted Signing 是同类替代。适合完全没有 Windows 机器的团队。

路径 C:Linux 本地签名。只有拿到可导出的 PFX 才可行,EV 令牌不适用,OV 或内部自签场景可用 osslsigncode / jsign:

# osslsigncode:签名并打 RFC3161 时间戳
osslsigncode sign -pkcs12 cert.pfx -pass pass:YourPass 
  -n "MyApp" -i https://www.example.com 
  -ts http://timestamp.sectigo.com -h sha256 
  -in app.exe -out app-signed.exe

# 验证
osslsigncode verify -in app-signed.exe

# jsign(Java 实现,支持 RFC3161 与 keystore)
jsign --keystore codesign.p12 --storepass YourPass --alias code 
  --tsaurl http://timestamp.sectigo.com --tsmode RFC3161 
  --name "MyApp" --url https://www.example.com app.exe

注意 -ts 与 --tsaurl 必须写 RFC 3161 服务地址;如果误用 -t(Authenticode 时间戳),部分 Windows 版本会提示签名“未加时间戳”。另外 CI 中不要把 --storepass 明文写进脚本,用环境变量 + secret 注入;签名机应做网络隔离,那台机器永远不应该同时跑构建任务。

六、配置示例:可复用的批量签名脚本与失败重试

单文件签名容易,批量签名才是事故高发区。下面的 PowerShell 脚本做了两件事:时间戳服务器失败自动切换、每个文件签完立即复验,失败即停。

$ErrorActionPreference = 'Stop'
$Thumb  = 'A1B2C3D4E5F60718293A4B5C6D7E8F9012345678'
$Desc   = 'MyApp'
$TsList = @('http://timestamp.sectigo.com',
            'http://timestamp.digicert.com',
            'http://timestamp.acs.microsoft.com')

function Invoke-Sign {
    param([string]$File)
    foreach ($ts in $TsList) {
        & signtool.exe sign /v /sha1 $Thumb /fd sha256 /td sha256 `
            /tr $ts /d $Desc $File
        if ($LASTEXITCODE -eq 0) { return }
        Write-Warning "时间戳服务器 $ts 失败,切换下一个"
    }
    throw "签名失败:$File"
}

Get-ChildItem -Path .dist -Recurse -Include *.exe,*.dll,*.msi |
    ForEach-Object {
        Invoke-Sign -File $_.FullName
        & signtool.exe verify /pa /q $_.FullName
        if ($LASTEXITCODE -ne 0) { throw "验证失败:$($_.FullName)" }
    }

GitHub Actions 侧把 job 指到自建签名机:

sign:
  runs-on: [self-hosted, windows, codesign]
  steps:
    - uses: actions/download-artifact@v4
      with: { name: dist, path: dist }
    - run: powershell -File .scriptssign-all.ps1
    - uses: actions/upload-artifact@v4
      with: { name: dist-signed, path: dist }

三条硬性规则:先签名,后打包——若先做安装包再往里塞已签名文件,安装包本身必须再签一次;签名后不要再改文件,任何资源修改、加壳(如 UPX)、重新压缩都会让签名失效;失败即停,批量脚本必须检查 $LASTEXITCODE,否则 CI 会产出“看起来成功、实际没签”的产物。

七、EV、OV 与云签名方案对比

维度 OV 代码签名 Sectigo EV 代码签名 云签名 / HSM 托管
验证深度 企业工商信息核验 工商 + D-U-N-S + 电话回拨 + 申请人身份 取决于底层证书
私钥存储 FIPS 140-2 L2+ 硬件或云 HSM USB 令牌,FIPS 140-2 L3,不可导出 CA 侧 HSM
签发时长 1–3 个工作日 1–5 个工作日 数小时至数天
有效期 最长 460 天 最长 460 天 按订阅周期
SmartScreen 表现 需累积下载量,初期仍可能拦截 信誉起点更高,长期稳定签名效果最好 与底层证书类型一致
CI 集成 可导出 PFX,Linux 可签 需自建 Windows 签名机插令牌 API 直连,最适合流水线
典型场景 内部工具、OEM 定制 对外分发的商业软件、驱动、金融客户端 高频发布、纯云 CI 团队

一句话结论:面向公众分发、对首次下载体验敏感的软件选 EV;内部或小范围分发 OV 足够;每天多次发布又没有 Windows 构建机,直接上云签名。另需注意,Microsoft 近年把信誉体系逐步迁往云端(Trusted Signing 等),EV 带来的“立即信任”不再是永久免死金牌,用同一发布者名称持续发布才是根本。

八、常见错误与排查(含真实报错)

  1. SignTool Error: No certificates were found that met all the given criteria.
    含义:当前用户证书存储里没有匹配的代码签名证书。排查顺序:令牌是否插好 → SafeNet Authentication Client 服务是否运行 → certutil -user -store My 能否看到证书 → 指纹是否抄错。若签名进程以服务账户(LocalSystem)运行,用户存储里的证书看不到,需装到 LocalMachineMy 或改用同一用户上下文执行。
  2. SignTool Error: A certificate chain processed, but terminated in a root certificate which is not trusted by the trust provider. (0x800B0109)
    含义:缺中间证书或根证书未受信任。执行 certutil -addstore -f "CA" SectigoPublicCodeSigningCAR36.crt,再用 certutil -verify -urlfetch app.exe 检查整条链。
  3. SignTool Error: The specified timestamp server either could not be reached or returned an invalid response.
    含义:时间戳服务不可达。常见原因是企业代理只放行 443,而 http://timestamp.sectigo.com 走 80 端口;改用 https://timestamp.sectigo.com 或 http://timestamp.digicert.com,并确认已加 /td sha256(缺 /td 会返回格式错误)。
  4. SignTool Error: The signer's certificate is not valid for the requested usage.
    含义:选中的证书 EKU 不是代码签名(1.3.6.1.5.5.7.3.3),多半是同一令牌里还装了 TLS/SSL 证书。用 /sha1 指定指纹,别用 /a 靠自动匹配。
  5. 签名成功但用户仍看到“未知发布者”
    九成是签名之后又动了文件:安装包二次打包、UPX 加壳、资源编辑、CI 里重新压缩后再解压。用 signtool verify /pa /v 复验即可确认签名是否被破坏。
  6. 证书过期后旧安装包签名集体失效
    说明当初没打时间戳。检查 signtool verify /pa /v 输出中是否有 The signature is timestamped:;补签时必须加 /tr + /td sha256,且时间戳服务必须是 RFC 3161 的。

九、效果验证:签名、时间戳与信任链的最终确认

签名完成后必须做三道验证,缺一不可。

# 1) Authenticode 策略校验 + 时间戳告警
signtool verify /pa /v /tw .distapp.exe
# 期望输出包含:
#   Successfully verified: .distapp.exe
#   The signature is timestamped: 2025-01-01 10:00:00

# 2) PowerShell 侧确认状态与时间戳证书
Get-AuthenticodeSignature .distapp.exe |
  Format-List Status, StatusMessage, SignerCertificate, TimeStamperCertificate

# 3) 查看证书有效期
(Get-AuthenticodeSignature .distapp.exe).SignerCertificate |
  Format-List Subject, Thumbprint, NotBefore, NotAfter

# 4) Linux 侧交叉验证
osslsigncode verify -in dist/app.exe

# 5) Sysinternals 快速核对(可选)
sigcheck -a -h .distapp.exe

判定标准:Status 必须为 Valid,而不是 NotSigned / HashMismatch / UnknownError;TimeStamperCertificate 不能为空;NotAfter 应约为签发日 + 460 天。随后在干净的 Windows 虚拟机(建议 Win10 22H2 与 Win11 各一台)实测:文件右键属性应出现“数字签名”选项卡,UAC 提示显示公司名而非“未知发布者”。若仍被 SmartScreen 拦截,属于信誉累积阶段,用同一张证书持续发布新版本,通常数周内缓解。

常见问题

EV 代码签名证书的私钥能导出成 PFX 放到 Linux 上签名吗?

不能。按 CA/Browser Forum 代码签名基线要求,2021-06-01 起签发的代码签名证书私钥必须存放在 FIPS 140-2 Level 2 或 Common Criteria EAL4+ 以上的硬件模块中且不可导出,Sectigo EV 交付的 SafeNet eToken 正属此类。Linux 上想签名只有两条路:使用 CA 提供的云签名 / HSM 接口,或在 CI 中挂一台插着令牌的 Windows 签名机。

证书有效期到底多久?到期后之前签的软件还能用吗?

自 2023-06-01 起代码签名证书最长有效期 460 天(约 15 个月),到期需重新签发。只要签名时带了 RFC 3161 时间戳,证书过期后旧安装包的签名依然有效——验证方判断的是“签名时刻证书是否有效”。反之,没打时间戳的签名会在证书到期当天全部失效。

用了 EV 证书,SmartScreen 就一定不拦了吗?

不一定。EV 显著提升发布者信誉起点,但 Microsoft 已把应用信誉逐步迁到云端模型,仍与下载量、发布者稳定性、文件是否被篡改相关。最常见的踩坑是签名后又重新打包安装包,导致外层文件没有有效签名。保持同一证书、同一发布者名称持续发布,才是稳定通过的做法。

令牌丢了或者密码忘了怎么办?

私钥不可导出,无法恢复,只能向 CA 申请吊销当前证书并用新令牌重新签发。Sectigo 在有效期内支持不限次数重新签发,但吊销会产生 CRL 记录,已发布软件的签名在吊销后会被视为不可信。因此令牌应存放在保险柜级别的环境,密码由两人分管。

驱动签名能直接用这张证书吗?

不能只靠它。Windows 10 1607 之后,内核模式驱动必须经过 Microsoft 的 Attestation 或 WHQL 流程,由 Microsoft 做二次签名;Sectigo EV 证书的作用是给提交给 Microsoft 的 CAB 包签名、以及给驱动安装包(EXE/MSI)签名。签名时需加 /ac 交叉证书与 /kp 参数。

EV 和 OV 价格差不少,怎么选?

看分发范围与发布频率。面向公众下载的桌面软件、金融/安全类客户端、需要尽快通过 SmartScreen 的商业软件选 EV;内部工具、企业内网分发、OEM 定制 OV 足够,且 CI 集成更容易。若每天多次发布又完全没有 Windows 机器,可直接评估云签名方案。

内容审核

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