CLI command
skarbiec request
Keep the access requests agents make — a secret, a device or a membership — and let a vault owner or admin decide them, issuing only what the decider states.
Invocation#
skarbiec request file|list|show|approve|deny|withdraw|watch ...
skarbiec request helpPurpose#
Keep the access requests agents make — a secret, a device or a membership — and let a vault owner or admin decide them, issuing only what the decider states.
Required inputs and options#
- A verb, then that verb's arguments, as its page names them. request help prints every form with what each takes.
Output and state effects#
- Runs the verb against the request register beside the vault (vault.requests.json beside vault.json), every change journalled.
Refusals#
- No verb exits 2 with `request does nothing on its own, and was given none of its forms (file, list, show, approve, deny, withdraw, watch, help)`, and another word with `<word> is not one of the forms of request`; a flag the verb does not read exits 2 as arguments-flag-unknown, before the register is read.
- skarbiec.request request-kind-unknown — exit 2: reading the kind of access request to file; fix: name --kind secret, device or membership
- skarbiec.request request-text-unfit — exit 2: reading --{flag} of the access request; fix: give --{flag} as one line of text, with no line break and no leading or trailing space
- skarbiec.request request-number-unfit — exit 2: reading --{flag} of the access request; fix: give --{flag} as a whole number of at least {least}
- skarbiec.request request-decider-unfit — exit 2: reading who decides the access request; fix: give --decider owner, --decider admin or --decider <recipient-uid>; skarbiec recipient list names the uids
- skarbiec.request request-capability-action — exit 2: reading the bounded capability the access request names; fix: file it with --action read, or ask for a standing consumer grant with --for-consumer <name>
- skarbiec.request request-consumer-unfit — exit 2: reading the consumer a standing grant is asked for; fix: give --for-consumer one name of letters, digits, '.', '_' and '-'
- skarbiec.request request-record-grant — exit 2: reading the {kind} request; fix: drop --purpose, --target, --ttl-seconds, --max-uses and --for-consumer
- skarbiec.request request-lifetime-recorded — exit 1: reading the lifetime an earlier decision on the access request recorded; fix: deny the request with skarbiec request deny <request-id> --by <uid> and file it again
- skarbiec.request request-uses-missing — exit 2: reading how many times the approved capability is redeemed; fix: approve again with --uses <N>, N at most the {asked} the request asked
- skarbiec.request request-capability-forever — exit 2: reading how long the approved capability lives; fix: approve again with --ttl-seconds <N> and --uses <N>
- skarbiec.request request-uses-uncounted — exit 2: reading how many times the approved grant is used; fix: approve again without --uses
- skarbiec.request request-uses-zero — exit 2: reading how many times the approved capability is redeemed; fix: approve again with --uses 1 or more, or deny the request
- skarbiec.request request-unknown — exit 1: reading access request {id}; fix: name a request skarbiec request list shows
- skarbiec.request request-not-pending — exit 1: deciding access request {id}; fix: file a new request for what is still needed; a decided request stays as it was decided
- skarbiec.request request-not-a-decider — exit 1: letting {by} decide access request {id}; fix: decide it as a recipient with role owner or admin, or as the decider the request names (skarbiec request show {id})
- skarbiec.request request-decider-key-absent — exit 1: letting {by} decide access request {id}; fix: decide where {by} holds the key, or bring it here with skarbiec keys import
- skarbiec.request request-already-decided — exit 1: letting {by} decide access request {id}; fix: a dual-control request needs a second decider: decide it as another owner or admin
- skarbiec.request request-consumer-held — exit 1: approving access request {id}; fix: deny this request and ask for a fresh consumer name, or revoke the existing grant first with skarbiec grant revoke {consumer}