Slack Event Collector

Slack logs event collector integration for XSIAM.

Analytics & SIEM · Slack

Details

IDSlack Event Collector
ProviderSlack
CategoryAnalytics & SIEM
From Version6.8.0
Docker Imagedemisto/python3:3.12.13.10116658
Supported ModulesAgentix Cortex Cloud Cloud Runtime Security Cloud Posture Security XSIAM EDR

README

Slack logs event collector integration for XSIAM.
This integration was integrated and tested with version v1 of Slack Audit Logs API.

This is the default integration for this content pack when configured by the Data Onboarder in Cortex XSIAM.

Configure Slack Event Collector in Cortex

Parameter Description Required
Server URL   True
User Token   True
The maximum number of audit logs to fetch   False
First fetch time interval Data is not available prior to March 2018. False
Trust any certificate (not secure)   False
Use system proxy settings   False

Commands

You can execute these commands from the CLI, as part of an automation, or in a playbook.
After you successfully execute a command, a DBot message appears in the War Room with the command details.

slack-get-events

Gets audit log events from Slack.

Base Command

slack-get-events

Input

Argument Name Description Required
should_push_events If true, the command will create events, otherwise it will only display them. Possible values are: true, false. Default is false. Required
limit Number of results to return, maximum is 9999. Default is 10. Optional
oldest Occurrence time of the least recent audit event to include (inclusive). Data is not available prior to March 2018. Default is 3 days. Optional
latest Occurrence time of the most recent audit event to include (inclusive). Optional
action Name of the action. Optional
actor ID of the user who initiated the action. Optional
entity ID of the target entity of the action (such as a channel, workspace, organization, file). Optional

Context Output

There is no context output for this command.

Command Example

!slack-get-events action=user_login oldest="15 months ago" limit=1

Context Example

{
    "SlackEvents": [
      {
         "id":"0123a45b-6c7d-8900-e12f-3456789gh0i1",
         "date_create":1521214343,
         "action":"user_login",
         "actor":{
            "type":"user",
            "user":{
               "id":"W123AB456",
               "name":"Charlie Parker",
               "email":"bird@slack.com"
            }
         },
         "entity":{
            "type":"user",
            "user":{
               "id":"W123AB456",
               "name":"Charlie Parker",
               "email":"bird@slack.com"
            }
         },
         "context":{
            "location":{
               "type":"enterprise",
               "id":"E1701NCCA",
               "name":"Birdland",
               "domain":"birdland"
            },
            "ua":"Mozilla\/5.0 (Macintosh; Intel Mac OS X 10_12_6) AppleWebKit\/537.36 (KHTML, like Gecko) Chrome\/64.0.3282.186 Safari\/537.36",
            "session_id": "847288190092",
            "ip_address":"1.23.45.678"
        }
      }
    ]
}

Human Readable Output

Slack Audit Logs

action actor context date_create entity id
user_login type: user
user: {“id”: “W123AB456”, “name”: “Charlie Parker”, “email”: “bird@slack.com”}		 location: {“type”: “enterprise”, “id”: “E1701NCCA”, “name”: “Birdland”, “domain”: “birdland”}
ua: Mozilla\/5.0 (Macintosh; Intel Mac OS X 10_12_6) AppleWebKit\/537.36 (KHTML, like Gecko) Chrome\/64.0.3282.186 Safari\/537.36
session_id: 847288190092
ip_address: 1.23.45.678		 1970-01-18 14:33:34 type: user
user: {“id”: “W123AB456”, “name”: “Charlie Parker”, “email”: “bird@slack.com”}		 0123a45b-6c7d-8900-e12f-3456789gh0i2

Configuration parameters

  • url — Server URL (required)
  • user_token — (required)
  • isFetchEvents — Fetch Events
  • eventFetchInterval — Events Fetch Interval
  • limit — The maximum number of audit logs to fetch
  • oldest — First fetch time interval
  • insecure — Trust any certificate (not secure)
  • proxy — Use system proxy settings

Commands (1)

  • slack-get-events

    Gets audit log events from Slack. Use this command for development and debugging only, as it may produce duplicate events, exceed API rate limits, or disrupt the fetch mechanism.

Source

SlackEventCollector.py SlackEventCollector_test.py SlackEventCollector.yml SlackEventCollector_description.md command_examples.txt
Download History Raw 
Audit Logs API is only available to Slack workspaces on an Enterprise Grid plan, meaning, this Integration will *not* work for workspaces on a Free, Standard, or Business+ plan. For more information about the Audit Logs API, visit the [Slack API Documentation](https://api.slack.com/admins/audit-logs).

To configure an instance of Slack Event Collector, a Slack **User Token** with the `auditlogs:read` permissions must be obtained.

### Obtain a User Token
**Important**: The following steps must be done by the **Owner** of the Enterprise Grid organization.
1. Create a Slack app [here](https://api.slack.com/apps?new_app=1). By clicking the **Create App** button, you will be redirected to its settings page.
2. Using the left navigation bar, go to **OAuth & Permissions**.
   Scroll down to the **Scopes** section and add the `auditlogs:read` User Token Scope to your app.
3. Using the left navigation bar, go to **Manage Distribution**.
   * **Activate Public Distribution** by make sure all sections under **Share Your App with Other Workspaces** have the green check. Then click the **Activate Public Distribution** button.
   * Under the **Share Your App with Your Workspace** section, copy the **Sharable URL** and paste it into a browser to initiate the OAuth handshake that will install the app on your organization.
   * **Check the dropdown in the upper right of the installation page to make sure you are installing the app on the Enterprise Grid organization, not an individual workspace within the organization.**
4. Once your app completes the OAuth flow, you will be granted an OAuth token that can be used for calling all of the Audit Logs API methods for your organization. The token should start with `xoxp-`.