How to use roles

Rights management

Roles are part of our user management system, if you haven't already, we recommend reading our article: Rights management explained.×Dismiss alert

Every user has to get assigned a role in your company. This role determines what permissions that user will have in X4 Remote. You can configure as many roles as you like yourself, or you can use our default roles. Our default roles are: platform administrator, engineer and customer. They are the most common roles for users of X4 Remote. It is always possible to change or remove a role later.

Add a new role

Please follow the steps described below to add a new role.

  • Go to the Admin which is accessible from the Apps menu in the top right corner if you are currently in a different X4 Remote app.
  • Open the main menu, go to Roles then click on [add role].
  • In case you want to give users access to all devices, groups and templates, select company-wide role. This is required for some of the permissions. You can see for what permissions this is required in the table below. A company-wide role doesn’t belong to a group.
  • Select all the permissions you want to give users with this role. The table below contains a list of your options. Then click on [add].
Permission Details Company-wide role required
Configure company identity Make changes to the branding and company info. Yes
View audit trail You can see a log of all changes that have been made in your company. Yes
View licenses You can see whether Cloud Logging and Cloud Notify licenses are active. Yes
Mange roles, access categories and group types Make changes to  rights management Yes
Manage groups Make changes to the groups in your company. Yes
Can manage pages and cards You can create, edit and remove all dashboards in your company. Yes
Upload components You can create, edit and remove custom components for all the dashboards in you company. Yes
Manage users

You can add or remove new users within your group and edit the roles and groups that apply to them.

No
Manage devices You can manage all existing devices in your group and add new devices. No
Manage device templates You can create, edit and remove all device templates. Yes
Access categories You can give every role permission to all your access categories. No
Enforce two-factor authentication You can enforce 2FA for all users with a certain role. You need to turn on 2FA yourself to apply this permission No

Edit an existing role

Please follow the steps described below to edit an existing role.

  • Go to the Admin which is accessible from the Apps menu in the top right corner if you are currently in a different X4 Remote app.
  • Open the main menu, go to roles, then click on [Edit].
  • Change the role name, if you want.
  • Edit all the permissions you want to give users with this role. The table above contains a list of your options. Then click on [confirm].

Remote a role

Unable to remove

When a user is assigned to a role you can't remove that role. You first have to assign that user to a different role to remove that role. There has to be a platform administrator. This means you can't remove the platform administrator role..

Please follow the steps described below to remove an existing role.

  • Go to the Admin which is accessible from the Apps menu in the top right corner if you are currently in a different X4 Remote app.
  • Open the main menu, go to roles.
  • Choose the role you would like to remove, then click on [remove].
  • Confirm by clicking on [remove].

Roles are configured

You have now successfully configured roles. You can also configure access categories and groups in order to fully customise our rights management system.

 

Formulário de contato