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

# Two-Factor Authentication

> Set up an authenticator app, save backup codes, and manage two-factor authentication for an Adriel account.

Two-factor authentication (2FA) adds a verification step after the primary sign-in method. 2FA is configured for each Adriel account and affects only the account that enables it. Other workspace members manage their 2FA settings independently. Once enabled, signing in requires either a six-digit code from an authenticator app or a one-time backup code.

## Before setting up 2FA

Prepare the following before starting:

* A TOTP-compatible authenticator app, such as Google Authenticator or Microsoft Authenticator.
* A secure place to store the backup codes. Each backup code can be used only once.

## Set up 2FA

**1. Open account settings**

Open **Settings**, then select the **Account** tab.

**2. Start the setup**

Under **Security Settings**, find **Two factor authentication** and click **Enable**.

**3. Connect an authenticator app**

Scan the QR code with Google Authenticator, Microsoft Authenticator, or another TOTP-compatible app. To enter the setup key instead, use the **Manual entry key** shown below the QR code.

**4. Verify the connection**

Click **Verify**, enter the current six-digit code from the authenticator app, then click **Verify** again.

**5. Save the backup codes**

Click **Copy all** and store all 10 backup codes in a secure location. The codes are shown only during this step and cannot be viewed again. Click **Done** after saving them.

**6. Sign in again**

Sign in again when prompted. Enabling 2FA ends active sessions on all devices and browsers.

> [!WARNING]
>
> 2FA becomes active as soon as the authenticator code is verified, even if the setup is closed before the backup codes are saved. Backup codes cannot be viewed again after leaving this step.

## Sign in with 2FA

After completing the primary sign-in method, enter the current six-digit code from the authenticator app on the **Verify it's you** screen.

To use a backup code instead, click **Sign in with a backup code**. Backup codes are not case-sensitive, spaces are ignored, and each code stops working after one successful use.

The verification session expires after five minutes. Repeated incorrect codes or an expired session return to the sign-in screen.

## Manage backup codes

The **Two factor authentication** section shows how many valid backup codes remain.

To replace the codes:

**1. Start regeneration**

Open **Settings** → **Account**, then click **Regenerate** under **Backup codes**.

**2. Confirm regeneration**

Review the confirmation message and click **Regenerate**. Enter the current six-digit code from the authenticator app when prompted.

**3. Save the new codes**

Click **Copy all** and store the 10 new backup codes securely. All previous backup codes stop working as soon as the new codes are generated. Current sessions remain active.

## Turn off 2FA

**1. Start deactivation**

Open **Settings** → **Account**, then click **Disable** next to **Two factor authentication**.

**2. Continue deactivation**

Review the confirmation message and click **Send code to turn off two-factor authentication**.

**3. Confirm with a code**

Enter the current six-digit code from the authenticator app, then click **Turn off two-factor authentication**.

**4. Sign in again**

Sign in again when prompted. Turning off 2FA disconnects the authenticator app, deletes all backup codes, and ends active sessions on all devices and browsers.

## Troubleshooting

> [accordion] The setup expired before verification
>
> Adriel provides a new QR code when the setup session expires. Delete the previous Adriel entry from the authenticator app, scan the new QR code, and complete verification again.

> [accordion] The verification code is incorrect
>
> Enter the current code shown in the authenticator app. If the setup was restarted, remove the previous Adriel entry and scan the latest QR code before trying again.

> [accordion] Too many verification attempts were made
>
> Close the setup window and retry after the wait period shown in the error message. If the sign-in challenge ended, start again from the sign-in screen.

> [accordion] The authenticator app is unavailable
>
> Click **Sign in with a backup code** and enter an unused backup code. To connect a new authenticator app, contact [support@adriel.com](mailto:support@adriel.com) to reset 2FA. A reset is also required when no valid backup code remains.

> [accordion] All backup codes have been used
>
> If the account is still signed in, open **Settings** → **Account** and regenerate the backup codes. If the account is signed out and the authenticator app is unavailable, contact [support@adriel.com](mailto:support@adriel.com).

> [accordion] Clicking the email address under Contact us opens a blank page
>
> The email link under **Contact us** may open a blank page (`about:blank`) if no **default mail app** or browser email handler is configured. Copy the displayed address into a new message in a mail app or webmail service, or configure an email handler to open the link directly.

## Related

> [card] [Managing members](https://docs.adriel.com/workspace-and-access/managing-members.md)
>
> Invite members, assign roles, and organize workspace access.

> [card] [Deactivate my account](https://docs.adriel.com/workspace-and-access/deactivate-account.md)
>
> Close an Adriel account while preserving workspace data.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.