Darktrace Event Collector
Use this integration to fetch model breaches from Darktrace as events in XSIAM.
Analytics & SIEM · Darktrace
Details
| ID | Darktrace Event Collector |
|---|---|
| Provider | Thoma Bravo |
| Category | Analytics & SIEM |
| From Version | 6.9.0 |
| Docker Image | demisto/python3:3.12.13.10116658 |
| Supported Modules | Agentix XSIAM |
README
Use this integration to fetch a list of model breaches, filtered by the specified parameters. This is important for organizations that wish to integrate Darktrace programmatically into their SOC environment.
The integration was integrated and tested with version v5.2 API of Darktrace.
This is the default integration for this content pack when configured by the Data Onboarder in Cortex XSIAM.
Configure Darktrace Event Collector in Cortex
| Parameter | Description | Required |
|---|---|---|
| Server URL (e.g. https://example.cloud.darktrace.com) | REST API Endpoint of Darktrace server. | True |
| Trust any certificate (not secure) | False | |
| Use system proxy settings | False | |
| Public API Token | Public token obtained by creating an API token pair on the /config configuration page. | True |
| Private API Token | Private token obtained by creating an API token pair on the /config configuration page. | True |
| Max events per fetch | Maximum number of Darktrace model breaches to fetch at a time. | False |
| First fetch timestamp (<number> <time unit>, e.g., 12 hours, 7 days) | Time to start fetching the first incidents. Limited to 1 Year. | 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.
darktrace-get-events
Gets events from Darktrace Event Collector.
Base Command
darktrace-get-events
Input
| Argument Name | Description | Required |
|---|---|---|
| limit | The number of events to return. Default is 10. | Optional |
| start_time | The start time by which to filter events. Date format will be the same as in the first_fetch parameter. | Optional |
| end_time | The end time by which to filter events. | Optional |
| should_push_events | Set this argument to True in order to create events, otherwise the command will only display them. Possible values are: true, false. Default is false. | Required |
Context Output
There is no context output for this command.
Configuration parameters
base_url— Server URL (e.g., https://example.cloud.darktrace.com) (required)insecure— Trust any certificate (not secure)proxy— Use system proxy settingspublic_creds— (required)private_creds— (required)max_fetch— Max events per fetchfirst_fetch— First fetch timestamp (<number> <time unit>, e.g., 12 hours, 7 days)
Commands (1)
-
darktrace-get-eventsGets events from Darktrace.