Slack Bot Destination

Configuring Panther's Slack Bot as an alert destination in your Panther Console

Overview

Destinations are integrations that receive alerts from rules, policies, system health notifications, and rule errors. Panther supports configuring a Panther Slack Bot as the destination where you will receive alerts.

Panther's Slack Bot is a Slack application that can send alerts to one or more Slack Channels.

Please note the following:

  • To interact with the alerts, the Slack user email address must match the email address of the user profile defined in Panther.

    • If your email addresses in Slack do not match your Panther Console email addresses, please contact Panther's support team for assistance.

Managing alerts in Slack

Interactions with the Alert within Slack, such as updating the status, setting the assignee, and sending Boomerang messages, will sync back to the Panther Console. In addition, the resolution comment when marking an alert as "Resolved" will sync to Panther's Alert Activity History. Note that this is a one-way sync; changes made to these alerts in the Panther Console will not sync back to Slack.

For more information on managing alerts in Slack, see Managing Alerts in Slack.

Slack Bot setup video walkthrough

Video walkthrough for setting up Panther's Slack Bot alert destination integration.

How to set up Slack Bot alert destinations in Panther

Panther users should have the permissions View Alerts and Manage Alerts to assign alerts and change alert statuses.

Step 1: Creating your first Slack Bot alert destination in Panther

Creating your first Slack Bot alert destination requires the creation of a new Slack Application. Once the initial destination has been created, additional Slack Bot alert destinations will automatically reuse the same Slack Application and its credentials.

  1. Log in to the Panther Console.

  2. In the left sidebar, click Configure > Alert Destinations.

  3. Click +Add your first Destination.

    • If you have already created Destinations, click Create New in the upper right side of the page to add a new Destination.

  4. Click Slack Bot.

Make sure to keep this browser tab open while you begin the next steps.

Step 2: Configuring the Slack Bot app in Slack

  1. In a separate browser tab, log in to Slack using an administrator account.

  2. In Slack - Your Apps, click Create New App.

    1. If your Slack plan is Enterprise Grid, select a Workspace in the Grid that you wish to have the Slack Bot available. The ability to install into other Workspaces in the Grid will come in a later step.

  3. Click Next.

  4. Click Next.

  5. If you are logged in as a Slack administrator, skip to Step 3: Installing the Slack Bot. Otherwise, continue below.

    • In the "Request to install Panther" dialog, add an optional message for your Slack administrator to provide context, then click Submit Request.

    • The Basic Information page should now display Request Submitted under the "Install your app" section.

  6. Ask your Slack administrator to approve the install request, but do not install it yet.

    • Once approved, the Request Submitted button will update to Install to Workspace.

Step 3: Installing Slack Bot

If your Slack plan is Enterprise Grid, please see the Enterprise Grid tab below. For all other Slack plans, please see the Non-Enterprise Slack tab below.

Installing the Slack Bot to your Workspace

  1. Click Allow to authorize access to your new app.

    • You will be redirected back to the Basic Information page in Slack.

Step 4: Configuring Panther Slack App

  1. Download the Panther App Icon image to your computer.

  2. Navigate back to Settings > Basic Information in your Slack App.

    • Select the Panther App Icon you downloaded in the prior step.

Step 5: Continuing configuration in Panther

  1. Open the browser tab where you began configuring the Slack Bot alert destination in the Panther Console.

    • If that tab was closed, or if you are not a Slack admin and you submitted a request to install the app, you will need to follow the previous steps to get back to the Slack Bot destination setup process in the Panther Console. You will also need to update the manifest of your Slack Bot app to match the latest version from the Panther Console.

  2. From the "Create your Slack Bot app" page in the Panther Console where your manifest is displayed, click Continue.

  3. Fill out the form to configure the Destination:

    • Display Name: Enter a descriptive name for the Alert Destination.

      • Note: This is the display name of the Alert Destination in the Panther Console, not the name of the Bot in Slack.

    • Channel ID or Channel Name: Enter the Slack Channel Name (e.g. #hello-world) or Slack Channel ID where you want to receive your alerts.

    • Client ID: Enter the Client ID value from the App Credentials section of your Slack Bot app.

    • Client Secret: Enter the Client Secret value from the App Credentials section of your Slack Bot app.

    • Signing Secret: Enter the Signing Secret value from the App Credentials section of your Slack Bot app.

    • Severity: Select the severity level of alerts to send to this Destination.

    • Alert Types: Select the alert types to send to this Destination.

    • Log Types: By default, we will send alerts from all log types. Specify log types here if you want to only send alerts from specific log types.

    • Timezone: Select the timezone to use for the messages sent to this Destination.

Keep this browser tab open for the next steps.

Step 6: Invite the Panther Slack Bot to your Slack channel

  1. Open your Slack application and navigate to the channel you configured to use with Panther.

  2. In the Slack channel, type and send the following message: /invite @Panther

Step 7: Finish setup in the Panther Console

  1. Navigate back to the Panther Console.

  2. On the final page, optionally click Send Welcome Message to test the integration. This will send a message to the Slack channel you've elected to receive alerts.

  3. When you are finished, click Finish Setup.

For information on how to view or manage alerts sent to Slack by your new Slack Bot Alert Destination, see Triaging Alerts - Slack Bot.

Step 8 (Optional): Creating additional Slack Bot destinations

It's recommended to avoid a Slack Bot alert destination configuration that sends messages for any given alert to more than one channel. For more information, see Managing Alerts in Slack.

To create an additional Slack Bot alert destination, you don't need to create a new application in your Slack workspace.

  1. In the left sidebar, click Configure > Alert Destinations.

  2. Click Create New in the upper right side of the page to add a new Destination.

  3. Click Slack Bot.

  4. Complete the form, indicating a Display Name and Channel ID or Channel Name.

    • The Client ID, Client Secret, Signing Secret, and Bot OAuth Token are pre-filled based on your existing Slack Bot alert destination.

  5. Click Add Destination.

Additional Information on Destinations

For more information on alert routing order, modifying or deleting destinations, and workflow automation, please see the Panther docs: Destinations.

Last updated