Integration Details

ThreatQuotient provides the following details for this integration:

Introduction

The IBM QRadar Action Bundle for ThreatQ enables analysts to seamlessly integrate and enrich threat intelligence data with insights from IBM QRadar. This bundle allows users to query QRadar for additional context on Indicators of Compromise (IOCs) and incorporate relevant event information into ThreatQ.

The integration provides the following actions:

• IBM QRadar Action - performs a lookup within QRadar to find logs related to an indicator.
• IBM QRadar Get Description For Events - requests and ingests IBM QRadar Offense Analyst Notes as descriptions for the events previously retrieved by the IBM QRadar Action.

The action is compatible with the following object types:

• Events
• Indicators
  • Email Address
  • FQDN
  • IP Address
  • URL

The action returns enriched indicator and event object types. 

This action is intended for use with ThreatQ TDR Orchestrator (TQO). An active TQO license is required for this feature.

Prerequisites

• An active ThreatQ TDR Orchestrator (TQO) license.
• A QRadar Host and SEC Token
• A data collection containing at least one of the following object types:
  • Events
  • Indicators
    • Email Address
    • FQDN
    • IP Address
    • URL

Installation

Perform the following steps to install the integration:

The same steps can be used to upgrade the integration to a new version.

1. Log into https://marketplace.threatq.com/.
2. Locate and download the action zip file.
3. Navigate to the integrations management page on your ThreatQ instance.
4. Click on the Add New Integration button.
5. Upload the action zip file using one of the following methods:
   • Drag and drop the zip file into the dialog box
   • Select Click to Browse to locate the zip file on your local machine
6. Select the actions to install, when prompted, and then click on Install.

   ThreatQ will inform you if the action already exists on the platform and will require user confirmation before proceeding. ThreatQ will also inform you if the new version of the action contains changes to the user configuration. The new user configurations will overwrite the existing ones for the action and will require user confirmation before proceeding.

The action(s) will now be installed. You will still need to configure the action(s).

Configuration

ThreatQuotient does not issue API keys for third-party vendors. Contact the specific vendor to obtain API keys and other integration-related credentials.
 

To configure the integration:

1. Navigate to your integrations management page in ThreatQ.
2. Select the Actions option from the Category dropdown (optional).
3. Click on the action entry to open its details page.
4. Enter the following parameters under the Configuration tab:

   The configurations set on this page will be used as the default settings when inserting this action into a new workflow. Updating the configurations on this page will not update any instances of this action that have already been deployed to a workflow. In that scenario, you must update the action’s configurations within the workflow itself.

   IBM QRadar Action Parameters Table

   Parameter	Description
   IBM QRadar Host	The host (with scheme) to the QRadar instance to run the operation against.
   IBM QRadar SEC Token	The Authorized service token from the QRadar instance.
   Days to Search	Number of previous days QRadar will search for events that match an indicator.
   Record Limit	Limits the number of records fetched.
   First Results	If enabled, the results are sorted ascending (earliest).
   Enable SSL Certificate Verification	Enable this parameter if the action should validate the host-provided SSL certificate.
   Disable Proxies	Enable this parameter if the action should not honor proxies set in the ThreatQ UI.
   Objects Per Run	The max number of objects to send to this action, per run.

   
   

   IBM QRadar Get Description for Events Parameters Table

   Parameter	Description
   IBM QRadar Host	The host (with scheme) to the QRadar instance to run the operation against.
   IBM QRadar SEC Token	The Authorized service token from the QRadar instance.
   Enable SSL Certificate Verification	Enable this parameter if the action should validate the host-provided SSL certificate.
   Disable Proxies	Enable this parameter if the action should not honor proxies set in the ThreatQ UI.
   Objects Per Run	The max number of objects to send to this action, per run.

   
   
5. Review any additional settings, make any changes if needed, and click on Save.

Actions

The following actions are available:

{
    "cursor_id": "a4a5781f-b88d-4108-91c3-4d724d9675be",
    "status": "WAIT",
    "compressed_data_file_count": 0,
    "compressed_data_total_size": 0,
    "data_file_count": 0,
    "data_total_size": 0,
    "index_file_count": 0,
    "index_total_size": 0,
    "processed_record_count": 0,
    "desired_retention_time_msec": 86400000,
    "progress": 0,
    "progress_details": [],
    "query_execution_time": 0,
    "query_string": "SELECT LOGSOURCENAME(logsourceid), * FROM events   WHERE sourceip = '10.114.3.34' OR destinationip = '10.114.3.34'  ORDER BY starttime DESC LIMIT 0 LAST 1 DAYS",
    "record_count": 0,
    "size_on_disk": 0,
    "save_results": false,
    "completed": false,
    "subsearch_ids": [],
    "snapshot": null,
    "search_id": "a4a5781f-b88d-4108-91c3-4d724d9675be"
}

