Microsoft Azure Active Directory

Microsoft Azure Active Directory (AD) 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.

This article shows how to configure Azure Active Directory as the identity provider for Databricks. If you use Microsoft Windows Active Directory that you host in your Azure tenant or on your premises, you can use it for SSO with Databricks. In that case, 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, in the Azure services pane, click Enterprise applications. The All applications pane opens and displays a random sample of the applications in your Azure Active Directory tenant.

  2. In the Enterprise applications pane, click New application.

    The Browse Azure Active Directory Gallery pane opens and displays tiles for cloud platforms, on-premises applications, and featured applications.

  3. Switch to the legacy app galley experience.

    In the banner at the top of the Add an application page, click the link that says You’re in the new and improved app gallery experience. Click here to switch back to the legacy app gallery experience.

  4. Enter a name, then click Create your own application. Under What are you looking to do with your application? choose Integrate any other application you don’t find in the gallery.

The application’s properties pane appears.

Configure the Azure portal application

  1. In the application’s properties pane, click Users and groups. Select users and 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.

  2. In the application’s properties pane, click Single sign on.

  3. Click SAML configure the application for SAML authentication. The SAML properties pane appears.

  4. Next to Basic SAML configuration, click Edit.

  5. Next to SAML Signing Certificate, click Edit.

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

  7. Next to Certificate (Base64), click Download. The certificate is downloaded locally as a file with .cer extension.

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

  9. Copy the file contents.

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