Integration Details

ThreatQuotient provides the following details for this integration:

Introduction

The TeamT5 ThreatVision Action Bundle enables the automatic extraction of FQDNs (or IP Addresses) from URLs within your Threat Library.

The integration provides the following actions:

• TeamT5 ThreatVision - ITM Enrichment - uses the TeamT5 ThreatVision's ITM API to fetch enrichment for network indicators (IPs & Domains).
• TeamT5 ThreatVision - Sample Enrichment - uses the TeamT5 ThreatVision's Sample API to fetch enrichment for file indicators (MD5, SHA1, SHA256).

The action is compatible with the following indicator types:

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

The action returns the following enriched indicator types:

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

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

Prerequisites

• A ThreatVision License & API Keys

  ThreatVision API Keys can be generated from My Account -> API in the ThreatVision Portal.

• An active ThreatQ TDR Orchestrator (TQO) license.
• A data collection containing the following indicator types:
  • IP Address
  • FQDN
  • 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

   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.

   ITM Enrichment

   Parameter	Description
   Client ID	Enter your OAuth Client ID to authenticate with the ThreatVision API.
   Client Secret	Enter your OAuth Client Secret to authenticate with the ThreatVision API.
   Wait for Analysis Results	If ThreatVision does not know of the given IOC, wait for the IOC to be analyzed and return the results. The wait time is 20 seconds.  This parameter is enabled by default.
   Risk Score Threshold	Enter a number representing the minimum risk score threshold to ingest enrichment for a given IOC. The default value is 50.
   Additional Enrichment	Select the additional pieces of enrichment you want to ingest into ThreatQ.  As of this publication, Related Samples is only option available.  Each selection will result in additional API calls.
   Context Filter	Select the pieces of enrichment context you want to ingest into ThreatQ.  Options include: Risk Score (default) Risk Types (default) Location Related Adversaries (default) Labels (default)
   Sample Context Filter	Select the pieces of enrichment context you want to ingest into ThreatQ with the related Samples.  Options include: MD5 (default) SHA-256 (default) Filename Related Malware (default) Risk Level (default) ThreatVision Link
   Enable SSL Verification	Enable this for the action to validate the host-provided SSL certificate.
   Disable Proxies	Enable this option if the action should not honor proxies set in the ThreatQ UI.
   Objects Per Run	The number of objects to process per run of the workflow.   The default value is 10000.

   
   

   Sample Enrichment

   Parameter	Description
   Client ID	Enter your OAuth Client ID to authenticate with the ThreatVision API.
   Client Secret	Enter your OAuth Client Secret to authenticate with the ThreatVision API.
   Risk Level Filter	Select the risk levels for samples you want to ingest into ThreatQ.  Options include: Unknown Undetected Low Medium (default) High (default)
   Context Filter	Select the pieces of enrichment context you want to ingest into ThreatQ.  Options include: Risk Level (default) Related Adversaries (default) Malware Family (Attribute) (default) File Type (default) First Seen ThreatVision Link
   Sample Aliases	Select which sample aliases you want to ingest into ThreatQ. Options include: MD5 SHA-256 SHA-1 Filename File Path
   Context Filter (VirusTotal)	Select the pieces of VirusTotal context you want to ingest into ThreatQ.  Options include: Tags (default) Detection Rate (default) In-the-Wild URLs (default) In-the-Wild Filenames & File Paths (default)
   Malicious Count Threshold (VirusTotal)	Enter the number of malicious detections required to mark a sample with a "Malicious" attribute. Enter 0 to disable. The default value is 10.
   IOC Status (VirusTotal)	Select the status to assign to VirusTotal IOCs.  Options include: Review (default) Active Indirect
   Context Filter (Cuckoo)	Select the pieces of Cuckoo Sandbox context you want to ingest into ThreatQ.  Options include: Network IOCs (IPs & FQDNs)  Mutexes
   IOC Status (Cuckoo)	Select the status to assign to Cuckoo Sandbox IOCs. Options include: (default: Review) Review (default) Active Indirect
   Enable SSL Verification	Enable this for the action to validate the host-provided SSL certificate.
   Disable Proxies	Enable this option if the action should not honor proxies set in the ThreatQ UI.
   Objects Per Run	The number of objects to process per run of the workflow.  The default value is 10000.

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

Actions

The following actions are available:

