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:
Click Proceed to set up MFA.
Cannot disable MFA later
Once configured, MFA cannot be disabled for a user wallet account.
User must provide answers to five security questions and create a recovery PIN as part of 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.
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.
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 chose 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.
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.
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. |