Configure authentication to Slack

Important

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

This page shows how to configure Slack to enable authentication from Azure 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 Azure 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 Azure 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 Azure Databricks workspace URL.

     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:

     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 Azure Databricks.

Next steps

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