Configure SSO with Okta for your workspace

Warning

Workspace-level SSO is a legacy configuration. It can only be configured when unified login is disabled. When unified login is enabled, your workspace uses the same SSO configuration as your account.

If your account was created after June 21, 2023, unified login is enabled on your account by default for all workspaces, new and existing, and it cannot be disabled.

Databricks recommends enabling unified login on all workspaces. See Enable unified login.

This documentation has been retired and might not be updated.

This article shows how to configure Okta as the identity provider for a Databricks workspace. To configure SSO in your Databricks account, see Configure SSO in Databricks.

Gather required information

  1. As a workspace admin, log in to the Databricks workspace.

  2. Click your username in the top bar of the Databricks workspace and select Settings.

  3. Click on the Identity and access tab.

  4. Next to SSO settings, click Manage.

  5. Copy the Databricks SAML URL.

Do not close this browser tab.

Configure Okta

  1. In a new browser tab, log into Okta as an administrator.

  2. In the home page, click Applications > Applications.

  3. Click Create App Integration.

  4. Select SAML 2.0 and click Next.

  5. Set App name to Databricks SSO and click Next.

  6. Configure the application using the following settings:

  7. Click Advanced settings. Ensure that Response is set to Signed (the default). Signing the assertion is optional. Do not modify other advanced settings.

    Important

    Assertion encryption must be set to Unencrypted.

  8. Click Hide advanced settings.

  9. Click Next.

  10. Select I’m an Okta customer adding an internal app.

  11. Click Finish. The Databricks SAML app is shown.

  12. Under SAML 2.0 is not configured until you complete the setup instructions, click View Setup Instructions.

  13. Copy the following values:

    • Identity Provider Single Sign-On URL

    • Identity Provider Issuer

    • x.509 certificate

Configure Databricks

  1. Go back to the browser tab for Databricks.

  2. Click your username in the top bar of the Databricks workspace and select Settings.

  3. Click on the Identity and access tab.

  4. Next to SSO settings, click Manage.

  5. Set Single Sign-On URL to the Identity Provider Single Sign-On URL from Okta.

  6. Set Identity Provider Entity ID to the Identity Provider Issuer from Okta.

  7. Set x.509 Certificate to the x.509 certificate from Okta, including the markers for the beginning and ending of the certificate.

  8. Click Enable SSO.

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

  3. Log in to Okta. If SSO is configured correctly, you are redirected to Databricks.

If the test fails, review Troubleshooting.