CLI command
skarbiec request deny
Close a pending request without issuing anything.
Invocation#
skarbiec request deny <request-id> --by <uid> [--reason <text>]Purpose#
Close a pending request without issuing anything.
Required inputs and options#
- The request id, --by the deciding recipient, and an optional --reason kept with the decision. POST /v1/operator/requests/deny takes id, by and reason.
Output and state effects#
- Records the denial, sets the state denied, journals access-denied and prints ok, request_id and state.
Refusals#
- A flag other than --by and --reason exits 2 (arguments-flag-unknown); no --by exits 2. The decider is held to the rules approve holds it to, and a request no longer pending is request-not-pending.
- 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}