Published

An invoice reaches Finance before its approved confidentiality value arrives. A clerk has permission to use the Finance site, but the document's required access facts are incomplete. Keep ordinary access restricted while an authorised intake or correction process resolves the missing value.
Attribute-based access control (ABAC) evaluates facts about the caller, document, operation, and relevant context. Missing classification, a pending review, and an outdated department assignment are different states. Give each a defined response and recovery path, then test the decision where content is actually released.
Permit only the intake, processing, and correction work authorised for the unresolved state.
Validate the source, document version, allowed value, reviewer, and authority to change the policy input.
Re-evaluate the caller and operation, including search and delivery paths affected by the change.
A FormKiQ site can separate departments, business use cases, or customer tenants. Within that boundary, a department label or site membership still needs the applicable document and operation checks. Apply the same reasoning to service identities and AI agents retrieving documents.
| State | Access response | Recovery |
|---|---|---|
| Required fact missing | Restrict ordinary discovery and retrieval; allow designated intake or correction roles. | An authorised steward supplies the approved value from its trusted source. |
| Invalid or unrecognised value | Reject the invalid change or keep an imported item restricted. An unknown value does not mean public. | Correct the mapping or value and revalidate the affected record. |
| Proposal pending or conflicting | Use an approved decision only while it remains applicable to this content; otherwise hold the protected operation. | The responsible reviewer resolves the proposal or conflict and records the accepted result. |
| Fact stale or source unavailable | Apply the defined freshness window. Deny the protected operation when its required current basis cannot be established. | Refresh the authoritative fact or use a separately approved, bounded exception path. |
| Decision covers an older document version | Keep the changed content restricted until its approval and access facts are reconciled. | Review the current version and prevent a late result from approving its replacement. |
For each fact, name the authoritative source, owner, accepted values, relevant revision or check time, permitted age, and outage behaviour. Document classification and a person's current assignment can have different freshness requirements. Set those requirements from the operation's risk and withdrawal needs; they are not universal FormKiQ expiry settings.
FormKiQ's schemas define required attributes and allowed values. Its attribute documentation distinguishes ordinary metadata, governed attributes, and OPA access attributes. Protect the actual field and API path the policy consumes. A valid string alone does not establish reviewer approval, current assignment, or applicability to the current content.
Use the documented permissions for the selected attribute operation. The OPA module documents administrator-controlled access-attribute endpoints; a content editor's ability to update ordinary metadata must not become authority to widen access. Keep a classifier's proposal separate from the approved access value, and use the authorised governance path to apply a reviewed change.
OPA's default-rule guidance explains how a default such as default allow := false handles otherwise undefined rules. Also define how the enforcement layer handles errors, unavailable sources, and partial results. A partial result needs supported query enforcement before it can permit data release.
This is a configured Finance intake example. Its invoice reference, reviewer responsibilities, and release conditions are application choices. Retain the FormKiQ document ID and version at each step.
Invoice INV-1042 arrives with documentType = invoice and department = Finance. The approved confidentiality value needed by this deployment's access policy is missing. If the configured schema rejects the record, resolve that intake failure; if the workflow accepts it for restricted processing, keep it outside ordinary discovery and retrieval.
The designated intake reviewer and processing identity can perform their authorised work. A clerk's ordinary Finance-site access does not satisfy the document's unresolved access condition.
A classifier may propose Restricted. The steward checks the source and current version, then the authorised governance integration writes the approved access value. A proposal or untrusted upload field cannot approve its own audience.
The workflow coordinates the required index updates and decision re-evaluation. Test an allowed reviewer and an excluded caller through the actual query, preview, and retrieval routes before treating the document as available to its intended audience. An attribute update alone does not prove caches or indexes have refreshed.
The clerk later leaves Finance while an old session or cached decision remains. Apply the assignment-source and withdrawal rules at the next protected operation. Keep the document's approved classification history, and distinguish the denied new request from previously issued retrieval credentials or copies already downloaded.
Check titles, counts, facets, snippets, OCR text, thumbnails, renditions, attachments, exports, and shared links as well as original-file access. Search needs a query that respects the permitted document set. Verify the deployed endpoint, backend, and policy shape; the broader OPA authorisation guide explains that boundary.
Key any decision cache by the caller, site, operation, document or version, and relevant policy and attribute revisions. Define its invalidation and maximum age. Recheck queued work at execution and before protected output is released, so a privileged worker cannot reuse a stale initiating-user decision.
Previously issued URLs and downloaded copies have their own exposure period. Agree the retrieval-credential lifetime and withdrawal controls, then test them. Where emergency access is necessary, use a named approver, limited scope and duration, recorded purpose, and reviewed actions.
An administrator can use POST /sites/{siteId}/opa/accessPolicy/test to evaluate a saved or draft policy against simulated request and user context. Inspect the decision and any returned criteria, then test the deployed routes against fixture documents. The simulation does not modify a document or prove that search and delivery enforce the result.
Treat incomplete and stale metadata as named policy states with an authorised recovery path. Protect the facts that permit access, check their applicability when the operation runs, and verify the decision across the routes that expose the document.
The open-source foundation — API-first, deployable into your own AWS account, and free to use. Right for architecture validation and early implementation.
Production-ready editions for departments and complex workflows. Start with a Proof-of-Value deployment or go straight to production.
For governance-heavy environments with residency, sovereignty, assurance, and multi-jurisdiction requirements. Talk to us about the right deployment model.