Integration Details

ThreatQuotient provides the following details for this integration:

Introduction

The IBM X-Force Exchange Action Bundle enables the automatic enrichment of indicators within your Threat Library.

The integration provides the following actions:

• IBM X-Force Exchange Enrichment - fetches enrichment context such as tags, categories, and scores from the IBM X-Force Exchange API.
• IBM X-Force Exchange - Get Relation IOCs - fetches indicators associated with malware that are related to the input indicators.

The actions are compatible with the following indicator types:

• CVE
• FQDN
• IP Address
• IPv6 Address
• URL
• MD5
• SHA-1
• SHA-256

The actions return enriched indicators to the ThreatQ platform.  

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 following indicator types:
  • CVE
  • FQDN
  • IP Address
  • IPv6 Address
  • URL
  • MD5
  • SHA-1
  • SHA-256

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 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.

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 X-Force Exchange Enrichment Parameters

   Parameter	Description
   Authentication
   API Key	Enter your OAuth Client ID to authenticate with the ThreatVision API.
   API Password	Enter your API Secret to authenticate with the IBM X-Force API.
   IP Enrichment Options
   Context Enrichment	Select the pieces of context to ingest as part of the enrichment.  Options include: Tags (default) Categories (default) Score (default) Country Country Code Disposition Reason
   Minimum Score Threshold	Only ingest enrichment for indicators with a score greater than or equal to this value. Typically, uncategorized indicators will be scored a 1.  The default value is 2.
   Include Category Percentages	Include the percentage of each category in the enrichment.  This option is disabled by default.
   File Hash Enrichment Options
   Context Enrichment	Select the pieces of context you would like to ingest as part of the enrichment.  Options include: Tags (default) Risk (default) Malware Type (default) Malware Family (Attribute) (default) MIME Type Platform Community Coverage Last Seen First Seen
   Relationship Enrichment	Select the relationships you would like to ingest as part of the enrichment.  Options include:  Command and Control Domains (default) Command and Control IPs (default) Command and Control URLs (default) Download Server Domains Download Server IPs Download Server URLs
   Risk Filter	Only ingest enrichment for indicators with a risk within the selected values.  Options include: High (default) Medium (default) Low
   URL & FQDN Enrichment Options
   Context Enrichment	Select the pieces of context to ingest as part of the enrichment.  Options include:  Tags (default) Categories (default) Score (default) Associated Application
   Minimum Score Threshold	Only ingest enrichment for indicators with a score greater than or equal to this value.  The default value is 1.
   CVE Enrichment Options
   Context Enrichment	Select the pieces of context to ingest as part of the enrichment.  Options include:  Score (default) Vulnerability Title (default) Description (default) Affected Platforms (default) Temporal Score Remedy Consequences Exploitability External References Report Confidence
   CVSS Enrichment	Select the pieces of CVSS context to ingest as part of the enrichment. Options include:  Privileges Required User Interaction Access Vector Access Complexity Integrity Impact Availability Impact Remediation Level
   Minimum Score Threshold	Only ingest enrichment for CVEs with a score greater than or equal to this value.  The default value is 5.
   Workflow Options
   Objects Per Run	The number of objects to process per run of the workflow. The default value is 1000.

   
   

   IBM X-Force Exchange Get Related IOCs Parameters

   Parameter	Description
   Authentication
   API Key	Enter your OAuth Client ID to authenticate with the ThreatVision API.
   API Password	Enter your API Secret to authenticate with the IBM X-Force API.
   Enrichment Options
   Context Enrichment	Select the pieces of context to ingest as part of the enrichment.  Options include: Malware Family Last Seen First Seen
   Relationship Enrichment	Select the relationships to ingest as part of the enrichment.  Options include:   Domains (default) IPs (default) URLs (default) MD5 Hashes (default)
   WHOIS Enrichment	Select whether or not to ingest WHOIS information as part of the enrichment.
   Workflow Options
   Objects Per Run	The number of objects to process per run of the workflow. The default value is 1000.

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

Actions

The following actions are available:

{
  "ip": "209.197.3.8",
  "history": [
    {
      "created": "2012-03-22T07:26:00.000Z",
      "reason": "Regional Internet Registry",
      "geo": {
        "country": "United States",
        "countrycode": "US"
      },
      "ip": "209.197.0.0/19",
      "categoryDescriptions": {},
      "reasonDescription": "One of the five RIRs announced a (new) location mapping of the IP.",
      "score": 1,
      "cats": {}
    }
  ],
  "subnets": [
    {
      "created": "2012-03-22T07:26:00.000Z",
      "reason": "Regional Internet Registry",
      "geo": {
        "country": "United States",
        "countrycode": "US"
      },
      "ip": "209.197.0.0",
      "categoryDescriptions": {},
      "reasonDescription": "One of the five RIRs announced a (new) location mapping of the IP.",
      "score": 1,
      "cats": {},
      "subnet": "209.197.0.0/19"
    }
  ],
  "cats": {
    "Scanning IPs": 43
  },
  "geo": {
    "country": "United States",
    "countrycode": "US"
  },
  "score": 4.3,
  "reason": "Security analyst review",
  "reasonDescription": "Based on the review of an X-Force security analyst.",
  "categoryDescriptions": {
    "Scanning IPs": "These IPs have been identified as illegally scanning networks for vulnerabilities."
  },
  "tags": []
}

{
  "result": {
    "url": "pnc-bankwu.com",
    "cats": {
      "Early Warning": true
    },
    "score": 10,
    "categoryDescriptions": {
      "Early Warning": "This category contains potentially malicious domains identified by analysing DNS traffic."
    }
  },
  "tags": []
}

