Skip to main content

Darktrace Event Collector

This Integration is part of the Darktrace Pack.#

Supported versions

Supported Cortex XSOAR versions: 6.9.0 and later.

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 on Cortex XSIAM#

  1. Navigate to Settings > Configurations > Data Collection > Automations & Feed Integrations.

  2. Search for Darktrace Event Collector.

  3. Click Add instance to create and configure a new integration instance.

    ParameterDescriptionRequired
    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 settingsFalse
    Public API TokenPublic token obtained by creating an API token pair on the /config configuration page.True
    Private API TokenPrivate token obtained by creating an API token pair on the /config configuration page.True
    Max events per fetchMaximum 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
  4. Click Test to validate the URLs, token, and connection.

Commands#

You can execute these commands from the Cortex XSIAM 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 NameDescriptionRequired
limitThe number of events to return. Default is 10.Optional
start_timeThe start time by which to filter events. Date format will be the same as in the first_fetch parameter.Optional
end_timeThe end time by which to filter events.Optional
should_push_eventsSet 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.