Skip to main content

Module policy

Module policy 

Source
Expand description

Generated per-method signature policy (§4.4, §5.2).

Enrollment equivalence is not authorization. An enrolled signer proves who signed; the method’s generated policy decides what signing topology that method requires: whether it may be called with no credential at all, which cryptographic suite the primary logical signer must use, and whether additional enrolled approvers are required.

The policy is a property of the decoded leaf, not of the caller. It is resolved after the single Cap’n Proto decode and evaluated before replay admission, so a request that fails it never consumes store capacity.

A leaf with no policy row is unlisted and denies. That is the same rule the design gives for a leaf that exists only in a newer client schema: an unlisted (service, leaf path) denies, never falls back to a coarser row.

Structs§

AllowedApproverGroup
One approver group the generated policy allows, pinned exactly.
GeneratedMethodPolicyProvider
Inventory registration submitted by every server-side generated module.
GeneratedMethodPolicyRow
One generated method-policy row (v16 §6.1).
InMemoryMethodPolicy
An explicit policy table keyed by (service domain, leaf path).

Enums§

ApproverRule
How many, and which, additional enrolled logical signers must approve.
AuthenticationRequirement
Whether a generated row admits the Unauthenticated disposition (v16 §6.1).
CryptoSuite
The cryptographic suite a method requires of its primary logical signer.
MutationSemantics
The generated application policy a mutating method declares (v16 §4.8) — distinct from request-proof replay admission. The declaration metadata describes each method’s retry semantics or activation prerequisite; the annotation itself does not implement enforcement.
SignaturePolicy
The signing topology a method requires.

Constants§

READ_CLASS_ACTIONS
The read-class authorization actions (S3 ScopeAction Block A). A leaf may explicitly classify bounded session/subscription state under either action; every other action requires a mutation policy.
SYSTEM_LOW_LABEL
The system-low label — the exact expansion of $dispatchPublic and the mandatory value of every row’s transitional_label during migration (v16 §7.3). Public ⇔ target_label is exactly this label.

Traits§

DispatchMethodPolicy
Resolves the generated policy row for one decoded leaf.

Functions§

build_generated_method_policy
Build and validate the complete generated method-policy table.
collect_generated_rows
Collect the complete generated inventory, deterministically sorted by (service, numeric leaf path).
dispatch_label
Construct a dispatch label from its parsed axes (v16 §6). This is the ONE constructor generated rows use — there is no permissive default and no string parsing at runtime; the grammar was checked at code generation against the checked-in InitialLabelMap.
evaluate
Evaluate a resolved policy against a verified proof.
global_method_policy
install_generated_method_policy
Install the complete generated method-policy inventory as the process policy table (v16 §6.1). Returns the number of installed rows.
mediated_operation_for_request
Recover the only policy action an authenticated scoped request may mediate. The returned action is derived from the signed request leaf, not supplied by the mediator.
set_global_method_policy
validate_generated_rows
Validate one complete generated row set (v16 §6.1 build gates).
verify_mediated_operation
Bind a mediated query’s operation to the original signed request leaf. This does not authenticate the body or grant authority: callers must first verify the holder transcript, credential, target, freshness and replay.