Configure single sign-on for your Databricks account
Configure single sign-on (SSO) so that users sign in to the Databricks account console and workspaces with your organization's identity provider (IdP). Databricks recommends that you configure SSO and require multi-factor authentication in your IdP.
SSO authenticates users. It doesn't grant access to workspaces or data. Users must also be assigned to a workspace. See Add users to your Databricks account.
Requirements
Before you configure SSO, meet these requirements:
- You must be an account admin.
- You must have admin access to your IdP. Your IdP must support Security Assertion Markup Language (SAML) 2.0 or OpenID Connect (OIDC).
Configure SSO
To configure SSO, you connect the account console to an application in your IdP.
After you enable SSO, all users, including account admins, must sign in with SSO. To prevent a lockout during setup, keep the account console open in a separate browser window. To let up to 20 users sign in if your IdP is unavailable, configure emergency access. See Emergency access to prevent lockouts.
Open the SSO configuration
Open the SSO configuration dialog in the account console:
- As an account admin, log in to the account console.
- Click Security.
- Click the Identity provider setup tab.
- In the Authentication section, open the SSO configuration dialog.
Create an application in your IdP
Select an identity protocol, copy the Databricks redirect URL, and then register Databricks as an application in your IdP:
- On the Add details step, under Identity protocol, select SAML or OpenID Connect.
- Copy the Databricks redirect URL.
- In your IdP, create an application for Databricks, and enter the redirect URL.
- Copy the values that your IdP generates for the application, such as the client ID, client secret, and issuer URL for OIDC.
For instructions for your IdP, such as Microsoft Entra ID or Okta, see Configure SSO in Databricks.
Enter the IdP values in Databricks
Return to the SSO configuration dialog, and enter the values from your IdP.
Enable SSO
Enabling SSO saves your configuration and then starts a test sign-in with your IdP:
- Click Enable SSO. Databricks saves the configuration in a disabled state, runs a connection test, and redirects you to your IdP to sign in.
- Complete the sign-in flow in your IdP. If the test succeeds, SSO is enabled automatically. If the test fails, review the values that you entered and try again.
- In your IdP, grant your account users access to the Databricks application.
Verify SSO
Test sign-in for the account console:
Use a test user to check account-console sign-in:
- Open a private or incognito browser window.
- Go to the account console, and enter a test user's email address. Confirm that your browser redirects to your IdP's sign-in page.
- Complete the sign-in flow, and confirm that the account console opens as the test user.
If unified login is enabled, also test workspace sign-in: in a new private or incognito browser window, go to a workspace URL, and confirm that the sign-in redirects to your IdP. See Test workspace login.
Troubleshooting
Use these entries for sign-in loops and for users who can't reach a workspace.
The SSO sign-in fails or redirects in a loop
Confirm that the redirect URL in your IdP application matches the redirect URL in the Databricks SSO configuration exactly, including the protocol and any trailing slash. See Troubleshooting OIDC SSO or Troubleshooting SAML SSO.
A user signs in but can't access a workspace
SSO authenticates users, but it doesn't grant access to workspaces. Confirm that the user, or a group that the user belongs to, is assigned to the workspace. See Assign users and groups to workspaces.
Next steps
-
- Add users to your Databricks account
- Add account users and groups, and assign them to workspaces
-
- Authentication and access control
- Learn about authentication and access control in Databricks