We created two new resources in License Manager to simplify and standardize access control, grouping actions related to administrative user management in the VTEX Admin more intuitively.
What has changed?
We consolidated legacy reading and writing resources for user information and roles into two new License Manager resources:
| New resource name | New resource key (resource_key) | Description |
|---|---|---|
| Edit Admin Users | EditAdminUsers | Allows creating, editing, and removing admin users. |
| View Admin Users | ViewAdminUsers | Allows viewing user and role information. |
These new resources replace the legacy resources for managing users in the VTEX Admin:
| Legacy resource name | Legacy resource key (resource_key) | Legacy resource description | New resource name | New resource key (resource_key) |
|---|---|---|---|---|
| Get paged users | Get_Users_Paged | Allows listing the account's admin users. | View Admin Users | ViewAdminUsers |
| Find user by email | Get_User_By_Identifier | Allows searching for admin users by email. | View Admin Users | ViewAdminUsers |
| Get paged roles | Get_Roles_Paged | Allows listing the account roles. | View Admin Users | ViewAdminUsers |
| Save user | Save_User | Allows creating or editing admin users. | Edit Admin Users | EditAdminUsers |
| Remove user | Remove_User | Allows revoking admin user access. | Edit Admin Users | EditAdminUsers |
Why did we make this change?
Grouping resources with similar scopes improves traceability, reduces redundancies, and makes it easier to manage permissions based on roles. The change simplifies understanding and controlling which administrative actions each role can perform.
What needs to be done?
No action is needed. We analyzed existing roles and automatically updated their permissions:
- If a role already had one or more legacy resources, an equivalent new resource was added.
- No previous permissions were removed.
- Legacy resources weren't deprecated.
We recommend reviewing the existing roles on your account to understand how the new resources were applied. If you have any questions, see the License Manager documentation.