Using Login with SSO
As an end-user of Bitwarden, you may need to have an organization SSO identifier before you can login using SSO.
tip
Depending on how your organization is set up, you may also need to link your account to SSO. This is typically required if you already have a Bitwarden account that's a member of an organization or if your organization does not require you to use SSO.
Every Bitwarden organization has a unique identifier specifically for login with SSO. You will need this value to login, so ask your manager or Bitwarden administrator to retrieve it for you.
note
Enterprise customers can verify domain ownership (e.g., mycompany.com) for their organization. If your login email matches your organization's verified domain (e.g., mycompany.com), you won't need to enter in the SSO identifier when using login in with SSO.
.avif?eu=d9df58e4b199a8d1073aa18a3d27626ce63c54f8fe043682386db1fc4ba8cd8472f34c5728c779b42f3b0cda82b24bb26fc52a3510eb828895bc1cf3ee64a90b52875ce763b57202002bc3a8e5f602426bc71000e5c7884ba9726d8db8e2e0255a4e4f6ffe2bfbc2b9ed767aeed66b2dedf4f87d2398aa2ee84f1953d41f39961adc98a4727c9c9cd4169d97b5cd43b0e5b1581849defb3d7174451c09b97cbef1e751763d7a130a3ccca850926891b63c183222413c50b5326f8e16a33375ace6fba35ec47a78fcaacd5e21c2aca79eee19b22b7788be5ac6ed3915104df244&a=w%3D300%26h%3D213%26fm%3Davif%26q%3D75&cd=2023-03-24T14%3A17%3A12.990Z)
To learn more about domain verification, see here.
The steps required to join an organization using SSO will be slightly different depending on whether you have received an email invitation and whether you already have a Bitwarden account associated with the email address you want to join Bitwarden with:
If you have an email invitation to join the organization in your inbox, follow one of these procedures depending on whether you already have a Bitwarden account with that email address:
I already have a Bitwarden account
If the invitation is sent to an email that is already linked to a Bitwarden account and matches the email address supplied by the IdP, follow these steps to join the organization:
Click the Join Organization button in the email invitation.
On the Bitwarden invitation page, select Log in. Enter your email address, then master password, and select Log in once more.
Once you have successfully logged in, a green banner will appear at the top of the page, indicating that your organization invitation has been accepted. An organization admin will need to confirm you to the organization before you can proceed.
Once you're confirmed, you'll be able to access the organization by logging in to Bitwarden again, this time using the Enterprise single sign-on option.
I don't have a Bitwarden account
If the invitation is sent to an email that isn't already linked to a Bitwarden account, follow these steps:
Click the Join Organization button in the email invitation.
Select Log in on the invitation page, then enter your email address. On the following page, select the Enterprise single sign-on button.
Enter your SSO identifier and select Log in (if your email matches an organization's verified domain, you will bypass this step).
Log in to your IdP. Once you do, you'll be redirected to a page where you can create a master password for your new account.
Create a master password for the account. An organization admin will need to confirm you to the organization before you can proceed.
Once you're confirmed, you'll be able to access the organization by logging in to Bitwarden using the Enterprise single sign-on option.
If you receive the error message <email> has been invited to the organization, please accept invitation. while attempting to log in, there's already a Bitwarden account associated with this email. Please follow the I already have a Bitwarden account instructions above.
If you don't have an email invitation to join the organization in your inbox, follow one of these procedures depending on whether you already have a Bitwarden account with that email address:
I already have a Bitwarden account
You won't be able to join an organization using SSO with this account. Contact your organization admin to request an invitation.
I don't have a Bitwarden account
If you are joining an organization without an invite and no pre-existing Bitwarden account, follow these instructions:
Enter your email on the Bitwarden login page. On the following page, select the Enterprise single sign-on button.
Enter your SSO Identifier and select Log in (if your email matches an organization's verified domain, you will bypass this step).
Log in to your IdP. Once you do, you'll be redirected to a page where you can create a master password for your new account.
Create a master password for the account. An organization admin will need to confirm you to the organization before you can proceed.
Once you're confirmed, you'll be able to access the organization by logging in to Bitwarden using the Enterprise single sign-on option.
The steps required to login using SSO will be slightly different depending on whether your organization is using Key Connector or not:
To login using SSO and your master password:
Open your Bitwarden web vault and enter your Bitwarden email and select Continue. If you don't have a Bitwarden account email yet, you may enter your company email.
![email address]()
email address Select the Enterprise single sign-on button:
![Enterprise single sign on and master password]()
Enterprise single sign on and master password Enter your SSO identifier and select Log In (Organizations with a verified domain will bypass this step):
![SSO identifier]()
SSO identifier tip
We recommend bookmarking this page with your organization identifier included as a query string so that you don't have to enter it each time, for example
https://vault.bitwarden.com/#/sso?identifier=YOUR-ORG-IDorhttps://your.domain.com/#/sso?identifier=YOUR-ORG-ID.Now that you have authenticated your identity using SSO, you will be prompted to either create a master password for your new account or, if you already have a Bitwarden account, to enter your master password to decrypt your vault.
note
Why is my master password still required?
All vault data, including credentials shared by your organization, is kept by Bitwarden only in its encrypted form. This means that in order to use any of those credentials, you need a way to decrypt that data. We can't.
Your master password is the source of that decryption key. Even though you are authenticating (proving your identity) to Bitwarden using SSO, you still need to use a decryption key (your master password) to unscramble vault data.
If you are using two-step login, authenticate using your secondary device.
warning
Two-step login via email is not recommended if you are using login with SSO, as using multiple methods will cause errors. Consider setting up two-step login via a free authenticator instead.
.avif?eu=ded852b2b19bf9855a3ea9d168756760e53a57f9fe5635863463e2a94ffeca8775f14f5d23967bb12e6f098c80e117e834c22a621fbbd7dbc3ef4af4e83da25e54d15bba35e57805022dc1ade4fd05453d951c0da6d19b5ba66f72d4b6b6e22319011f7fa222fcc5acea3f7bafda7263bde3e5303686fd29a3510b1088062fa920a4979c6d4da894b149e7bba9ae16cef487597b27d284477906487b21b62ce1a3c775197836445f67cffd5a956791e539186427080a02f7336fd657f36c64c7e5f2a00fde7f6482fb8b6425d8accdd8b25ec32876e5cd3aa883267b0962fd57c2bd7be9d762180e81458be823dd016a2b00dc4b&a=w%3D386%26h%3D231%26fm%3Davif%26q%3D75&cd=2023-03-22T13%3A13%3A20.775Z)
.avif?eu=d98652e1e4cdf4810f6ba18639263368e53b50a9af033e826963e6a946fa9b8f70f41a53759c2cb62b380fd8d0e04bee67c029634fe7d7d295ee4da7ef37a35a50d709ed33e72104532dc2ffbaad420128851047beda9559f43831cab6f7e1215a13496feb64e6d4a8b63226eed06968ebe0ae7322c5b47da36c285c8d1f33fe1cf8d9a25243e699e419a7949db60a9bcfef2b56128aa6302475481c5fee7cb8f3b705796b29440d349dac5ac06689d56f5e3476003060af387ebf57fb6e33dee5fabc5dde152aa5c7ca2f7387ddad89827ad14519e5a039e9dc6c&a=w%3D413%26h%3D330%26fm%3Davif%26q%3D75&cd=2023-03-22T13%3A13%3A20.828Z)
To login using SSO and Key Connector:
Open your Bitwarden web vault and enter your Bitwarden email and select Continue. If you don't have a Bitwarden account email yet, you may enter your company email.
![email address]()
email address Select the Enterprise single sign-on button:
![Enterprise single sign on and master password]()
Enterprise single sign on and master password Enter your SSO identifier and select Log in (Organizations with a verified domain will bypass this step):
![SSO identifier]()
SSO identifier tip
We recommend bookmarking this page with your organization identifier includes as a query string so that you don't have to enter it each time, for example
https://vault.bitwarden.com/#/sso?identifier=YOUR-ORG-IDorhttps://your.domain.com/#/sso?identifier=YOUR-ORG-ID.Depending on your account status, you might be required to enter or create a master password the first time you login with SSO and Key Connector. Doing so will remove the master password from your account.
If you are using two-step login, authenticate using your secondary device.
warning
Two-step login via email is not recommended if you are using login with SSO, as using multiple methods will cause errors. Consider setting up two-step login via a free authenticator instead.
You should only need to link your account to SSO if you already have a Bitwarden account that's a member of the organization or if your organization does not require you to use SSO:
Open the web vault, and select the Options menu next to your organization.
From the dropdown menu, select Link SSO.
![Link SSO in the Web Vault]()
Link SSO in the Web Vault
Once linked, you should be able to login using SSO as documented above.