Glossary.
The terms the architecture depends on, defined once. Identity proves who is acting. A mandate proves what they may do. The public service decides whether the action is allowed now.
- Agent identity
Identifies a logical software actor and its responsible operator: who is asking. It conveys no authority by itself.
The registered agent and its operator answer one of the six questions every action needs. An identifier lets a service recognise the actor and hold the operator responsible; it says nothing about what the citizen has allowed. Authority comes only from a mandate, and the decision only from the service.
See also: Workload identity, MandateIn the essay
- Automated administrative procedure (automaatne haldusmenetlus)
Estonia’s HMS § 7¹, in force from 1 January 2027: an administrative authority issuing acts or performing steps automatically through an information system, applying to procedures started on or after 1 July 2027.
It is the authority acting automatically, which is a different thing from a citizen’s agent expressing the citizen’s intent as a representative. Discretionary decisions still need a specific act, the person keeps the right to personal contact and to be heard, and an automated act must say that it was issued automatically and explain its decision principles. The amendment at Riigi Teataja; this gloss is unofficial.
See also: Principal, Enforcement boundaryIn the essay
- Confirmation
Human approval bound to the exact transaction: action, service, principal, mandate version, resource and its version, material values, payload digest, nonce and expiry.
The service, not the agent, renders the authoritative details through a trusted channel; agent-generated text cannot substitute for them. A changed payload invalidates the approval, and the approval is consumed once and rechecked at commit. Whether an action needs ordinary authentication, explicit approval or a qualified electronic signature is a legal and service-policy question, decided per action by the service owner.
See also: permit, confirmation_required, deny, Receipt, Enforcement boundaryIn the essay
- Delegation depth
How many further times an authority may be re-delegated. Every derived grant narrows it; a depth of zero forbids any further delegation.
The mandate fixes the maximum. A request that asks for more delegation than the mandate allows is denied before the action is considered further; the evaluator on this site reports that check as AUTHORITY_DELEGATION.
See also: Mandate, Downstream action grant, Monotonic attenuationIn the essay
- Downstream action grant
Further attenuated authority for one internal actor, tool or command: seconds or one operation, and strictly narrower than its parent.
Token exchange can produce a new token from evidence, but the standard does not attenuate authority or link parent and child revocation. Narrowing every child grant is a rule the implementation must enforce.
See also: Service access token, Monotonic attenuationIn the essay
- Enforcement boundary
The public service’s own policy enforcement and decision point, at the resource API or command broker, which returns permit, confirmation_required or deny for every protected operation.
A government service cannot outsource its final authorization decision to the citizen’s agent, to a model gateway or to a national registry. The decision combines verified evidence with current ownership, eligibility, workflow state, cumulative limits and policy. Stronger authentication cannot repair missing authority; a new or expanded mandate is a separate process.
See also: permit, confirmation_required, deny, Trust plane, Strictest boundIn the essay
- Idempotent replay
A repeated command with the same idempotency key and unchanged payload returns the original result and causes no second effect; a changed payload must fail.
The key is bound to principal, mandate, action and payload digest. If a command times out after dispatch and its result is uncertain, the system reconciles the original operation rather than issuing a second one blindly.
See also: permit, confirmation_required, deny, ReceiptIn the essay
- Mandate
The authoritative, revocable definition of the authority a principal has delegated: exact actions, resources, services, limits, purpose, validity and maximum delegation depth.
The mandate record is owned by the mandate issuer or registry and lives as long as the use case needs; a tax-declaration mandate that legitimately spans a month is not a bug. “Minutes, not months” applies to the execution tokens derived from it, never to the mandate itself. Revoking a mandate must invalidate every dependent grant within a declared bound.
See also: Mandate credential, Presentation, Service access token, Revocation windowIn the essay
- Mandate credential
A signed, portable representation of selected mandate facts, issued by a trusted issuer with an authenticated status reference.
It carries only the claims a service needs and points at a status list the verifier can check. It is bounded and longer-lived than a token, but it remains evidence about authority, not authority: the receiving service decides.
See also: Mandate, PresentationIn the essay
- Monotonic attenuation
Every child grant is strictly no broader than its parent in audience, action, resource, limits, lifetime and delegation depth.
Rich authorization requests carry structured details and token exchange represents actor relationships, but neither guarantees that derived authority only narrows. The rule belongs to the architecture, and the service rejects any derived grant that widens.
See also: Downstream action grant, Strictest boundIn the essay
- permit, confirmation_required, deny
The three explicit outcomes of the enforcement boundary: within current authority; eligible but awaiting a specified human approval; not permitted by evidence, authority, policy or state.
The authorization outcome and the command execution result are different layers: a replayed, already-committed request may be permitted while nothing executes again. The evaluator on this site returns exactly these three words and a list of reasons.
See also: Enforcement boundary, Confirmation, Receipt, Idempotent replayIn the essay
- Presentation
Fresh evidence of selected mandate claims, bound to one verifier and one transaction through audience, nonce and holder-key proof.
A presentation reveals the required facts and proves control of the holder key for this transaction only. Setting an audience cannot create service authority, and a matching string supplied by the agent is not a binding. A fresh presentation must never silently become an unlimited execution credential.
See also: Mandate credential, Service access tokenIn the essay
- Principal
The person, organisation or authorised representative on whose behalf an action is taken: the legal source of every mandate.
The service authenticates the principal with an accepted eID and, where someone acts for an organisation, checks the right of representation against an authoritative source and records when it was checked. Only a principal who can legally grant an authority can create a mandate for it.
See also: Mandate, Delegation depthIn the essay
- Protected agent client
The hardened part of the agent that holds credentials, acquires tokens, generates proofs, builds requests and reaches side-effecting tools, outside the model’s untrusted context.
The model proposes a structured action; trusted code validates it against a fixed schema and the active mandate. A non-exportable key is still a signing oracle if an attacker can invoke it without constraint, so the client reduces exposure while the public service remains the final enforcement boundary.
See also: Workload identity, ConfirmationIn the essay
- Receipt
Evidence produced by the service that a request was evaluated and a result committed, returned to the citizen. It is not a signature.
A receipt records the actor and authority chain, the decision basis and the committed result. The citizen’s data tracker retrieves receipts from services rather than becoming a second central log of payloads.
See also: Confirmation, permit, confirmation_required, denyIn the essay
- Revocation window
The maximum end-to-end time before a revocation is enforced everywhere: publication delay + delivery or refresh delay + verifier application delay + clock allowance.
Revocation does not undo a completed transaction; it prevents future use once the verifier has accepted fresh status. Dependent service tokens and internal grants must be invalidated as well. A status snapshot older than the permitted signed age fails closed for protected writes, and fetching the same stale snapshot again does not make it fresh.
See also: Mandate, Trust planeIn the essay
- Service access token
Short-lived, audience-restricted, sender-constrained permission to call one service within a narrow scope: minutes, and never later than the mandate’s expiry.
A service authorisation server issues it when repeated calls are needed, as the OAuth security best current practice recommends. It does not freeze the service’s business permission: enforcement, status freshness and resource state are checked again at every protected operation.
See also: Downstream action grant, Mandate, PresentationIn the essay
- Strictest bound
The effective authority for any action: mandate scope ∩ service limit ∩ citizen limit. The smallest allowance wins.
The agent cannot request what it was never granted; the service cannot be talked into more than its own policy allows; the citizen’s per-transaction and cumulative limits cap both. The evaluator names the bound that decided each result.
See also: Mandate, Monotonic attenuation, Enforcement boundaryIn the essay
- Trust plane
The control plane that distributes trusted issuers, mandate status and operator information without carrying or brokering ordinary citizen-service transactions.
In the X-Road pattern the central server distributes membership and security-policy configuration while security servers mediate the actual requests. “Outside the data path” does not mean “never contacted”: issuance, periodic status distribution and exceptional identity resolution still touch the control plane. What the baseline forbids is a synchronous national lookup on every ordinary action.
See also: Enforcement boundary, Revocation windowIn the essay
- Workload identity
Identifies the running workload, device or protected client that presents a request, attested by its operator. It does not prove citizen intent or legal power.
A SPIFFE identity, for example, names a workload inside an operator’s trust domain and may be shared by replicas, so it is not a globally unique process identifier. Personal identifiers and mandates never belong in it. A valid mandate presented by the wrong workload must fail; a correctly attested workload without authority from the citizen must also fail.
See also: Agent identity, Protected agent client, MandateIn the essay