Stand with Ukraine flag
Pricing Try it now
PE MQTT Broker
Community Edition Professional Edition Cloud Edge PE Edge IoT Gateway License Server Trendz Analytics Mobile Application PE Mobile Application MQTT Broker PE MQTT Broker
Documentation > Administration UI > Users
Getting Started
Installation Architecture API FAQ
On this page

User management

TBMQ PE includes two predefined user roles: Administrator and Viewer. For a detailed explanation of role-based access control, see RBAC.

User management can be performed through TBMQ’s Web UI or REST API.

Add user

To add a new User, please follow these steps:

  1. On the left-hand menu, click ‘Users’ and then the plus icon to create a new user.
  2. Provide the user’s email address, which must be unique within the system. The fields for first name, last name, and description are optional. Click Add to create the user.
Navigate to the Users page. Then click on the "plus" icon in the top right corner;
Navigate to the Users page. Then click on the "plus" icon in the top right corner;
Provide the email address, which must be unique within the system. The fields for first name, last name, and description are optional. Click "Add" to create the user.
Provide the email address, which must be unique within the system. The fields for first name, last name, and description are optional. Click "Add" to create the user.

Note that all new users are initially created with the default password sysadmin. Upon logging in, users will be prompted to change the default password.

Edit user

To edit the details of an existing administrator, please follow these steps:

  1. Locate the desired user in the Users table and click on the corresponding row.
  2. Click the Toggle edit mode button to modify the user’s first name, last name, or description.
  3. Click the Apply changes button to save any modifications.
Locate the desired user in the Users table and click on the corresponding row.
Locate the desired user in the Users table and click on the corresponding row.
Click the Toggle edit mode button.
Click the Toggle edit mode button.
Modify the first name, last name, or description and click on the button "Apply changes" to save the changes.
Modify the first name, last name, or description and click on the button "Apply changes" to save the changes.

Delete user

Logged-in user can delete other users, but not itself. To delete the user, follow these steps:

  1. Find the user in the Users table and click on the corresponding row.
  2. Click the Delete user button and confirm the action by selecting Yes.
Find the user in the Users table and click on the Delete button.
Find the user in the Users table and click on the Delete button.
Confirm the action by selecting Yes.
Confirm the action by selecting Yes.

Login as another user

TBMQ allows Admin users to securely log in as other users automatically, without requiring their credentials or manual authentication.

  1. Find the user in the Users table (you can only log in as other users).
  2. Click the Login button in the corresponding row.
In the Users table, select the desired user and click the Login button to proceed.
In the Users table, select the desired user and click the Login button to proceed.

User created via OAuth 2.0

If a user signs in using OAuth 2.0 while the Allow user creation option is enabled, the user account is automatically created in the system. These users are created without a password set and can continue using Single Sign-On (SSO) to log in. If the user wants to log in using a regular username/password flow, they should go to Account → Security and set a new password. When changing the password, leave the Current password field empty.