{
  "success": true,
  "analysis_status": true,
  "risk_score": 5,
  "adversaries": [],
  "attributes": [
    {
      "name": "Malware C2",
      "first_seen": "2022-12-15T15:34:06.071Z",
      "last_seen": "2023-04-14T05:54:22.454Z"
    }
  ],
  "risk_types": [
    "other"
  ],
  "ip_sharing": [
    {
      "name": "Hosting",
      "first_seen": "2023-08-29T11:42:27.576Z",
      "last_seen": "2023-08-29T11:42:27.576Z"
    }
  ],
  "services": [],
  "location": "West Chicago, United States of America",
  "summary": {
    "whois": true,
    "related_adversaries": 0,
    "related_reports": 0,
    "related_samples": 0,
    "dns_records": 7,
    "osint": 0
  }
}

{
    "success": true,
    "sample": {
        "sha256": "755a4b2ec15da6bb01248b2dfbad206c340ba937eae9c35f04f6cedfe5e99d63",
        "md5": "cba74e507e9741740d251b1fb34a1874",
        "sha1": "56ee57de81ecea6a2c83d5430238fa98a041e8eb",
        "crc32": "984C2375",
        "tlshash": "62752331b142443bc0a209785947a3b6b636fb081b3c69df73dd58acc93735a2a663d9",
        "ssdeep": "24576:pAT8QE+kzjj/IxaSyRBCy6qqY1da7ZE+3BxNERNR700TVQtJmQtWadWPMmuioG5:pAI+M/IaSueDYOmilISMasPMmuLG5",
        "risk_level": "middle",
        "adversaries": [],
        "malwares": [],
        "file_type": "Win32 EXE",
        "size": 1580101,
        "tlp": "green",
        "first_seen": 1599480594,
        "meta_timestamp": 708992537,
        "auto_analysis": {
            "cuckoo": {
                "last_succeed_at": 1599481494
            },
            "vt_hunt": {
                "last_succeed_at": 1676469410
            },
            "vt_info": {
                "last_succeed_at": 1660301165
            },
            "filetype": {
                "last_succeed_at": 1676472007
            },
            "file_hash": {
                "last_succeed_at": 1676471995
            },
            "pe_file": {
                "last_succeed_at": 1676472022
            },
            "yara_scan": {
                "last_succeed_at": 1676472021
            },
            "exiftool": {
                "last_succeed_at": 1676472022
            }
        },
        "related_samples": [
            {
                "sha256": "05ff897f430fec0ac17f14c89181c76961993506e5875f2987e9ead13bec58c2",
                "md5": "0b4ad1bd093e0a2eb8968e308e900180",
                "file_type": "WIN32_EXE",
                "file_name": null,
                "relations": "Drops",
                "first_seen": 1569479863,
                "url": "https://api.threatvision.org/samples/05ff897f430fec0ac17f14c89181c76961993506e5875f2987e9ead13bec58c2"
            }
        ],
        "virus_total": {
            "file_type": null,
            "tags": [
                "peexe",
                "overlay",
                "bobsoft",
                "runtime-modules",
                "detect-debug-environment",
                "direct-cpu-clock-access",
                "checks-user-input"
            ],
            "itw_urls": [
                "http://83.149.110.52/dzKuxMHj5HVzcoWU3KsWwhjyfzgTqY"
            ],
            "itw_filenames": [
                "/var/www/clean-mx/virusesevidence/output.180503168.txt"
            ],
            "positive": "49/75",
            "first_seen": 1441253114,
            "last_seen": 1660630051
        },
        "cuckoo_sandbox": {
            "network": [
                "193.104.215.66"
            ],
            "mutexes": [
                "!IECompat!Mutex",
                "Local\\__DDrawCheckExclMode__"
            ],
            "self_copy": [],
            "screenshot": [
                "https://api.threatvision.org/samples/755a4b2ec15da6bb01248b2dfbad206c340ba937eae9c35f04f6cedfe5e99d63/screenshots/10"
            ]
        },
        "microsoft_office_meta": {
            "author": null,
            "code_page": null,
            "ole_path": [],
            "samba_strings": null,
            "created_at": null,
            "updated_at": null
        },
        "email_info": {
            "from": null,
            "to": null,
            "subject": null,
            "header": {
                "received": null
            },
            "attachments": [],
            "html_object_tags": null
        },
        "file_names": [
            "600347.exe"
        ],
        "file_paths": [
            "/var/www/clean-mx/virusesevidence/output.180503168.txt"
        ]
    }
}

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.

ITM Enrichment

Sample Enrichment

Change Log

• Version 1.1.0
  • Updated the actions to use version 2 of the TeamT5 API endpoints.
  • Added the following configuration parameters:
    • Enable SSL Verification
    • Disable Proxies
• Version 1.0.0
  • Initial release