Skip to main content

Module atproto_perimeter

Module atproto_perimeter 

Source
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 → SecurityContext mapping, mutable admission-gated EnrollmentStore, 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:web resolver (#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§

AtprotoPerimeterGateway
The perimeter gateway: turns an admission-gated external identity into an enrolled internal peer with a derived MAC context.
AtprotoPermission
An exact ATProto OAuth scope plus lexicon permission presented at the federation edge.
AtprotoPermissionMapping
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.
AtprotoPermissionTranslator
A configured, fail-closed ATProto OAuth/lexicon → UCAN+MAC translator.
EnrolledPeer
A pinned, enrolled external peer.
EnrollmentStore
A mutable, admission-gated store of enrolled external peers.
TranslatedAtprotoAuthorization
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.
VerifiedDpopBinding
Evidence that the surrounding OAuth resource server verified a DPoP proof and bound this authorization to its JWK thumbprint (jkt).