kyvernon auth

The auth command of the kyvernon CLI with its subcommands and arguments.

`kyvernon auth`

Own session: browser-login settings, API tokens, TOTP, password

Usage

kyvernon auth <COMMAND>

Subcommands: config, session, password, totp, api-tokens

`kyvernon auth config`

Browser login settings (OIDC availability)

Usage

kyvernon auth config

API operation: GET /v1/auth/config

`kyvernon auth session`

The current session with its restrictions

Usage

kyvernon auth session

API operation: GET /v1/auth/session

`kyvernon auth password`

Change the own password (current and new from KYVERNON_PASSWORD / stdin: two lines)

Usage

kyvernon auth password

API operation: POST /v1/auth/password

`kyvernon auth totp`

TOTP enrolment and recovery codes

Usage

kyvernon auth totp <COMMAND>

Subcommands: enrol, confirm, recovery-codes

`kyvernon auth totp enrol`

Start enrolment: prints the secret and otpauth URL

Usage

kyvernon auth totp enrol

API operation: POST /v1/auth/totp/enrol

`kyvernon auth totp confirm`

Confirm enrolment with a code; prints the recovery codes once

Usage

kyvernon auth totp confirm <CODE>

Argument	Description	Required
`<CODE>`	Six-digit code	yes

API operation: POST /v1/auth/totp/confirm

`kyvernon auth totp recovery-codes`

New recovery codes (the old ones stop working)

Usage

kyvernon auth totp recovery-codes <CODE>

Argument	Description	Required
`<CODE>`	Six-digit code	yes

API operation: POST /v1/auth/totp/recovery-codes

`kyvernon auth api-tokens`

Own API tokens

Usage

kyvernon auth api-tokens <COMMAND>

Subcommands: list, create, delete

`kyvernon auth api-tokens list`

List tokens

Usage

kyvernon auth api-tokens list

API operation: GET /v1/auth/api-tokens

`kyvernon auth api-tokens create`

Create a token; the secret is printed once

Usage

kyvernon auth api-tokens create [OPTIONS] <NAME>

Argument	Description	Required
`<NAME>`	Token name	yes
`--ttl`	Lifetime in seconds, up to the controller maximum (365 days unless configured); default: that maximum. Every token expires

API operation: POST /v1/auth/api-tokens

`kyvernon auth api-tokens delete`

Delete a token

Usage

kyvernon auth api-tokens delete <ID>

Argument	Description	Required
`<ID>`	Token id	yes

API operation: DELETE /v1/auth/api-tokens/{id}

Version 0.1.