User profile administration
You can manage your profile using the Keycloak profile application.
Before you can manage your profile, you must log in to Litmus Edge Manager and access your user profile, which is located in the top-right corner of Litmus Edge Manager.
See Access to Litmus Edge Manager to access the Keycloak application the first time.
Access user profile
To open your user profile:
- Log in to Litmus Edge Manager.
- Select a company. The Projects pane appears.
- From the top of the window, click the User icon, and then select Profile.
The Keycloak profile application opens.
Manage personal info
You can manage your username and email by clicking Personal info from the Keycloak landing page.
Update your username and email as needed and click Save.
Manage account password
You can manage the account password needed to log in to Litmus Edge Manager through the Keycloak application.
Notes:
- After you change your user account password, you are logged out and you must log in again using your new password.
- If two-factor authentication is enabled, you must provide the six-digit code from the authentication application on your phone during log in.
To manage your account password:
- From the Keycloak landing page, click Signing in.
- From the Signing in page, click Update. The Litmus Edge Manager login screen displays.
- Log in to Litmus Edge Manager again with your current credentials.
- Enter the new password twice and click Submit.
Set up Keycloak two-factor authentication
You have the option of setting up two-factor authentication through Keycloak. For additional security, you can configure two-factor authentication (TFA) with a free authenticator application like Google Authentication.
Two-factor authentication exceeds standard security practices by requiring more than a username and password for login access. The authenticator software generates a token that expires within 60 seconds. This token provides the additional layer of authentication required for login.
Before you begin
You must modify your user account and optionally change your user account password using the Keycloak profile application.
To configure two-factor authentication:
- From the Keycloak landing page, click Signing in.
- From the Signing in page, click Set up authenticator application.
- Follow the prompts to set up the authenticator application.
Once you configure the authenticator, you will see a confirmation message.
Note:
- Once you set up two-factor authentication, you must use the authenticator application to access your account after entering your username and password.
- After you enter the username and password, the login directs you to a screen to enter the 6-digit one-time code generated by the application on your smart phone.
View device activity
To view device activity for Litmus Edge Manager, click Device activity from the Keycloak landing page.
You have the option of signing out specific signed-in devices or logging out of all devices.
View application permissions
You can view application permissions by click Applications.
Click the arrow for an application to view more information.
Assign admin privileges
You can assign admin privileges to a user in your Litmus Edge Manager through the Keycloak admin console.
Important: You must have the Administrator role (em-admin) to do the following:
- Add or manage a company from your LEM.
- Assign Admin roles to other users in your LEM.
To assign admin privileges:
- To access the Keycloak admin console, use the URL https://<lem hostname>/auth/admin. Check the Sign in to Litmus Edge Manager for your first-time login details.
- From the Keycloak Realm drop-down on the left, switch the realm to standalone.
- Navigate to Users and select the user to whom you want to grant the privileges.
- Click the Role mapping tab and then click the Assign role button.
- Select em-admin on the pop-up and click Assign.
Once completed, log out and log back in on the LEM UI with the user who was just granted the admin privileges. You should now see (Admin) next to their name on the top right.
