: Onboard a Slack Enterprise App to SSPM
Focus
Focus

Onboard a Slack Enterprise App to SSPM

Table of Contents

Onboard a Slack Enterprise App to SSPM

Connect a Slack Enterprise instance to SSPM to detect posture risks.
The following instructions describe a newer method of onboarding Slack Enterprise, which was introduced in October 2023. This onboarding method uses an OAuth token to connect to your Slack Enterprise instance. This method replaces an earlier approach, which connected SSPM to your Slack Enterprise instance by using administrator login credentials. If you already connected to your Slack Enterprise instance using the earlier approach, your established connection will continue to work. However, if there is any change to the configuration information that you provided to SSPM (such as an updated login password), you will need to onboard Slack Enterprise by using this new method.
For SSPM to detect posture risks in your Slack Enterprise instance, you must onboard your Slack Enterprise instance to SSPM. Through the onboarding process, SSPM connects to a Slack Enterprise API and, through the API, scans your Slack Enterprise instance for misconfigured settings. If there are misconfigured settings, SSPM suggests a remediation action based on best practices.
SSPM gets access to your Slack Enterprise instance by connecting to a Slack API using an access token that you provide. To obtain this token, you first create an OAuth integration application in Slack Enterprise. From your OAuth integration application, you copy a user OAuth token. You then provide this OAuth token to SSPM during onboarding.
To onboard your Slack Enterprise instance, you complete the following actions:

Create an App for Accessing Your Slack Enterprise Instance

To access your Slack Enterprise instance, SSPM requires an OAtuh token that Slack Enterprise generates for a Slack org-wide app that you create. A Slack org-wide app is an app that you deploy across all Slack workspaces in your organization. For this SSPM integration, you will be creating an org-wide app that enables SSPM to connect to your Slack Enterprise instance. To create your org-wide app and obtain the OAuth token, complete the following steps:
  1. Identify the administrator account that you will use to create your Slack org-wide app.
    Required Permissions: Because you will install the app across all workspaces in your organization, you must be assigned to the Org Admin role or a role with greater permissions.
  2. Log into the Slack API console and navigate to the Your Apps page (api.slack.com/apps).
  3. Create New App.
  4. In the Create an app dialog, specify that you want to create the app From scratch.
  5. In the Name app & choose workspace dialog, specify a name for your app and choose a workspace. You will be configuring your app in this workspace, and later will deploy it across the other workspaces your organization.
  6. Create App in the selected workspace.
    Slack Enterprise displays the configuration settings your new app.
  7. Configure your app according to the specifications required by SSPM.
    1. Navigate to the OAuth and Permissions settings and locate the Scopes section.
    2. Under Bot Token Scopes, Add an OAuth Scope and select the team:read scope.
    3. Navigate to the Org Level Apps settings and Opt in to the org apps program.
    4. Navigate back to the OAuth and Permissions settings and locate the Scopes section.
    5. Under User Token Scopes, Add an OAuth Scope and select the following scopes:
      • admin.teams:read
      • auditlogs:read
      • team:read
  8. Install your app across your organization's workspaces to generate the User OAuth Token that SSPM requires.
    1. In the OAuth and Permissions settings, locate the OAuth Tokens for Your Workspace section and Install to Organization.
      Slack Enterprises generates tokens for your app.
    2. Copy the User OAuth Token and paste it into a text file.
      Do not continue to the next step unless you have copied the User OAuth Token. You must provide the User OAuth Token during onboarding when SSPM prompts you for an API Key.

Connect SSPM to Your Slack Enterprise Instance

By adding a Slack Enterprise app in SSPM, you enable SSPM to connect to your Slack Enterprise instance.
  1. From the Add Application page ( Posture SecurityApplicationsAdd Application), click the Slack Enterprise tile.
  2. Under posture security instances, Add Instance or, if there is already an instance configured, Add New instance.
  3. Choose the option to Log in with Credentials.
  4. Specify the User OAuth Token in the API Key field and Connect.