Federation: grants, approvals and revocation
A grant lets people at another agency's instance query records your instance owns. Nothing is released without one, and a grant releases only what both the grant and each record's own marking allow.
Propose a grant (the owning agency):
1. Open Grants and choose the requesting peer.
2. Name the collection and list the fields it may see. There is no "all fields" option.
3. Set the marking ceiling: the highest classification and the categories and dissemination controls the grant permits.
4. Optionally require a minimum clearance for the people who will ask.
5. State the purpose of use and an expiry. A grant can run at most 365 days.
Approvals:
Two different administrators approve on each side, four approvals in all. Each approval is signed by that instance's key over the exact terms, so changing any term afterward invalidates every approval. Use Show document to hand the grant to the other agency, and Import to load the copy they send back with their approvals.
What a request has to pass:
The grant must verify, be within its dates, not be revoked or suspended, and name the requesting instance. The person asking must meet the grant's attribute requirements. Then each record is checked on its own: its marking must be within the ceiling, the person's clearance must reach its classification, and they must meet the requirement of every category and control on it. A record with no marking is withheld. A field marked above what the person may see is withheld and counted.
Revoke or suspend:
Either agency can revoke a grant alone, with a reason, and it takes effect on that instance at once. Revocation cannot be undone; a new grant needs fresh approvals. Suspend is a local stop you can apply without revoking.
The Audit tab records every grant change and every release decision on a tamper-evident hash chain.