Skip to main content
Skip table of contents

Two Factor Authentication - User Guide (Agent Desk)

There are 3 two-factor authentication channels, implemented in the Keycloak Adapter, which will be available to the end user for authenticating himself with two-factor authentication. These channels are:

  1. Google/Microsoft Authenticator Mobile App

  2. SMS

  3. RSA SecurID

Workflow for End-User

Following will be the steps performed by the user to access the applications with two factor authentication.

2FA with Google/Microsoft Authenticator

  1. User has not registered for 2FA

    1. User enters his login credentials on login screen (Image1) and clicks “Login”.

      Screenshot 2025-04-22 at 12.11.32 PM.png

      Image1 Login screen

    2. User will be redirected to another screen where a QR code (Image2) and secret code (Image3) will be shown to user for registration.

    3. There will also be an input field for OTP.(Image2 and image3)

      Screenshot 2025-04-22 at 1.50.25 PM.png

      Image2 QR Code

      Screenshot 2025-04-22 at 1.50.39 PM.png

      Image3 Secret code screen

    4. User will scan QR code through Google/Microsoft Authenticator or enter secret code manually in the app.

    5. An OTP will be displayed to user with his username. A new OTP will be generated after every 30 seconds.

    6. User will enter the OTP (which is currently visible in app) in OTP field and click “Register”.

    7. If OTP is valid then user will be successfully logged in and registered for 2FA.

  2. User has already registered for 2FA

    1. User enters his login credentials on login screen (Image1) and clicks “Login”.

    2. User will be redirected to another screen (Image4) where an input field will be shown to user to enter OTP.

      Screenshot 2025-04-22 at 1.59.47 PM.png

      Image4 OTP code secret

    3. User will enter the OTP (which is currently visible in app) in OTP field and click “Send”.

    4. If OTP is valid then user will be successfully logged in.

2FA with SMS

  1. User has not registered for 2FA

    1. User enters his login credentials on login screen (sms image 1) and clicks “Login”.

      Login Screen.png

      sms image 1 Login screen

    2. User will be redirected to another screen (sms image 2) and will be prompted to enter his phone number in the input field shown to him for 2FA registration.

      Screenshot 2025-04-22 at 2.04.10 PM.png

      sms image 2 Enter Phone number

    3. User will enter his phone number in input field and click “Register”.

    4. A dialogue box will be displayed (sms image 3) to user to confirm his phone number.

      Screenshot 2025-04-22 at 2.04.25 PM.png

      sms image 3 Phone number confirmation

      1. If it’s wrong then user will be allowed to edit his phone number.

      2. If it’s correct then an OTP will be sent to user via SMS.

    5. An input field will be shown to user to enter the OTP.(sms image 4)

    6. User can also request to resend OTP (if it is not received) by clicking “Resend OTP” button. This option will only be available while registering for 2FA.

    7. If OTP is valid then user will be successfully logged in and registered for 2FA.

      Screenshot 2025-04-22 at 2.05.48 PM.png

      sms image 4 Enter OTP screen

  2. User has already registered for 2FA

    1. User enters his login credentials on login screen (sms image 1) and clicks “Login”.

    2. User will be redirected to another screen (sms image 4) where an input field will be shown to user to enter OTP sent to his phone number.

    3. If OTP is not received then user can re-login to receive another OTP.

    4. User will enter the OTP received via SMS in OTP field and click “Send”.

    5. If OTP is valid then user will be successfully logged in.

2FA with RSA SecurID

  • Unlike the other two 2FA channels, there will be no 2FA registration flow for RSA SecurID. This process will be managed by the Customer/Administrator.

  • If 2FA is enabled on the solution, each user will be required to enter an OTP during login. If a user does not have access to the OTP, they should contact the Administrator.

  • User enters his login credentials on login screen and clicks “Login”.

    Login screen.png
  • User will be redirected to another screen where an input field will be shown to user to enter OTP.

    Screenshot 2025-05-23 at 8.49.51 PM.png
  • User will enter a 14 characters passcode in OTP field. First 8 characters will be the PIN setup by the user in SecurID Self Service Console and last 6 characters will be the OTP received on RSA Authenticator App.

  • User will be able to show/hide passcode by clicking on the eye icon.

    Screenshot 2025-05-23 at 8.50.24 PM.png
  • If OTP is valid then user will be successfully logged in.

The following error will be visible if:

  1. The OTP is invalid.

  2. The configurations are invalid.

  3. There is an issue with the RSA server.

    Screenshot 2025-05-23 at 8.57.08 PM.png
JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.