SSO with Azure Active Directory for your workspace

Note

Workspace-level SSO can only be configured when unified login is disabled. When unified login, your workspace uses the same SSO configuration as your account. Databricks recommends enabling unified login on all workspaces. See Unified login.

This article shows how to configure single sign-on (SSO) when you use Databricks and your users and groups are managed in Azure Active Directory (AD). Azure Active Directory runs in your Azure tenant and supports SAML 2.0. If you use Microsoft Windows Active Directory that you host in your Azure tenant or on your premises, see SSO with Microsoft Windows Active Directory for your workspace instead of this article.

This article shows how to configure Azure Active Directory as the identity provider for a Databricks workspace. To configure SSO in your Databricks account, see Set up SSO in your Databricks account console.

Gather required information

1. Log in to Databricks as an administrator.

2. Go to the admin settings page.

3. Click Single Sign On.

4. Copy the Databricks SAML URL.

Do not close this browser tab.

Configure Azure Active Directory

Create an Azure portal application

Follow these steps to create a non-gallery Azure portal SAML application.

1. In the Azure portal menu, click All services. In the Identity section, click Enterprise applications.

2. Click New application, then click Create your own application.

3. Enter a name for the application. When asked What are you looking to do with your application?, choose Integrate any other application you don’t find in the gallery.

4. Click Create.

Configure the Azure portal application

1. In the Azure portal menu, click Users and groups.

2. Click Add user/group and select users or groups to grant them access to this SAML application. Users must have access to this SAML application to log into your Databricks workspace using SSO.

3. In the Azure portal menu, click Single sign-on.

4. Click the SAML tile to configure the application for SAML authentication.

5. Next to Basic SAML configuration, click Edit.

   • Set Entity ID to the Databricks SAML URL from Gather required information.

   • Set Reply URL to the Databricks SAML URL from Gather required information.

6. Next to SAML Signing Certificate, click Edit.

7. In the Signing Option drop-down list, select Sign SAML response and assertion.

8. In Attributes & Claims, click Edit.

9. Set the Unique User Identifier (Name ID) field to user.mail.

10. Under SAML Certificates, next to Certificate (Base64), click Download. The certificate is downloaded locally as a file with the .cer extension.

11. Open the .cer file in a text editor. Do not open it using the macOS keychain, which is the default on macOS. The file comprises the entire x.509 certificate for the Azure Active Directory SAML application.

    Important

    The certificate is sensitive data. Be cautious about where you download it and delete it from local storage as soon as possible.

12. Copy the file contents.

13. Under Set up Azure AD SAML Toolkit, copy the Login URL and Azure Active Directory Identifier.

Configure Databricks

As a Databricks administrator:

1. Go to the admin settings page.

2. Go to the Single Sign On tab.

3. Set Single Sign-On URL to the Login URL from Configure the Azure portal application.

4. Set Identity Provider Entity ID to the Azure Active Directory Identifier from Configure the Azure portal application.

5. Paste the certificate from Configure the Azure portal application into the X.509 Certificate field.

6. Click Enable SSO.

7. Optionally, click Allow auto user creation.

Test the configuration

1. In an incognito browser window, go to your Databricks workspace.

2. Click Single Sign On. You are redirected to Azure Active Directory.

3. Enter your Azure Active Directory credentials. If SSO is configured correctly, you are redirected to Databricks.

If the test fails, review Troubleshooting.