Users and roles
Instructions about user management
Introduction
Within IPMHub.io
, you can manage user access and permissions. Each user is assigned a specific role that defines what actions they can perform within the system. Owners have full control over an organization, allowing them to create, assign, or update user roles to ensure proper access control across the platform. Roles help streamline permissions, making it easy to manage what users can see and do.
Manage a User Role
You can manage each user’s role individually based on their needs. When a user is newly added to IPMHub.io
, they start with the role None
, meaning they are part of your organization but have no access yet.
Change a User’s Role
-
Go to the Organization dashboard.
-
Click the
Users
button.Click the image to enlarge
-
Select the user whose role you want to change. Tip: You can use the search box to filter the user table. The input can be based on any column.
Click the image to enlarge
-
Select the new role you want to assign to the user.
Click the image to enlarge
-
Confirm that the changes have been saved correctly.
Click the image to enlarge
Role overview
Within IPM the following roles are available to be used.
Role | Description |
---|---|
None |
A user with this role is part of the organization but has no access to any features. This role does not require a license. |
Reader |
Allows a user permission to view and use basic components, such as packages and Tracked Workspaces. |
Contributor |
Allows a user to view, use, and modify basic components, including packages and Tracked Workspaces. |
Security Manager |
Users with this role can modify the roles of other users (except those with the Owner role) but have no access to packages or Tracked Workspaces. |
Manager |
Can view and modify everything within an organization, except for changing the role of an Owner . |
Owner |
Has full control over the organization, including viewing and changing all aspects within it. |
Functionality overview
The table below give an clear overview of which role a user needs to use a specific version.
Functionality | None | Reader | Contributor | Security Manager | Manager | Owner |
---|---|---|---|---|---|---|
IPM Add | ✔ | ✔ | ✔ | ✔ | ||
IPM Info | ✔ | ✔ | ✔ | ✔ | ||
IPM Search | ✔ | ✔ | ✔ | ✔ | ||
IPM List | ✔ | ✔ | ✔ | ✔ | ||
IPM Publish | ✔ | ✔ | ✔ | |||
View Packages | ✔ | ✔ | ✔ | ✔ | ||
Use Packages | ✔ | ✔ | ✔ | ✔ | ||
Change Packages | ✔ | ✔ | ✔ | |||
Create Packages | ✔ | ✔ | ✔ | |||
Create Tracked Workspaces | ✔ | ✔ | ✔ | |||
Modify Tracked Workspaces | ✔ | ✔ | ✔ | |||
Delete Tracked Workspaces | ✔ | ✔ | ✔ | |||
Restore Tracked Workspaces | ✔ | ✔ | ✔ | |||
Change Organization Settings | ✔ | |||||
Invite users* | ✔ | ✔ | ✔ | |||
Add users* | ✔ | ✔ | ✔ | |||
Remove users* | ✔ | ✔ | ✔ | |||
Modify User Roles | ✔ | ✔ | ✔ | |||
Change Role of Manager | ✔ | ✔ | ||||
Change Role of Owner | ✔ |
- You can only invite, add and remove users who have the same role as yours or lower.
Error references and rules
Rules
- You cannot change your own role.
- You cannot change (demote or promote) users who have a higher role assigned than you.
- A
None
role does not consume a seat in the subscription plan. When promoting users, ensure there are sufficient seats available. - There must be a
Owner
at all time
Error codes
When changing a role is failing it’s probably because of one of the following reason, and what you can to to resolve it.
ipmh100
Unhandled exception when changing the role for {user}
Explanation
This error occurs when an unexpected issue arises while trying to change the role of a specific user in IPMHub.io
. It could be due to system or network problems, or the user’s data not being retrieved correctly.
Solution
Try refreshing the page and attempting the role change again. If the issue persists, check if there are any ongoing system issues. If the problem continues, contact support to investigate the cause of the error.
ipmh101
Changing the role of a higher privileged member is not allowed
Explanation
In IPMHub.io
, only users with specific roles can modify the roles of others. The roles authorized to make these changes are Security Manager
, Manager
, and Owner
. However, you can only change the roles of users who are on the same or a lower role level than yours. This is designed to prevent unauthorized users from modifying the roles of those with higher permissions, ensuring proper access control and security within your organization.
Solution
To change the role of a user with a higher role than yours, you must contact someone with a role level equal to or higher than the user whose role needs to be changed. For example, if you are a Manager
and need to change the role of a Security Manager
, you would need to ask an Owner
to perform the role update.
ipmh102
Changing your own role within an organization is not allowed
Explanation
In IPMHub.io
, users are not permitted to modify their own role. This restriction is in place to prevent potential abuse of permissions and ensure that role assignments remain secure and consistent.
Solution
To change your role, you must contact another user with sufficient permissions, such as a Security Manager
, Manager
, or Owner
, and request that they update your role.
ipmh103
The role you are trying to set is already set
Explanation
This error indicates that the role you are trying to assign to a user is the same as their current role. No changes can be made if the user is already assigned the selected role.
Solution
Verify the current role of the user before attempting to make changes. If the role is correct, no further action is needed.
ipmh104
Failed to get an actual list of owners
Explanation
This error occurs when IPMHub.io
cannot retrieve the list of users assigned the Owner
role within the organization. It may be caused by connectivity issues or data synchronization problems. This check is in place to make sure an Organization will always have at least one **
Owner`**. If this check fails we stop further processing to prevent an unexpected loss of control of your organization.
Solution
Try refreshing the page or checking your network connection. If the issue persists, reach out to support to resolve the data retrieval problem.
ipmh105
An organization needs at least 1 owner
Explanation
Every organization in IPMHub.io
must have at least one user assigned the Owner
role to maintain administrative control over the organization. This error appears if an action results in the removal of all users with the **
Owner**
role.
Solution
Ensure that there is always at least one user with the Owner
role before attempting any role changes. If you need to remove an **
Owner**
, assign a new Owner
` first.
ipmh107
Changing the role of user {user} is not allowed
Explanation
This error occurs when you attempt to change the role of a user who has higher or equal permissions to your current role. In IPMHub.io
, you can only modify the roles of users who are on the same level or below your role.
Solution
To change the role of the user, contact someone with a higher role, such as a Security Manager
, Manager
, or Owner
`, to make the changes on your behalf.