pub(crate) fn install_session_pq_overlay()Expand description
Install the session PQ binding overlay, the runtime anchoring path for clients no operator can pre-enroll (browsers and other device-generated identities).
It is consulted only after the admin-anchored store above misses, so it
cannot displace an operator’s enrollment, and a binding it establishes at
first contact is capped at Classical assurance — it makes a request
verifiable, it does not make the requester more trusted. Promotion to
PqHybrid requires an out-of-band fingerprint comparison.
Set HYPRSTREAM_SESSION_PQ_OVERLAY=0 for a mesh-only deployment that wants
every unenrolled identity rejected at the envelope layer as before.
§Operator limitations at this revision — read before enabling
The overlay’s approve / promote / revoke operations exist as library calls and have no operator surface yet: nothing here, no RPC method, no CLI. Two consequences an operator must know about up front:
- Every binding stays at first-contact provenance for its lifetime.
Out-of-band promotion is unreachable, so the overlay cannot raise MAC
assurance for anyone — a browser client is
Classicaland stays there. - A refused rebinding is loud but unanswerable. A client that rotates its ML-DSA-65 key while keeping its Ed25519 identity is refused here, cannot be approved (no surface), and cannot be routed around through the admin-anchored store (immutable after install). Restarting the daemon clears the overlay and is currently the only way through. Until the operator surface lands, plan rotations around a restart.