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

# Set up two-factor authentication (2FA) in Chatbase

> Secure your Chatbase account with an authenticator app and one-time recovery codes.

Chatbase two-factor authentication (2FA) adds a second step when you sign in or change sensitive account settings, so your account stays protected even if someone knows your password. Each user turns it on for their own account from **Account settings**, using an authenticator app. It protects every workspace you belong to, whether you sign in with email and password or with Google.

With 2FA enabled in Chatbase, you:

* Sign in with your email and password, or with Google
* Then confirm using:
  * A 6-digit code from an authenticator app (TOTP), or
  * A one-time recovery code as backup

> [!TIP]
>
> We strongly recommend that every member of your workspace enables 2FA.

## How 2FA works in Chatbase

* **Per user, not per workspace.** 2FA is set on your personal account. There's no workspace setting that requires 2FA for all members, so each member turns it on themselves.
* **Owners can't reset it for others.** Nothing in member management changes another user's 2FA. Only you can remove 2FA from your own account.
* **Authenticator app only.** The only method is **Authenticator App** (TOTP), for example Google Authenticator, 1Password, or Authy. SMS codes and passkeys aren't supported.
* **Applies to every sign-in method.** If 2FA is on, you're asked for a code after signing in with Google too.

## Enable 2FA for your account

**1. Open your account security settings**

1. Sign in to the Chatbase dashboard.
2. Click your avatar at the bottom-left of the sidebar.
3. Select **Account settings** and open the **Two step verification** section.

![Account settings page showing the Two step verification section in Chatbase](https://mintcdn.com/chatbase/Sf2A7dWoAAJE_0w4/user-guides/workspace/images/two-factor-auth/2fa-settings.png?fit=max\&auto=format\&n=Sf2A7dWoAAJE_0w4\&q=85\&s=eaab56c60957b5871f688acddefbce8a)

**2. Scan the QR code with your authenticator app**

1. Select **Set up two-step verification**.
2. Open your authenticator app (for example, Google Authenticator, 1Password, or Authy).
3. Scan the QR code shown in Chatbase.

> [!WARNING]
>
> Anyone with access to this QR code or secret can generate valid 2FA codes for your account. Do not share it or store screenshots in insecure places.

![Two-factor authentication setup dialog in Chatbase showing the QR code and secret key](https://mintcdn.com/chatbase/dHVzvEBYwztIJakH/user-guides/workspace/images/two-factor-auth/totp-setup.png?fit=max\&auto=format\&n=dHVzvEBYwztIJakH\&q=85\&s=2bd1696bbf0222535e9c17baa83ca25d)

**3. Confirm with a 6-digit code**

1. In Chatbase, enter the 6-digit code from your authenticator app.
2. Select **Confirm** to finish setup.

> [!TIP]
>
> After confirmation, you'll be prompted for a 2FA code the next time you sign in.

**4. Save your recovery codes**

When setup succeeds, the **Manage recovery codes** dialog opens and generates your first set of recovery codes automatically. Copy or download them before closing the dialog.

## Recovery codes

Recovery codes let you sign in when you don't have access to your authenticator app (for example, if you lost your phone).

Key rules:

* You get **8 codes**, each **8 characters** long
* You see recovery codes **only once** when you generate them
* Each code is **single-use** ("Warning: Recovery codes are one-time use only")
* Generating a new set of codes **invalidates all previous codes**

> [!WARNING]
>
> Treat recovery codes like physical keys. Store them in a secure password manager or print them and keep them in a safe place.

### Generate and download recovery codes

1. In the Chatbase dashboard, go to **Account settings > Two step verification**.
2. Open **Manage recovery codes**.
3. Select **Generate codes**.
4. Copy or download the codes and store them securely.

![Manage recovery codes dialog in Chatbase showing a list of one-time backup codes with copy and download options](https://mintcdn.com/chatbase/Sf2A7dWoAAJE_0w4/user-guides/workspace/images/two-factor-auth/recovery-codes.png?fit=max\&auto=format\&n=Sf2A7dWoAAJE_0w4\&q=85\&s=cb0f9449fc037ec0fde0c0b54b3f0a2b)

If you close the recovery codes dialog without saving, you will need to generate a new set. Old codes are invalidated when you regenerate.

## Sign in with 2FA

When 2FA is enabled, the sign-in flow looks like this:

1. Enter your email and password as usual, or sign in with Google.
2. If your account requires 2FA, Chatbase redirects you to a **Two-factor authentication** page.
3. On this page you can:
   * Enter a 6-digit code from your authenticator app, or
   * Select **Use a recovery code** and enter one of your single-use codes.

If the code is valid, you're redirected back to the page you were trying to access.

![Two-factor authentication challenge page in Chatbase with fields for authenticator code and a link to use a recovery code](https://mintcdn.com/chatbase/Sf2A7dWoAAJE_0w4/user-guides/workspace/images/two-factor-auth/challenge-page.png?fit=max\&auto=format\&n=Sf2A7dWoAAJE_0w4\&q=85\&s=d2ba25cba89f63d3c5e3d1e1ce951579)

> [!NOTE]
>
> If you close or navigate away from the 2FA challenge page without completing it, Chatbase signs you out to protect your session.

## Change email or 2FA settings

With 2FA on, Chatbase asks for a code before these actions:

* Signing in
* Approving access for an app that connects to Chatbase (OAuth or MCP)
* Changing your account email
* Changing your password
* Managing or regenerating recovery codes
* Removing 2FA from your account

You can confirm every one of these with either:

* A 6-digit authenticator code, or
* A recovery code

> [!WARNING]
>
> If you remove 2FA, your account will fall back to password-only protection. Do this only if you have a strong, unique password and understand the risk.

## Frequently asked questions

> [accordion] Can a workspace Owner require 2FA for all members?
>
> No. 2FA is a personal account setting, and there's no workspace setting that makes it mandatory. Ask each member to turn it on from **Account settings > Two step verification**.

> [accordion] Can an Owner reset a member's 2FA?
>
> No. Only the signed-in user can remove 2FA from their own account. Nothing in workspace member management changes another user's 2FA.

> [accordion] Does 2FA work with Google sign-in?
>
> Yes. If 2FA is on, you're asked for a code after signing in with Google, the same as with email and password.

> [accordion] Does Chatbase support SMS codes or passkeys for 2FA?
>
> No. The only method is an authenticator app (TOTP). Use any app that supports TOTP, such as Google Authenticator, 1Password, or Authy.

> [accordion] How many recovery codes do I get?
>
> 8 codes of 8 characters each. They're generated automatically when you finish setup. Each works once, and generating a new set replaces all old codes.

> [accordion] Does 2FA affect my API keys?
>
> API requests are authenticated with your API key rather than a signed-in session, so turning on 2FA shouldn't change how existing API integrations work.

## Related

> [card] [Manage](https://chatbase.co/docs/user-guides/workspace/manage.md)
>
> Workspace roles, owners, and members.

> [card] [HIPAA compliance](https://chatbase.co/docs/user-guides/workspace/hipaa-compliance.md)
>
> Safeguards and responsibilities on HIPAA workspaces.


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