Skip to main content
Version: next

User Management

Overview

User Management is used to manage login accounts in the system. Here you can create new users, view the user list, search for users, enter user details to adjust information, or reset passwords.

User Management list page

Key Features

  • Full account lifecycle management: Create, edit, disable, and delete users
  • Multiple activation methods: Activate new accounts via temporary password or email invitation (business tenant)
  • Quick search: Fuzzy search by username, name, or email, and filter by locked status
  • Bulk operations: Select multiple users for batch deletion
  • Security controls: Identify locked accounts and prevent deletion of the initial administrator account

Interface Layout

The User Management page uses a standard list layout, divided into three sections: search/filter area, table area, and toolbar.

Search and Filter Area

The search bar above the table provides the following search criteria:

CriterionDescription
Search boxFuzzy search by username, name, or email, case-insensitive
Lock statusFilter by "All / Locked / Unlocked" accounts

Enter criteria and click Search to execute the query, or click Reset to clear all criteria.

User List

For common table operations such as column management, density, pagination, and quick navigation, see Data Table Common Operations.

The user list displays the following columns by default:

ColumnDescription
UsernameLogin identifier; click to enter user details
NameUser's first and last name
EmailContact email
SourceLocal user (created in the system) or external user (synced from an external identity source)
Lock statusLocked (red tag) or unlocked (green tag)
RolesRoles directly assigned to the user (only shown in business tenant, up to 2 displayed)
ActionsPer-row delete (requires edit permission)
About "Lock Status"

Common reasons an account may be locked: an administrator manually locks it, or the system's brute-force protection is triggered after multiple consecutive failed password attempts. Locked users cannot log in; an administrator needs to reset the password or unlock the account. See User Details - Lock Status.

Toolbar

The toolbar in the upper-right corner of the table provides the following actions:

ButtonFunctionUse Case
CreateOpens the "Create User" dialogAdding a new login account
Batch DeleteDeletes multiple selected users at onceBulk cleanup of expired accounts
RefreshReloads the user listData was changed elsewhere and you want to see the latest results

The above create and delete operations are only visible to administrators with "full access" permission on the "User" resource. Regular users can only view.

Creating a User

Click the Create button in the toolbar to open the Create User dialog.

Create User dialog

Field Descriptions

FieldRequiredDescription
UsernameYesLogin identifier; cannot be changed after creation. 3-64 characters, must start with a letter, and may only contain letters, numbers, underscores (_), and hyphens (-)
First nameYesUser's first name
Last nameYesUser's last name
Activation methodYesSee "Activation Methods" below (only shown in business tenant)
EmailRequired for email activationContact email. Must be filled in when "Email Activation" is selected
PasswordRequired for temporary passwordAt least 8 characters; must include uppercase letters, lowercase letters, numbers, and special characters
Confirm passwordRequired for temporary passwordMust match the password
RolesNoRoles directly assigned to the user; "Read-Only User" is checked by default. Can also be assigned later in User Details or User Groups (only shown in business tenant)

Activation Methods

When creating a user in a business tenant, you can choose from two activation methods:

Activation MethodProcessSuitable For
Temporary password (default)You set a password for the new user, communicate it to the user, and the user must change it on first loginWhen you know the person and can securely deliver the password
Email activationThe system sends an activation email to the user's mailbox; the user sets their own passwordWhen a valid email is available and you want the user to self-set their password
Note when choosing "Email Activation"

If the user's email is correct but the email delivery fails (e.g., mailbox is unreachable or email service is down), the system will display "User created, but activation email failed to send." In this case, the user account has been created but no activation email was received. Please verify the email address or email service and resend.

Differences in System Tenant

In the system tenant, the Create User dialog only has basic fields such as username, first name, last name, password, and confirm password. There is no "Activation Method" or "Roles" option. Users in the system tenant are always activated using the temporary password method.

Creation Steps

  1. Click the Create button in the toolbar
  2. Fill in the username, last name, and first name
  3. Select an activation method (business tenant):
    • Temporary password: fill in and confirm the password
    • Email activation: fill in a valid email address
  4. Optionally check roles to assign (business tenant; "Read-Only User" is checked by default)
  5. Click Create to submit

A confirmation message will appear upon successful creation, and the new user will immediately appear in the list.

Deleting Users

Deleting a Single User

Click the delete icon in the Actions column of the corresponding row, then click Confirm in the confirmation dialog.

Batch Deletion

  1. Select multiple users to delete in the table (checkbox in the first column)
  2. Click the Batch Delete button in the toolbar
  3. Confirm the number of deletions in the confirmation dialog, then click Confirm

Deletion Restrictions

The system provides protection for the following scenarios:

ScenarioResult
Attempting to delete the initial administrator accountThe delete button for that account is grayed out and cannot be selected; displays "Initial user cannot be deleted"
Batch deletion that includes the initial accountThe initial account is automatically excluded; the rest are deleted normally with a notification
Data After User Deletion

Deleting a user does not delete the configuration items, dashboards, or other business data they created. The "creator" and "last updated by" records for that data are preserved; only the account can no longer log in to the system.

Entering User Details

Click the Username link in the list to enter that user's details page, where you can edit basic information, assign roles and user groups, reset passwords, and more. See User Details.