进阶 docs.pypi.org 2026-10-20 06:39:13 · 24 阅读
第18章 简介:PyPI 数字证明
第18章 简介
本文档介绍了 PyPI 数字证明(PEP 740)的实现,包括 PyPI 特有的 in-toto 证明谓词。
快速背景
数字证明让包维护者以及第三方(如索引本身、外部审计机构等)能够对上传的包进行密码学签名。这些签名将每个发布分发文件(如单个 sdist 或 wheel)与其内容的强密码学摘要绑定在一起,使 PyPI 和下游用户都能验证某个包确实由某个特定身份(如 GitHub Actions workflow)所证明。
这些证明有多种形式,包括发布证明(用于公开验证包是通过特定的 Trusted Publisher 发布的),或者更通用的 SLSA Provenance(证明包的原始来源位置)。
支持的证明类型
PyPI 采用 in-toto Attestation Framework 来处理接受的证明。目前 PyPI 允许以下证明谓词:
- SLSA Provenance - PyPI Publish
每个文件都可以附带其证明一起上传。目前 PyPI 对每个上传的发布文件最多支持两个证明:每个允许的谓词各一个。每个文件的证明超过两个,或存在重复谓词的证明,上传都会被拒绝。
目前,PyPI 允许证明由以下 Trusted Publisher 身份签名:
- GitHub Actions - GitLab CI/CD - Google Cloud - ActveState