Skip to main content

ReliaQuest GreyMatter DRP Event Collector

This Integration is part of the ReliaQuest GreyMatter DRP Incidents Pack.#

Supported versions

Supported Cortex XSOAR versions: 8.0.0 and later.

ReliaQuest GreyMatter DRP Event Collector minimizes digital risk by identifying unwanted exposure and protecting against external threats. The award-winning SearchLight solution provides ongoing monitoring of a customer's unique assets and exposure across the open, deep, and dark web. This enables clients to detect data loss, brand impersonation, infrastructure risks, cyber threats, and much more.

This integration fetches event items which can be either incident/alerts, for more information refer here

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

Configure ReliaQuest GreyMatter DRP Event Collector On XSIAM#

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

  2. Search for Relia Quest GreyMatter DRP Event Collector.

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

    ParameterDescriptionRequired
    Server URLURL for the Relia Quest API instance.True
    Account IDThe account ID for the Reila Quest instance.True
    Maximum number of events per fetchThe maximum number of events to fetch every time fetch is executed. Default is 1000.True
    Trust any certificate (not secure)False
    Use system proxy settingsFalse
    UsernameThe username to authenticate Relia Quest Event Collector.False
    PasswordThe password to authenticate Relia Quest Event CollectorFalse
  4. Click Test to validate the URLs, token, and connection.

ReliaQuest GreyMatter DRP EventCollector Authentication#

Requests to all operation endpoints require HTTP Basic authentication, using dedicated (high entropy) API credentials. These normally consist of a six character key, and a 32 character 'secret'. Note that you will not be able to use your normal email/password login details with the HTTP Basic authentication mechanism.

Contact your Digital Shadows representative to obtain API credentials.

To authenticate the integration, you must have a username, password and account ID. To get the account ID, see here.

Limitations#

Increasing the Maximum number of events per fetch parameter to high numbers can cause rate-limits, however The integration will recover from those rate-limits automatically. For more information about rate-limits, see here.

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.

relia-quest-get-events#


Manual command to fetch reila-quest events and display them.

Base Command#

relia-quest-get-events

Input#

Argument NameDescriptionRequired
start_timeFrom which time to get the events in ISO8601 format, for example 2020-09-24T16:30:10.016Z or (<number> <time unit>, e.g., 12 hours, 7 days). If not provided, will retrieve the oldest events available in case event_num_after argument is not provided. Default is 3 days ago.Optional
end_timeUntil which time to get the events in ISO8601 format, for example 2020-09-24T16:30:10.016Z or (<number> <time unit>, e.g., 12 hours, 7 days).Optional
limitThe maximum number of events to retrieve. Default is 200.Optional
event_num_afterFetch events that were created after a specific event-number.Optional

Context Output#

PathTypeDescription
ReilaQuest.EventsUnknownA list of events.