Managing Users and Groups
Note
Role based access control is an Orkes Conductor Enterprise feature. Managing users, groups, and role assignments is available only to Admins.
Users and groups control human access to an Orkes Conductor cluster. Use users for individual identities and groups for team-level permissions that should apply consistently across workflows, tasks, agents, secrets, environment variables, tags, domains, integrations, prompts, and decision rules.
Users
A user represents a human identity that signs in through SSO or email/password. Users can have direct roles, group memberships, and resource permissions inherited from groups.
Use direct user roles sparingly. For production clusters, prefer groups so access can be reviewed and changed at the team level.
Adding users
Users must be added to your Orkes Conductor cluster before they can sign up or log in.
Use the Create User API or navigate to Access Control > Users, and create a new user with the following parameters:
| Parameter | Description |
|---|---|
| User Id | The user’s email address. This cannot be changed later. |
| Name | The username. |
| Roles | The user role, which governs the basic access level for the user. The available roles are:
|
| Groups | The groups that the user should be part of. This provides additional group-level permissions to the user. |
Note
Read Only User must be the only role assigned to a user. It cannot be combined with other roles, and Read Only Users cannot be added to groups. If you change an existing user to Read Only User, their granular permissions are removed.
Editing user information
Edit a user when their team, role, or display name changes. Group membership changes take effect through inherited group permissions.
Deleting users
Delete users when they no longer need cluster access. Before deleting, check whether they own workflows, applications, schedules, secrets, or other resources that should be transferred.
APIs
Manage users programmatically with the Users API, including creating, listing, updating, and deleting users, and checking user permissions.
Groups
Groups are the preferred way to grant access to teams. A user added to a group inherits the group's roles and permissions; removing the user removes those inherited permissions.
Note
Read Only Users cannot be added to any groups.
Design groups around operational responsibilities, not individual projects. For example:
| Group | Common permissions |
|---|---|
workflow-builders |
Read/update workflow and task definitions in a namespace or tag. |
workflow-operators |
Read/execute workflows and retry, rerun, pause, resume, or terminate executions. |
worker-services |
Execute specific task definitions or domains through application identities. |
security-admins |
Manage secrets, environment variables, users, groups, and applications. |
Configuring groups
Use the Create Group API or navigate to Access Control > Groups, and create a new group with the following parameters:
| Parameter | Description |
|---|---|
| Name | A name to identify your group. For example, “Engineering”. This cannot be changed later. |
| Description | A description of the group. |
| Default group role | Optional. Roles that all group members inherit in addition to their individually assigned roles. The available roles are:
|
Note
Read Only User must be the only default role for a group. A group that already has granular permissions cannot be given Read Only User.
Next, add members or permissions to the group.
-
Add members to the group.
Use the Add User to Group API or go to the Members section, select + Add User to add an existing user to the group. If the user you are looking for does not exist, you must first add them to your cluster.
-
Add permissions to grant group-level access to resources such as Workflows, Agents, Tasks, Secrets, Environment Variables, Tags, Domains, Integrations, Prompts, and Decision Rules.
Use the Grant Access API, or go to the Permissions section, select + Add Permission.
- Toggle between each resource type and select the resources to provide access to.
- Toggle the access levels for your selected resource:
- Read: Users will be able to view the resource.
- Update: Users will be able to update the resource.
- Execute: Users will be able to execute the resource.
- Delete: Users will be able to delete the resource.
All group members will now have these roles and permissions, on top of their existing user-based permissions.
Tip
You can grant permissions to tags, rather than to individual resources. Tags can be added to multiple resources, so that when you grant a permission to a tag, it instantly provides access to all tagged resources. Learn more about tags in Managing Tags.
Editing group information
Edit a group to update its description, default roles, members, or permissions. Treat group changes as production-impacting changes because they can immediately expand or restrict access for every member.
Deleting groups
Delete a group only after confirming no users, applications, or operational processes depend on its permissions. Removing a group removes its inherited access from all members.
APIs
Manage groups programmatically with the Groups API, including creating groups, adding or removing users, and managing group permissions.