Skip to main content

install_session_pq_overlay

Function install_session_pq_overlay 

Source
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 Classical and 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.