代码签名证书（Code Signing）

代码签名证书是什么？代码签名如何工作？

代码签名（Code Signing）是用公钥密码学为软件附加“发布者身份 + 完整性”证明的技术。代码签名证书是其中的身份凭证：CA 核验申请者（个人或组织）的真实身份后，签发一张写有发布者名称与公钥、扩展密钥用法为 codeSigning 的 X.509 证书。开发者用与之对应的私钥签名软件，用户的操作系统再用证书中的公钥验证签名。在 Windows 中，这套机制称为 Authenticode。

签名与验证的过程

1. 计算哈希：签名工具（如 Windows SDK 中的 signtool）对程序文件计算哈希值，当前应使用 SHA-256；
2. 私钥签名：用存放在 USB 令牌、HSM 或云签名服务中的私钥对哈希值签名，私钥本身始终不离开硬件；
3. 嵌入签名与证书链：签名值、代码签名证书与中间证书一起写入文件，Authenticode 签名直接嵌入 .exe、.dll、.msi 等文件中；
4. 加时间戳：签名工具把签名值的哈希发送给 CA 的 RFC 3161 时间戳服务器，取回由时间戳机构签名的“签名时间”证明，并一同嵌入文件；
5. 用户端验证：用户运行程序时，系统重新计算哈希并与签名比对，沿证书链验证到受信任的根证书并检查吊销状态，通过后在用户账户控制（UAC）提示中显示“已验证的发布者”。

代码签名能证明什么，不能证明什么

• 能证明：软件由证书中写明的发布者签名；签名之后文件没有被修改，包括被植入恶意代码、被捆绑或在下载途中被篡改；
• 不能证明：软件本身是安全的、没有漏洞或恶意功能。CA 只核验发布者身份，不审查代码内容。如果签名私钥被盗并用于签名恶意软件，CA 会吊销该证书。

因此，代码签名的价值来自可追溯的身份：每一个签名都能追溯到经过 CA 核验的个人或组织。这也是 Windows、杀毒软件与企业安全策略普遍把“是否有有效签名、由谁签名”作为信任判断依据之一的原因。

为什么一定要加时间戳？

没有时间戳的签名，其有效性取决于“验证时证书是否仍然有效”：证书一过期，所有未加时间戳的程序都会显示签名无效。加了 RFC 3161 时间戳后，系统改为检查“签名时证书是否有效”，只要签名发生在证书有效期内且证书没有因此被吊销，程序在证书过期多年后仍能正常验证。在单张证书最长 460 天的情况下，时间戳几乎是必选项。公共 CA 普遍提供免费的 RFC 3161 时间戳服务，地址见各 CA 的签名指南。

代码签名证书有哪些硬性规则？

公共信任的代码签名证书受 CA/浏览器论坛《代码签名基线要求》（Baseline Requirements for the Issuance and Management of Publicly-Trusted Code Signing Certificates，简称 CSBR）约束。2023 年以来，私钥必须硬件保护与证书有效期缩短，是对开发者影响最大的两项变化。

私钥交付方式：USB 令牌、HSM 还是云签名？

硬件存储要求生效后，代码签名证书不再以文件形式交付。根据团队规模与签名频率，可以选择三种方式：

SmartScreen 提示为什么还在？

Microsoft Defender SmartScreen 会根据文件与发布者的信誉决定是否显示“Windows 已保护你的电脑”。代码签名让信誉可以累积到发布者身份上，但新证书、新发布者在下载量不足时仍可能触发提示。微软已调整 SmartScreen，EV 证书不再保证立即消除提示，信誉仍需积累。建议用同一发布者身份持续签名所有版本、通过官网等正规渠道分发，并避免频繁更换签名主体。

常见错误

• 忘记加时间戳：证书一过期，已发布的程序全部显示签名无效，只能重新签名并重新发布；
• 多人共用签名令牌：令牌和 PIN 在团队中随意传递，或长期插在联网的构建机上，一旦被滥用签名恶意程序，证书会被吊销，影响所有已发布的软件；
• 签名时机不当：先签名再修改文件（例如再次打包、写入资源），会导致签名失效，签名应放在构建的最后一步；
• 平台用错证书：用公共 CA 代码签名证书去签 macOS 或 Android 应用，这些平台使用各自的签名体系。