NAME¶

agama-auth - Authenticate with Agama's server

SYNOPSIS¶

agama auth [-h|--help] <subcommands>

DESCRIPTION¶

Authenticate with Agama's server.

Unless you are executing this program as root, you need to authenticate with Agama's server for most operations. You can log in by specifying the root password through the "auth login" command. Upon successful authentication, the server returns a JSON Web Token (JWT) which is stored to authenticate the following requests.

If you run this program as root, you can skip the authentication step because it automatically uses the master token at /run/agama/token. Only the root user must have access to such a file.

You can logout at any time by using the "auth logout" command, although this command does not affect the root user.

OPTIONS¶

-h, --help

Print help (see a summary with '-h')

SUBCOMMANDS¶

agama-auth-login(1)

Authenticate with Agama's server and store the token

agama-auth-logout(1)

Deauthenticate by removing the token

agama-auth-show(1)

Print the used token to the standard output