CLI command

skarbiec subscription list

List every subscription grant the vault holds, whether it is due a sign-in and why, and its last sign-in.

Invocation#

Shell
skarbiec subscription list [--due]

Purpose#

List every subscription grant the vault holds, whether it is due a sign-in and why, and its last sign-in.

Required inputs and options#

  • No positional input. --due keeps the grants due a sign-in. POST /v1/operator/subscriptions takes due.

Output and state effects#

  • Reads the vault and prints subscriptions (one row per live item tagged brama:subscription: item, provider, subscription_id, login_item, revision, grant present, absent or unreadable, refused with when, why and by whom, refusal_current, due, held (true when a sign-in refused on this same footing keeps the grant back; a word for the sign-in, never for the grant), why, blockers, last_attempt_at, last_status signed_in, held or retry, last_error, last_run, last_cause, the id of the declared cause the last sign-in failed for (skarbiec errors show skarbiec.subscription describes each; null after a sign-in that succeeded or a failure no cause declares), and last_due, why the grant was due when that sign-in was asked for (absent, refused or unreadable; null for one asked for with --now while it held a grant)) and due, the count. It changes no state and decrypts each subscription item only to tell whether a grant is in it, never printing it, and each login item only to judge its second factor.

Refusals#

  • An argument or a flag other than --due exits 2 (form-unknown, flag-unknown). A subscriptions section or record that is not an object is refused naming its kind (section-malformed).