Skip to main content
Last updated on

Configure authentication to Slack

Beta

This feature is in Beta. Workspace admins can control access to this feature from the Previews page. See Manage Databricks previews.

This page shows how to configure Slack to enable authentication from Databricks for the Slack Access and Integration Logs connector. Use the credentials that you retrieve from the steps on this page to create a Unity Catalog connection in Databricks.

Prerequisites​

  1. Enablement of the Lakewatch Public Preview.
  2. Enablement of serverless Lakeflow Spark Declarative Pipelines in your workspace.
  3. Unity Catalog (UC), with CREATE CONNECTION permissions in your workspace.
  4. A Slack paid plan (Pro, Business+, or Enterprise Grid). The connector isn't available on Slack's free plan.
  5. A Slack user who is a Workspace Owner or Workspace Admin on the workspace you want to ingest from.

Configure Slack for OAuth​

In this step, you configure Slack to enable authentication from Databricks by creating an OAuth app in Slack.

  1. Sign in to Slack as a Workspace Owner or Workspace Administrator, then go to https://api.slack.com/apps?new_app=1.

  2. Create the OAuth app From a manifest file (to rapidly apply a predefined and repeatable configuration) or From scratch (to manually configure the app).

    • If you select From a manifest, use the following YAML manifest. Replace <your_slack_app> with a name for your app, and replace <your_databricks_workspace_URL> with your Databricks workspace URL.

      YAML
      display_information:
        name: <your_slack_app>
      oauth_config:
        redirect_urls:
          - https://<your_databricks_workspace_URL>/login/oauth/lakehousefederation.html
        scopes:
          user:
            - admin
      settings:
        org_deploy_enabled: false
        socket_mode_enabled: false
        token_rotation_enabled: <true_or_false>

      For an example redirect URL:

      Text
      https://my-databricks-account.cloud.databricks.com/login/oauth/lakehousefederation.html

    • If you select From scratch, specify an App name.

  3. In the workspace selection drop-down menu, select the Slack workspace that you want to create the app in.

  4. In the app's settings, select OAuth & Permissions in the left pane.

    1. In the Scopes section, verify you've added the admin scope. If not, click Add an OAuth Scope under User Token Scopes, and add it.
    2. In the Redirect URLs section, verify you've added https://<your_databricks_workspace_URL>/login/oauth/lakehousefederation.html as a redirect URL. If not, click Add New Redirect URL and add it.
    3. You can optionally enable token rotation under Advanced token security via token rotation.

  5. In the app's settings, select Manage Distribution in the left pane.

    1. In the Share Your App with Other Workspaces section, verify that all four sections show a green checkmark.
    2. Click the green Activate Public Distribution button.

  6. Select Basic Information in the left pane and note the Client ID and Client Secret. Use these credentials to create a Unity Catalog connection in Databricks.

Next steps​

Create a Slack Access and Integration Logs connection in Databricks. See Create a Slack Access and Integration Logs connection.

On this page