ZIFFER home

Glossary

One definition per term, in the words the rest of this section uses, with the API's name beside each of the three verdicts.

The words on the left are the ones used everywhere else in this section. Where the API spells something differently, its name is given too, because that is what your code compares against.

TermWhat it means
action catalogThe set of action classes your policy names. It is closed: an action outside it has no risk function, and an action with no risk function is refused rather than graded.
ALLOWThe API's name for a granted action. A receipt exists; verify it, then act.
anchored externallyPublished where a party other than us can read it. A record only one party holds is a record only that party can edit.
append-only ledgerThe chain receipts are added to. A receipt cannot be removed later without breaking every receipt after it.
approverA person who confirms a held action by signing it. The check is on the signing identity, never on the name in the message.
ATTESTThe API's name for an action held for a quorum. It is the gate, not a refusal: the proposal is in flight, the receipt attaches to the same decision once the quorum forms, and proposing again would be a second action.
decision recordOne decision as a person reads it: what was proposed, how it was graded, who signed, and when.
DENYThe API's name for a refused action. Nothing ran.
epochThe version number of a policy bundle. An integer, and every publish must raise it. The same epoch twice is refused, which is what stops a rollback to older, more permissive rules.
executorThe component on your side that verifies a receipt and then performs the action with your credential. It is yours, and it is the only holder of the credentials that cause an effect.
grant, grantedThe decision that an action may run, produced by grading a proposal against signed policy and comparing the grade to a floor. The API answers ALLOW. A grant is not an execution: ZIFFER never performs the action.
hold, heldWhat happens to an action at or above its floor: it waits for signatures rather than being blocked. The API answers ATTEST.
policyThe rules that decide: how sensitive each system is, how risky each action is, what can be undone, who is told, who is paged.
policy bundleThe signed files that carry the policy, with a manifest naming the tenant, the epoch and the signature. You sign it with your own key; change one byte afterwards and the signature no longer verifies.
proposalA request from an agent for one action: what to do, to which resource, with which arguments. It is not a permission, and holding one grants nothing.
quorumThe rule for a held action: how many distinct approvers must confirm before a grant is issued. Two named humans, in the policy this documentation uses as its example. Two confirmations from one approver are one approver.
receiptThe signed record of a grant: the proposal it answers, the grade, the quorum that met, the identities that signed, and the time. Signed with two independent algorithms, and verification requires both.
refuse, refusedThe answer when an action is outside policy, or when policy has nothing to say about it. The API answers DENY. Distinct from an access denial: a gap in policy refuses rather than grading down.
sandboxA separate tenant whose held actions are answered by a robot approver. It exercises the real path with nobody in it, and its receipts fail production verification because it signs under its own identity. It is not a dry run: your handler still performs the action.
signing ceremonyThe controlled process by which a policy bundle is signed, with an offline key held apart from every runtime key.
tenantThe customer one signed bundle governs. Your API key determines which tenant you are, and a request naming a different one is refused rather than rewritten.
trust anchorThe public half of the identity that signs your receipts, held by you and obtained out of band. An anchor fetched from the service it is used to check is that service asserting its own identity.
two named humansThe gloss on a quorum of two: named in advance, in signed policy, rather than whoever holds a role at the time.