Create users

User types

The Tuum system has two types of users:

1. BackOffice user is a user for human operators who access the Tuum system through the BackOffice interface. These users are identities for employees of your company who perform their daily tasks and should not have a system role included in their role set.

2. API user is a user for applications communicating with Tuum through API endpoints. These users are identities for other IT systems of your company integrated with Tuum and should have a system role included in their role set.

Tuum has a unique system user with the username modular.system. The system reserves this user for maintenance purposes. Tuum customers should not modify or use this user.

User creation flow

To enable a new user to perform tasks within the Tuum system, follow these three steps:

1. Create a BackOffice or API user.

2. Assign roles to restrict a user's permissions to perform authorised tasks.

3. Set up credentials to enable secure access to the Tuum system.

Below you can find more details about each step.

Create users and add roles

To create a new user:

1. Go to Administration > Access management > Users.

2. On the Users page, click Add.

Only users with the MANAGE_USERS privilege can add new employees to the BackOffice.

1. Enter the user details. The username and email must be unique within the Tuum system.

2. Select required roles. To assign a role, toggle On next to the role name.

   • If you are creating a BackOffice user, do not assign the System role to the user.

   • If you are creating an API user, assign the System role to the user.

3. Click Submit to complete the creation of a new user.

If you need to create a new role, refer to the Role management section to learn more.