Skip to main content
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
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
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.
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
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.
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
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
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
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
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

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.
No. Only the signed-in user can remove 2FA from their own account. Nothing in workspace member management changes another user’s 2FA.
Yes. If 2FA is on, you’re asked for a code after signing in with Google, the same as with email and password.
No. The only method is an authenticator app (TOTP). Use any app that supports TOTP, such as Google Authenticator, 1Password, or Authy.
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.
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.

Manage

Workspace roles, owners, and members.

HIPAA compliance

Safeguards and responsibilities on HIPAA workspaces.