Skip to content

Latest commit

 

History

History

README.md

Concepts

For: Architects, and Builders who want the mental model before the code. Time: ~30 min end-to-end. Prereqs: Quickstart — authserver running locally.

Authplane vocabulary lives here. Every page below assumes nothing beyond this primer; read in order if the topic is new.

Reading order

  1. What is Authplane — the envelope.
  2. Resources and scopes — Mint vs Broker vs Fronted.
  3. Tokens and claims — JWT shape, agent_id, audience.
  4. Identity and federation — users, IdPs, OIDC, XAA.
  5. Delegation and agent chains — token exchange in plain terms.
  6. DPoP and proof of possession — sender-constrained tokens.
  7. Broker vs Mint — the disambiguation page.
  8. Architecture — hexagonal layers, where the ports sit.
  9. Threat model — what we defend against.

Conventions used in this section

  • "AS" = authserver. "RS" = resource server (your MCP server).
  • All code examples are illustrative pseudo-shape, not runnable. Runnable code lives in examples/.
  • All RFC references link to the IETF datatracker.

Glossary

See glossary.md — every term used below has an entry.