Skip to content

docs: say what the gateway measures, and when - #664

Merged
imran-siddique merged 1 commit into
mainfrom
docs/measurement-before-first-call
Sep 18, 2026
Merged

imran-siddique merged 1 commit into
mainfrom
docs/measurement-before-first-call

Conversation

@imran-siddique

Copy link
Copy Markdown
Member

The README (lines 49, 106, 276) and docs/SPEC.md line 83 say the policy bundle hash is measured into the attestation report "before any code runs". That is not what the runtime does, and a reader who checks startup.py will find so.

Step 3b of startup measures installed code, the policy bundle and config before the gateway serves traffic (tee/measurement.py, gateway_measurement). On sev-snp, azure-cvm-sev-snp and tdx the digest goes into report_data (tee/report_binding.py, MEASUREMENT_BOUND_PROVIDERS); on the TPM tier it is extended into a certified NV index. refresh_measurement_binding re-attests on every bundle reload.

This changes the four sentences to say that. The real guarantee is stronger than the old wording: it covers code and config as well as policy, and it survives a reload. Docs only, no behaviour change.

🤖 Generated with Claude Code

Signed-off-by: Imran Siddique <imran.siddique@opaque.co>
@imran-siddique
imran-siddique merged commit 49392a4 into main Sep 18, 2026
16 checks passed
@imran-siddique
imran-siddique deleted the docs/measurement-before-first-call branch September 18, 2026 18:09
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