ProofpointThreatResponseEventCollector

Details

ID	`ProofpointThreatResponseEventCollector`
Provider	Thoma Bravo
Category	Analytics & SIEM
From Version	6.8.0
Docker Image	`demisto/python3:3.12.13.10116658`
Supported Modules	Agentix XSIAM EDR Cortex Cloud Cloud Runtime Security

README

Use the Proofpoint Threat Response integration to orchestrate and automate incident response.

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

Configure Proofpoint Threat Response Event Collector in Cortex

Parameter	Description	Required
Server URL (e.g., https://192.168.0.1)		True
API Key for the authentication.		True
Trust any certificate (not secure)		False
Use system proxy settings		False
First fetch timestamp (<number> <time unit>, e.g., 12 hours, 7 days)	The time range for the initial data fetch. If timeout errors occur, consider changing this value.	False
Fetch limit - maximum number of incidents per fetch		False
Fetch delta - The delta time in each batch. e.g. 1 hour, 3 minutes.	The time range between create_after and created_before that is sent to the API when fetching older incidents. If timeout errors occur, consider changing this value.	False
Fetch incidents with specific event sources. Can be a list of comma-separated values.		False
Fetch incidents with specific ‘Abuse Disposition’ values. Can be a list of comma-separated values.		False
Fetch incident with specific states.		False
POST URL of the JSON alert source.	You can find this value by navigating to Sources -> JSON event source -> POST URL.	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.

proofpoint-trap-get-events

Retrieves all incident metadata from Threat Response by specifying filter criteria such as the state of the incident or time of closure.

Base Command

proofpoint-trap-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
state	The state of the incidents to retrieve. Possible values are: new, open, assigned, closed, ignored.	Optional
created_after	Retrieve incidents that were created after this date, in ISO 8601 format (UTC). Example: 2020-02-22 or 2020-02-22T00:00:00Z.	Optional
created_before	Retrieve incidents that were created before this date, in ISO 8601 format (UTC). Example: 2020-02-22 or 2020-02-22T00:00:00Z.	Optional
closed_after	Retrieve incidents that were closed after this date, in ISO 8601 format (UTC). Example: 2020-02-22 or 2020-02-22T00:00:00Z.	Optional
closed_before	Retrieve incidents that were closed before this date, in ISO 8601 format (UTC). Example: 2020-02-22 or 2020-02-22T00:00:00Z.	Optional
expand_events	If false, will return an array of event IDs instead of full event objects. This will significantly speed up the response time of the API for incidents with a large number of alerts. Possible values are: true, false.	Optional
limit	The maximum number of incidents to return. Default is 100.	Required

Context Output

There is no context output for this command.

Configuration parameters

url — Server URL (e.g., https://192.168.0.1) (required)
credentials — (required)
first_fetch — First fetch timestamp (<number> <time unit>, e.g., 12 hours, 7 days)
fetch_limit — Fetch limit - maximum number of incidents per fetch
fetch_delta — Fetch delta - The delta time in each batch. e.g., 1 hour, 3 minutes.
event_sources — Fetch incidents with specific event sources. Can be a list of comma-separated values.
abuse_disposition — Fetch incidents with specific 'Abuse Disposition' values. Can be a list of comma-separated values.
states — Fetch incident with specific states.
post_url_id — POST URL of the JSON alert source.
insecure — Trust any certificate (not secure)
proxy — Use system proxy settings

Commands (1)

proofpoint-trap-get-events
Retrieves all incident metadata from Threat Response by specifying filter criteria such as the state of the incident or time of closure.

Source

ProofpointThreatResponseEventCollector.py ProofpointThreatResponseEventCollector_test.py ProofpointThreatResponseEventCollector.yml ProofpointThreatResponseEventCollector_description.md

Download History Raw

To create the API Key, in the Proofpoint UI, go to:

  Settings > API Key > Add api key
  
**Note:** If the ***fetch-events*** command results in a timeout, 
consider changing *fetch_delta* and *fetch_limit* parameters to reduce the number of API calls and results.