Skip to content

docs(adr): sanction Rekor transparency-log reads for signature continuity (amend 0015 + 0020)#134

Merged
thejefflarson merged 1 commit into
mainfrom
docs/adr-rekor-egress
Jun 30, 2026
Merged

docs(adr): sanction Rekor transparency-log reads for signature continuity (amend 0015 + 0020)#134
thejefflarson merged 1 commit into
mainfrom
docs/adr-rekor-egress

Conversation

@thejefflarson

Copy link
Copy Markdown
Owner

Records the operator-accepted egress carve-out for ADR-0020 signature continuity.

The engine may read the public Rekor transparency log to: verify signature inclusion (already implicit in keyless cosign verify), bootstrap a repo's signing baseline from the public history (the fix for TOFU cold-start), and detect registry↔log divergence (tampering).

Honest about the tension with ADR-0015's zero-egress posture: that ADR rejected per-CVE lookups because they leak the cluster's vulnerability profile; a Rekor query keyed on an image digest has the same shape (leaks which images run) — but the leaked datum is image identifiers (already public from public registries), not the vuln profile, and the security graph/evidence still never leave. A self-hosted Rekor mirror restores full zero-egress (signature inventory still works offline; only the public history/divergence go dark).

  • 0020 §4 — the transparency-log element (inclusion + history bootstrap + divergence); cold-start consequence amended to note Rekor narrows it.
  • 0015 — amendment section + relates-to + README status note.

Implemented by the new Linear ticket (Rekor bootstrap + divergence), blocked by JEF-261.

🤖 Generated with Claude Code

…uity (amend 0015 + 0020)

Records the operator-accepted egress carve-out: the engine may read the public Rekor
transparency log to (a) verify signature inclusion (already implicit in keyless cosign
verify), (b) bootstrap a repo's signing baseline from the public history — the fix for
ADR-0020's TOFU cold-start weakness — and (c) detect registry↔log divergence (tampering).

Honest about the tension: ADR-0015 rejected per-CVE lookups because they leak the
cluster's vulnerability profile; a Rekor query keyed on an image digest has the same
shape (it leaks which images run), but the leaked datum is image identifiers (already
public) not the vuln profile, and the security graph/evidence still never leave. A
self-hosted Rekor mirror restores full zero-egress (inventory still works offline).

- 0020 §4: the transparency-log element (inclusion + history bootstrap + divergence);
  cold-start consequence amended to note Rekor narrows it.
- 0015: amendment section + relates-to + README status note.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VtjoJttCvBY4dzCoE4f9vP
@thejefflarson thejefflarson merged commit e2e585e into main Jun 30, 2026
1 of 3 checks passed
@thejefflarson thejefflarson deleted the docs/adr-rekor-egress branch June 30, 2026 04:31
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.

1 participant