Skip to main content

MFA Setup

Enable multi-factor authentication (MFA) using a TOTP authenticator app. MFA adds a second layer of security and is required for sensitive operations like managing API keys and gateway tokens.

Key Concepts

What is MFA?

Multi-factor authentication requires two forms of identification: your password (something you know) and a time-based one-time password from an authenticator app (something you have). This protects your account even if your password is compromised.

When MFA is required

Clevername enforces MFA for high-security operations through Supabase's AAL (Authenticator Assurance Level) integration. These operations include:

  • Creating or deleting API keys
  • Creating or revoking gateway tokens
  • Changing account email or password
  • Managing organization SSO or SCIM settings

Supported apps

Any TOTP-compatible authenticator app works with Clevername. Popular options include Google Authenticator, Authy, 1Password, and Microsoft Authenticator.

Step-by-Step Guide
1

Open Security settings

Go to Settings → Security in the dashboard. Find the Multi-Factor Authentication section.

Security settings page showing the MFA section with an Enable MFA button
The Security tab in Settings contains the MFA configuration.
2

Start MFA enrollment

Click Enable MFA. A QR code will appear on screen. You will also see a text-based secret key for manual entry.

MFA enrollment screen showing a QR code and a text secret key below it
Scan the QR code with your authenticator app, or enter the secret key manually.
3

Scan the QR code

Open your authenticator app and scan the QR code. The app will add a Clevername entry and start generating 6-digit codes that refresh every 30 seconds.

Tip
Save the text-based secret key in a secure location (like a password manager). You will need it to re-add the entry if you lose access to your authenticator app.
4

Verify with a code

Enter the current 6-digit code from your authenticator app into the verification field and click Verify. This confirms your app is set up correctly.

5

Confirm MFA is active

Once verified, MFA is active on your account. The Security settings page will show MFA as Enabled. You will be prompted for a TOTP code when performing sensitive operations.

Security settings showing MFA status as Enabled with a Disable MFA button
MFA is now active. You will see a code prompt for sensitive operations.