SaaS Security Administrator's Guide
    : Begin Scanning a Slack Enterprise App
    Focus
    Download PDF
    Focus
    1. Home
    2. SaaS Security
    3. SaaS Security Administrator's Guide
    4. Data Security
    5. Secure Sanctioned SaaS Apps on Data Security
    6. Add Cloud Apps to Data Security
    7. Begin Scanning a Slack Enterprise App
    Download PDF

    SaaS Security Administrator's Guide

    Begin Scanning a Slack Enterprise App

    Table of Contents

    Begin Scanning a Slack Enterprise App

    Authorize
    Data Security
     to connect to Slack Enterprise to scan all content shared within the app.
    In addition to the
    Grid
     license,
    Data Security
     also supports the
    Select
     license for Slack Enterprise.
    If you have Slack Pro or Slack Business+ plan, you must onboard using the Slack Pro and Business app instead.
    Delete any previously installed Slack Enterprise Grid app of the same instance before onboarding Slack Enterprise. If you use both versions at the same time, rate limits for Slack will be shared between the two and might impact asset discovery.
    To connect Slack Enterprise to
    Data Security
     and begin scanning assets, you need to:
    • Ensure that you have a Slack Enterprise administrator account with Organization Owner permissions.
    • Authorize a
      Data Security
       bot to enable Admin Quarantine.
    • Grant
      Data Security
       access to Slack.
    • Add the Slack Enterprise app to
      Data Security
      , providing
      Data Security
       information about your Slack account.
    Support for automated remediation capabilities varies by SaaS application.

    Add Slack Enterprise App

    For
    Data Security
     to scan assets, you must consent to specific permissions during adding the Slack Enterprise app.
    1. (
      Recommended
      ) Add your Slack Enterprise domain as an internal domain.
    2. Sign out of all Slack workspaces.
      Doing so ensures that you sign in under the correct account and workspace.
    3. Enable the privileges required for communication between
      Data Security
       and the Slack app.
      The Organization Owner must contact exports@slack.com and request that Slack Support enables the Slack app for DLP API access and integration with
      Data Security
      . Slack Support requires over-the-phone enablement whereby you answer a series of security questions.
      DLP API access provides visibility into the assets in Slack and allows
      Data Security
       to monitor the sharing of assets.
    4. To add the Slack app, go to
      Data Security
      Applications
      Add Application
      Slack Enterprise
      .
      1. Select
        Slack Enterprise
        .
      2. Select
        Connect to Slack Enterprise Account
        .
      3. Enter your team’s Slack domain or workspace (top-level enterprise organization), then
        Continue
        .
      4. Sign in
         with an administrator account that is an Organization Owner.
        If this account is deleted from Slack, the associated credentials or tokens will be revoked. Therefore, it is advisable to create a service account that remains unaffected by deletions, ensuring uninterrupted access to APIs.
      5. Review and
        Allow
         the requested permissions.
        Data Security
         requires these permissions to scan your assets on Slack Enterprise.
        After authentication,
        Data Security
         adds the new Slack app to the list of Cloud Apps as Slack n, where n is the number of Slack app instances that you have connected to
        Data Security
        . After successful onboarding, you’ll specify a descriptive name soon.

    Enable Remediation Using Slack Bot

    1. Authorize a
      Data Security
       bot to enable Admin Quarantine.
      1. Select the Slack n link on the Cloud Apps list.
      2. In
        Cloud App Detail
        , add an email address for the quarantine administrator, click
        Bot Token
         in the drop-down, then
        Allow
         to reauthorize access.
    2. (
      Optional
      ) Give a descriptive name to this app instance.
      1. Select the Slack n link on the Cloud Apps list.
      2. Enter a descriptive
        Name
         to differentiate this instance of Slack from other instances.
      3. Click
        Done
         to save your changes.

    Troubleshooting Onboarding for Slack Enterprise App

    To ensure that your app has onboarded correctly without any issues in authentication or permissions, Data Security performs validation checks between the onboarding and scanning process. You can start scanning only after a successful validation. For Slack Enterprise, the following validation happens:
    • Validating Permissions
    After the validation is successful, Data Security displays the sample data assets.
    If the
    Validating Permissions
     check fails, try the following:
    1. Ensure you have administrator permissions.
    2. Go to your
      slack app directory
       and check if your Palo Alto Networks application is listed in the list of
      Installed Apps
      . Following are the app names for specific regions:
      • India region: Palo Alto Networks NG-CASB - India
      • Australia region: Palo Alto Networks NG-CASB - AU
      • Japan region: Palo Alto Networks NG-CASB - JP
      • UK region: Palo Alto Networks NG-CASB - UK
      • EU region: Palo Alto Networks NG-CASB - EU
      • APAC region: Palo Alto Networks NG-CASB - APAC
    Handling Errors
    To understand your error messages and ways to resolve them, see:
    The other most common issues related to onboarding a Slack Enterprise app are as follows:
    Symptom
    Explanation
    Solution
    When you attempt to log in to your Slack administrator account during the onboarding process, an authorization error is returned:
    Something went wrong when authorizing Palo Alto Networks NG-CASB for Slack
    .
    You have a Slack workspace open in your browser for a workspace other than the workspace associated with the administrator account that you’re using to onboard the Slack Enterprise app or the administrator account isn’t an Organization Owner.
    Log out of all Slack workspaces and verify that the administrator account is an Organization Owner.
    If the issue persists, contact SaaS Security Technical Support.

    Start Scanning and Monitor Results

    Before beginning to scan for risks, configure Data Patterns to identify specific strings of text, characters, words, or patterns to make it possible to find all instances of text that match a data pattern you specify
    When you add a new cloud app and enable scanning,
    Data Security
     automatically scans the cloud app against the default data patterns and displays the match occurrences. You can take action now to improve your scan results and identify risks.
    1. To start scanning the new Slack Enterprise app for risks, go to
      Data Security
      Applications
      Slack Enterprise
      View Settings
      ...
      Start Scanning
      .
    2. During the discovery phase,
      Data Security
       scans files and matches them against enabled default policy rules.
      Verify that your default policy rules are effective. If the results don’t capture all risks or you see false positives, proceed to the next step.
    3. (
      Optional
      ) Modify match criteria for existing policy rules.
    4. (
      Optional
      ) Add new policy rules.
      Consider the business use of your app, then identify risks unique to your organization. As necessary, add new:

    Fix Slack Enterprise App Quarantine Issues

    If
    Data Security
     is unable to quarantine the asset, quarantine status displays a summary explanation of the quarantine failure. If you need additional information, and due to the underlying differences between cloud apps, use the table below for a detailed explanation and resolution.
    Symptom
    Explanation
    Solution
    You’re not receiving notifications in Slack when
    Data Security
     quarantines an asset and quarantine status indicates
    Missing authorized bot
    .
    Admin Quarantine actions fail if you did not authorize
    Data Security
     bot to enable notifications or you did not add an email address for the quarantine administrator. In these cases,
    Data Security
     can neither quarantine files nor notify the quarantine administrator.
    Authorize a
    Data Security
     bot to enable Admin Quarantine.
    When you attempt to manually quarantine a file,
    Data Security
     doesn’t quarantine the file and you receive a quarantine status that indicates
    Missing authorized bot
    .
    When you choose admin quarantine for automatic remediation,
    Data Security
     doesn’t quarantine the file, and you receive a quarantine status that indicates
    Missing authorized bot
    .

    Recommended For You

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