Skip to content

ADR on source provenance verification#268

Merged
ralphbean merged 7 commits intomainfrom
source-slsa
Oct 31, 2025
Merged

ADR on source provenance verification#268
ralphbean merged 7 commits intomainfrom
source-slsa

Conversation

@ralphbean
Copy link
Copy Markdown
Member

No description provided.

Comment thread ADR/####-slsa-source-provenance-verification.md Outdated
Comment thread ADR/####-slsa-source-provenance-verification.md Outdated
Copy link
Copy Markdown
Contributor

@chmeliik chmeliik left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This makes sense to me. Do we also want to say something about git submodules, or leave that for the future?

Comment thread ADR/####-slsa-source-provenance-verification.md Outdated
Comment thread ADR/####-slsa-source-provenance-verification.md Outdated
Comment thread ADR/####-slsa-source-provenance-verification.md
The verification task already captures the public key as a task parameter,
which is included in the build attestation by Tekton Chains. Recording it
again in task results is redundant.

Updates three references:
- Removes bullet point about recording public key in results from
  verification workflow section
- Clarifies Conforma reads public key from task parameters, not results
- Removes duplicate line from implementation requirements section

Addresses review feedback from chmeliik in PR #268.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
Signed-off-by: Ralph Bean <rbean@redhat.com>
Comment thread ADR/####-slsa-source-provenance-verification.md Outdated
Comment thread ADR/####-slsa-source-provenance-verification.md
Comment thread ADR/####-slsa-source-provenance-verification.md Outdated
Comment thread ADR/####-slsa-source-provenance-verification.md Outdated
Comment thread ADR/####-slsa-source-provenance-verification.md Outdated
Comment thread ADR/####-slsa-source-provenance-verification.md Outdated
Comment thread ADR/####-slsa-source-provenance-verification.md Outdated
Comment thread ADR/####-slsa-source-provenance-verification.md Outdated
Comment thread ADR/####-slsa-source-provenance-verification.md
Comment thread ADR/####-slsa-source-provenance-verification.md Outdated
@ralphbean
Copy link
Copy Markdown
Member Author

Re: #268 (comment)

Updated the text to clarify that the public key is read from the provenance attestation of the verification task (which includes the task parameters).

Updates based on code review feedback:

1. Clarify that Conforma reads the public key from the provenance
   attestation of the verification task (which includes task parameters)

2. Add explicit mention that Conforma verifies trust in the source
   verification task itself using Trusted Tasks mechanisms (ADR 53)

3. Specify that the verification task will be maintained in
   build-definitions with possibility of future relocation

4. Remove "OCI storage overhead" from negative consequences as the
   duplication provides desirable availability/reliability benefits

5. Clarify ITS provisioning is a capability for deployments that choose
   to adopt source provenance verification, not a mandatory global rollout

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
Signed-off-by: Ralph Bean <rbean@redhat.com>
ralphbean and others added 2 commits October 31, 2025 13:51
Updates based on second round of review feedback:

1. Clarify relationship between Build Track and Source Track in Context
   section, providing better foundation for discussing source provenance

2. Specify OCI storage mechanism: task uses OCI referrers API (via
   oras attach) with container image as subject of OCI reference (git
   commit remains subject within VSA payload)

3. Note that Conforma supports both tag-based and referrers-based
   attestation storage mechanisms

4. Expand trust model explanation to include reliance on Trusted Tasks
   mechanisms for verifying task provenance

5. Add timing consideration as race condition mitigation: typical
   workflows have builds taking longer than VSA generation, reducing
   likelihood of unfavorable race condition outcomes

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
Signed-off-by: Ralph Bean <rbean@redhat.com>
Signed-off-by: Ralph Bean <rbean@redhat.com>
Comment thread ADR/####-slsa-source-provenance-verification.md Outdated
After discussion,we learned that the tag-based fallback is unsupportable here.
Comment thread ADR/####-slsa-source-provenance-verification.md
Comment thread ADR/####-slsa-source-provenance-verification.md
Copy link
Copy Markdown
Member

@arewm arewm left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the clarifications and updates. Approved.

@ralphbean ralphbean merged commit 4c2cb30 into main Oct 31, 2025
2 checks passed
@ralphbean ralphbean deleted the source-slsa branch October 31, 2025 18:42
ralphbean added a commit that referenced this pull request Nov 3, 2025
🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
Signed-off-by: Ralph Bean <rbean@redhat.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size/L Large

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants