Enterprise single sign-on (SSO) lets your people sign in to Warrant with your company's identity provider, Okta or Microsoft Entra ID, instead of a separate Warrant password. This article is for admins and IT teams setting it up, and for anyone who wants to know what sign-in looks like afterwards.
How setup works
SSO is not switched on from Warrant Settings. Warrant starts the setup for you, and your IT contact finishes it in a guided setup portal provided by WorkOS, Warrant's identity partner.
Contact your Warrant account manager or Warrant support and tell us who your IT contact is.
Warrant emails your IT contact a secure setup link. They do not need a Warrant account to use it.
Your IT contact opens the link, which shows a Set up Single Sign-On (SSO) page for your company, and clicks Continue to SSO setup.
In the portal, they verify your email domain (usually by adding a DNS record) and connect your identity provider.
When they finish, they are returned to a Warrant page that says You're all set.
The setup link stays valid for 30 days and can be opened more than once, so your IT contact can leave while a DNS change takes effect and come back to finish. If the link expires or is lost, ask Warrant to send a new one.
Automatic access (optional)
By default, people still need to be invited to Warrant before they can sign in, even with SSO. If you would rather let anyone from your company in on their first SSO sign-in, with no invitation, ask Warrant to turn on automatic access. It is off unless you ask for it. People who join this way start with the Member access level, and an admin can change it afterwards.
What your team sees at sign-in
Enter your work email address and click Continue with email.
You are sent to your identity provider's sign-in page. After you sign in there, you come straight back into Warrant.
People who sign in through SSO are not asked for a Warrant two-factor code, because your identity provider handles the second check.
If someone signs in successfully at your identity provider but has not been invited to Warrant (and automatic access is off), they see an Access Denied page. Invite them from Settings, then Members, and they can sign in straight away. If the sign-in can't be completed, for example because your identity provider returned an error or the connection isn't set up correctly, people see a We couldn't sign you in page with the reason, such as "Your organization's identity provider couldn't complete the sign-in. Please try again, or contact your IT administrator." or "Single sign-on isn't set up for your organization yet. Please contact your IT administrator." Try again takes them back to the sign-in page. Your IT team can check the connection in your identity provider, and Warrant support can help if the problem continues.
Google and Microsoft sign-in
Separately from enterprise SSO, anyone can sign in with a Google or Microsoft account that uses the same email address as their Warrant account. No setup is needed.
On the Warrant sign-in page, click Continue with Google or Continue with Microsoft.
Sign in to your Google or Microsoft account if asked.
Warrant matches the account to your Warrant account by email address and signs you in.
A few things to know:
You must already have a Warrant account. If you have not been invited, you will see an Access Denied page saying your account is not set up. Ask your administrator to invite you, or click Sign in with a different account.
If your company requires two-factor authentication, Google and Microsoft sign-ins also need a code from an authenticator app. See Two-Factor Authentication (MFA).
Who can use it
Enterprise SSO is set up per company by Warrant together with your IT contact. Google and Microsoft sign-in is available to every member.