跳到主要内容
代码签名证书(Code Signing Certificate)

代码签名证书申请、配置与购买实战指南(2026 版)

代码签名证书申请、配置与购买实战指南(2026 版) — 代码签名证书申请、配置与购买实战指南(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 代码签名证书对比

选择证书时不要只看价格。标准版 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 签发策略和证书类型为准。

内容审核

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