Two-Factor Authentication
Enable 2FA on your personal account, enforce it for your organization, or configure it system-wide for all users.
Two-Factor Authentication
Two-factor authentication (2FA) adds a second verification step to login. After entering a password, users must confirm a one-time code before gaining access. There are three levels where 2FA can be configured:
| Level | Where | Who controls it |
|---|---|---|
| User | Your profile → Auth | Each user for their own account |
| Organization | Organization settings → Two Factor | Organization admins for their org's users |
| System-wide | Admin → 2FA Config | Instance admins for all organizations |
User-Level 2FA
Individual users can enable 2FA on their own account. The 2FA settings section is only visible when the instance admin has enabled 2FA system-wide.
Open Your Profile
Click your avatar in the top-right corner of the console and select Your profile. This opens your personal profile and account settings.
Choose a Method
Select how you want to receive your one-time codes:
| Method | Description |
|---|---|
| A code is sent to your registered email address at login | |
| SMS | A code is sent to your registered phone number — requires Twilio to be configured on the instance |
Enable and Save
Toggle 2FA on and click Save 2FA Settings. From your next login, you'll be prompted for a code after entering your password.
Logging In with 2FA Enabled
- Enter your email and password as usual
- A one-time code is dispatched to your email or phone
- Enter the code to complete sign-in
Codes expire after a short window. If you don't receive a code, check your spam folder (for email) or confirm your phone number is on your profile (for SMS), then request a new code.
Disabling User-Level 2FA
Return to Your profile → Auth and toggle 2FA off. You will not be prompted for a code on future logins unless your organization or the system enforces it.
Organization-Level 2FA
Organization administrators can require all users within their organization to set up 2FA. Navigate to Organization settings → Two Factor to configure this.
| Setting | Description |
|---|---|
| Enable Two-Factor Authentication | Makes 2FA available as an option for users in this organization |
| Require Users to Set-Up 2FA | Forces all users in the organization to configure 2FA on their next login — they cannot access the console until setup is complete |
Click Save 2FA Settings to apply. The enforcement toggle only appears when 2FA is enabled.
System-Wide 2FA
Instance administrators can enable and enforce 2FA across the entire Fleetbase instance — for all users in all organizations. This is configured from Admin → 2FA Config.
See System Setup → Two-Factor Authentication for details.