代码签名证书申请、配置与购买实战指南(2026 版)
代码签名证书不是给软件加密,而是用 X.509 证书对二进制摘要做 Authenticode 数字签名,让 Windows 在下载、安装和运行阶段显示发布者名称,并验证文件是否被篡改。未签名程序常显示“未知发布者”,触发 SmartScreen 和杀毒软件拦截;根因是操作系统无法建立“发布者身份 + 文件完整性 + 可信时间戳”的信任链。代码签名证书与 SSL/TLS 证书使用公钥基础设施,但用途不同:TLS 证书用于服务器身份认证,代码签名证书必须包含 Code Signing EKU(1.3.6.1.5.5.7.3.3),不能混用。需要特别修正两个常见过时说法:第一,代码签名不是“加密保护代码”,签名后软件仍是明文,只保证完整性和来源认证;第二,不要套用公开 TLS 证书 398 天、Let’s Encrypt 90 天的规则。按当前 CA/B Forum Code Signing BR,2023-06-01 起公共信任代码签名证书普遍要求私钥存储在硬件令牌或 HSM 中,单张证书有效期常见不超过 460 天,具体以 CA 签发策略为准。签名时必须使用 SHA-256 和 RFC 3161 时间戳,SHA-1 已淘汰。
典型业务根因有三类:一是发布流程只做编译不做签名,安装包、DLL、驱动和 PowerShell 脚本漏签;二是证书私钥放在普通磁盘或 CI 明文变量中,不符合硬件密钥保护要求,CA 审计或泄露事件会导致吊销;三是签名后没有时间戳,证书到期后旧版本安装包验签失败。购买阶段还要区分标准版(OV)与 EV:OV 适合常规桌面软件、MSI、EXE、DLL、脚本和 Java JAR;EV 验证更严格,常用于微软 Partner Center、WHQL、Windows 内核驱动和更高信任场景,但 EV 并不等于自动获得 SmartScreen 信誉,信誉仍需下载量和时间积累。
申请前准备:主体资格、密钥与硬件令牌
购买前先确定证书类型和主体。企业申请需准备营业执照或登记证明、组织名称、注册地址、电话、申请人邮箱;个人开发者需准备身份证明。CA 会做组织验证(OV)或扩展验证(EV),可能电话回拨。代码签名证书不验证域名,但会核验组织真实性和申请人授权。生产私钥不能放在普通文件、Git 仓库或 CI 明文变量中;2023-06-01 后应使用 CA 提供的 USB 硬件令牌、HSM 或云签名服务。申请时在令牌内生成密钥对,提交 CSR,私钥不出令牌。采购清单要写清:证书类型、有效期、是否含硬件令牌、是否支持 PKCS#11、是否支持 CI 云签名、时间戳服务、吊销和重签流程、发票与 renewal 通知。EV 还要确认是否支持微软 Partner Center 和驱动签名流程。下面命令仅用于内部测试或自签名验证,不能用于公共信任生产证书。
openssl req -new -newkey rsa:3072 -nodes -keyout codesign.key -out codesign.csr -subj '/C=CN/O=Example Tech Co., Ltd./CN=Example Code Signing/emailAddress=dev@example.com' -addext 'extendedKeyUsage=codeSigning'
openssl req -in codesign.csr -noout -text
如果使用 Windows 内部测试证书,可执行:
New-SelfSignedCertificate -Type CodeSigningCert -Subject 'CN=Example Internal Code Signing' -CertStoreLocation Cert:/CurrentUser/My -KeyUsage DigitalSignature -TextExtension @('2.5.29.37={text}1.3.6.1.5.5.7.3.3')
注意:公共 CA 通常不接受普通 OpenSSL 生成的私钥文件,而是要求令牌内生成 CSR;采购时让 CA 提供令牌驱动、PKCS#11 模块和签名工具说明。
完整实操步骤:从 CSR 到签名
步骤一,在 CA 门户下单并完成组织验证,选择 OV 或 EV,填写组织法定名称、地址、电话和授权联系人。步骤二,插入硬件令牌,用 CA 工具或 PKCS#11 生成密钥对并导出 CSR,密钥长度至少 RSA 3072 或 ECC P-256,摘要算法 SHA-256。步骤三,上传 CSR,CA 签发后下载证书和中间 CA 链,导入令牌或系统证书存储。步骤四,在 Windows 证书存储中确认证书含 Code Signing EKU,执行:
certutil -store My
Get-ChildItem Cert:/CurrentUser/My -CodeSigningCert | Format-List Subject,Thumbprint,NotAfter
步骤五,使用 SignTool 签名并加 RFC 3161 时间戳,THUMBPRINT 替换为实际指纹:
signtool sign /fd SHA256 /tr http://timestamp.digicert.com /td SHA256 /sha1 THUMBPRINT /a app.exe
signtool sign /fd SHA256 /tr http://timestamp.sectigo.com /td SHA256 /sha1 THUMBPRINT /a installer.msi
步骤六,对 DLL、驱动、脚本和安装包逐一签名,不要只签 EXE。PowerShell 脚本可用:
$cert = Get-ChildItem Cert:/CurrentUser/My -CodeSigningCert | Select-Object -First 1
Set-AuthenticodeSignature -FilePath script.ps1 -Certificate $cert -TimestampServer http://timestamp.digicert.com -HashAlgorithm SHA256
步骤七,Linux 或 CI 环境可用 osslsigncode,生产环境应通过 PKCS#11 访问令牌,避免导出私钥:
osslsigncode sign -pkcs11engine /usr/lib/x86_64-linux-gnu/engines-3/pkcs11.so -pkcs11module /usr/lib/x86_64-linux-gnu/opensc-pkcs11.so -key 0:9a -certs cert.pem -n 'Example App' -t http://timestamp.digicert.com -in app.exe -out app-signed.exe
步骤八,保存签名日志、证书指纹、时间戳响应和构建号,便于审计和吊销后重签。
配置示例:SignTool、osslsigncode 与 CI
Windows 发布流水线建议固定参数:/fd SHA256 指定文件摘要,/td SHA256 指定时间戳摘要,/tr 指定 RFC 3161 时间戳地址,/a 自动选择合适证书。若使用 PFX 测试文件,命令为:
signtool sign /fd SHA256 /f codesign.pfx /p PASSWORD /tr http://timestamp.digicert.com /td SHA256 app.exe
signtool verify /pa /v app.exe
GitHub Actions 可把硬件令牌接入自托管 Runner,或用 CA 云签名服务,不要把 PFX 和密码放进仓库。示例步骤:
- name: Sign app
run: signtool sign /fd SHA256 /tr http://timestamp.digicert.com /td SHA256 /sha1 $env:CERT_THUMBPRINT /a app.exe
Linux 构建可用 osslsigncode 的 PFX 测试模式:
osslsigncode sign -pkcs12 codesign.pfx -pass PASSWORD -n 'Example App' -i https://example.com -t http://timestamp.digicert.com -in app.exe -out app-signed.exe
osslsigncode verify -in app-signed.exe
Java JAR 可用 jarsigner:
jarsigner -digestalg SHA-256 -sigalg SHA256withRSA -tsa http://timestamp.digicert.com app.jar codesign
配置要点:时间戳服务器至少配置主备两个;签名失败要让 CI 失败,不能跳过;对安装包内所有可执行文件签名;保留未签名构建产物用于比对哈希;证书续期后更新指纹和密钥材料。EV 证书通常要求令牌始终插入或云签名授权,CI 需使用支持 PKCS#11 的签名代理。
标准版与 EV 代码签名证书对比
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
- HTTPS证书申请 · SSL证书安装部署 · 证书续费
- SSL/HTTPS 证书配置 · 证书安装 · 证书申请
选择证书时不要只看价格。标准版 OV 能满足大多数 Windows 软件、MSI、EXE、DLL、PowerShell 和 Java 签名;EV 验证更严格,适合驱动、WHQL、Partner Center 和高信任分发。两者都应使用 SHA-256、RFC 3161 时间戳和硬件密钥保护。
| 项目 | 标准版 OV | EV 代码签名 | 自签名测试证书 |
|---|---|---|---|
| 身份验证 | 组织验证,电话回拨 | 扩展验证,材料更严格 | 无第三方验证 |
| 私钥存储 | 硬件令牌或 HSM | 硬件令牌或 HSM | 本地文件或证书存储 |
| 有效期 | 单张常见不超过 460 天,以 CA 为准 | 单张常见不超过 460 天,以 CA 为准 | 自定义 |
| 适用场景 | EXE、MSI、DLL、脚本、JAR | 驱动、WHQL、Partner Center、高信任软件 | 内部测试 |
| SmartScreen | 需积累信誉 | 不保证立即通过,仍需信誉 | 不适用 |
| 时间戳 | 必须配置 | 必须配置 | 可选 |
| 成本与交付 | 较低,令牌可能另计 | 较高,验证和令牌流程更长 | 免费 |
购买建议:公开分发的 Windows 桌面软件优先选 OV,预算允许且涉及驱动或微软生态认证再选 EV;只做内部测试用自签名证书,但必须把自签名根证书通过组策略部署到测试机。证书到期前 30 到 60 天启动续期,确认 CA 通知、令牌回收和旧证书吊销策略。
常见错误排查(含真实报错)
报错一:SignTool Error: No certificates were found that met all the given criteria. 原因是指纹错误、证书不在当前用户存储、令牌未插入或证书无 Code Signing EKU。执行 certutil -store My 和 Get-ChildItem Cert:/CurrentUser/My -CodeSigningCert 核对指纹与有效期;CI 中确认证书导入到运行签名任务的账户。
报错二:SignTool Error: The signer certificate is not valid for code signing. 原因是证书 EKU 不包含 1.3.6.1.5.5.7.3.3,或误用了 TLS 证书。重新申请代码签名证书,不能把 SSL/TLS 证书用于 Authenticode。
报错三:SignTool Error: A certificate chain could not be built to a trusted root authority. 原因是缺少中间 CA 或根证书未受信。安装 CA 提供的中间证书链,必要时用 signtool sign /ac intermediate.cer 指定中间证书,并在目标系统用 certutil -verify -urlfetch cert.cer 检查链。
报错四:SignTool Error: The specified timestamp server either could not be reached or returned an invalid response. 原因是网络、代理、防火墙或时间戳地址不可用。换用 http://timestamp.digicert.com 或 http://timestamp.sectigo.com,检查 80 和 443 出站,重试并保留时间戳日志。
报错五:osslsigncode: Failed to load PKCS11 module. 原因是 PKCS#11 模块路径或令牌驱动错误。用 opensc-tool -l 或 pkcs11-tool -L 确认模块,核对 -pkcs11module 路径和 -key 槽位。报错六:The specified PFX password is not correct. 检查密码编码和 CI 变量,不要把密码写入脚本。
效果验证与发布检查清单
签名后必须验签,不能只看命令返回码。Windows 执行 signtool verify /pa /v app.exe,期望输出 Successfully verified;再执行 signtool verify /pa /v /tw app.exe 检查时间戳。PowerShell 执行 Get-AuthenticodeSignature app.exe | Format-List,Status 应为 Valid,SignerCertificate 的 Subject 应显示组织名称,TimeStamperCertificate 不应为空。Linux 执行 osslsigncode verify -in app-signed.exe,期望 Succeeded。证书链可用 certutil -verify -urlfetch cert.cer 检查。
signtool verify /pa /v app.exe
Get-AuthenticodeSignature app.exe | Format-List Status,StatusMessage,SignerCertificate,TimeStamperCertificate
osslsigncode verify -in app-signed.exe
发布检查清单:1)EXE、DLL、MSI、驱动、脚本、JAR 是否全部签名;2)是否使用 SHA-256 和 RFC 3161 时间戳;3)证书是否含 Code Signing EKU;4)私钥是否在令牌或 HSM;5)安装包内文件签名后是否被再次修改;6)证书到期后旧安装包是否仍能验签;7)是否保留签名日志和哈希;8)是否配置证书到期通知和吊销监控。效果上,用户安装时看到的是组织名称而不是“未知发布者”,SmartScreen 和杀毒误报会随签名与信誉积累改善,但代码签名不能保证 100% 消除误报,也不能替代安全开发、代码审计和漏洞修复。
常见问题
代码签名证书和 SSL/TLS 证书能混用吗?
不能。TLS 证书 EKU 是 serverAuth,用于服务器身份认证;代码签名证书 EKU 是 codeSigning(1.3.6.1.5.5.7.3.3),用于 Authenticode。把 TLS 证书拿去签 EXE 会报 The signer certificate is not valid for code signing。
证书过期后已签名的软件还能用吗?
只要签名时加了可信 RFC 3161 时间戳,证书过期后旧签名通常仍可验证,因为验证的是签名时刻证书有效。若没有时间戳,证书到期后验签会失败。续期后应用新证书重新签名新版本,不必追签所有旧版本,但关键安装包建议重签。
标准版和 EV 怎么选?
常规 EXE、MSI、DLL、脚本和 JAR 选标准版 OV 即可;涉及 Windows 内核驱动、WHQL、微软 Partner Center 或高信任分发选 EV。EV 验证更严格、成本更高,但不等于自动通过 SmartScreen,信誉仍需下载量和时间积累。
为什么代码签名证书必须用硬件令牌或 HSM?
按当前 CA/B Forum Code Signing BR,2023-06-01 起公共信任代码签名证书要求私钥在硬件加密模块中保护,防止私钥被复制、泄露和滥用。生产环境不要把 PFX 私钥放普通磁盘或 CI 明文变量,应使用 USB 令牌、HSM 或云签名服务。
代码签名能消除杀毒软件误报吗?
不能保证。代码签名让系统显示可信发布者并验证完整性,能减少“未知发布者”警告,但杀毒引擎仍可能基于行为、启发式或样本信誉拦截。需要配合代码审计、提交误报、积累下载信誉和持续更新。
代码签名证书有效期是 398 天吗?
不是。398 天是公开 TLS 证书的单张最长有效期规则;Let’s Encrypt 常见为 90 天。代码签名证书按 Code Signing BR 管理,2023-06-01 后普遍要求硬件密钥保护,单张有效期常见不超过 460 天,具体以 CA 签发策略和证书类型为准。