Search Results :

×

Configure Kentico 2FA Using OTP Over SMS

Kentico Two-Factor Authentication (2FA) adds an extra layer of security to your Kentico application login by enabling OTP verification over SMS. After users enter the correct username and password, they receive a time-sensitive one-time passcode (OTP) on their registered mobile number. OTP over SMS is a reliable second-factor method that helps protect user accounts against phishing, brute-force attacks, and unauthorized access. The plugin also supports methods such as Google Authenticator, Microsoft Authenticator, and OTP over Email.

  • Download the Kentico Two-Factor Authentication (2FA) plugin.
  • Add the following module in your web.config file under the <modules> section.
 <add name="miniOrangeKenticoMFAModule"
    type="miniOrange.Kentico.MFA.HttpModules.miniOrangeKenticoMFAModule, miniOrange.Kentico.MFA"
    preCondition="managedHandler" />
  • After adding the module, open your browser and browse the plugin dashboard with the URL below:
 https://<kentico-base-url>/CMSPages/logon.aspx?mfaaction=config
  • Select the required connection string from the dropdown and click on the Save and Test Connection buttons to configure the database connection for the miniOrange Kentico MFA plugin.
  • After saving and testing the connection, click the Continue button to proceed.
Kentico MFA - Save and test connection, then Continue

Step-by-step guide for implementing Two-Factor Authentication (2FA) in Kentico using OTP over SMS.

  • After successful database configuration, the registration page or login page will appear as shown below.
Kentico MFA - Register with miniOrange

  • Register with your account by clicking the Register button to configure the Kentico MFA plugin.
  • After successful registration, you will receive a trial license key on your registered email address.
  • To activate the plugin, you can either:

    • Enter the license key received via email in the provided input field.

    OR

    • Go to the Upload License File tab and upload the license file that you downloaded using the Download License Key button by using the Choose File option.
Kentico MFA - Activate License

Kentico MFA - Upload License File

  • Then, click the Activate License button.
Kentico MFA - Enter and Activate License

  • After successful license activation, the plugin dashboard will open as shown below.
Kentico MFA - Plugin Dashboard
  • On the plugin dashboard, navigate to the OTP via SMS tab and click the Configure button below the OTP over SMS method.
Kentico MFA - Configure OTP over SMS

  • Enter the phone number with country code and click the Get OTP button.
Kentico MFA - OTP over SMS Get OTP

  • After clicking the Get OTP button, the user will receive a One Time Passcode on the entered mobile number. Enter the received OTP.
  • Click the Verify OTP button. After verifying the OTP, the method will be configured and can be enabled for the end user.
Kentico MFA - Verify OTP

  • To enable the method for the end user, click on the OTP over SMS toggle button.
Kentico MFA - OTP over SMS configured and active

  • Enable the Enable 2FA for End-Users toggle button.
Kentico MFA - Enable 2FA for End-Users

  • To enable 2FA for administrators, turn on the Enable 2FA for Administrators toggle.
Kentico MFA - Enable 2FA for Administrators
  • Log in to your Kentico application.
Kentico MFA - Kentico login page

  • After login, end users see the Setup 2FA methods list.
  • Click Setup beside OTP Over SMS.
Kentico MFA - End user setup OTP over SMS

  • Enter the phone number with country code and click the Get OTP button.
Kentico MFA - End user Get OTP over SMS

  • Enter the OTP sent to your phone number and click Verify OTP.
Kentico MFA - End user verify OTP over SMS

Note: These configuration steps are a one-time setup for configuring the TFA method for the user. The next time the user logs in, they will only see the Verify OTP screen (the last step below) to complete authentication.


  • On the next login, enter the OTP and click Verify OTP.
Kentico MFA - Verify OTP on login

  • The user will be logged in to their Kentico application.

 Thank you for your response. We will get back to you soon.

Something went wrong. Please submit your query again

We'll Reach Out to You at the Earliest!


ADFS_sso ×
Hello there!

Need Help? We are right here!

support