Add MFA based on user group

You can enable a more secure login flow for users that belong to specific groups by applying the Group-Based conditional authentication template for Adaptive MFA. This template enables two-factor authentication with TOTP for users who belong to the user groups you specify.

Scenario

Consider a scenario with two user groups, manager and employee. For users assigned to these groups, the login flow in applications should be stepped up with TOTP as follows:

1. Username and password
2. TOTP

Prerequisites

• You need to register an application with Asgardeo. You can register your own application or use one of the sample applications provided.

• Create two user groups named manager and employee and assign user accounts to them. For instructions, see the following:

  • Managing groups
  • Managing users

Configure the login flow

To enable conditional authentication:

1. On the Asgardeo Console, click Applications.

2. Select the relevant application and go to it's Login Flow tab.

3. Add group-based adaptive MFA using your preferred editor:

   Using the Classic Editor

   To add group-based adaptive MFA using the classic editor:

   1. Click Start with default configuration to define the login flow starting with the username and password login.

   2. Turn on Conditional Authentication by switching the toggle on.

   3. Select the Adaptive MFA > Group-Based template.

   Using the Visual Editor

   To add group-based adaptive MFA using the visual editor:

   1. Switch to the Visual Editor tab, and expand Predefined Flows > Conditional Login Flows > Adaptive MFA.

   2. Click + ADD next to Group-Based to add the group-based adaptive MFA script.

   3. Click Confirm to replace any existing script with the selected predefined script.

   Important

   As a security measure, Asgardeo does not allow the usage of two consecutive periods (..) in authentication scripts.

4. Verify that the login flow is now updated with the following two authentication steps:

   • Step 1: Username and Password
   • Step 2: TOTP

5. Update the following parameter in the script.

   Parameter	Description
   groupsToStepUp	Comma separated list of user groups. Two-factor authentication should apply to users from these groups. For this example scenario, enter manager and employee.

6. Click Update to confirm.

How it works

Shown below is the script of the group-based conditional authentication template.

var groupsToStepUp = ['manager', 'employee'];

var onLoginRequest = function (context) {
   executeStep(1, {
      onSuccess: function (context) {
            // Extracting authenticated subject from the first step.
            var user = context.currentKnownSubject;
            // Checking if the user is assigned to one of the given groups.
            var isMember = isMemberOfAnyOfGroups(user, groupsToStepUp);
            if (isMember) {
               Log.info(user.username + ' is a member of one of the groups: ' + groupsToStepUp.toString());
               executeStep(2);
            }
      }
   });
};

Let's look at how this script works.

1. When step 1 of the authentication flow is complete, the onLoginRequest function retrieves the user from the context.
2. The user and the configured list of groups are passed to the following function: isMemberOfAnyOfGroups.
3. This function (which is available in Asgardeo by default) verifies whether the given user belongs to any of the listed groups.
4. If the user belongs to any of the configured groups, authentication step 2 (TOTP) is prompted.

Find out more about the scripting language in the Conditional Authentication API Reference.

Try it out

Follow the steps given below.

1. Access the application URL.
2. Try to log in with a user who does not belong to any of the configured groups (manager or employee). You will successfully sign in to the application.
3. Log out of the application.
4. Log in with a user who belongs to the manager or employee group or both. TOTP authentication is prompted.