Resolve and manage MFA errors

Prev Next

Overview

Identify, monitor, and resolve Multi-Factor Authentication (MFA) related issues to restore secure access and maintain business continuity. By effectively managing MFA errors, you can reduce downtime, prevent unauthorized access, and ensure a secure experience.


Who uses this feature

  • Administrators

  • Applies to all business types

  • Applies to all trades

Feature configuration

  • Account configuration is required to use this feature. Please contact Technical Support for details.

View MFA error logs

  1. On the MFA screen, click More .

  2. Select the View MFA error logs option. MFA settings interface showing user details and options for account security configuration.

  3. On the Multi-Factor Authentication Errors window that opens, you can:        

    1. Search for the error log

    2. Filter by date

    3. Filter the type by:                

      1. Account Lock

      2. Cooldown Activated

      3. MFA Provider Failure

      4. Not My Number Multi-Factor Authentication Errors with filter options and no records available message.

Lock employee or technician account

  1. On the Security screen, click More .

  2. Select Lock user AccountUser account management interface showing Multi-Factor Authentication settings and options.

  3. In the confirmation window that opens, click Lock Account to proceed with locking the employee or technician account, or click Cancel to dismiss the action. Confirmation prompt to lock a user account, preventing future logins.

View MFA errors and system messages

Account lock

After multiple failed MFA attempts, the system locks the employee or technician account and displays a message prompting them to contact their administrator.

Notification indicating account is locked, with instructions to contact administrator for help.

Code resend cooldown period

Note: You can reset the 1-hour MFA setup cooldown so you can try again right away.

After five failed verification attempts, employees or technicians receive a cooldown error message and must wait before trying again.

Account cooldown notification after exceeding login attempts, with a prompt to sign in again.

Not my number

If the displayed phone number is incorrect, employees or technicians can click It's not my phone number. The system displays an error message.

Screen displaying phone number verification instructions and a button to proceed.

An error message appears.

Message instructing users to contact their administrator for assistance with an issue.

The account is locked after multiple failed login attempts.

Account locked due to exceeding maximum login attempts. Contact administrator for assistance.

If the session times out, a Session Expired error message is displayed.

Session expired notification prompting user to log in again to continue.

Use recovery codes

You see your recovery codes only when you first log in. Save them in a secure location, as you need one if you lose access to your mobile device.

Note: Recovery codes are shown to users with an Administrator role only. The order of codes is important, and if you don't save them, there's no way to recover them.

1. 670428962800532

2. 6704289626800532

3. 6704289626800532

4. 670428962680532

5. 670428962680532

6. 670428962680532

7. 670428962680532

8. 670428962680532

9. 670428962680532

10. 670428962680532

Troubleshoot MFA errors

During the MFA process, employees or technicians may encounter the following errors:

  • Incorrect phone number: The phone number the employee or technician enters doesn't match the one associated with their account.

  • Account lock: Employee or technician account is temporarily locked due to multiple failed login attempts.

  • Cooldown: The system temporarily blocks additional verification attempts after too many failed MFA submissions.

  • SMS failure: The system is unable to send the verification code by SMS.

  • MFA provider failure: The system was unable to retrieve data from the MFA provider, for example, Twilio, and the request failed with the Error Code: 500

Want to learn more?