Users
Users are human principals who can log in to Chronicle using a username and password. They are distinct from applications, which authenticate with client credentials. Manage users when you need to grant or revoke interactive access to the Chronicle server.
Lists all users registered on the Chronicle server.
cratis chronicle users listExamples
Section titled “Examples”List all users:
cratis chronicle users listList in plain format:
cratis chronicle users list --output plainCreates a new user account with the specified username, email address, and password.
cratis chronicle users add <USERNAME> <EMAIL> <PASSWORD>Arguments
Section titled “Arguments”| Argument | Description |
|---|---|
USERNAME | The login name for the new user. |
EMAIL | The email address for the new user. |
PASSWORD | The initial password for the new user. |
Examples
Section titled “Examples”Add a new user:
cratis chronicle users add alice alice@example.com initialpasswordSecurity note
Section titled “Security note”Avoid passing passwords as shell arguments in environments where command history is logged. Use a variable to supply the password:
cratis chronicle users add alice alice@example.com "$INITIAL_PASSWORD"remove
Section titled “remove”Removes a user account from Chronicle. This operation is irreversible. The user immediately loses all access to the server.
cratis chronicle users remove <USER_ID>The command prompts for confirmation before proceeding. Pass --yes to skip the prompt in automated workflows.
Arguments
Section titled “Arguments”| Argument | Description |
|---|---|
USER_ID | The GUID of the user to remove. Use users list to retrieve user IDs. |
Options
Section titled “Options”| Flag | Description |
|---|---|
-y, --yes | Skip confirmation prompt. |
Examples
Section titled “Examples”Remove a user interactively:
cratis chronicle users remove a1b2c3d4-e5f6-7890-abcd-ef1234567890Remove without confirmation:
cratis chronicle users remove a1b2c3d4-e5f6-7890-abcd-ef1234567890 --yes