VISULOX 4 Documentation

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:

User

Role

eMail

SMS

Application

Master

Supervisor

<supervisor>@company.com

-

VISULOX Cockpit

Miller

User

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

image2021-3-8_15-11-29.png

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:

image2021-3-8_15-13-32.png

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:

image2021-3-8_15-14-42.png

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.

    pin.jpg

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

    pinCockpit.jpg

    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:

    2FAPINMailtoUser.JPG

    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

Feature

Expected behaviour

Comment

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