Managing Users & Groups
To ensure secure access to the Conductor server in a remote environment, it is critical to establish a system that enables access to the server. With Conductor’s Users & Groups functionality, an admin can easily create and manage users & groups in the Conductor server.
This feature is available only to the Admins of an Orkes Conductor instance.
Users
Inviting Users
To invite a user to your Orkes Cloud instance,
- From your Conductor server, navigate to ACCESS CONTROL > Users from the left menu.
- Click the Create User button.
- You need to fill in the following user details:
- Email - Enter the email address of the user.
- Name - Provide the user’s name.
- Roles - Choose the access level you wish the user to have. The available Conductor roles are Admin, User, Metadata Manager, Workflow Manager, and Read Only User.
- Click Create, and an email invitation will be sent to the user with the instructions to access the Conductor instance.
User Roles
A user can have the following roles:
- Admin - An admin has full access to the Conductor instance.
- User - A user can access permitted workflows, tasks, and shared Applications.
- Metadata Manager - An "admin" for metadata who can create/update/delete any workflow or task.
- Workflow Manager - A workflow manager can run/pause/rerun any workflow.
- Read Only User - A user with read-only permissions over the workflows and tasks.
Editing Users
To change the access for a specific user, click on the edit button next to the user, and change the role by clicking the toggle button for the relevant roles.
Deleting Users
To delete a user from your Conductor server, click the trash icon near the username and confirm the action.
Groups
Groups are a way to share workflows and tasks among your team quickly.
Creating Groups
To create a user group:
- From the left menu, navigate to ACCESS CONTROL > Groups.
- Click Create Group and provide the following details:
- Group ID - Provide a name to identify your group.
- Description - Provide a suitable description for the group.
- Click Create.
- Once the group is created, you can assign a role to the group. The Group can take the roles Admin, User, Metadata Manager, Workflow Manager or Read Only User.
- You can add members by clicking +Add User from the Members section. You can add only the users that have already been created/invited. If the user you are looking for has not been added, you can invite and then add them to the groups.
Workflow and Tasks Permissions is an additional section where you can limit the group members' access to the permitted workflows, tasks, secrets & tags.
- Click +Add Permission, and you can choose the group to have access to selected Workflows/Tasks/Secrets/Tags. Permissions that can be granted include Read, Create, Update, Execute & Delete.
Even if certain permissions are granted under the Workflow and Tasks Permissions section, the chosen role supersedes these permissions. This means that if both the Workflow and Tasks Permissions section is configured and a role is selected, the role always supersedes the other.
Group Roles
Group roles allow you to add/remove permissions to groups of users quickly. The roles are the same for an individual user but are quickly applied to everyone in the group. Group has five possible roles: Admin, User, Metadata Manager, Workflow Manager, and Read Only User.
If a role is defined for these members, they will all be given this role for the Conductor instance. For example, if Admin is selected, all the group members are now admins irrespective of their individual roles.
Editing Groups
The group settings can be modified by clicking the group name. This takes you to the individual group page, from where you can edit the group roles, members, and permissions.
Deleting Groups
To delete a group from your Conductor server, click the trash icon near the group name and confirm the action.
Example for Workflow Permissions using Groups
In the Orkes Playground, default workflows are available for all users to try out. To facilitate sharing of these workflows/tasks, we have included them in a particular group. So, every person who signs up for the Playground is added to this group so that they can have access to the workflows.