# Multi-factor authentication (MFA)

In Beachside, your organization's admin has enabled MFA. If required, you will set it up during your next login. If MFA is enforced, you must set it up **before accessing Beachside**. Once configured, you'll need a code for **future logins**.

***

## How to set up MFA

<div data-with-frame="true"><figure><img src="/files/0LKb0IM7ja5GMHT8YuaT" alt=""><figcaption></figcaption></figure></div>

You will use an authenticator app on your phone (like Google Authenticator, Microsoft Authenticator, or 1Password).

{% stepper %}
{% step %}

#### Log in to Beachside

Enter your ***Email*** and ***Password*** to access Beachside.
{% endstep %}

{% step %}

#### Open your authenticator app

On your phone, open an authenticator app (for example: Google Authenticator, Microsoft Authenticator, or 1Password).
{% endstep %}

{% step %}

#### Add a new account in the app

In the authenticator app, tap <kbd><mark style="color:$primary;">**Add account**<mark style="color:$primary;"></kbd> (or the + button).
{% endstep %}

{% step %}

#### Scan the QR code

In your authenticator app, choose <kbd><mark style="color:$primary;">**Scan a QR code**<mark style="color:$primary;"></kbd>, then scan the code shown in Beachside.
{% endstep %}

{% step %}

#### Enter the 6-digit code

Your authenticator app will show a **6-digit code**. Type that code into Beachside to finish setup.
{% endstep %}

{% step %}

#### Copy or download your recovery codes (recommended)

Recovery codes are one-time backup codes you can use to sign in if you cannot access your authenticator app. Click <kbd><mark style="color:$primary;">**Copy**<mark style="color:$primary;"></kbd> or <kbd><mark style="color:$primary;">**Download**<mark style="color:$primary;"></kbd> to save them somewhere safe.
{% endstep %}

{% step %}

#### Confirm you saved your recovery codes

Check <kbd><mark style="color:$primary;">**I have safely saved these codes**<mark style="color:$primary;"></kbd> to continue.
{% endstep %}

{% step %}

#### Continue to Beachside

Click <kbd><mark style="color:$primary;">**Continue to Beachside**<mark style="color:$primary;"></kbd>.
{% endstep %}
{% endstepper %}

***

## How to log in with MFA

<div data-with-frame="true"><figure><img src="/files/KN1TiPVAbs496jq2etM1" alt=""><figcaption></figcaption></figure></div>

{% stepper %}
{% step %}

#### Log in to Beachside

Enter your ***Email*** and ***Password*** to access Beachside.
{% endstep %}

{% step %}

#### Enter the code from your authenticator app

Open your authenticator app and enter the 6-digit code you see.
{% endstep %}
{% endstepper %}

### Need help? Ask your organization admin to reset MFA

If you no longer have access to your authenticator app and you can’t use a recovery code, contact your organization admin. An admin can reset MFA for your account so you can set it up again on your next login.<br>

***

## FAQ

<details>

<summary><strong>Why am I being asked to set this up?</strong></summary>

Your organization has turned on MFA. When it is required, everyone in the organization needs to set it up.

</details>

<details>

<summary><strong>I can’t scan the QR code. What can I do?</strong></summary>

If you cannot scan the QR code (for example, your camera is not working or you are setting it up on the same phone):

* Select the option <kbd><mark style="color:$primary;">**Can’t scan?**<mark style="color:$primary;"></kbd> on the Beachside screen.
* Copy the **setup key** shown there.
* In your authenticator app, choose **Enter a setup key** (or **Manual entry**) and paste or type the key.
* Then enter the **code** from the authenticator app to finish setup.

</details>

<details>

<summary><strong>What if I changed phones or lost my authenticator app?</strong></summary>

Use a recovery code to sign in. If you do not have recovery codes, contact your organization admin for help.

</details>

<details>

<summary><strong>My code is not working. What should I do?</strong></summary>

* Try the newest code (it changes every few seconds).
* Make sure your phone’s time is set automatically.

</details>

<details>

<summary><strong>I used a recovery code, and it does not work again.</strong></summary>

That is expected. Recovery codes are one-time use. Use another recovery code.

</details>

<details>

<summary><strong>I’m blocked after entering the wrong code a few times. What happened?</strong></summary>

For security, Beachside locks your login session after 3 incorrect MFA attempts.

* Restart the login flow and try again with the newest code from your authenticator app.
* If you can’t access your authenticator app, select Use a recovery code.
* If you don’t have recovery codes, contact your organization admin to reset MFA.

</details>

<details>

<summary><strong>Can someone reset MFA for me?</strong></summary>

Not at the moment. Contact your organization admin if you need help.

</details>

<details>

<summary><strong>Can I turn off MFA?</strong></summary>

If your organization requires MFA, you cannot turn it off yourself. Contact your organization admin if you need help.

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.theseaai.com/others/mfa.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.