QuickStart Guide

User Profile Administration

11min

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:

  1. Log in to Litmus Edge Manager.
  2. Select a company. The Projects pane appears.
  3. From the top of the window, click the User icon, and then select Profile.
User profile drop down menu
User profile drop down menu


The Keycloak profile application opens.

Keycloak landing page
Keycloak landing page


Manage Personal Info

You can manage your username and email by clicking Personal info from the Keycloak landing page.

Personal info link
Personal info link


Update your username and email as needed and click Save.

Personal info settings
Personal info settings


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:

  1. From the Keycloak landing page, click Signing in.

    Signing in link
    Signing in link
    
  2. From the Signing in page, click Update. The Litmus Edge Manager login screen displays.

    Update password button
    Update password button
    
  3. Log in to Litmus Edge Manager again with your current credentials.
  4. 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:

  1. From the Keycloak landing page, click Signing in.

    Signing in link
    Signing in link
    
  2. From the Signing in page, click Set up authenticator application.

    Set up authentication link
    Set up authentication link
    
  3. 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.

Device activity link
Device activity link


You have the option of signing out specific signed-in devices or logging out of all devices.

Options to sign out devices
Options to sign out devices


View Application Permissions

You can view application permissions by click Applications.

Applications link
Applications link


Click the arrow for an application to view more information.

Application information
Application 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:

  1. To access the Keycloak admin console, use the URL https://<lem hostname>/auth/admin. Check the Access to Litmus Edge Manager for your first-time login details.
  2. From the Keycloak Realm drop-down on the left, switch the realm to standalone.

    Keycloak realm side menu
    Keycloak realm side menu
    
  3. Navigate to Users and select the user to whom you want to grant the privileges.
  4. Click the Role mapping tab and then click the Assign role button.
  5. Select em-admin on the pop-up and click Assign.

    Assign roles dialog box
    Assign roles dialog box
    

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.

Admin role assigned to user
Admin role assigned to user