Skip to content

Authentication

enum uses OIDC-based authentication. All credentials are stored locally in ~/.config/enumctl/.

Terminal window
enumctl auth login

On a machine with a browser, enumctl opens one automatically and completes login via a localhost callback.

On headless machines (SSH sessions, remote servers), enumctl uses device authorization by default: open the printed URL on any device, sign in, and enumctl picks up the session automatically. Force device authorization explicitly with:

Terminal window
enumctl auth login --device
FlagDescription
--deviceUse device authorization (for headless or SSH sessions)
--browserForce browser callback login even on SSH sessions
Terminal window
enumctl auth logout

Removes stored credentials from your machine.

Terminal window
enumctl auth get-token

Outputs the current access token in Kubernetes ExecCredential format. This is used internally by kubectl. You typically don’t need to run this directly.

Session expired or invalid:

Terminal window
enumctl auth logout
enumctl auth login

Debug logging:

Terminal window
enumctl auth login --verbose

Check config directory:

Terminal window
ls -la ~/.config/enumctl/