Skip to content

MFA Setup

This guide explains how users of Web3 apps integrated with the Arcana Auth SDK can boost wallet security by setting up Multi-Factor Authentication (MFA).

Enabling MFA at Login

Log in to the app integrated with the Arcana Auth SDK using one of the available authentication mechanisms. At the very first login, user is prompted to set up enhanced wallet security by configuring two-factor authentication:

MFA first login setup prompt
MFA Setup

Click Proceed to set up MFA.

Cannot disable MFA later

Once configured, MFA cannot be disabled for the user's wallet account.

The user must provide answers to five security questions and create a recovery PIN as part of the MFA setup.

Security Questions

You can use the security questions already listed in the drop-down list or create custom questions by clicking in the question field and editing them.

MFA qa setup
Security Questions

Recovery PIN

The MFA setup also requires the user to provide a 6-digit alphanumeric PIN which is an additional recovery method for the user.


That is all!

Users can easily configure MFA to enable enhanced wallet security.

MFA Enabled!
MFA Enabled!

Save your Security Answers

When logging in from a new device, MFA will require you to either answer three security questions correctly or provide the PIN. Make sure you save the responses to the security questions and the PIN carefully.

Enabling MFA Later

If the user chooses to not enable MFA at the first login into the app, it can be enabled later. Note that once enabled, MFA cannot be disabled for a user account.

To enable MFA, log into the app integrated with the Arcana Auth SDK. Access the Arcana wallet UI and click on the 'Profile' tab. Select Setup Now under the 'Enhanced Wallet Security' section. Choose Proceed to set up security questions, and answers and specify the recovery PIN as described in the previous section.

Setup MFA via Profile Tab
Setup MFA via Profile Tab

MFA Recovery

The MFA feature secures your wallet by encrypting and saving an authentication factor on your device and browser. If you log into the app using a different device or browser, you'll need to regenerate this local MFA component. This is essential to confirm your identity for wallet access.

When logging in on a new device or browser, the MFA prompt will help you recover the encrypted MFA component. You can do this in two ways:

  • Enter the MFA recovery PIN you set up during MFA setup.
  • Answer three security questions correctly.
Recovery Options
MFA Recovery

Once the user provides one of these options, the local MFA factor is regenerated and the user will not be asked for it again on the same device or the browser app unless local storage is cleared for some reason.

MFA Errors

MFA Phase Error Message Cause Corrective Action
MFA Setup Share expired. Please log in again to continue. If a user logs into the app and chooses to enable MFA, but fails to complete the MFA setup within 24 hours of login initiation, you will see this error. This error can be resolved by making sure that once initiated, the user completes the MFA setup a few minutes before the session expires.
MFA Setup Security questionnaire errors. These errors are displayed when the user is setting up MFA and specifying the security questions and answers. User must answer all the required questions, each question should be unique and not repeated, an empty string is not allowed for a security question.
MFA Setup PIN validation errors. These errors are displayed when the user is setting up the MFA PIN with invalid characters. Make sure that a 6-digit alphanumeric PIN is provided during MFA setup. The PIN cannot have a space character and should have a minimum of 6 characters and a maximum of 25 characters.
MFA Recovery Incorrect security answer. This error is displayed during MFA secret recovery process if the user fails to provide the correct answer to any of the three security questions. Provide the correct answer or choose a different question for which you remember the answer. Alternatively, try using the correct PIN for completing the MFA secret recovery process.
MFA Recovery Incorrect PIN. During MFA recovery, if the user chooses to use the PIN and enters an incorrect PIN, this error is displayed. Use the correct PIN or try an alternative method of MFA recovery by answering the security questions correctly.
MFA Recovery Computed address did not match the actual address This error occurs when the address computed on the user's local device does not match the one that is decrypted locally after retrieving it from the Arcana encrypted store. It can happen when somehow the local address component is tampered with or corrupted. Simply clearing the app's local storage in the browser should allow the user to verify their identity via MFA and use the app.

Last update: April 12, 2024 by shaloo, shaloo