wazo-auth-cli

A command line interface for the wazo-auth service

Configuration

Configuration file can be added at the following locations:

~/.config/wazo-auth-cli/*.yml
/etc/wazo-auth-cli/conf.d/*.yml
/etc/wazo-auth-cli/config.yml

The /etc/wazo-auth-cli/config.yml is the default configuration file shipped with the debian package. This file should not be modified but can be used as a reference.

The /etc/wazo-auth-cli/conf.d/*.yml files will be used to override the default configuration file. System-wide configurations should be dropped in this directory.

The ~/.config/wazo-auth-cli/*.yml files will be used to override the global configuration files for a given user. This directory will generally include files containing credentials.

The user's configuration file directory are not read automatically at the moment. wazo-auth-cli can be launched using the --config option to read this directory.

wazo-auth-cli --config ~/.config/wazo-auth-cli

The WAZO_AUTH_CLI_CONFIG environment variable can also be used to avoid having to use the --config option.

export WAZO_AUTH_CLI_CONFIG=~/.config/wazo-auth-cli

This line can also be added to the user's ~/.bashrc to avoid typing it at each session

A credential files should be created for the root user when wazo-auth is installed

# cat ~/.config/wazo-auth-cli/050-credentials.yml
auth:
  username: wazo-auth-cli
  password: uwt1V5GILaJ6tFEZZzFM
  backend: wazo_user

If a similar file does not exist, it can be recreated with the following command:

wazo-auth-bootstrap complete

Commands

To specify which user, password, backend or hostname you can use config file or command line like

wazo-auth-cli --hostname mywazo --insecure --auth-username test --auth-password test --backend wazo_user <command> <args>

Completion

wazo-auth-cli complete > /etc/bash_completion.d/wazo-auth-cli

Users

Creating a new user

wazo-auth-cli user create --firstname foo --lastname baz --password baz --email "baz@example.com" baz

Listing users

wazo-auth-cli user list

Deleting a user

wazo-auth-cli user delete <uuid>

Policies

Creating a policy

wazo-auth-cli policy create --acl "auth.users.*.read" "auth.users.create" -- mypolicy

Tenants

Creating a tenant

wazo-auth-cli tenant create mytenant

Creating a tenant as a subtenant of another tenant

wazo-auth-cli tenant create --parent mytenant othertenant

Other commands

wazo-auth-cli --help

wazo-platform / wazo-auth-cli