Microsoft Azure Active Directory

This article shows how to configure single sign-on (SSO) when you use Databricks and your users and groups are managed in Microsoft Azure Active Directory (AD). Azure Active Directory runs in your Azure tenant. It provides identity based access controls for a wide range of Microsoft product and provides support for authenticating third-party applications such as Databricks. Azure Active Directory uses SAML 2.0.

If you use Microsoft Windows Active Directory that you host in your Azure tenant or on your premises, see Microsoft Windows Active Directory instead of this article.

Gather required information

1. Log in to Databricks as an administrator.

2. Go to the admin console.

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. Next to Certificate (Base64), click Download. The certificate is downloaded locally as a file with .cer extension.

9. 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.

10. Copy the file contents.

11. 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 console.

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.