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

  1. Go to the Organization dashboard.

  2. Click the Users button.

    Organization dashboard

    Click the image to enlarge

  3. 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.

    user table

    Click the image to enlarge

  4. Select the new role you want to assign to the user.

    Change user role popup

    Click the image to enlarge

  5. Confirm that the changes have been saved correctly.

    Role change saved

    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.