Skip to content

Configuring the Slack SaaS Connector

To connect your organization's Slack instance to Agentic Fabric, you'll create and install an app in Slack. This will allow Agentic Fabric to discover Slackbots as non-human accounts.

Important

If your organization has already configured a Slack SaaS source, you can use the existing source for agent discovery. The fields will be prepopulated with the source's information. You can edit these fields to configure a new integration.

Creating an App in Slack

Before you create the app, ensure you have the following:

  • A Slack Business+ plan

  • A Slack owner account

    Note

    Only Slack owners can generate an OAuth token to use the SCIM API. All operations by users are performed through SCIM-based APIs. For more information, refer to the Slack developer documentation.

To create an app in Slack:

  1. Follow Slack's product documentation to create an app. You can create an app from the App Settings page or through the Slack CLI.

  2. In the What it can do in Slack? window, add the following OAuth scopes for the Bot scopes:

    • users:read - List workspace members and identify bots through is_bot and profile.bot_id.

    • users:read.email - Read the workspace administrator email for slackAdministratorEmail.

    • team:read - Read the workspace name and domain through team.info.

    These scopes allow Agentic Fabric to aggregate Slackbots as machine accounts.

  3. Select the User scopes tab and add the admin scope. Select Continue.

  4. In the What it can respond to in Slack window, select Continue to skip this step. Bot and Workspace events are not required for this connection.

  5. In the Review your app window, select Create and Install to install and authorize your app. Ensure you select org-wide while installing the Slack app to have permissions on the org level.

    If you make changes to the app later, you must reinstall it.

  6. On the Your Apps page, select the app you created.

  7. Go to the Features section and select OAuth & Permissions.
  8. In the OAuth Tokens section, copy the values for the User OAuth Token and Bot User OAuth Token. You'll provide these values in Agentic Fabric to complete the connection.

Connecting Slack to Agentic Fabric

  1. Go to the Connect Source step of the Agentic Fabric onboarding experience.
  2. Select Slack SaaS from the left pane.

  3. In the Slack SaaS section, complete the following:

    • In the Source Name field, enter a unique name for the source.

    • In the Source Owner field, select the identity who will own the source.

    • In the Description field, enter a unique description for the source to distinguish it from similar connections.

  4. In the Configure Authentication section, complete the following:

    • In the API URL field, enter the host URL for SCIM API. For example, you can use https://api.slack.com/scim/v1.
    • In the API Token field, enter the value for the User OAuth Token from the OAuth & Permissions page in Slack.
    • Select the Enable Slack Machine Accounts toggle to aggregate Slackbots as machine accounts.
    • In the Bot User OAuth Token field, enter the value for the Bot User OAuth Token from the OAuth & Permissions page in Slack
    • Select Test Connection to ensure the connection is successful.

  5. If the test is successful, select Aggregate to run an aggregation for the source. Select Exit to skip this step. You can configure aggregations for the source's datasets later in the source's configuration. For information on the datasets specific to Slack, refer to the Slack connector documentation.

    A Completed status is now displayed next to the source in the left panel.

  6. Choose another connector to configure or select Continue to proceed to the next onboarding step.

Documentation Feedback

Feedback is provided as an informational resource only and does not form part of SailPoint’s official product documentation. SailPoint does not warrant or make any guarantees about the feedback (including without limitation as to its accuracy, relevance, or reliability). All feedback is subject to the terms set forth at https://developer.sailpoint.com/discuss/tos.