进阶 docs.pypi.org 2026-10-20 06:39:13 · 24 阅读

第22章 PyPI 认证的安全模型与注意事项

安全模型与注意事项

认证(attestations)本质上是一套用于声明软件包某些事实的框架。因此,认证的安全模型取决于它所声明的具体事实类型。

最基础的认证类型(也是 pypa/gh-action-pypi-publish 默认启用的类型)声明该项目是由某个受授权的发布者(例如特定代码仓库中的某个 CI 服务)发布的。这类认证主要有两个目的:

- 防止项目在被构建后遭篡改,例如在存储于软件包索引或镜像期间被恶意修改。 - 让验证方能够观察到项目 Trusted Publisher(可信发布者)的变化。例如,如果验证方发现项目的新版本来自不同的 Trusted Publisher,这可能意味着项目的控制权已发生变动,甚至可能存在恶意接管。

更高级的认证类型可以声明关于软件包更多的信息,例如构建前是否被篡改。但这些认证需要专门化的构建流程,因此相对少见。请参考 SLSA FAQ 中“关于可复现构建”的相关说明。

通用考量

PyPI 对认证的支持建立在 Trusted Publishing(可信发布)与 Sigstore 的“无密钥签名”能力之上。以下是针对这两项技术的具体安全考量。

可信度

Note 简而言之:认证只能告诉你 PyPI 软件包来自哪里,但不能告诉你是否应该信任它。

在所有签名机制中,人们都很容易将“存在认证”误认为软件包可信度的证明。然而,这正是认证(或任何形式的签名)并不传达的含义。核心而言,软件包上针对某身份的有效签名,仅证明在软件包构建期间,该身份拥有访问权限。换言之:有效签名并未告知验证方(例如从 PyPI 安装软件包的用户)是否应该信任持有密钥的身份,也未告知是否在构建前或构建过程中引入了恶意/易受攻击的代码。

举个具体的例子:PyPI 提供了 sampleproject-4.0.0.tar.gz,该文件由 GitHub 上的 pypa/sampleproject 进行认证。这证明了 sampleproject-4.0.0.tar.gz 源自该身份且未被修改,但并未告知用户是否应该信任 pypa/sampleproject。为了判断可信度,用户必须自行做出对 pypa/sampleproject 的信任决策。

这一信任决策可以包含时间维度:用户可能因为 pypa/sampleproject 是 PyPI 上 sampleproject 名称对应的首个身份而决定信任它。随后,如果 sampleproject 的新版本由一个新身份(如 "pypa/evil-sampleproject")认证,或者完全没有认证,用户可以自动观察到这一差异并开始着手应对。

Trusted Publishing

由于认证与 Trusted Publisher 身份绑定,Trusted Publishers - Security Model and Considerations 中所述的所有注意事项同样适用于认证。

总体而言:虽然 Trusted Publishing 和认证比密码或长期有效的 API 令牌更安全、更抗滥用,但它们不能替代基本的安全实践,例如限制谁有权触发你的发布工作流。

Sigstore 的“无密钥”签名

Tip 关于“无密钥”签发的详细信息,请参见 Fulcio 的《证书颁发概述》。

PyPI 的认证支持围绕“无密钥”(也称为“基于身份”)签名构建。PyPI 项目并非使用长期有效的签名密钥,而是由与其 Trusted Publishers 之一匹配的身份进行签署。该身份通过一项类似 Trusted Publishing 使用但针对 Sigstore 的 OpenID Connect (OIDC) 操作,在密码学上绑定到一个短期有效的签名密钥:

- Trusted Publishing/认证行为主体(如 GitHub Actions 工作流)由其身份提供商颁发一个 OIDC 令牌。 - 该 OIDC 令牌连同临时密钥对的公钥部分一起发送给 Sigstore 的公共证书颁发机构(CA)Fulcio。如果 OIDC 令牌有效(即未过期且确由其声称的身份提供商颁发),Fulcio 将返回一个 X.509 签名证书,将 OIDC 令牌中的声明与公钥绑定。 - 认证行为主体现在可以使用其临时密钥对的私钥部分进行签名。签名完成后,临时私钥即可丢弃,因为 X.509 签名证书已永久将其公钥部分与验证期间使用的身份绑定。

这种“无密钥”方法在易用性与信任之间做出了权衡:与传统长期有效的签名密钥不同,这里存在一个可信第三方(Sigstore 的 Fulcio CA)中介了签名密钥与其关联身份之间的绑定。作为交换,Sigstore 提供了抗滥用、短期有效且绑定于可验证身份的签名密钥。

这与 HTTPS 中的权衡类似,其中 CA 作为可信第三方,将网站的身份(即其域名)与其公钥绑定。

与 HTTPS 生态系统类似,Sigstore 也采取措施减少对 Fulcio CA 不必要的信任:

- Sigstore 运营着证书透明度(CT)日志,可以通过监控和审计确认,除非提供了特定身份的合法凭证,否则 Fulcio 不会为该身份颁发证书。 - Sigstore 还运营 Rekor 作为“软件包透明度”日志,实际上记录了使用 Fulcio 颁发证书进行的每一次签名事件。与 CT 日志类似,Rekor 也可以被监控和审计,以确认 Fulcio 颁发的证书没有签署……

综合来看,这些透明度机制通过使 Fulcio 的完整性在密码学上可审计和可验证,从而削弱了对 Fulcio 的依赖信任。

PyPI 的认证功能充分利用了这些降低信任依赖的技术:除非认证包含来自 Rekor 的包含证明(inclusion proof)以及来自 Fulcio CT 日志的包含证明,否则该认证被视为未经验证。

评论 (0)