{
  "malware": {
    "origins": {
      "emails": {},
      "CnCServers": {
        "rows": [
          {
            "type": "CnC",
            "md5": "474B9CCF5AB9D72CA8A333889BBB34F0",
            "domain": "pc-guard.net",
            "firstseen": "2014-10-20T23:19:00Z",
            "lastseen": "2014-10-20T23:19:00Z",
            "ip": "61.255.239.86",
            "count": 483,
            "schema": "http",
            "filepath": "v.html",
            "origin": "CnC",
            "uri": "http://pc-guard.net/v.html"
          }
        ],
        "count": 1
      },
      "downloadServers": {},
      "subjects": {},
      "external": {
        "detectionCoverage": 44,
        "family": ["heuristic", "trojan"]
      }
    },
    "type": "md5",
    "md5": "0x474B9CCF5AB9D72CA8A333889BBB34F0",
    "hash": "0x474B9CCF5AB9D72CA8A333889BBB34F0",
    "created": "2014-10-20T23:19:00Z",
    "family": ["tsunami"],
    "familyMembers": {
      "tsunami": {
        "count": 61
      }
    },
    "risk": "high"
  },
  "tags": []
}

[
  {
    "type": "vulnerability",
    "xfdbid": 260217,
    "updateid": 171362,
    "updated": true,
    "variant": "single",
    "title": "Microsoft Windows and Microsoft Office code execution",
    "description": "Microsoft Windows and Microsoft Office could allow a remote attacker to execute arbitrary code on the system. By persuading a victim to open a specially crafted file, an attacker could exploit this vulnerability to execute arbitrary code on the system.",
    "risk_level": 8.3,
    "cvss": {
      "version": "3.0",
      "privilegesrequired": "None",
      "userinteraction": "Required",
      "scope": "Changed",
      "access_vector": "Network",
      "access_complexity": "High",
      "confidentiality_impact": "High",
      "integrity_impact": "High",
      "availability_impact": "High",
      "remediation_level": "Unavailable"
    },
    "temporal_score": 7.6,
    "remedy": "No remedy available as of July 11, 2023.",
    "remedy_fmt": "<p>No remedy available as of July 11, 2023.</p>",
    "reported": "2023-07-11T00:00:00Z",
    "tagname": "ms-windows-cve202336884-code-exec",
    "stdcode": ["CVE-2023-36884"],
    "platforms_affected": [
      "Microsoft Windows Server 2012",
      "Microsoft Windows Server 2012 R2"
    ],
    "exploitability": "Unproven",
    "consequences": "Gain Access",
    "references": [
      {
        "link_target": "https://msrc.microsoft.com/update-guide/vulnerability/CVE-2023-36884",
        "link_name": "Microsoft Security TechCenter - July 2023",
        "description": "Office and Windows HTML Remote Code Execution Vulnerability"
      }
    ],
    "report_confidence": "Confirmed",
    "uuid": "c31817e6ac25a2cd1598e8be5f3a1444"
  }
]

{
  "malware": [
    {
      "type": "WEB",
      "md5": "6865D47EEB5B85D949BDF5BD1BA27AC0",
      "domain": "160.16.58.163",
      "firstseen": "2022-03-31T22:25:00Z",
      "lastseen": "2022-03-31T22:25:00Z",
      "ip": "0x00000000000000000000ffffa0103aa3",
      "count": 1,
      "schema": "http",
      "filepath": "wp-content/.b/pty5",
      "uri": "http://160.16.58.163/wp-content/.b/pty5",
      "first": "2022-03-31T22:25:00Z",
      "last": "2022-03-31T22:25:00Z",
      "origin": "WEB",
      "family": ["gafgyt"]
    },
    {
      "type": "WEB",
      "md5": "582A434BA0F2E04BD8B5495C50320068",
      "domain": "160.16.58.163",
      "firstseen": "2022-03-31T22:25:00Z",
      "lastseen": "2022-03-31T22:25:00Z",
      "ip": "0x00000000000000000000ffffa0103aa3",
      "count": 1,
      "schema": "http",
      "filepath": "wp-content/.b/pty3",
      "uri": "http://160.16.58.163/wp-content/.b/pty3",
      "first": "2022-03-31T22:25:00Z",
      "last": "2022-03-31T22:25:00Z",
      "origin": "WEB",
      "family": ["gafgyt"]
    }
  ]
}

{
    "updatedDate": "2024-04-05T18:43:01.000Z",
    "contactEmail": "hm-changed@vnnic.vn",
    "registrarName": "APNIC",
    "netRange": "116.96.0.0 - 116.111.255.255",
    "contact": [
        {
            "type": "registrant",
            "name": "Viettel Group",
            "organization": "VIETTEL-VN",
            "country": "Vietnam"
        }
    ],
    "extended": {
        "updatedDate": "2024-04-05T18:43:01.000Z",
        "contactEmail": "hm-changed@vnnic.vn",
        "registrarName": "APNIC",
        "netRange": "116.96.0.0 - 116.111.255.255",
        "contact": [
            {
                "type": "registrant",
                "name": "Viettel Group",
                "organization": "VIETTEL-VN",
                "country": "Vietnam"
            }
        ]
    }
}
}

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 X-Force Exchange Enrichment

IBM X-Force Exchange Get Related IOCs

Known Issues / Limitations

• You will be limited to your IBM X-Force Exchange API rate limit.   Be aware of this rate limit and use the Objects Per Run parameter configuration accordingly.
• Related indicators are limited to a maximum number of 200.

Change Log

• Version 1.0.0
  • Initial release