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
- 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.Log into the Slack API console and navigate to the Your Apps page (api.slack.com/apps).Create New App.In the Create an app dialog, specify that you want to create the app From scratch.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.Create App in the selected workspace.
![]()
Slack Enterprise displays the configuration settings your new app.Configure your app according to the specifications required by SSPM.- Navigate to the OAuth and Permissions settings and locate the Scopes section.
- Under Bot Token Scopes, Add an OAuth Scope
and select the team:read scope.
![]()
- Navigate to the Org Level Apps settings and
Opt in to the org apps program.
![]()
- Navigate back to the OAuth and Permissions settings and locate the Scopes section.
- Under User Token Scopes, Add an OAuth Scope
and select the following scopes:
- admin.teams:read
- auditlogs:read
- team:read
Install your app across your organization's workspaces to generate the User OAuth Token that SSPM requires.- 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.
- 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. - From the Add Application page ( ), click the Slack Enterprise tile.Under posture security instances, Add Instance or, if there is already an instance configured, Add New instance.Choose the option to Log in with Credentials.Specify the User OAuth Token in the API Key field and Connect.
