Expand description
ATProto perimeter gateway: external-DID → assurance binding (#549, first half).
Native-only — depends on the admission gate (did:web/did:key resolution).
ATProto perimeter gateway — external-DID → assurance binding (#549, first half).
This is the enrollment-time translation seam between a federated ATProto
identity (an external Did) and the internal MAC lattice (#548). It “translates,
does not tunnel”: an external DID is resolved once, off the auth path, its
verified key material is mapped to an Assurance, and the result is pinned as
an EnrolledPeer carrying a derived SecurityContext. The per-op reference
monitor (#548 S2) then reads the cached context and never re-resolves.
§What this module is / is not
- Is: the
external Did → VerifiedKeyMaterial → SecurityContextmapping, mutable admission-gatedEnrollmentStore, and exact, DPoP-gated ATProto OAuth-scope/lexicon → bounded interior UCAN+MAC translation. It consumes the (mirrored) #579 resolver and the existing epic MAC types (Assurance,SecurityLabel,SecurityContext,VerifiedKeyMaterial) — it does not re-declare any of them. - Is not: per-op enforcement (#548 S2), concrete DPoP proof verification
(performed by the OAuth boundary before translation), or a concrete
did:plc/did:webresolver (#579).
§Fail-closed
Any resolver error, a None DID, or a missing verifying key yields Err ⇒ the
peer is not enrolled. There is no default enrollment and no default
assurance: an un-resolvable identity dominates nothing above the lattice floor.
§Zero standing privilege (ZSP)
The enrollment edge ceiling is Level::Internal × <crypto-derived assurance> × EMPTY compartments. Compartments are explicit grants made later, never
conferred at enrollment. The clamp-down in
SecurityContext::from_clearance guarantees a classical peer can never obtain
a PqHybrid context even if the ceiling allowed it.
Structs§
- Atproto
Perimeter Gateway - The perimeter gateway: turns an admission-gated external identity into an enrolled internal peer with a derived MAC context.
- Atproto
Permission - An exact ATProto OAuth scope plus lexicon permission presented at the federation edge.
- Atproto
Permission Mapping - A policy-approved, one-way translation from an exact ATProto permission to an interior UCAN capability and the greatest MAC object label it may target.
- Atproto
Permission Translator - A configured, fail-closed ATProto OAuth/lexicon → UCAN+MAC translator.
- Enrolled
Peer - A pinned, enrolled external peer.
- Enrollment
Store - A mutable, admission-gated store of enrolled external peers.
- Translated
Atproto Authorization - The bounded result of edge translation, ready for the trusted interior UCAN issuer / MAC compiler. It is deliberately not an external UCAN transport format: UCAN authoring and delegation remain inside HyprStream.
- Verified
Dpop Binding - Evidence that the surrounding OAuth resource server verified a DPoP proof
and bound this authorization to its JWK thumbprint (
jkt).