Two-factor authentication (also called multi-factor authentication, or MFA) adds a second check when people sign in to Warrant. When an admin turns it on, a correct password is no longer enough on its own: everyone also enters a 6-digit code from an authenticator app on their phone, such as Google Authenticator, Microsoft Authenticator, 1Password or Authy. This article covers how admins turn it on and what everyone else sees at sign-in.
Turn on two-factor authentication (admins)
The setting applies to everyone in your organization at once.
Click Settings at the foot of the workspace sidebar.
Under Members, select Access & security.
In the Sign-in card, switch on Multi-factor authentication (MFA).
You will see a confirmation that MFA is enabled for your organization. To turn it off again, switch it off in the same place. Companies that leave the setting off see no change at sign-in.
Tip: in Settings, you can also type mfa or 2fa into the search box to jump straight to this switch.
Before you switch it on, let your team know they will need an authenticator app on their phone the next time they sign in.
What your team sees at sign-in
The first time: set up your authenticator app
The next time each person signs in after MFA is turned on, Warrant asks them to set up an authenticator app before letting them in:
Sign in as usual with your email and password, or with Continue with Google or Continue with Microsoft.
You see Set up two-step verification. with a QR code.
Open your authenticator app, add a new account, and scan the QR code. The account appears in your app as Warrant OS with your email address. If you can't scan, click Can't scan? Enter the key manually and type the key into your app instead.
Enter the 6-digit code your app shows, then click Verify and sign in.
You're signed in, and your authenticator app is now linked to your Warrant account.
Every sign-in after that
After you sign in, the sign-in page asks for a code. Open your authenticator app, enter the current 6-digit code for Warrant OS, and continue.
Single sign-on, Google and Microsoft sign-in
Enterprise single sign-on (SSO): people who sign in through your company's identity provider, such as Okta or Microsoft Entra ID, aren't asked for a Warrant code, because your identity provider handles the second check. See Enterprise Single Sign-On (SSO).
Google and Microsoft sign-ins are not exempt. If your company requires MFA, people who use Continue with Google or Continue with Microsoft set up an authenticator app too.
Already require MFA in Google Workspace or Microsoft Entra ID? The Sign-in card suggests leaving Warrant's MFA off in that case, otherwise people who use Continue with Google or Continue with Microsoft are asked for a second check twice.
Troubleshooting
"That code didn't match." Codes change every 30 seconds. Enter the code currently showing in your app. If it still fails, check that the date and time on your phone are set automatically.
"Too many incorrect codes" or "That sign-in has expired." Setup must be finished within 15 minutes, and after five wrong codes it starts over. Click Back to login and sign in again to get a fresh QR code.
You got a new phone or lost your authenticator app. There is no way to reset your authenticator app yourself. Ask your Warrant admin to contact [email protected], and Warrant will reset it so you can set it up again at your next sign-in.
You forgot your password. Use Reset password on the sign-in page. See How to Reset Password.
Admins: the switch shows "Failed to update MFA setting". Contact [email protected] and we will help you turn it on.
Who can use it
Only admins can see and change the Multi-factor authentication (MFA) switch. Once it is on, it applies to every member of the organization.
For other sign-in protections, see Anomalous Login Detection.