SaaS Security Administrator's Guide
    : Onboard a Slack Enterprise App to SSPM
    Focus
    Download PDF
    Focus
    1. Home
    2. SaaS Security
    3. SaaS Security Administrator's Guide
    4. SaaS Security Posture Management
    5. Onboard SaaS Apps Supported by SSPM
    6. Onboard a Slack Enterprise App to SSPM
    Download PDF

    SaaS Security Administrator's Guide

    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 Security
      Applications
      Add 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
      .

    Recommended For You

    © 2024 Palo Alto Networks, Inc. All rights reserved.