{
  "events": [
    {
      "logsourcename_logsourceid": "Health Metrics-2 :: qradar75",
      "starttime": 1720263000505,
      "protocolid": 255,
      "sourceip": "10.114.3.34",
      "logsourceid": 69,
      "qid": 94000001,
      "sourceport": 0,
      "eventcount": 1,
      "magnitude": 5,
      "identityip": "0.0.0.0",
      "destinationip": "127.0.0.1",
      "destinationport": 0,
      "category": 8052,
      "username": null
    },
    {
      "logsourcename_logsourceid": "Health Metrics-2 :: qradar75",
      "starttime": 1720263000505,
      "protocolid": 255,
      "sourceip": "10.114.3.34",
      "logsourceid": 69,
      "qid": 94000001,
      "sourceport": 0,
      "eventcount": 1,
      "magnitude": 5,
      "identityip": "0.0.0.0",
      "destinationip": "127.0.0.1",
      "destinationport": 0,
      "category": 8052,
      "username": null
    }
  ]
}

[
    {
        "event_flow_count": 53290499,
        "local_destination_address_ids": [],
        "first_event_flow_seen": 1761059057046,
        "last_event_flow_seen": 1761560576819,
        "source_ip": "10.114.3.161",
        "magnitude": 0,
        "id": 18,
        "offense_ids": [
            10,
            11
        ],
        "domain_id": 1,
        "network": "other"
    }
]

[
    {
        "note_text": "This is a note for destination IP 10.114.3.161 - Should go to TQ Description as well",
        "create_time": 1761193541394,
        "id": 52,
        "username": "admin"
    }
]

Enriched Data

Object counts and action runtime are supplied as generalities only - objects returned by a provider can differ based on credential configurations and action runtime may vary based on system resources and load.

IBM QRadar Action

IBM QRadar Get Description for Events

Use Case Example

IBM QRadar Action

1. A Threat Analyst identifies a collection of supported objects he/she would like to enrich.
2. The Threat Analyst adds the IBM QRadar Action to a Workflow.
3. The Threat Analyst configures the action with the desired parameters, and enables the Workflow.
4. The Workflow executes all Actions in the graph, including IBM QRadar.
5. The Workflow enriches the objects with IBM QRadar data.

IBM QRadar Get Description for Events

1. A threat Analyst identifies a collection of events ingested by the IBM QRadar Action and sends it to IBM QRadar to retrieve related Offenses Analyst Notes and ingest them as event description.
2. The Threat Analyst adds the IBM QRadar Action to a Workflow and configures it with desired parameters.
3. The Workflow will take the IBM QRadar Search ID attribute from each event and request the offenses notes related to the provided source IP.
4. The workflow processes the Analyst Notes and enriches the events setting them as description.

Known Issues / Limitations

• The IBM QRadar Action has three different scenarios depending on the attributes of the object:

  1. The action runs and searches for IBM QRadar Search ID and IBM QRadar Search Status attributes. If not present, create a new search and add those attributes to the Indicator.

  2. The IBM QRadar Search ID and IBM QRadar Search Status attributes are present but IBM QRadar Search Status is different from COMPLETE. Recheck the status of the search.

  3. The IBM QRadar Search ID and IBM QRadar Search Status attributes are present and IBM QRadar Search Status is COMPLETE. The search is complete and fetches the results. If there's a result, an event will be created. The IBM QRadar Search ID and IBM QRadar Search Status attributes are deleted.

• Before rerunning the action, ensure that adequate time has been provided for the database to complete all value updates.

Change Log

• Version 1.1.0
  • Resolved an issue where incomplete searches left Indicators with temporary IBM QRadar Search ID attributes that resulted in 404 errors.
  • Resloved an issue where temporary attributes (IBM QRadar Search Status and IBM QRadar Search ID) were not removed upon search completion.
  • Added a new action: IBM QRadar Get Description for Events. This action enables the ingestion of IBM QRadar Analyst Notes into events retrieved by the IBM QRadar Action function.
  • Renamed the integration to the IBM Radar Action Bundle. 
• Version 1.0.0
  • Initial release