> ## Documentation Index
> Fetch the complete documentation index at: https://help.draftable.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MFA configuration

> Multi Factor Authentication (MFA) is a security method that is used to grant instance access to users only after they provide two sets of login credentials. The first is the user's password and the second is a code generated by an authentication app.

<Warning>
  **This documentation is for API Self-Hosted Version 2 (Legacy)**

  Version 2 is a legacy deployment model. All new customers **must** use Version 3, which features a modern multi-container architecture with improved security and performance.

  👉 [Get started with API Self-Hosted v3](/hc/en-us/articles/51133475373465-API-Self-Hosted-v3-Quick-Start-Guide)
</Warning>

If you wish to use MFA, users will be required to use an authentication app on their mobile devices.

## Setting up MFA for all users 

As an administrator account, navigate to the **Users** tab and see the User Security window in the bottom left. You can click on **enable** to immediately require all users to use MFA to login with their account. 

<Frame>
  <img src="https://mintcdn.com/draftable/XirHSA4IUskuCT0o/images/draftable-api-self-hosted/image-94.png?fit=max&auto=format&n=XirHSA4IUskuCT0o&q=85&s=400906332e815f70010e3da718b41bd5" alt="" width="1095" height="654" data-path="images/draftable-api-self-hosted/image-94.png" />
</Frame>

To setup the MFA once enabled by the administrator, ensure your users (including yourself) log out of the instance, and attempt to log back in. 

<Frame>
  <img src="https://mintcdn.com/draftable/XirHSA4IUskuCT0o/images/draftable-api-self-hosted/image-95.png?fit=max&auto=format&n=XirHSA4IUskuCT0o&q=85&s=7cc59c4f6bfc594f263524943df6140b" alt="" width="299" height="178" data-path="images/draftable-api-self-hosted/image-95.png" />
</Frame>

Once you have provided your username and password, you will be presented with the initial setup for the MFA. Click **Set up using an app,** and using your mobile device scan the QR code that will be presented. 

<Frame>
  <img src="https://mintcdn.com/draftable/XirHSA4IUskuCT0o/images/draftable-api-self-hosted/image-96.png?fit=max&auto=format&n=XirHSA4IUskuCT0o&q=85&s=2a07a2cb155ce6550e08e443630120df" alt="" width="461" height="462" data-path="images/draftable-api-self-hosted/image-96.png" />
</Frame>

Once complete enter the requested passcode from the authenticator app.

<Frame>
  <img src="https://mintcdn.com/draftable/XirHSA4IUskuCT0o/images/draftable-api-self-hosted/image-97.png?fit=max&auto=format&n=XirHSA4IUskuCT0o&q=85&s=57e0d2b0ed9144c6605dc9d3e6d6fbcc" alt="" width="453" height="273" data-path="images/draftable-api-self-hosted/image-97.png" />
</Frame>

Upon initial setup, users will also be provided with recovery codes in a situation where they have lost their mobile device or are unable to provide a passcode. 

<Frame>
  <img src="https://mintcdn.com/draftable/XirHSA4IUskuCT0o/images/draftable-api-self-hosted/image-98.png?fit=max&auto=format&n=XirHSA4IUskuCT0o&q=85&s=1ad140edc916fb1fdac70dcfc1927827" alt="" width="683" height="242" data-path="images/draftable-api-self-hosted/image-98.png" />
</Frame>

## Removing MFA for users 

You can remove MFA from all users by returning to the **users** page within the **admin** section, and by clicking **disable** in the User Security window. This will immediately remove MFA requirements for login, for all user accounts. 

<Frame>
  <img src="https://mintcdn.com/draftable/XirHSA4IUskuCT0o/images/draftable-api-self-hosted/image-99.png?fit=max&auto=format&n=XirHSA4IUskuCT0o&q=85&s=1ea1af2b24ec94c525932f2735e951a0" alt="" width="340" height="178" data-path="images/draftable-api-self-hosted/image-99.png" />
</Frame>

If you wanted to reset an MFA login for a specific user, without having to disable MFA completely, the administrator can delete an MFA method for a specific user, which will force them to complete a new MFA setup the next time they log in. 

<Frame>
  <img src="https://mintcdn.com/draftable/xiYLgQoBwoYUCU65/images/draftable-api-self-hosted/image-100.png?fit=max&auto=format&n=xiYLgQoBwoYUCU65&q=85&s=9ea8834e49e894321239ddac523125e9" alt="" width="768" height="589" data-path="images/draftable-api-self-hosted/image-100.png" />
</Frame>
