feat: bind the destroy gate to approval_binding_digest and pdp_path
The vocabulary mapping this path was waiting on is not coming: gate-house rejected it in GH-DEC-2026-008, because a translation can be confidently wrong and fails open by accepting a claim approved for a different action. The stronger option arrived instead, and both halves are enforced here. flex-auth published binding.approval_binding_digest (FLEX-DEC-2026-007) to fix the circularity this repo reported: a pdp_digest recorded at issue time can never equal the request_digest of the request that carries the claim in its hashed context, so with GH-DEC-2026-008 requiring that equality, destroy would have failed closed forever on a check no correct record could pass. - authorization.approval_binding_digest implements the published exclusion rule, including Go's context,omitempty behaviour when stripping empties the context; digest_material drops an empty context for the same reason. - validate_decision_envelope recomputes the field rather than trusting it, refuses a claim-bearing request whose decision records none, and compares the claim's digest from step 1 against it -- never against request_digest, which still covers the claim so it stays a sound replay identity. - validate_approval_claim requires binding.pdp_path true before using pdp_digest at all. Path intent is never inferred from a digest that happens to be present; pre-schema-v3 approvals carry pdp_path false regardless of any digest they hold. Replay fixtures re-vendored from dd3ce4c. The destroy pins moved a second and final time; approval_binding_digest did not, which is the point. The fixture now demonstrates the property instead of asserting it: we rederive fa07becf... from its own request through our canonical implementation, proving we hash the same material flex-auth does rather than pinning a constant we cannot reproduce. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01E4tNMAYcSQmZWUE4wqP4ij Assistant: claude-code Assistant-Model: opus Assistant-Process: 715726@bnt-lap001 Assistant-Session: 80a42b32-cba6-4b23-8be0-68819b1a6092
This commit is contained in:
parent
67b28f48a8
commit
c44306b1b2
11 changed files with 411 additions and 40 deletions
|
|
@ -17,6 +17,7 @@ from pathlib import Path
|
|||
import pytest
|
||||
|
||||
from secrets_engine.authorization import (
|
||||
approval_binding_digest,
|
||||
digest_material,
|
||||
request_digest,
|
||||
validate_decision_envelope,
|
||||
|
|
@ -37,9 +38,9 @@ CASES = {
|
|||
},
|
||||
"destroy": {
|
||||
"file": "decision_destroy_dual_control.json",
|
||||
"digest": "sha256:fc155dba88f8ab18b3032ed086ba2f455158c6981106e7829d520ab7b036bdf3",
|
||||
"digest": "sha256:c749ee2dc3cdf927a70a3e5b27cff4d97a438d3264153b4b2e3bcacbaf82091a",
|
||||
"action": "destroy",
|
||||
"context_claim_digest": "sha256:b0d2203cd2b43a9ba573c21c038154c131afba4255e313affd7ecf810e2cc221",
|
||||
"context_claim_digest": "sha256:8b73d29ecef286d42e03d2420531d6c45219f325a7ae004c1ecfc781203a2800",
|
||||
},
|
||||
}
|
||||
|
||||
|
|
@ -180,14 +181,19 @@ def test_embedded_claim_uses_approval_engine_vocabulary_not_ours():
|
|||
assert claim["binding"]["target"]["id"] != envelope["resource"]["id"]
|
||||
|
||||
|
||||
APPROVAL_BINDING_DIGEST = (
|
||||
"sha256:fa07becfaa471394d06aee5fa3cd66352bf0cc69ef24900240489684cda8cd56"
|
||||
)
|
||||
|
||||
|
||||
def test_embedded_claim_pdp_digest_cannot_equal_the_carrying_request_digest():
|
||||
"""Carrying the claim inside a hashed context makes the two unequal.
|
||||
|
||||
context is part of the digest material, so embedding an approval-claim
|
||||
changes the request digest of the very request that carries it. A
|
||||
pdp_digest recorded at issue time therefore cannot equal the final digest
|
||||
of the dual-control request. Raised with approval-engine and flex-auth; this
|
||||
test records the property so a future change is visible rather than silent.
|
||||
of the dual-control request. This is why comparing pdp_digest against
|
||||
request_digest can never pass and would fail destroy closed forever.
|
||||
"""
|
||||
envelope = _envelope("destroy")
|
||||
binding = envelope["binding"]
|
||||
|
|
@ -195,8 +201,112 @@ def test_embedded_claim_pdp_digest_cannot_equal_the_carrying_request_digest():
|
|||
request = _request_from(envelope)
|
||||
assert request_digest(request) == binding["request_digest"]
|
||||
assert pdp != binding["request_digest"]
|
||||
without_claim = dict(request)
|
||||
without_claim["context"] = {
|
||||
k: v for k, v in binding["context"].items() if k != "approval"
|
||||
}
|
||||
assert pdp != request_digest(without_claim)
|
||||
|
||||
|
||||
def test_pdp_digest_equals_the_published_approval_binding_digest():
|
||||
"""FLEX-DEC-2026-007 closed the circularity, and we reproduce the value.
|
||||
|
||||
``approval_binding_digest`` is the canonical digest with context.approval
|
||||
removed. Recomputing it here from our own canonical implementation is the
|
||||
hermetic proof that this engine hashes the same material flex-auth does --
|
||||
a pin alone would only assert the constant, not that we can derive it.
|
||||
"""
|
||||
envelope = _envelope("destroy")
|
||||
binding = envelope["binding"]
|
||||
pdp = binding["context"]["approval"]["binding"]["pdp_digest"]
|
||||
assert binding["approval_binding_digest"] == APPROVAL_BINDING_DIGEST
|
||||
assert pdp == APPROVAL_BINDING_DIGEST
|
||||
|
||||
assert approval_binding_digest(_request_from(envelope)) == APPROVAL_BINDING_DIGEST
|
||||
|
||||
|
||||
def test_approval_binding_digest_is_not_a_replay_identity():
|
||||
"""It must not collapse into request_digest, or an allow becomes replayable.
|
||||
|
||||
Two requests differing only in which approval was presented share an
|
||||
approval_binding_digest while their decisions differ -- one allows, one
|
||||
denies dual_control_required. The fixture asserts the two digests disagree
|
||||
on a claim-bearing request so the distinction stays real.
|
||||
"""
|
||||
envelope = _envelope("destroy")
|
||||
binding = envelope["binding"]
|
||||
assert binding["approval_binding_digest"] != binding["request_digest"]
|
||||
|
||||
|
||||
def test_ordinary_decision_carries_no_approval_binding_digest():
|
||||
"""The field is omitted, not duplicated, on a claim-free decision."""
|
||||
binding = _envelope("rotate")["binding"]
|
||||
assert "approval" not in binding.get("context", {})
|
||||
assert "approval_binding_digest" not in binding
|
||||
|
||||
|
||||
def test_embedded_claim_declares_the_pdp_path():
|
||||
"""pdp_path is the issuer's declaration, and it is what our PEP requires.
|
||||
|
||||
Path intent is never inferred from a pdp_digest that happens to be present;
|
||||
approvals issued before approval-engine schema v3 carry pdp_path false
|
||||
regardless of any digest they hold.
|
||||
"""
|
||||
claim = _envelope("destroy")["binding"]["context"]["approval"]
|
||||
assert claim["binding"]["pdp_path"] is True
|
||||
|
||||
|
||||
def test_decision_validation_ties_the_claim_to_the_approval_binding_digest():
|
||||
"""Step 2 checks the identity against the real envelope, not a local guess.
|
||||
|
||||
The PEP knows the claim's pdp_digest from step 1. When the request it sent
|
||||
carried that claim, the decision must name the same claim-free envelope, or
|
||||
the approval was issued against some other request.
|
||||
"""
|
||||
envelope = _refresh_lifetime(_envelope("destroy"))
|
||||
request = _request_from(envelope)
|
||||
result = validate_decision_envelope(
|
||||
envelope,
|
||||
request,
|
||||
accepted_policy_packages={"secrets-engine.catalog-lane.lifecycle"},
|
||||
accepted_policy_versions={"v1"},
|
||||
expected_approval_binding_digest=APPROVAL_BINDING_DIGEST,
|
||||
)
|
||||
assert result.action == "destroy"
|
||||
|
||||
with pytest.raises(DecisionError, match="approval binding digest"):
|
||||
validate_decision_envelope(
|
||||
envelope,
|
||||
request,
|
||||
accepted_policy_packages={"secrets-engine.catalog-lane.lifecycle"},
|
||||
accepted_policy_versions={"v1"},
|
||||
expected_approval_binding_digest="sha256:" + "c" * 64,
|
||||
)
|
||||
|
||||
|
||||
def test_claim_bearing_request_without_a_binding_digest_fails_closed():
|
||||
"""A decision that records no binding digest cannot tie the claim to itself.
|
||||
|
||||
Comparing against request_digest instead would be the fail-open direction
|
||||
the whole field exists to prevent, so the absence is refused outright.
|
||||
"""
|
||||
envelope = _refresh_lifetime(_envelope("destroy"))
|
||||
request = _request_from(envelope)
|
||||
del envelope["binding"]["approval_binding_digest"]
|
||||
with pytest.raises(DecisionError, match="records no approval_binding_digest"):
|
||||
validate_decision_envelope(
|
||||
envelope,
|
||||
request,
|
||||
accepted_policy_packages={"secrets-engine.catalog-lane.lifecycle"},
|
||||
accepted_policy_versions={"v1"},
|
||||
expected_approval_binding_digest=APPROVAL_BINDING_DIGEST,
|
||||
)
|
||||
|
||||
|
||||
def test_a_forged_binding_digest_is_recomputed_not_trusted():
|
||||
"""The field is verified against our own canonical digest, never taken on faith."""
|
||||
envelope = _refresh_lifetime(_envelope("destroy"))
|
||||
request = _request_from(envelope)
|
||||
envelope["binding"]["approval_binding_digest"] = "sha256:" + "d" * 64
|
||||
with pytest.raises(DecisionError, match="does not match this request"):
|
||||
validate_decision_envelope(
|
||||
envelope,
|
||||
request,
|
||||
accepted_policy_packages={"secrets-engine.catalog-lane.lifecycle"},
|
||||
accepted_policy_versions={"v1"},
|
||||
)
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue