进阶 docs.pypi.org 2026-10-20 06:39:13 · 25 阅读
第20章 消费 PyPI 认证信息
Consuming attestations PyPI 通过简单索引(HTML)和简单 JSON API 提供文件的认证信息。完整的 API 参考请参阅 Integrity API 文档。 内部机制 由于分发文件可能拥有多条认证信息,且 PyPI 将这些认证信息打包为一个 JSON 文件提供,该文件会将认证信息归类到一个 provenance(溯源)对象中。此对象包含按签名所用的 Trusted Publisher 身份进行分组的认证信息束。 若要手动验证 PyPI 产物与其 provenance 对象,可使用 pypi-attestations CLI 工具: export WHEEL_DIRECT_URL=https://files.pythonhosted.org/packages/d7/73/c16e5f3f0d37c60947e70865c255a58dc408780a6474de0523afd0ec553a/sampleproject-4.0.0-py3-none-any.whl
pypi-attestations verify pypi --repository https://github.com/pypa/sampleproject $WHEEL_DIRECT_URL
该命令会从 PyPI 下载 wheel 及其对应的 provenance JSON(通过 Integrity API),检查 provenance 中指定的 Trusted Publishers 是否匹配用户传入的 --repository 参数,最后对该 wheel 执行密码学验证,确认其符合所附带的认证信息。