Add SMS as a second factor

    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

    Feedback

    How helpful was this page?

    See a problem?

    File an issue in our docs repo

    Have a question or comment to share?

    Visit the FusionAuth community forum.