sysand auth logout#

Remove a stored index credential.

Usage#

sysand auth logout [OPTIONS] [INDEX_URL]

Description#

Removes the stored credential for an index from the operating system’s keyring. Logout is always safe to run: it only removes the local stored credential and never touches the index side. The token is discarded locally, so revoke it on the index too if it should stop working everywhere.

Without [INDEX_URL], the command targets the default index, echoing the resolved index and erroring if the default-index chain is ambiguous.

Logging out of an index that has no stored credential is not an error: the command warns that there was nothing to remove and succeeds, so running it twice is safe. sysand auth status lists the stored logins and prints each key in the exact form this command accepts.

On a host with no usable keyring the command does fail, with an error saying so, because there are no stored credentials to remove there; credentials on such hosts come from SYSAND_CRED_* environment variables, which this command never touches. A cleanup script that must not fail should tolerate that exit status.

Arguments#

  • [INDEX_URL]: Index URL to log out from (e.g. https://sysand.com). URL templates are accepted. Defaults to the default index.

Global options#

  • -v, --verbose: Use verbose output

  • -q, --quiet: Do not output log messages

  • --no-config: Disable discovery of configuration files [env: SYSAND_NO_CONFIG]

  • --config-file <CONFIG_FILE>: Give path to sysand.toml to use for configuration [env: SYSAND_CONFIG_FILE]

  • -h, --help: Print help

Examples#

$ sysand auth logout https://sysand.com
 Logging out from index `https://sysand.com/`
     Removed stored credential for `https://sysand.com/`

See also#