42.1. Users #
42.1.1. Creating a User #
In the navigation panel, go to Users.
In the top-right corner of the page, click Add user.
Specify parameters of the new user (parameters marked with an asterisk are required):
First name.
Last name.
Email.
Login: The user login for logging in to the web application.
The maximum login length is 64 characters.
Password: The password for logging in to the web application.
The minimum password length is 8 characters.
Job title.
Phone.
Personal roles: Roles that are assigned to the user.
To assign a role to a user, click Add and select the role. For certain roles, select objects to which these roles grant access.
Groups: Groups to which the user is added.
You can also add a user to a group when creating or editing the group.
PPEM access: Specifies whether the user can log in to the web application.
Possible values:
Password change is required: The user can log in to the web application. When logging in, the user must reset the password.
Active: The user can log in to the web application.
Blocked: The user is blocked from logging in to the web application.
To unblock a user, select Active from PPEM access when editing the user.
Auto-blocked: This value cannot be selected when creating a user, but it can be displayed when viewing users.
Click Add.
42.1.2. Viewing Users #
In the navigation panel, go to Users.
The table of users with the following columns will be displayed:
Login: The user login for logging in to the web application.
Full name: The first and last name of the user.
This column includes additional information:
Email.
Phone number.
This column includes additional information:
Job title.
PPEM access: Specifies whether the user can log in to the web application.
Possible values:
Active: The user can log in to the web application.
Auto-blocked: The user was automatically blocked from logging in to the web application for exceeding the failed login attempt limit.
For more information about automatic user blocking, refer to Section 42.1.5.
Blocked: The user is blocked from logging in to the web application.
To unblock a user, select Active from PPEM access when editing the user.
Password change is required: The user can log in to the web application. When logging in, the user must reset the password.
User type.
Possible values:
System: The
manageruser created automatically by PPEM for internal purposes, such as performing automated actions by the manager component. This user is not intended for login and cannot be edited or deleted.Local: Users created manually using the web application. They are intended for login and can be managed using PPEM.
LDAP: Users synchronized from an external LDAP directory service, such as OpenLDAP or Microsoft Active Directory. They can be managed using PPEM after synchronization.
OIDC: Users authenticated through the external OpenID Connect provider. They are created automatically upon successful authentication and can be managed using PPEM after synchronization.
Personal roles: Roles that are assigned to the user.
Groups: PPEM groups, LDAP groups, and OIDC groups to which the user is added.
Actions.
For more information about available actions, refer to the corresponding instructions.
42.1.3. Editing a User #
In the navigation panel, go to Users.
Click next to the user.
Edit user parameters.
Click Save.
42.1.4. Resetting a User Password #
In the navigation panel, go to Users.
Click next to the user.
Enter and confirm the new password.
Click Update password.
42.1.5. Configuring the Automatic User Blocking #
You can specify the maximum number of failed attempts to log in to the web application, after which the user is automatically blocked from logging in again. To do this, use the jwt.max_failed_login_attempts: parameter of the maximum_number_of_failed_attemptsppem-manager.yml manager configuration file.
The default value of the parameter is 0. When set to 0, automatic blocking is disabled and failed login attempts are not counted. When set to a value greater than 0, the user account is automatically blocked when the number of failed login attempts reaches the specified threshold. The failed login attempt counter is maintained for each user individually and is reset after a successful login.
When automatic blocking is enabled, the table of users additionally displays the current number of failed login attempts for each user. For a user blocked for exceeding the failed login attempt limit, the time when the user was blocked is also displayed.
Users blocked for exceeding the failed login attempt limit are not unblocked automatically. Only an administrator can unblock such a user by changing the user status to Active, which also resets the failed login attempt counter.
To unblock a user, select Active from PPEM access when editing the user.
Note
Set max_failed_login_attempts to a non-default value to comply with your organization security policies.
42.1.6. Deleting a User #
Important
Deleted users cannot be restored.
To delete a user:
In the navigation panel, go to Users.
Click next to the user.
Click Delete.
After a user is deleted, the user record is automatically hidden from the user list. However, this record remains in the database to maintain data integrity.