Skip to main content
Skip table of contents

How to enable, configure and use MFA

General

VISULOX MFA enriches the standard VISULOX PORTAL authentication layer to change the behaviour of the one factor authentication process (username, password) to a multi factor process (username,  password / random-pin). Every time the user tries to login, a new PIN is generated. The PIN is randomly chosen and unique.

Prerequisites

For this example setup two users have to be registered in VISULOX PORTAL with the following settings:

UserRoleeMailSMSApplication
MasterSupervisor<supervisor>@company.com-VISULOX Cockpit
MillerUser<user>@company.com<user SMS via LDAP>-

Supervisor Master enables and configures the MFA login.

User Miller logs into VISULOX PORTAL with MFA authentciation enabled.

Supervisor Master: Enable MFA for Miller

Creating a new Login Policy in Cockpit:

A unique name for the policy must be entered: "POL-LOGIN".

The Policy mode can be chosen from a dropdown list.

The sequence number, the lifetime and the time will be displayed on the login mask of the user.

The default settings are fine for this example. A comment for the policy can be entered as well.


Selecting the policy Login mode:


Setting the filter:

Filter is set to "Miller" for all examples.

Additional filters can be set based on the Remote IP address or on the access point (not used in this example).


Selecting the script:

With the Login script, notifications can be sent to the supervisor (Not used in this example).

The default "PINScript" can be used to send the PIN notification to user Miller.

It is also possible to adjust the PIN script, so that a supervisor gets an eMail/SMS as well (See: Action script interface & variables).

If a script is selected, it will be used for all MFA modes.


After saving the new Login Policy, it will be shown on top of the existing entries. The first Login Policy, that matches the filter criteria will be used.

Example 1: Miller logs into VISULOX PORTAL with verbal token


  1. Miller tries to login with his credentials and needs an additional PIN to login:


    The generated PIN is valid for 15 Minutes and Miller has to call supervisor Master to request the PIN for SQ=38751920.



  2. Supervisor Master receives the call from Miller and opens his Cockpit:

    Master selects the session from Miller ("Wait for Token") and the sequence number with the according valid PIN is displayed.

    Master provides the PIN verbally.
    (With the "Copy PIN" button, the user and the sequence number will be copied to clipboard and can also be used in an eMail.)


  3. Now Miller is able to login with his credentials and the PIN (Here: "B5Q-M71").

Example 2: Miller logs into VISULOX PORTAL with PIN provided via eMail


  1. Miller tries to login with his credentials and needs an additional PIN to login.

  2. Miller receives the eMail with his PIN shortly after he has tried to login:

    The default PIN script displays the sequence number in the subject.

    The name of the user, the PIN and how long the PIN is valid is shown in the eMail text.



  3. Now Miller is able to login with his credentials and the PIN.

Example 3: Miller logs into VISULOX PORTAL with token provided via SMS

  1. Miller tries to login with his credentials and needs an additional PIN to login.

  2. Miller receives the SMS with his PIN shortly after he has tried to login.

  3. Now Miller is able to login with his credentials and the PIN.

MFA check list with additional tests

FeatureExpected behaviourComment
Login is allowed
  • User can login with his credentials, without the need of entering an additional MFA PIN

Login allowed with verbal token
  • After first login try, the login mask with PIN field and Sequence number + time is displayed
  • Session is displayed in Cockpit with "Wait for Token"
  • User is able to log in with his credentials and the valid requested PIN
  • User can not log in, if the PIN is no longer valid (timed out)
  • If the wrong or timed out PIN is entered, the correct error message is displayed
  • If the time of the PIN has run out, the session with "Wait for Token" disappears

Login is allowed wiith token provided via eMail
  • After first login try, the login mask with PIN field and Sequence number + time is displayed
  • Session is displayed in Cockpit with "Wait for Token"
  • User receives the eMail with the correct PIN
  • User is able to log in with his credentials and the valid PIN
  • User can not log in, if the PIN is no longer valid (timed out)
  • If the wrong or timed out PIN is entered, the correct error message is displayed
  • If the time of the PIN has run out, the session with "Wait for Token" disappears

Login is allowed with token provided via SMS
  • After first login try, the login mask with PIN field and Sequence number + time is displayed
  • Session is displayed in Cockpit with "Wait for Token"
  • User receives the SMS with the correct PIN
  • User is able to log in with his credentials and the valid PIN
  • User can not log in, if the PIN is no longer valid (timed out)
  • If the wrong or timed out PIN is entered, the correct error message is displayed
  • If the time of the PIN has run out, the session with "Wait for Token" disappears

Login is allowed wiith token provided via eMail and/or SMS
  • After first login try, the login mask with PIN field and Sequence number + time is displayed
  • Session is displayed in Cockpit with "Wait for Token"
  • User receives the SMS with the correct PIN
  • User receives the eMail with the correct PIN
  • User is able to log in with his credentials and the valid PIN
  • User can not log in, if the PIN is no longer valid (timed out)
  • If the wrong or timed out PIN is entered, the correct error message is displayed
  • If the time of the PIN has run out, the session with "Wait for Token" disappears

Login is not allowed
  • After first login try, not allowedmessage is displayed in the login mask

Disabled
  • Login Policy has no effect, the next Policy, that matches will be used

Filter settings
  • User/group mask: all registered users get the PIN login mask
  • Remote IP mask: all users connecting from the registered IP get the PIN login mask
  • Access point mask: all users connecting over the registered access point get the PIN login mask

PIN definition
  • Changing the login text, e.g. "PIN sent via eMail - SQ=%SQ% / %LF%min (%TIME%)"
  • New message is displayed in the login mask correctly
  • Adjusting the MFA Token lifetime

Notification
Events
  • All MFA information is displayed in the Cockpit



JavaScript errors detected

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

If this problem persists, please contact our support.