Skip to content

docs(security): the task SBOM is the base SBOM, attested — read it with cosign verify-attestation - #163

Draft
LukasWodka wants to merge 2 commits into
developfrom
docs/sbom-form-attested
Draft

docs(security): the task SBOM is the base SBOM, attested — read it with cosign verify-attestation#163
LukasWodka wants to merge 2 commits into
developfrom
docs/sbom-form-attested

Conversation

@LukasWodka

Copy link
Copy Markdown
Contributor

DRAFT = HOLD until tracebloc/tracebloc-engine#950 merges (backend#3317 lever c). Docs must not describe unshipped behaviour; this page changes how a customer reads a task image's SBOM.

What changes on the page

Section View the SBOM and provenance of environment-setup/security.mdx: the task image's SBOM becomes a cosign attestation on the digest (cosign verify-attestation --type spdxjson with the same identity regexp as the signature; one SPDX statement per platform), while build provenance stays inline (imagetools inspect --format '{{ json .Provenance }}') and names the base digest. The base images carry their SBOM inline. A <Note> covers the one-release transition (older digests behind :stg/:prod still answer to the inline command).

Why

The task Dockerfiles install nothing (a publish-time guard now refuses any change that would), so the SBOM of a task image is by construction the base image's; generating it per leg cost ~15 min of the longest task-image build. Details on tracebloc/tracebloc-engine#950.

Checklist

  • Targets develop (the page lives there)
  • Undraft only after engine#950 is on develop

…ith cosign verify-attestation; provenance stays inline

Held until tracebloc-engine#950 (backend#3317 lever c) merges: this page must not describe unshipped behaviour.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@LukasWodka LukasWodka self-assigned this Sep 8, 2026
@LukasWodka
LukasWodka requested a review from saadqbal September 8, 2026 14:45
…to the base's inline SBOM (backend#3439 part 3)

Still held until tracebloc-engine#961 merges.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@LukasWodka

Copy link
Copy Markdown
Contributor Author

Amended to the attest-by-reference form (tracebloc-engine#961, backend#3439 part 3): the consumer still runs cosign verify-attestation --type spdxjson … | jq .predicate, then follows externalDocumentRefs[0] to the base image's inline SBOM (imagetools inspect for the content, crane blob … | sha256sum for the bytes). Still DRAFT = HOLD until #961 is on develop and the repaired digests verify.

@LukasWodka
LukasWodka requested review from saqlainsyed007 and removed request for saadqbal September 9, 2026 15:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants