CLI command
skarbiec request list
List the access requests the register holds, or only those in one state.
Invocation#
skarbiec request list [--state pending|approved|denied|withdrawn]Purpose#
List the access requests the register holds, or only those in one state.
Required inputs and options#
- No positional input. --state keeps the requests in that state. POST /v1/operator/requests takes state.
Output and state effects#
- Prints one row per request: id, requested_at, state, kind, resource, action, agent, decider, dual_control and how many decisions it holds. Reads only.
Refusals#
- A flag other than --state exits 2 (arguments-flag-unknown): a mistyped --state used to list every request. A register that cannot be read, is not JSON or holds no requests list is refused naming it (request-register-not-json, request-register-damaged).
- skarbiec.request.register request-register-not-json — exit 1: reading the access request register {path}; fix: restore {path} from a backup taken before the damage, or move it aside and file the open requests again; it is a JSON object holding a requests list
- skarbiec.request.register request-register-damaged — exit 1: reading the access request register {path}; fix: restore {path} from a backup taken before the damage, or move it aside and file the open requests again; it is a JSON object holding a requests list
- skarbiec.request.register request-record-damaged — exit 1: reading access request {id} from the register {path}; fix: remove the record {id} from {path} and file the request again; skarbiec request list shows the others
- skarbiec.request.register request-record-field-unreadable — exit 1: reading access request {id} from the register {path}; fix: remove the record {id} from {path} and file the request again; skarbiec request list shows the others
- skarbiec.request.register request-recipient-damaged — exit 1: reading {by}'s recipient record to decide access request {id}; fix: restore {by}'s recipient record from a backup taken before the damage; skarbiec recipient list shows the record and skarbiec doctor names what else is wrong
- skarbiec.request.register request-id-unavailable — exit 69: drawing a request id from /dev/urandom; fix: file the request again; if it fails again, the operating system's random source is broken and skarbiec doctor on this host says what else is
- skarbiec.request.register request-grant-unanswered — exit 1: issuing the {form} grant access request {id} names; fix: deny the request with skarbiec request deny {id} --by <uid> and issue the grant with skarbiec grant {leaf}