Manage user provisioning with user groups
This article describes how to add, view, or edit user groups in OneID. These operations apply only to organization admins.
A user group contains a group of Zuora tenants and the corresponding OneID user roles. For more information about user groups and priorities, see OneID user groups.
Add user groups
To add a user group in OneID, take the following steps:
- Navigate to Admin Console > Groups.
- Click Add New Group. The New User Group page opens.
- Specify the basic information of the user group:
- User Group Name: the name of the user group.
- Description: optionally, the description of the user group.
- Click Next. The Edit User Group page opens.
- Define the permission and user role information for each tenant in the Set Tenant Permissions and Roles section:
- Switch the toggle in the Permission column to indicate whether to add permissions for this tenant to the current user group.
- If the toggle is switched to On, select a user role from the dropdown list in the User Role column.
- Repeat steps a and b for each tenant.
- Click Save.
- Optional: Add users to this user group:
- Click the plus icon in the Users section. The Select the Available Users window opens.
- Add users to the current user group by selecting the checkboxes.
- Click Add Users. The selected users are listed in the Users section.
View user groups
To view user group information in OneID, take the following steps:
- Navigate to Admin Console > Groups.
All user groups in your organization are listed in the table, including the group name, tenant, and user role information of each user group. - If a user group contains more than one tenant, click the icon at the beginning of a row to show all Zuora tenants and corresponding user roles in this group.
Edit user groups
To edit a user group in OneID, take the following steps:
- Navigate to Admin Console > Groups.
- Click the pencil icon to the right of a user group. The Edit User Group page opens.
- Update the basic information:
- Click Edit to make the User Group Name and Description fields editable.
- Enter a new user group name and/or a new description.
- Click Save to confirm the changes.
- Define the permission and user role information for each tenant in the Set Tenant Permissions and Roles section:
- Switch the toggle in the Permission column to indicate whether to add permissions for this tenant to the current user group.
- If the toggle is switched to On, select a user role from the dropdown list in the User Role column.
- Repeat steps a and b for each tenant.
- Click Save.
- Add users to this user group:
- Click the plus icon in the Users section. The Select the Available Users window opens.
- Add users to the current user group by selecting the checkboxes.
- Click Add Users. The selected users are listed in the Users section.
Add users to user groups
There is a many-to-many relationship between users and user groups. A user group can contain multiple users, and a user can belong to multiple user groups.
Here are some ways to add users to user groups in OneID:
- Add a user to a user group when creating a user.
- Add a user to multiple user groups when editing a user.
- Add multiple users to a user group when creating or editing a user group.
The following table shows the operations and details of these approaches:
Operation | How many users can be managed? | How many user groups can be managed? |
---|---|---|
Adding a user | One | One |
Editing a user | One | Multiple |
Adding a user group | Multiple | One |
Editing a user group | Multiple | One |
For example, when editing an existing user in OneID, you can add the current user to multiple user groups.