All Products
Search
Document Center

Agent Identity:User management

Last Updated:Sep 03, 2026

Users in a user pool represent the end users who sign in to AI Agent applications. This topic describes how to create users, update user information, view user information, and delete users in a user pool.

User sources

A user pool supports the following user sources: users automatically created and updated through JIT (Just-In-Time) provisioning from SAML 2.0 or OIDC identity sources, users manually created by an administrator in the console, and users synchronized from identity sources such as the IDaaS Application Identity Service, DingTalk, Lark, WeCom, and generic SCIM.

  • JIT provisioning: When an end user signs in for the first time through a SAML 2.0 or OIDC identity source by using SSO, the system automatically creates the corresponding user in the user pool based on the attributes from the identity source. The system can automatically update the user information on subsequent sign-ins.

  • Manual creation in the console: An administrator creates a user directly from the user list in a user pool. This method applies when no identity provider (IdP) is available or when you need to perform quick integration tests. For more information, see Create a user.

  • Active user synchronization from identity sources: Includes the IDaaS identity source, generic SCIM protocol identity sources, DingTalk, Lark, and WeCom.

Users in each user pool are isolated from one another. When the same user from an external IdP signs in to different user pools, the system creates a separate user in each user pool.

Create a user

When no IdP is available or you need to perform quick integration tests, manually create a user in the console. After the user is created, the system automatically assigns the default role. You can adjust the role assignment in role management.

Prerequisites

  • A user pool has been created.

  • Your account has management permissions on the target user pool.

Procedure

  1. Log on to the Agent Identity console.

  2. In the left navigation pane, select Inbound > User Pool.

  3. Click the name of the target user pool to open its details page.

  4. Click the Users tab, and then click Create user.

  5. In the Create user panel, enter the user information, and then click Create user.

User parameter descriptions

Parameter

Required

Description

User name

Yes

The unique identifier of the user in the user pool. The length must be 3 to 128 characters. Letters, digits, underscores (_), hyphens (-), and dots (.) are supported.

User display name

No

The name displayed for the user in the console and applications to help identify the user.

Email

No

The user's email address. Enter a valid email address.

Description

No

Additional information about the user. The maximum length is 128 characters.

Password

Yes

Select one of the following three options:

  • Unset: The user has no initial sign-in password. An administrator must later set one by using Set password.

  • Automatically generate: The system generates an initial password according to the password rules.

  • Custom: Enter an initial password that complies with the password rules below.

Even if you select "Unset", explicitly select this option. You cannot create the user without selecting one of the options.

Password rules

The user pool uses fixed password rules that cannot currently be customized:

  • At least 8 characters.

  • Contain uppercase letters, lowercase letters, digits, and special characters.

  • Do not include the username.

  • Never expire.

  • After five consecutive incorrect sign-in passwords, the account is locked for one hour.

View users

You can view all created users and their attributes in a user pool.

  1. Log on to the Agent Identity console.

  2. In the left navigation pane, select Inbound > User Pool.

  3. Click the name of the target user pool to open its details page.

  4. Click the Users tab.

The user list displays the following information:

  • User name: The unique identifier of the user in the user pool. The name of a JIT-created user comes from the NameID in the SAML assertion. For a manually created user, the administrator enters the name.

  • Source identity provider: The name of the SAML identity provider that created the user. This column is empty for manually created users.

  • UserType: The source from which the user was created. The system records this value automatically, such as Manual, Sync from JIT, or Sync from IDaaS.

  • Created at: The time when the user was created. For a JIT-created user, this is the time of the first SSO sign-in. For a manually created user, this is the time when the administrator created the user.

Update user information

Edit the user display name, email address, or description individually from the user details page. You can also enable or disable the account by using the Status field. System-managed fields, including the user name, UserType, Created at, and Updated at, cannot be modified.

Procedure

  1. Log on to the Agent Identity console.

  2. In the left navigation pane, select Inbound > User Pool.

  3. Click the name of the target user pool to open its details page.

  4. Click the Users tab.

  5. In the user list, click the name of the target user to open the user details page.

  6. In the Basic Info section, click Edit to the right of the target field, make the change in the dialog, and then click OK.

Field descriptions

Field

Editable

Description

User name

No

The unique identifier of the user in the user pool. It cannot be modified after creation and can only be copied.

User display name

Yes

The name displayed for the user in the console and applications.

Email

Yes

The user's email address.

Description

Yes

Additional information about the user.

UserType

No

The source from which the user was created. The system records this value automatically, such as Manual, Sync from JIT, or Sync from IDaaS.

Status

Yes

The enabled status of the user account. Click Edit to open the Toggle user status dialog, select Enabled or Disabled, and then click OK.

Created at

No

The time when the user was created in the user pool.

Updated at

No

The most recent time when the user information was updated.

Note

On the upper-right corner of the user details page, you can also use Set password and Delete user, among other operations.

Delete a user

Delete a user from the user pool when the user no longer needs access to the AI Agent application.

Important

Deleting a user also deletes all role assignments for the user, and the action cannot be undone. If JIT provisioning is enabled and the user signs in through SSO again, the system creates a new user record without the previous role assignments.

  1. In the user list, find the target user, and in the Actions column, click Delete user.

  2. In the Delete user dialog, enter the user name as prompted, and then click Delete user.