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 
category: Analytics & SIEM
provider: Slack
sectionorder:
- Connect
- Collect
commonfields:
  id: Slack Event Collector
  version: -1
configuration:
- defaultvalue: https://api.slack.com/audit/v1/
  display: Server URL
  name: url
  type: 0
  required: true
  section: Connect
- display: ''
  displaypassword: User Token
  name: user_token
  type: 9
  required: true
  hiddenusername: true
  section: Connect
- display: Fetch Events
  name: isFetchEvents
  type: 8
  required: false
  section: Collect
- name: eventFetchInterval
  section: Collect
  display: Events Fetch Interval
  advanced: true
  defaultvalue: "1"
  type: 19
  required: false
- defaultvalue: 1000
  display: The maximum number of audit logs to fetch
  name: limit
  type: 0
  section: Collect
  required: false
- defaultvalue: '10 minutes ago'
  display: First fetch time interval
  name: oldest
  type: 0
  additionalinfo: Data is not available prior to March 2018.
  section: Collect
  required: false
- display: Trust any certificate (not secure)
  name: insecure
  type: 8
  additionalinfo:
  section: Connect
  advanced: true
  required: false
- display: Use system proxy settings
  name: proxy
  type: 8
  additionalinfo:
  section: Connect
  advanced: true
  required: false
description: Slack logs event collector integration for XSIAM.
display: Slack Event Collector
name: Slack Event Collector
script:
  commands:
  - arguments:
    - auto: PREDEFINED
      defaultValue: 'false'
      description: If true, the command will create events, otherwise it will only display them.
      name: should_push_events
      predefined:
      - 'true'
      - 'false'
      required: true
    - description: The maximum number of audit log events to return. The command collects events oldest-first and keeps fetching until this limit is reached.
      name: limit
      defaultValue: 10
      type: number
    - description: The occurrence time of the least recent audit event to include (inclusive), i.e. the date to fetch events from. Data is not available prior to March 2018. Accepted formats are ISO 8601 or relative time (e.g., "3 days").
      name: oldest
      defaultValue: 3 days
      type: date
    - description: The occurrence time of the most recent audit event to include (inclusive), i.e. the date to fetch events until. Accepted formats are ISO 8601 or relative time (e.g., "3 days").
      name: latest
      defaultValue: now
      type: date
    - description: Name of the action.
      name: action
    - description: ID of the user who initiated the action.
      name: actor
    - description: ID of the target entity of the action (such as a channel, workspace, organization, file).
      name: entity
    description: 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.
    name: slack-get-events
  script: '-'
  type: python
  subtype: python3
  isfetchevents: true
  dockerimage: demisto/python3:3.12.13.10116658
marketplaces:
- marketplacev2
- platform
supportedModules:
- xsiam
fromversion: 6.8.0
tests:
- No tests (auto formatted)