Add SMS as a second factor

FusionAuth Reactor logo

This feature is only available in paid plans. Please visit our pricing page to learn more.

Available since 1.26.0

Add a Two Factor Method - SMS#

SMS two factor is not enabled by default. Configure your tenant by navigating to Tenants -> Edit Tenant -> Multi-Factor .

Enable MFA method on Tenant (Admin Facing)#

Configure Tenant SMS

You can enable the SMS factor on the tenant level by following these steps:

  • Toggle this Two Factor method by clicking enabled
  • Select a messenger (previously created, see documentation)
  • Select a template (FusionAuth ships with a default to be customized if needed)

Enable SMS Factor from Account Management (User Facing)#

Account Management Index
  1. Navigate back to your account page.
  2. Click Manage two-factor
  3. Click Add two-factor
  4. There will be an option for SMS.
Add Factors Add SMS Authenticator

Next,

  1. Enter your phone number.
  2. Click on Send a one-time-code.
  3. Enter the Verification Code
  4. Click Enable.

Recovery Codes (User Facing)#

Now you will be presented with recovery codes. Save these in a safe space.

Recovery Codes

Success!

Upon the next login, you will be prompted for a code sent by SMS code in addition to your password.

See It in Action (User Facing)#

With SMS MFA enabled, if you log out and log back in you will be presented with the following screen in addition to the typical login screen.

Challenge Account Management