Integration Details

ThreatQuotient provides the following details for this integration:

Introduction

The Elastic Action integration enriches indicators with information found in Elastic Security.

Elastic Security unifies SIEM, endpoint security, and cloud security on an open platform.  This allows SecOps teams to protect, detect, and respond at scale. These analytical and protection capabilities, leveraged by the speed and extensibility of Elasticsearch, enable analysts to defend their organization from threats before damage and loss occur.

The integration provides the following action:

• Elastic Enrich Indicators - executes an Elastic search query and retrieves the hits that match the query.

The action is compatible with the following object types:

• Assets
• Indicators

The action returns the following enriched system objects:

• Assets
• Indicators

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 data collection containing at least one of the the following object types:
  • Asset
  • Indicator

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

   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.

You will still need to configure the action.

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.

   Parameter	Description
   Elastic Instance	The URL to the Elastic instance to connect to (http<s>://<hostname>:<port>).
   Username	Enter a username to authenticate with your Elastic instance.
   Password	Enter the password associated with the entered username.
   Verify SSL	Enable this to verify the host's SSL certificate.
   Context Filter	Select the pieces of enrichment context you want to ingest into ThreatQ.  Options include: Agent Name Agent Type Event Module Event Action Event Category Event Type Elastic Host ID Elastic Host MAC Address Architecture Operating System Network Direction Network Type Cloud Instance Name Cloud Machine Type Cloud Service Name Cloud Availability Zone Cloud Provide
   Custom Attributes	Enter a comma-separated list of Elastic fields to ingest as attributes if they exist. (e.g process.name, host.os.platform)
   IP Address Search Query	Enter a search query to use when searching for IP Addresses. Use % as a placeholder for the IP Address.
   FQDN Search Query	Enter a search query to use when searching for FQDNs. Use % as a placeholder for the FQDN.
   URL Search Query	Enter a search query to use when searching for URLs. Use % as a placeholder for the URL.
   MD5 Search Query	Enter a search query to use when searching for MD5. Use % as a placeholder for the MD5.
   SHA-1 Search Query	Enter a search query to use when searching for SHA-1. Use % as a placeholder for the SHA-1.
   SHA-256 Search Query	Enter a search query to use when searching for SHA-256. Use % as a placeholder for the SHA-256.
   SHA-384 Search Query	Enter a search query to use when searching for SHA-384. Use % as a placeholder for the SHA-384.
   SHA-512 Search Query	Enter a search query to use when searching for SHA-512. Use % as a placeholder for the SHA-512.
   Search Query Start Date (YYYY-MM-DD HH:MM:SS)	Optional - Search only for entries added after a specific date. Use the format YYYY-MM-DD HH:MM:SS (e.g. 2023-07-17 00:00:00)
   Search Query End Date (YYYY-MM-DD HH:MM:SS)	Optional - Search only for entries added before a specific date. Use the format YYYY-MM-DD HH:MM:SS (e.g. 2023-07-18 00:00:00)

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

Actions

The following action is available:

  "took": 113,
  "timed_out": false,
  "_shards": {
    "total": 36,
    "successful": 36,
    "skipped": 0,
    "failed": 0
  },
  "hits": {
    "total": {
      "value": 1,
      "relation": "eq"
    },
    "max_score": null,
    "hits": [
      {
        "_index": ".ds-auditbeat-8.10.2-2023.11.30-000001",
        "_id": "3UIDfYwB7RuHjy-IBr4h",
        "_score": null,
        "_source": {
          "@timestamp": "2023-12-18T12:59:58.207Z",
          "agent": {
            "ephemeral_id": "4757edc4-7ec4-4954-93f6-10cda0905ad0",
            "id": "d9f71a78-927a-4583-8aca-cc727d3bc933",
            "name": "elk.tis.threatq.local",
            "type": "auditbeat",
            "version": "8.10.2"
          },
          "event": {
            "start": "2023-12-18T12:59:28.004Z",
            "end": "2023-12-18T12:59:28.004Z",
            "module": "system",
            "kind": "event",
            "action": "network_flow",
            "category": [
              "network"
            ],
            "dataset": "socket",
            "type": [
              "info",
              "connection"
            ],
            "duration": 20467
          },
          "flow": {
            "final": true,
            "complete": false
          },
          "client": {
            "port": 57200,
            "packets": 1,
            "bytes": 32,
            "ip": "10.114.0.243"
          },
          "related": {
            "ip": [
              "10.114.1.145",
              "10.114.0.243"
            ]
          },
          "service": {
            "type": "system"
          },
          "ecs": {
            "version": "8.0.0"
          },
          "host": {
            "id": "86b8f15024004e2cb5c8746ff57dcfc5",
            "containerized": false,
            "ip": [
              "10.114.1.145",
              "fe80::f816:3eff:fea6:dc6f"
            ],
            "mac": [
              "FA-16-3E-A6-DC-6F"
            ],
            "hostname": "elk.tis.threatq.local",
            "architecture": "x86_64",
            "os": {
              "platform": "ubuntu",
              "version": "22.04.3 LTS (Jammy Jellyfish)",
              "family": "debian",
              "name": "Ubuntu",
              "kernel": "5.15.0-84-generic",
              "codename": "jammy",
              "type": "linux"
            },
            "name": "elk.tis.threatq.local"
          },
          "network": {
            "direction": "unknown",
            "type": "ipv4",
            "transport": "tcp",
            "packets": 2,
            "bytes": 84,
            "community_id": "1:ybaELx9TIlP1rHQ/mbqlc/4uw+w="
          },
          "destination": {
            "ip": "10.114.1.145",
            "port": 9200,
            "packets": 1,
            "bytes": 52
          },
          "server": {
            "ip": "10.114.1.145",
            "port": 9200,
            "packets": 1,
            "bytes": 52
          },
          "system": {
            "audit": {
              "socket": {
                "kernel_sock_address": "0xffff9b19f21fe880"
              }
            }
          },
          "cloud": {
            "instance": {
              "id": "i-00000bb4",
              "name": "ladams-ubuntu"
            },
            "machine": {
              "type": "support.m4"
            },
            "availability_zone": "nova",
            "service": {
              "name": "Nova"
            },
            "provider": "openstack"
          },
          "source": {
            "ip": "10.114.0.243",
            "port": 57200,
            "packets": 1,
            "bytes": 32
          }
        },
        "sort": [
          1702904398207
        ]
      }
    ]
  }

Change Log

• Version 1.0.0
  • Initial release