Managing Users
Studio Conductor provides a user management mechanism, so you can define different users with different permissions, and upon login perform authentication and authorization to control the users’ access to resources.
The users can be either defined and managed in Studio Conductor itself, or you can configure your Manager to integrate with an LDAP-based user-management system.
You must select one of these options, as you cannot do both, and you must configure your manager accordingly upon installation or immediately afterwards, when no actions were performed on it yet.
User management can be performed using the CLI or the Conductor Management Console.
You must have Conductor Manager administrator permissions to perform user-management related actions.
Managing users in Conductor Manager
If you choose not to integrate with an external user-management system, you can manage your Studio Conductor users on the manager itself, either by the CLI commands or the User Management widget in the Conductor Management Console. You can create users, add them to user-groups, assign them with tenants under specific roles, deactivate and delete them.
Managing users by Integrating with an LDAP System
To integrate the Conductor Management Console with an LDAP user repository, please follow these directions
Adding Users Manually
If you choose not to integrate Conductor Manager with LDAP systems, you must add each user individually and set a password for them. You can also create user-groups and add users to them. The users and user groups can be assigned to one or more tenants.
For more information, see the users and user-groups commands in the CLI documentation.
Tenant-Related Commands
You can add and remove users and user groups to/from a specific tenant. To run these user-related tenant-specific commands, use cfy tenant
. For more information, see the tenants command in the CLI documentation.
add-user
enables you to add an individual user to a tenantadd-user-group
enables you to add a user groups to a tenantcreate
enables you to create a tenantdelete
enables you to delete a tenantget
enables you to view information about a tenant, including its userslist
displays a list of all tenants in this instance of Conductor Manager. By default, when you generate the list of tenants, only the number of linked user-groups and users is displayed. You can retrieve full details with the use of a--get data
flag.remove-user
enables you to remove a specific user from a tenantremove-user-group
enables you to remove a user group from a tenant
How to assign a role to user
When a user is added to a tenant, a Role must be assigned to it by passing a valid value in the -r/--role
option.
cfy tenant add-user -r <role name> ...
adding a user to a tenant, and give him a role.cfy tenant add-user-group -r <role name> ...
adding a user-group to a tenant, and give it a role.cfy users set-role <role-name>
setting the user system role
User Account Lock
Studio Conductor lets admins enforce an account lock after a user fails for a specified number of login attempts. After an account is locked the user must wait the specified time period before another login attempt, or the admin can unlock the user account.
You can configure the account lock in the Conductor Manager either:
-
Before you start to use the Conductor Manager - Before you install the Conductor Manager or after you install the Conductor Manager, you can set the account lock settings in the config.yaml file. After you install or configure the Conductor Manager, the account lock is enforced.
-
After you start to use the Conductor Manager - Edit the account lock settings in the rest service configuration file at
/opt/manager/rest-security.conf
. To enforce the account lock, restart the Studio Conductor rest service:supervisorctl restart cloudify-restservice
User Lock Settings
In either the config.yaml file or the REST service configuration, set these account lock settings:
failed_logins_before_account_lock
- Number of failed logins (bad password) before account lock.account_lock_period
- Account lockout time in minutes.-1
disables account lockout even whenfailed_logins_before_account_lock
has a value.
Unlocking a user
Studio Conductor admins can unlock a user account with the command: cfy users unlock <username>