Installation & Authentication

Requirements

• Node.js 18 or later

Install

Install the CLI globally via npm:

npm install -g @authaction/cli

Verify the installation:

authaction --version

Log In

Authenticate with your AuthAction account. This opens a browser window to complete the OAuth2 login flow and stores a token locally.

authaction login

Check Your Identity

After logging in, confirm who you are authenticated as:

authaction whoami

Select a Tenant

Most commands operate on a specific tenant. Set the active tenant so you don’t have to pass --tenant on every command:

authaction use-tenant <tenant-name>

You can still override the active tenant per-command with the --tenant flag.

Regions

Tenant data is stored in a specific region. Commands that interact with tenant resources accept a --region flag:

eu | us | au | ca | cn | in | gb | jp

The default region is eu. Set --region explicitly when your tenant is in a different region, or configure it once using:

authaction configure

Log Out

Remove the stored credentials from your machine:

authaction logout