release/provenance/python
Releases attest build provenance
Implements release/provenance for python.
| Severity | warning |
| Tiers | 1 |
| Stacks | python |
| Scope | root |
| Kind | outcome |
| Source | library v0.2.0 |
| Selected by | fleetlint-recommended@v0.2.0 |
Requirement
Distributions are uploaded by pypa/gh-action-pypi-publish with trusted publishing, which attaches PyPI attestations unless attestations: false; or a stack-neutral attestation.
Why
Provenance ties the artifact to the exact source and workflow that built it, which a signature alone does not.
Capability applies when
release.exists && tagged_workflows().size() > 0Fix
Publish with pypa/gh-action-pypi-publish from a job with id-token: write (trusted publishing).
Agent instruction: Add a step uses: actions/attest-build-provenance with subject-path covering the release artifacts; grant id-token: write and attestations: write to that job only. On GitLab set the variable RUNNER_GENERATE_ARTIFACTS_METADATA to “true” on the release job. On Gitea write a SLSA v1 predicate and run cosign attest-blob --type slsaprovenance1.
See: https://fleetlint.org/baseline/#releases, https://slsa.dev/spec/v1.0/provenance, https://fleetlint.org/stacks/#python, https://docs.pypi.org/attestations/
Generated by fleetlint docs from catalog v0.2.0.