vexa_subscriber.py - Vexa Delivery

Source: publisher/vexa_subscriber.py · audience: publisher

Overview

Emitted from python3 publisher/vexa_subscriber.py --help.

usage: vexa_subscriber [-h] {list,add,revoke} ...

Manage credentials on the Vexa channel registry (channel.vexa.ai).

positional arguments:
  {list,add,revoke}
    list             show accounts and their scope
    add              mint a credential for an account (also rotates an existing one)
    revoke           remove an account's credential

options:
  -h, --help         show this help message and exit

`list`

Show every account on the channel registry and its scope. The first thing to run when a customer reports a 401, and the inventory you reconcile against before a rotation.

usage: vexa_subscriber list [-h]

options:
  -h, --help  show this help message and exit

`add`

Mint a credential for an account — the same verb rotates an existing one. Onboarding a new subscriber and rotating a compromised one are the same act against the registry, and both end with an age-encrypted handoff.

usage: vexa_subscriber add [-h] name

positional arguments:
  name        account name, e.g. 'pilot'

options:
  -h, --help  show this help message and exit

`revoke`

Remove an account’s credential. Use it when a pilot ends or a credential is suspected: revocation stops future pulls, it does not un-deliver what the subscriber already has.

usage: vexa_subscriber revoke [-h] [--force] name

positional arguments:
  name

options:
  -h, --help  show this help message and exit
  --force     allow revoking the publisher account