BengarTrust infrastructure

Docs · Getting started

Core concepts

Six nouns and the sentence that connects them.

The sentence

Who authorizes whom, to do what, to which resource, under what conditions, until when — and afterwards, what proof is there that it happened that way.

The nouns

NounOne line
IdentityAn Ed25519 keypair and a did:key. Names a party.
PermitA signed document bounding what a party may ever ask for.
PolicyDeterministic rules saying what may happen now.
ApprovalA person deciding, recorded so it can be checked.
ExecutionActing on an ALLOW, with an outcome — including UNKNOWN.
ProofChecking an audit record against an anchored root.

Three sentences worth memorising

  • A permit is not authority. Authority is the meet of permit, policy and approval.
  • REQUIRE_APPROVAL is not an allow. Treating “not DENY” as go is a hole.
  • UNKNOWN is not FAILED. Never retry it automatically.