Skip to main content

Duo Event Collector

This Integration is part of the DUO Admin Pack.#

Supported versions

Supported Cortex XSOAR versions: 6.8.0 and later.

Collects Auth and Audit events for Duo using the API.

Configure Duo Event Collector on Cortex XSOAR#

  1. Navigate to Settings > Integrations > Servers & Services.

  2. Search for Duo Event Collector.

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

    ParameterDescriptionRequired
    Server HostThe URL for the API.True
    First fetch timestampsThe first time fetch date range, for example: 2 days, 1 month, 3 years.True
    Integration keyThe integration key for the admin API from Duo.True
    Secret keyThe secret key for the admin API from Duo.True
    XSIAM request limitThe maximum number of events to collect from the API in each cycle.True
    Request retriesThe number of times to retry a failed too many requests 429 HTTP error.False
    Use system proxy settingsEnable proxy support for running the collector.False
    logs_type_arrayThe type of APIs that this instance will use in the collector.False
  4. Click Test to validate the URLs, token, and connection.

Commands#

You can execute these commands from the Cortex XSOAR 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.

duo-get-events#


Manual command to fetch events and display them.

Base Command#

duo-get-events

Input#

Argument NameDescriptionRequired
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

Known Limitations and recommended configuration#

  • As suggested by the DUO ADMIN API documentation "We recommend requesting logs no more than once per minute".
  • Recomended fetch time interval 1 minute and limit of up to 1000 per fetch.
  • The returned logs are available ranging from the last 180 days up to as recently as two minutes before the API request.

Context Output#

There is no context output for this command.