Conductor Documentation

users

The cfy users command is used to manage users and passwords on the Conductor Manager.
If you choose not to integrate the Conductor Manager with LDAP-based user management system, you must add each user individually with a unique username and a password. You can also create user groups and add users to them. The users and user groups can be assigned to one or more tenants, with different roles in each tenant.

Requirements

Optional flags

These commands support the common CLI flags.

Commands

create

Usage

cfy users create [OPTIONS] USERNAME

Create a new user on the Conductor Manager.

USERNAME is the user name for the user.

Required flags

Optional flags

 

Example

$ cfy users create sue -p test1
...

User `sue` created as a non-admin user in the system with password 'test1'.

...

set-password

Usage

cfy users set-password [OPTIONS] USERNAME

Set the password for a specific user. You can use this command in a non-LDAP setup to change each of the users’ passwords, and in LDAP mode to change only the password of the bootstrap-admin (the user created by default upon Manager’s installation) .
USERNAME is the username of the user.

Required flags

 

Example

$ cfy users set-password sue -p new_pass
...

Setting new password for user sue...
New password set

...

set-role

Usage

cfy users set-role [OPTIONS] USERNAME

Set the system-wide (security) role for a specific user.

USERNAME is the username of the user

The system-wide role defines the user as a ‘sys-admin’ (admin user) or ‘default’ (non-admin user). To give the user sys-admin permissions, set this role to ‘sys_admin’. Otherwise, the user has the system-wide role ‘default’. A ‘default’ user must be explicitly assigned to tenants in order to perform actions and access resources.

Optional flags

 

Example

$ cfy users set-role sue -r sys_admin
...

Setting new role for user sue...
New role `sys_admin` set

...

delete

Usage

cfy users delete [OPTIONS] USERNAME

Delete a user from the Conductor Manager. You can delete a user only if the user is:

USERNAME is the username of the user.

 

Example

$ cfy users delete sue
...

Deleting user `sue`...
User removed

...

list

Usage

cfy users list

In non-LDAP mode, this command lists all of the users defined in this Conductor Manager. In LDAP mode, this command lists all of the users who logged in to Studio Conductor and successfully authenticated with the LDAP system.
By default, when you generate the list of users, only the number of user groups and tenants each user is associated with are displayed. You can retrieve full details with the use of a --get-data flag.

Optional flags

 

Example

$ cfy users list
...

Listing all users...

Users:
+----------+--------+------------------+------------------------------+--------+--------------------------+---------+
| username | groups | system wide role | system wide roles via groups | active |      last_login_at       | tenants |
+----------+--------+------------------+------------------------------+--------+--------------------------+---------+
|  admin   |        |    sys_admin     |                              |  True  | 2018-03-05 16:03:56.726  |    1    |
|   sue    |        |     default      |                              |  True  |                          |         |
+----------+--------+------------------+------------------------------+--------+--------------------------+---------+

...

get

Usage

cfy users get [OPTIONS] USERNAME

Get details for a single user.

USERNAME is the username of the user.

Optional flags

 

Example

$ cfy users get sue2
...

Getting info for user `sue2`...

Requested user info:
+----------+--------+------------------+------------------------------+--------+---------------+---------+
| username | groups | system wide role | system wide roles via groups | active | last_login_at | tenants |
+----------+--------+------------------+------------------------------+--------+---------------+---------+
|   sue    |        |     default      |                              |  True  |               |         |
+----------+--------+------------------+------------------------------+--------+---------------+---------+

...

deactivate

Usage

cfy users deactivate [OPTIONS] USERNAME

Deactivate a user. Deactivated users cannot login to Studio Conductor, but are in the list of users. To let the user login to Studio Conductor, reactivate the user.
USERNAME is the username of the user.

 

Example

$ cfy users deactivate assi2
...

Deactivating user `assi2`...
User deactivated

...

activate

Usage

cfy users activate [OPTIONS] USERNAME

Activate a user.

USERNAME is the username of the user.

 

Example

$ cfy users activate sue2
...

Activating user `sue2`...
User activated

...