GoogleThreatIntelligence

Analyzes suspicious hashes, URLs, domains, and IP addresses.

Data Enrichment & Threat Intelligence · GoogleThreatIntelligence

Details

IDGoogleThreatIntelligence
ProviderGoogle
CategoryData Enrichment & Threat Intelligence
From Version6.10.0
Docker Imagedemisto/python3:3.12.13.10116658
Supported ModulesAgentix XSIAM

README

Google Threat Intelligence

This integration analyzes suspicious hashes, URLs, domains, and IP addresses.

Configure Google Threat Intelligence in Cortex

Parameter Description Required
API Key See Acquiring your API key True
Use system proxy settings   False
Trust any certificate (not secure)   False
Source Reliability Reliability of the source providing the intelligence data  
GTI Malicious Verdict. Check Google Threat Intelligence verdict to consider the file malicious.   False
GTI Suspicious Verdict. Check Google Threat Intelligence verdict to consider the file suspicious.   False
File Malicious Threshold. Minimum number of positive results from GoogleThreatIntelligence scanners to consider the file malicious. See Indicator Thresholds. False
File Suspicious Threshold. Minimum number of positive and suspicious results from GoogleThreatIntelligence scanners to consider the file suspicious. See Indicator Thresholds. False
IP Malicious Threshold. Minimum number of positive results from GoogleThreatIntelligence scanners to consider the IP malicious. See Indicator Thresholds. False
IP Suspicious Threshold. Minimum number of positive and suspicious results from GoogleThreatIntelligence scanners to consider the IP suspicious. See Indicator Thresholds. False
Disable reputation lookups for private IP addresses To reduce the number of lookups made to the GoogleThreatIntelligence API, this option can be selected to gracefully skip enrichment of any IP addresses allocated for private networks. False
URL Malicious Threshold. Minimum number of positive results from GoogleThreatIntelligence scanners to consider the URL malicious. See Indicator Thresholds. False
URL Suspicious Threshold. Minimum number of positive and suspicious results from GoogleThreatIntelligence scanners to consider the URL suspicious. See Indicator Thresholds. False
Domain Malicious Threshold. Minimum number of positive results from GoogleThreatIntelligence scanners to consider the domain malicious. See Indicator Thresholds. False
Domain Suspicious Threshold. Minimum number of positive and suspicious results from GoogleThreatIntelligence scanners to consider the domain suspicious. See Indicator Thresholds. False
Preferred Vendors List. CSV list of vendors who are considered more trustworthy. See Indicator Thresholds. False
Preferred Vendor Threshold. The minimum number of highly trusted vendors required to consider a domain, IP address, URL, or file as malicious. See Indicator Thresholds. False
Enable score analyzing by Crowdsourced Yara Rules, Sigma, and IDS See Rules Threshold. False
Crowdsourced Yara Rules Threshold See Rules Threshold. False
Sigma and Intrusion Detection Rules Threshold See Rules Threshold. False
Domain Popularity Ranking Threshold See Rules Threshold. False

Acquiring your API key

Your API key can be found in your GoogleThreatIntelligence account user menu, clicking on your avatar:
How to get api key in GoogleThreatIntelligence
Your API key carries all your privileges, so keep it secure and don’t share it with anyone.

DBot Score / Reputation scores

The following information describes DBot Score which is new for this version.

Indicator Thresholds

Configure the default threshold for each indicator type in the instance settings.
You can also specify the threshold as an argument when running relevant commands.

  • Indicators with positive results from preferred vendors equal to or higher than the threshold will be considered malicious.
  • Indicators with positive results equal to or higher than the malicious threshold will be considered malicious.
  • Indicators with positive results equal to or higher than the suspicious threshold value will be considered suspicious.
  • Domain popularity ranks: GoogleThreatIntelligence is returning a popularity ranks for each vendor. The integration will calculate its average and will compare it to the threshold.

Rules Threshold

If the YARA rules analysis threshold is enabled:

  • Indicators with positive results, the number of found YARA rules results, Sigma analysis, or IDS equal to or higher than the threshold, will be considered suspicious.
  • If both the the basic analysis and the rules analysis is suspicious, the indicator will be considered as malicious.
    If the indicator was found to be suspicious only by the rules thresholds, the indicator will be considered suspicious.
  • Domain popularity ranks: GoogleThreatIntelligence is returning a popularity ranks for each vendor. The integration will calculate its average and will compare it to the threshold.

The DbotScore calculation process can be seen on the “description” field in any malicious/suspicious DBot score.
You can aquire those calculation on all of the indicators also from the debug log.

Example of a GoogleThreatIntelligence DBot score log:

Basic analyzing of "<domain>"
Found popularity ranks. Analyzing.
The average of the ranks is 809009.0 and the threshold is 10000
Indicator is good by popularity ranks.
Analyzing by get_domain_communicating_files
Found safe by relationship files. total_malicious=0 >= 3
Analyzing by get_url_downloaded_files
Found safe by relationship files. total_malicious=0 >= 3
Analyzing by get_url_referrer_files
Found safe by relationship files. total_malicious=0 >= 3

Reputation commands (ip, url, domain, and file)

  • Removed output paths: Due to changes in GoogleThreatIntelligence, the following output paths are no longer supported:
    • IP.GoogleThreatIntelligence
    • Domain.GoogleThreatIntelligence
    • URL.GoogleThreatIntelligence
    • File.GoogleThreatIntelligence

    Instead, you can use the following output paths that return concrete indicator reputations.

    • GoogleThreatIntelligence.IP
    • GoogleThreatIntelligence.Domain
    • GoogleThreatIntelligence.File
    • GoogleThreatIntelligence.URL
  • The following commands will no longer analyze the file/url sent to it, but will get the information stored in GoogleThreatIntelligence.
    • GoogleThreatIntelligence.Domain
    • GoogleThreatIntelligence.IP

    To analyze (detonate) the indicator, you can use the following playbooks:

    • Detonate File - GoogleThreatIntelligence
    • Detonate URL - GoogleThreatIntelligence
  • Each reputation command will use at least 1 API call. For advanced reputation commands, use the Premium API flag.
  • For each reputation command there is the new extended_data argument . When set to “true”, the results returned by the commands will contain
    additional information as last_analysis_results which contains the service name and its specific analysis.

  • Reputation commands can return relationships of the indicator.
    The relationships that are supported are defined as part of the instance configuration.
    For more information regarding URL relationships, see: https://gtidocs.virustotal.com/reference/url-info
    For more information regarding IP relationships, see: https://gtidocs.virustotal.com/reference/ip-info
    For more information regarding Domain relationships, see: https://gtidocs.virustotal.com/reference/domain-info
    For more information regarding File relationships, see: https://gtidocs.virustotal.com/reference/file-info

  • Starting with XSOAR version 6.9.0, You may monitor API usage via the GoogleThreatIntelligence Execution Metrics dashboard.

Comments

In GoogleThreatIntelligence you can now add comments to all indicator types (IP, Domain, File and URL) so each command now has the resource_type argument.
If supplied, the command will use the resource type to add a comment. If not, the command will determine if the given input is a hash or a URL.
This arguments is available in the following commands:

  • gti-comments-get
  • gti-comments-add

gti-comments-get

  • Added the resource_type argument. If not supplied, will try to determine if the resource argument is a hash or a URL.
  • Added the limit argument. Gets the latest comments within the given limit.
  • New output path: GoogleThreatIntelligence.Comments.

Detonation (scan) Commands

Removed the gtiLink output from all commands as it does no longer return from the API.
To easily use the scan commands we suggest using the following playbooks:

  • Detonate File - GoogleThreatIntelligence
  • Detonate URL - GoogleThreatIntelligence

Use the gti-analysis-get command to get the report from the scans.

file

Checks the file reputation of the specified hash.

Base Command

file

Input

Argument Name Description Required
file Hash of the file to query. Supports MD5, SHA1, and SHA256. Required
extended_data Whether to return extended data (last_analysis_results). Possible values are: true, false. Optional

Context Output

Path Type Description
File.MD5 String Bad MD5 hash.
File.SHA1 String Bad SHA1 hash.
File.SHA256 String Bad SHA256 hash.
File.Relationships.EntityA String The source of the relationship.
File.Relationships.EntityB String The destination of the relationship.
File.Relationships.Relationship String The name of the relationship.
File.Relationships.EntityAType String The type of the source of the relationship.
File.Relationships.EntityBType String The type of the destination of the relationship.
File.Malicious.Vendor String For malicious files, the vendor that made the decision.
File.Malicious.Detections Number For malicious files, the total number of detections.
File.Malicious.TotalEngines Number For malicious files, the total number of engines that checked the file hash.
DBotScore.Indicator String The indicator that was tested.
DBotScore.Type String The indicator type.
DBotScore.Vendor unknown The vendor used to calculate the score.
DBotScore.Score Number The actual score.
DBotScore.Reliability String Reliability of the source providing the intelligence data.
GoogleThreatIntelligence.File.attributes.type_description String Description of the type of the file.
GoogleThreatIntelligence.File.attributes.tlsh String The locality-sensitive hashing.
GoogleThreatIntelligence.File.attributes.exiftool.MIMEType String MIME type of the file.
GoogleThreatIntelligence.File.attributes.names String Names of the file.
GoogleThreatIntelligence.File.attributes.javascript_info.tags String Tags of the JavaScript.
GoogleThreatIntelligence.File.attributes.exiftool.FileType String The file type.
GoogleThreatIntelligence.File.attributes.exiftool.WordCount String Total number of words in the file.
GoogleThreatIntelligence.File.attributes.exiftool.LineCount String Total number of lines in file.
GoogleThreatIntelligence.File.attributes.crowdsourced_ids_stats.info Number Number of IDS that marked the file as “info”.
GoogleThreatIntelligence.File.attributes.crowdsourced_ids_stats.high Number Number of IDS that marked the file as “high”.
GoogleThreatIntelligence.File.attributes.crowdsourced_ids_stats.medium Number Number of IDS that marked the file as “medium”.
GoogleThreatIntelligence.File.attributes.crowdsourced_ids_stats.low Number Number of IDS that marked the file as “low”.
GoogleThreatIntelligence.File.attributes.sigma_analysis_stats.critical Number Number of Sigma analysis that marked the file as “critical”.
GoogleThreatIntelligence.File.attributes.sigma_analysis_stats.high Number Number of Sigma analysis that marked the file as “high”.
GoogleThreatIntelligence.File.attributes.sigma_analysis_stats.medium Number Number of Sigma analysis that marked the file as “medium”.
GoogleThreatIntelligence.File.attributes.sigma_analysis_stats.low Number Number of Sigma analysis that marked the file as “low”.
GoogleThreatIntelligence.File.attributes.exiftool.MIMEEncoding String The MIME encoding.
GoogleThreatIntelligence.File.attributes.exiftool.FileTypeExtension String The file type extension.
GoogleThreatIntelligence.File.attributes.exiftool.Newlines String Number of newlines signs.
GoogleThreatIntelligence.File.attributes.trid.file_type String The TrID file type.
GoogleThreatIntelligence.File.attributes.trid.probability Number The TrID probability.
GoogleThreatIntelligence.File.attributes.crowdsourced_yara_results.description String Description of the YARA rule.
GoogleThreatIntelligence.File.attributes.crowdsourced_yara_results.source String Source of the YARA rule.
GoogleThreatIntelligence.File.attributes.crowdsourced_yara_results.author String Author of the YARA rule.
GoogleThreatIntelligence.File.attributes.crowdsourced_yara_results.ruleset_name String Rule set name of the YARA rule.
GoogleThreatIntelligence.File.attributes.crowdsourced_yara_results.rule_name String Name of the YARA rule.
GoogleThreatIntelligence.File.attributes.crowdsourced_yara_results.ruleset_id String ID of the YARA rule.
GoogleThreatIntelligence.File.attributes.names String Name of the file.
GoogleThreatIntelligence.File.attributes.last_modification_date Number The last modification date in epoch format.
GoogleThreatIntelligence.File.attributes.type_tag String Tag of the type.
GoogleThreatIntelligence.File.attributes.total_votes.harmless Number Total number of harmless votes.
GoogleThreatIntelligence.File.attributes.total_votes.malicious Number Total number of malicious votes.
GoogleThreatIntelligence.File.attributes.size Number Size of the file.
GoogleThreatIntelligence.File.attributes.popular_threat_classification.suggested_threat_label String Suggested thread label.
GoogleThreatIntelligence.File.attributes.popular_threat_classification.popular_threat_name Number The popular thread name.
GoogleThreatIntelligence.File.attributes.times_submitted Number Number of times the file was submitted.
GoogleThreatIntelligence.File.attributes.last_submission_date Number Last submission date in epoch format.
GoogleThreatIntelligence.File.attributes.downloadable Boolean Whether the file is downloadable.
GoogleThreatIntelligence.File.attributes.sha256 String SHA-256 hash of the file.
GoogleThreatIntelligence.File.attributes.type_extension String Extension of the type.
GoogleThreatIntelligence.File.attributes.tags String File tags.
GoogleThreatIntelligence.File.attributes.last_analysis_date Number Last analysis date in epoch format.
GoogleThreatIntelligence.File.attributes.unique_sources Number Unique sources.
GoogleThreatIntelligence.File.attributes.first_submission_date Number First submission date in epoch format.
GoogleThreatIntelligence.File.attributes.ssdeep String SSDeep hash of the file.
GoogleThreatIntelligence.File.attributes.md5 String MD5 hash of the file.
GoogleThreatIntelligence.File.attributes.sha1 String SHA-1 hash of the file.
GoogleThreatIntelligence.File.attributes.magic String Identification of file by the magic number.
GoogleThreatIntelligence.File.attributes.last_analysis_stats.harmless Number The number of engines that found the indicator to be harmless.
GoogleThreatIntelligence.File.attributes.last_analysis_stats.type-unsupported Number The number of engines that found the indicator to be of type unsupported.
GoogleThreatIntelligence.File.attributes.last_analysis_stats.suspicious Number The number of engines that found the indicator to be suspicious.
GoogleThreatIntelligence.File.attributes.last_analysis_stats.confirmed-timeout Number The number of engines that confirmed the timeout of the indicator.
GoogleThreatIntelligence.File.attributes.last_analysis_stats.timeout Number The number of engines that timed out for the indicator.
GoogleThreatIntelligence.File.attributes.last_analysis_stats.failure Number The number of failed analysis engines.
GoogleThreatIntelligence.File.attributes.last_analysis_stats.malicious Number The number of engines that found the indicator to be malicious.
GoogleThreatIntelligence.File.attributes.last_analysis_stats.undetected Number The number of engines that could not detect the indicator.
GoogleThreatIntelligence.File.attributes.meaningful_name String Meaningful name of the file.
GoogleThreatIntelligence.File.attributes.reputation Number The reputation of the file.
GoogleThreatIntelligence.File.type String Type of the indicator (file).
GoogleThreatIntelligence.File.id String Type ID of the indicator.
GoogleThreatIntelligence.File.links.self String Link to the response.
GoogleThreatIntelligence.File.attributes.gti_assessment.verdict.value String GTI verdict of the file.
GoogleThreatIntelligence.File.attributes.gti_assessment.severity.value String GTI severity of the file.
GoogleThreatIntelligence.File.attributes.gti_assessment.threat_score.value Number GTI threat score of the file.

Command Example

!file file=0000000000000000000000000000000000000000000000000000000000000000

Context Example

{
    "DBotScore": {
        "Indicator": "0000000000000000000000000000000000000000000000000000000000000000",
        "Reliability": "A - Completely reliable",
        "Score": 2,
        "Type": "file",
        "Vendor": "GoogleThreatIntelligence"
    },
    "File": {
        "Extension": "txt",
        "MD5": "00000000000000000000000000000000",
        "SHA1": "0000000000000000000000000000000000000000",
        "SHA256": "0000000000000000000000000000000000000000000000000000000000000000",
        "SSDeep": "3:AIO9AJraNvsgzsVqSwHqiUZ:AeJuOgzskwZ",
        "Size": 103,
        "Tags": [
            "text"
        ],
        "Type": "text/plain"
    },
    "GoogleThreatIntelligence": {
        "File": {
            "attributes": {
                "capabilities_tags": [],
                "crowdsourced_yara_results": [
                    {
                        "author": "Marc Rivero | McAfee ATR Team",
                        "description": "Rule to detect the EICAR pattern",
                        "rule_name": "malw_eicar",
                        "ruleset_id": "0019ab4291",
                        "ruleset_name": "MALW_Eicar",
                        "source": "https://github.com/advanced-threat-research/Yara-Rules"
                    }
                ],
                "downloadable": true,
                "exiftool": {
                    "FileType": "TXT",
                    "FileTypeExtension": "txt",
                    "LineCount": "1",
                    "MIMEEncoding": "us-ascii",
                    "MIMEType": "text/plain",
                    "Newlines": "(none)",
                    "WordCount": "7"
                },
                "first_submission_date": 1613356237,
                "last_analysis_date": 1617088893,
                "last_analysis_stats": {
                    "confirmed-timeout": 0,
                    "failure": 0,
                    "harmless": 0,
                    "malicious": 7,
                    "suspicious": 0,
                    "timeout": 1,
                    "type-unsupported": 16,
                    "undetected": 50
                },
                "last_modification_date": 1617088964,
                "last_submission_date": 1613356237,
                "magic": "ASCII text, with no line terminators",
                "md5": "00000000000000000000000000000000",
                "meaningful_name": "brokencert.exe",
                "names": [
                    "brokencert.exe"
                ],
                "popular_threat_classification": {
                    "popular_threat_name": [
                        [
                            "eicar",
                            7
                        ]
                    ],
                    "suggested_threat_label": "eicar/test"
                },
                "reputation": 0,
                "sha1": "0000000000000000000000000000000000000000",
                "sha256": "0000000000000000000000000000000000000000000000000000000000000000",
                "size": 103,
                "ssdeep": "3:AIO9AJraNvsgzsVqSwHqiUZ:AeJuOgzskwZ",
                "tags": [
                    "text"
                ],
                "times_submitted": 1,
                "tlsh": "T1AEB01208274FFB1ED10738340431F8F14428434D1CD4697414911174887614512D8354",
                "total_votes": {
                    "harmless": 0,
                    "malicious": 0
                },
                "type_description": "Text",
                "type_extension": "txt",
                "type_tag": "text",
                "unique_sources": 1
            },
            "id": "0000000000000000000000000000000000000000000000000000000000000000",
            "links": {
                "self": "https://www.virustotal.com/api/v3/files/0000000000000000000000000000000000000000000000000000000000000000"
            },
            "type": "file"
        }
    }
}

Human Readable Output

Results of file hash 0000000000000000000000000000000000000000000000000000000000000000

Sha1 Sha256 Md5 MeaningfulName TypeExtension Last Modified Reputation Positives
0000000000000000000000000000000000000000 0000000000000000000000000000000000000000000000000000000000000000 00000000000000000000000000000000 brokencert.exe txt 2021-03-30 07:22:44Z 0 7/74

url-scan

  • New output path: GoogleThreatIntelligence.Submission
  • Preserved output: gtiScanID
  • Removed output path: gtiLink - The V3 API does not returns a link to the GUI anymore.

gti-file-scan-upload-url

  • New output path: GoogleThreatIntelligence.FileUploadURL
  • Preserved output: gtiUploadURL

New Commands

  • gti-search
  • gti-ip-passive-dns-data
  • gti-file-sandbox-report
  • gti-comments-get-by-id
  • gti-analysis-get

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.

ip

Checks the reputation of an IP address.

Base Command

ip

Input

Argument Name Description Required
ip IP address to check. Required
extended_data Whether to return extended data (last_analysis_results). Possible values are: true, false. Optional
override_private_lookup When set to “true”, enrichment of private IP addresses will be conducted even if it has been disabled at the integration level. Possible values are: true, false. Optional

Context Output

Path Type Description
IP.Address unknown Bad IP address.
IP.ASN unknown Bad IP ASN.
IP.Geo.Country unknown Bad IP country.
IP.Relationships.EntityA string The source of the relationship.
IP.Relationships.EntityB string The destination of the relationship.
IP.Relationships.Relationship string The name of the relationship.
IP.Relationships.EntityAType string The type of the source of the relationship.
IP.Relationships.EntityBType string The type of the destination of the relationship.
IP.Malicious.Vendor unknown For malicious IPs, the vendor that made the decision.
IP.Malicious.Description unknown For malicious IPs, the reason that the vendor made the decision.
IP.ASOwner String The autonomous system owner of the IP.
DBotScore.Indicator unknown The indicator that was tested.
DBotScore.Type unknown The indicator type.
DBotScore.Vendor unknown The vendor used to calculate the score.
DBotScore.Score Number The actual score.
DBotScore.Reliability String Reliability of the source providing the intelligence data.
GoogleThreatIntelligence.IP.attributes.regional_internet_registry String Regional internet registry (RIR).
GoogleThreatIntelligence.IP.attributes.jarm String JARM data.
GoogleThreatIntelligence.IP.attributes.network String Network data.
GoogleThreatIntelligence.IP.attributes.country String The country where the IP is located.
GoogleThreatIntelligence.IP.attributes.as_owner String IP owner.
GoogleThreatIntelligence.IP.attributes.last_analysis_stats.harmless Number The number of engines that found the domain to be harmless.
GoogleThreatIntelligence.IP.attributes.last_analysis_stats.malicious Number The number of engines that found the indicator to be malicious.
GoogleThreatIntelligence.IP.attributes.last_analysis_stats.suspicious Number The number of engines that found the indicator to be suspicious.
GoogleThreatIntelligence.IP.attributes.last_analysis_stats.undetected Number The number of engines that could not detect the indicator.
GoogleThreatIntelligence.IP.attributes.last_analysis_stats.timeout Number The number of engines that timed out for the indicator.
GoogleThreatIntelligence.IP.attributes.asn Number ASN data.
GoogleThreatIntelligence.IP.attributes.whois_date Number Date of the last update of the whois record.
GoogleThreatIntelligence.IP.attributes.reputation Number IP reputation.
GoogleThreatIntelligence.IP.attributes.last_modification_date Number Last modification date in epoch format.
GoogleThreatIntelligence.IP.attributes.total_votes.harmless Number Total number of harmless votes.
GoogleThreatIntelligence.IP.attributes.total_votes.malicious Number Total number of malicious votes.
GoogleThreatIntelligence.IP.attributes.continent String The continent where the IP is located.
GoogleThreatIntelligence.IP.attributes.whois String whois data.
GoogleThreatIntelligence.IP.type String Indicator IP type.
GoogleThreatIntelligence.IP.id String ID of the IP.
GoogleThreatIntelligence.IP.attributes.gti_assessment.verdict.value String GTI verdict of the IP address.
GoogleThreatIntelligence.IP.attributes.gti_assessment.severity.value String GTI severity of the IP address.
GoogleThreatIntelligence.IP.attributes.gti_assessment.threat_score.value Number GTI threat score of the IP address.

Command example

!ip ip=1.1.1.1

Context Example

{
    "DBotScore": {
        "Indicator": "1.1.1.1",
        "Reliability": "C - Fairly reliable",
        "Score": 1,
        "Type": "ip",
        "Vendor": "GoogleThreatIntelligence"
    },
    "IP": {
        "ASN": 13335,
        "ASOwner": "CLOUDFLARENET",
        "Address": "1.1.1.1",
        "DetectionEngines": 94,
        "PositiveDetections": 4,
        "Relationships": [
            {
                "EntityA": "1.1.1.1",
                "EntityAType": "IP",
                "EntityB": "00000cd773f456da710fa334507f8303e87ee228a0c42e365b0250a9a267e734",
                "EntityBType": "File",
                "Relationship": "communicates-with"
            },
            {
                "EntityA": "1.1.1.1",
                "EntityAType": "IP",
                "EntityB": "0000703e66fe64992425a5a6231671c08a6c3382a28d0efacc7efd3fb289a143",
                "EntityBType": "File",
                "Relationship": "communicates-with"
            }
        ]
    },
    "GoogleThreatIntelligence": {
        "IP": {
            "attributes": {
                "as_owner": "CLOUDFLARENET",
                "asn": 13335,
                "jarm": "27d3ed3ed0003ed1dc42d43d00041d6183ff1bfae51ebd88d70384363d525c",
                "last_analysis_stats": {
                    "harmless": 80,
                    "malicious": 4,
                    "suspicious": 0,
                    "timeout": 0,
                    "undetected": 10
                },
                "last_https_certificate": {
                    "cert_signature": {
                        "signature": "3064023024c2cf6cbdf6aed1c9d51f4a742e3c3dd1c03edcd71bd394715bfea5861626820122d30a6efc98b5d2e2b9e5076977960230457b6f82a67db662c33185d5b5355d4f4c8488ac1a003d0c8440dcb0a7ca1c1327151e37f946c3aed9fdf9b9238b7f2a",
                        "signature_algorithm": "1.2.840.10045.4.3.3"
                    },
                    "extensions": {
                        "**exten**": "0481f200f00076002979bef09e393921f056739f63a577e5be577d9c600af8f9",
                        "CA": true,
                        "authority_key_identifier": {
                            "keyid": "0abc0829178ca5396d7a0ece33c72eb3edfbc37a"
                        },
                        "ca_information_access": {
                            "CA Issuers": "http://cacerts.example.com/exampleTLSHybridECCSHA3842020CA1.crt",
                            "OCSP": "http://ocsp.example.com"
                        },
                        "certificate_policies": [
                            "**policy**"
                        ],
                        "crl_distribution_points": [
                            "http://crl3.example.com/exampleTLSHybridECCSHA3842020CA1.crl",
                            "http://crl4.example.com/exampleTLSHybridECCSHA3842020CA1.crl"
                        ],
                        "extended_key_usage": [
                            "serverAuth",
                            "clientAuth"
                        ],
                        "key_usage": [
                            "ff"
                        ],
                        "subject_alternative_name": [
                            "cloudflare-dns.com",
                            "*.cloudflare-dns.com",
                            "one.one.one.one",
                            "\u0001\u0001\u0001\u0001",
                            "\u0001\u0001",
                            "\\xa2\\x9f$\\x01",
                            "\\xa2\\x9f.\\x01",
                            "&\u0006GG\u0011\u0011",
                            "&\u0006GG\u0010\u0001",
                            "GGd",
                            "GGd"
                        ],
                        "subject_key_identifier": "19451b2318f874da2214cb466be213b360158240",
                        "tags": []
                    },
                    "issuer": {
                        "C": "US",
                        "CN": "example TLS Hybrid ECC SHA384 2020 CA1",
                        "O": "example Inc"
                    },
                    "public_key": {
                        "algorithm": "EC",
                        "ec": {
                            "oid": "secp256r1",
                            "pub": "0417ad1fe835af70d38d9c9e64fd471e5b970c0ad110a826321136664d1299c3e131bbf5216373dda5c1c1a0f06da4c45ee1c2dbdaf90d34801af7b9e03af2d574"
                        }
                    },
                    "serial_number": "5076f66d11b692256ccacd546ffec53",
                    "signature_algorithm": "1.2.840.10045.4.3.3",
                    "size": 1418,
                    "subject": {
                        "C": "US",
                        "CN": "cloudflare-dns.com",
                        "L": "San Francisco",
                        "O": "Cloudflare, Inc.",
                        "ST": "California"
                    },
                    "tags": [],
                    "thumbprint": "f1b38143b992645497cf452f8c1ac84249794282",
                    "thumbprint_sha256": "fb444eb8e68437bae06232b9f5091bccff62a768ca09e92eb5c9c2cf9d17c426",
                    "validity": {
                        "not_after": "2022-10-25 23:59:59",
                        "not_before": "2021-10-25 00:00:00"
                    },
                    "version": "V3"
                },
                "last_https_certificate_date": 1617041198,
                "last_modification_date": 1617083545,
                "network": "1.1.1.0/24",
                "reputation": 134,
                "tags": [],
                "total_votes": {
                    "harmless": 63,
                    "malicious": 8
                },
                "whois": "**whois string**",
                "whois_date": 1631599972
            },
            "id": "1.1.1.1",
            "links": {
                "self": "https://www.virustotal.com/api/v3/ip_addresses/1.1.1.1"
            },
            "relationships": {
                "communicating_files": {
                    "data": [
                        {
                            "id": "00000cd773f456da710fa334507f8303e87ee228a0c42e365b0250a9a267e734",
                            "type": "file"
                        },
                        {
                            "id": "0000703e66fe64992425a5a6231671c08a6c3382a28d0efacc7efd3fb289a143",
                            "type": "file"
                        }
                    ],
                    "links": {
                        "next": "https://www.virustotal.com/api/v3/ip_addresses/1.1.1.1/relationships/communicating_files?cursor=eyJsaW1pdCI6IDIwLCAib2Zmc2V0IjogMjB9&limit=20",
                        "related": "https://www.virustotal.com/api/v3/ip_addresses/1.1.1.1/communicating_files",
                        "self": "https://www.virustotal.com/api/v3/ip_addresses/1.1.1.1/relationships/communicating_files?limit=20"
                    },
                    "meta": {
                        "cursor": "eyJsaW1pdCI6IDIwLCAib2Zmc2V0IjogMjB9"
                    }
                }
            },
            "type": "ip_address"
        }
    }
}

Human Readable Output

IP reputation of 1.1.1.1

Id Network Country AsOwner LastModified Reputation Positives
1.1.1.1 1.1.1.0/24   CLOUDFLARENET 2022-08-29 15:15:41Z 134 4/94

url

Checks the reputation of a URL.

Base Command

url

Input

Argument Name Description Required
url URL to check. Required
extended_data Whether to return extended data (last_analysis_results). Possible values are: true, false. Optional

Context Output

Path Type Description
URL.Data unknown Bad URLs found.
URL.Relationships.EntityA String The source of the relationship.
URL.Relationships.EntityB String The destination of the relationship.
URL.Relationships.Relationship String The name of the relationship.
URL.Relationships.EntityAType String The type of the source of the relationship.
URL.Relationships.EntityBType String The type of the destination of the relationship.
URL.Malicious.Vendor unknown For malicious URLs, the vendor that made the decision.
URL.Malicious.Description unknown For malicious URLs, the reason that the vendor made the decision.
DBotScore.Indicator unknown The indicator that was tested.
DBotScore.Type unknown The indicator type.
DBotScore.Vendor unknown The vendor used to calculate the score.
DBotScore.Score Number The actual score.
DBotScore.Reliability String Reliability of the source providing the intelligence data.
GoogleThreatIntelligence.URL.attributes.favicon.raw_md5 String The MD5 hash of the URL.
GoogleThreatIntelligence.URL.attributes.favicon.dhash String Difference hash.
GoogleThreatIntelligence.URL.attributes.last_modification_date Number Last modification date in epoch format.
GoogleThreatIntelligence.URL.attributes.times_submitted Number The number of times the url has been submitted.
GoogleThreatIntelligence.URL.attributes.total_votes.harmless Number Total number of harmless votes.
GoogleThreatIntelligence.URL.attributes.total_votes.malicious Number Total number of malicious votes.
GoogleThreatIntelligence.URL.attributes.threat_names String Name of the threats found.
GoogleThreatIntelligence.URL.attributes.last_submission_date Number The last submission date in epoch format.
GoogleThreatIntelligence.URL.attributes.last_http_response_content_length Number The last HTTPS response length.
GoogleThreatIntelligence.URL.attributes.last_http_response_headers.date Date The last response header date.
GoogleThreatIntelligence.URL.attributes.last_http_response_headers.x-sinkhole String DNS sinkhole from last response.
GoogleThreatIntelligence.URL.attributes.last_http_response_headers.content-length String The content length of the last response.
GoogleThreatIntelligence.URL.attributes.last_http_response_headers.content-type String The content type of the last response.
GoogleThreatIntelligence.URL.attributes.reputation Number Reputation of the indicator.
GoogleThreatIntelligence.URL.attributes.last_analysis_date Number The date of the last analysis in epoch format.
GoogleThreatIntelligence.URL.attributes.has_content Boolean Whether the url has content in it.
GoogleThreatIntelligence.URL.attributes.first_submission_date Number The first submission date in epoch format.
GoogleThreatIntelligence.URL.attributes.last_http_response_content_sha256 String The SHA-256 hash of the content of the last response.
GoogleThreatIntelligence.URL.attributes.last_http_response_code Number Last response status code.
GoogleThreatIntelligence.URL.attributes.last_final_url String Last final URL.
GoogleThreatIntelligence.URL.attributes.url String The URL itself.
GoogleThreatIntelligence.URL.attributes.title String Title of the page.
GoogleThreatIntelligence.URL.attributes.last_analysis_stats.harmless Number The number of engines that found the domain to be harmless.
GoogleThreatIntelligence.URL.attributes.last_analysis_stats.malicious Number The number of engines that found the indicator to be malicious.
GoogleThreatIntelligence.URL.attributes.last_analysis_stats.suspicious Number The number of engines that found the indicator to be suspicious.
GoogleThreatIntelligence.URL.attributes.last_analysis_stats.undetected Number The number of engines that could not detect the indicator.
GoogleThreatIntelligence.URL.attributes.last_analysis_stats.timeout Number The number of engines that timed out for the indicator.
GoogleThreatIntelligence.URL.attributes.outgoing_links String Outgoing links of the URL page.
GoogleThreatIntelligence.URL.type String Type of the indicator (url).
GoogleThreatIntelligence.URL.id String ID of the indicator.
GoogleThreatIntelligence.URL.links.self String Link to the response.
GoogleThreatIntelligence.URL.attributes.gti_assessment.verdict.value String GTI verdict of the URL.
GoogleThreatIntelligence.URL.attributes.gti_assessment.severity.value String GTI severity of the URL.
GoogleThreatIntelligence.URL.attributes.gti_assessment.threat_score.value Number GTI threat score of the URL.

Command Example

!url url=https://example.com

Context Example

{
    "DBotScore": {
        "Indicator": "https://example.com",
        "Reliability": "A - Completely reliable",
        "Score": 2,
        "Type": "url",
        "Vendor": "GoogleThreatIntelligence"
    },
    "URL": {
        "Category": {
            "Dr.Web": "known infection source",
            "Forcepoint ThreatSeeker": "information technology",
            "alphaMountain.ai": "Malicious",
            "sophos": "malware callhome, command and control"
        },
        "Data": "https://example.com",
        "DetectionEngines": 86,
        "PositiveDetections": 8
    },
    "GoogleThreatIntelligence": {
        "URL": {
            "attributes": {
                "categories": {
                    "Dr.Web": "known infection source"
                },
                "first_submission_date": 1554509044,
                "has_content": false,
                "html_meta": {},
                "last_analysis_date": 1615900309,
                "last_analysis_stats": {
                    "harmless": 71,
                    "malicious": 8,
                    "suspicious": 0,
                    "timeout": 0,
                    "undetected": 7
                },
                "last_final_url": "https://example.com/dashboard/",
                "last_http_response_code": 200,
                "last_http_response_content_length": 1671,
                "last_http_response_content_sha256": "f2ddbc5b5468c2cd9c28ae820420d32c4f53d088e4a1cc31f661230e4893104a",
                "last_http_response_headers": {
                    "content-length": "1671",
                    "content-type": "text/html; charset=utf-8",
                    "date": "Tue, 16 Mar 2021 13:16:50 GMT",
                    "x-sinkhole": "Malware"
                },
                "last_modification_date": 1615900620,
                "last_submission_date": 1615900309,
                "outgoing_links": [
                    "http://www.example.com",
                    "http://www.example.com"
                ],
                "reputation": 0,
                "tags": [],
                "targeted_brand": {},
                "threat_names": [
                    "C2/Generic-A"
                ],
                "times_submitted": 5,
                "title": "Welcome page",
                "total_votes": {
                    "harmless": 0,
                    "malicious": 0
                },
                "trackers": {},
                "url": "https://example.com/"
            },
            "id": "84eb1485254266e093683024b3bd172abde615fc6a37498707ca912964a108a9",
            "links": {
                "self": "https://www.virustotal.com/api/v3/urls/84eb1485254266e093683024b3bd172abde615fc6a37498707ca912964a108a9"
            },
            "type": "url"
        }
    }
}

Human Readable Output

URL data of “https://example.com”

Url Title LastModified HasContent LastHttpResponseContentSha256 Positives Reputation
https://example.com Welcome page 2021-03-16 13:17:00Z false f2ddbc5b5468c2cd9c28ae820420d32c4f53d088e4a1cc31f661230e4893104a 8/86 0

domain

Checks the reputation of a domain.

Base Command

domain\

Input

Argument Name Description Required
domain Domain name to check. Required
extended_data Whether to return extended data (last_analysis_results). Possible values are: true, false. Optional

Context Output

Path Type Description
Domain.Name unknown Bad domain found.
Domain.Relationships.EntityA String The source of the relationship.
Domain.Relationships.EntityB String The destination of the relationship.
Domain.Relationships.Relationship String The name of the relationship.
Domain.Relationships.EntityAType String The type of the source of the relationship.
Domain.Relationships.EntityBType String The type of the destination of the relationship.
Domain.Malicious.Vendor unknown For malicious domains, the vendor that made the decision.
Domain.Malicious.Description unknown For malicious domains, the reason that the vendor made the decision.
DBotScore.Indicator unknown The indicator that was tested.
DBotScore.Type unknown The indicator type.
DBotScore.Vendor unknown The vendor used to calculate the score.
DBotScore.Score Number The actual score.
DBotScore.Reliability String Reliability of the source providing the intelligence data.
GoogleThreatIntelligence.Domain.attributes.last_dns_records.type String The type of the last DNS records.
GoogleThreatIntelligence.Domain.attributes.last_dns_records.value String The value of the last DNS records.
GoogleThreatIntelligence.Domain.attributes.last_dns_records.ttl Number The time To live (ttl) of the last DNS records.
GoogleThreatIntelligence.Domain.attributes.jarm String JARM data.
GoogleThreatIntelligence.Domain.attributes.whois String whois data.
GoogleThreatIntelligence.Domain.attributes.last_dns_records_date Number The last DNS records date in epoch format.
GoogleThreatIntelligence.Domain.attributes.last_analysis_stats.harmless Number The number of engines that found the domain to be harmless.
GoogleThreatIntelligence.Domain.attributes.last_analysis_stats.malicious Number The number of engines that found the indicator to be malicious.
GoogleThreatIntelligence.Domain.attributes.last_analysis_stats.suspicious Number The number of engines that found the indicator to be suspicious.
GoogleThreatIntelligence.Domain.attributes.last_analysis_stats.undetected Number The number of engines that could not detect the indicator.
GoogleThreatIntelligence.Domain.attributes.last_analysis_stats.timeout Number The number of engines that timed out for the indicator.
GoogleThreatIntelligence.Domain.attributes.favicon.raw_md5 String MD5 hash of the domain.
GoogleThreatIntelligence.Domain.attributes.favicon.dhash String Difference hash.
GoogleThreatIntelligence.Domain.attributes.reputation Number Reputation of the indicator.
GoogleThreatIntelligence.Domain.attributes.registrar String Registrar information.
GoogleThreatIntelligence.Domain.attributes.last_update_date Number Last updated date in epoch format.
GoogleThreatIntelligence.Domain.attributes.last_modification_date Number Last modification date in epoch format.
GoogleThreatIntelligence.Domain.attributes.creation_date Number Creation date in epoch format.
GoogleThreatIntelligence.Domain.attributes.total_votes.harmless Number Total number of harmless votes.
GoogleThreatIntelligence.Domain.attributes.total_votes.malicious Number Total number of malicious votes.
GoogleThreatIntelligence.Domain.type String Type of indicator (domain).
GoogleThreatIntelligence.Domain.id String ID of the domain.
GoogleThreatIntelligence.Domain.links.self String Link to the domain investigation.
GoogleThreatIntelligence.Domain.attributes.gti_assessment.verdict.value String GTI verdict of the domain.
GoogleThreatIntelligence.Domain.attributes.gti_assessment.severity.value String GTI severity of the domain.
GoogleThreatIntelligence.Domain.attributes.gti_assessment.threat_score.value Number GTI threat score of the domain.

Command Example

!domain domain=example.com

Context Example

{
    "DBotScore": {
        "Indicator": "example.com",
        "Reliability": "A - Completely reliable",
        "Score": 2,
        "Type": "domain",
        "Vendor": "GoogleThreatIntelligence"
    },
    "Domain": {
        "Admin": {
            "Country": " PA",
            "Email": " [REDACTED]@whoisguard.com",
            "Name": " WhoisGuard, Inc.",
            "Phone": null
        },
        "CreationDate": [
            " 2017-01-21T16:26:19.0Z"
        ],
        "ExpirationDate": " 2018-01-21T23:59:59.0Z",
        "Name": "example.com",
        "NameServers": [
            " PDNS1.REGISTRAR-SERVERS.COM"
        ],
        "Registrant": {
            "Country": " PA",
            "Email": " [REDACTED]@whoisguard.com",
            "Name": null,
            "Phone": null
        },
        "Registrar": {
            "AbuseEmail": " abuse@namecheap.com",
            "AbusePhone": " +1.6613102107",
            "Name": [
                " Namecheap",
                " NAMECHEAP INC"
            ]
        },
        "UpdatedDate": [
            "2017-03-06T21:52:39.0Z"
        ],
        "WHOIS": {
            "Admin": {
                "Country": " PA",
                "Email": " [REDACTED]@whoisguard.com",
                "Name": " WhoisGuard, Inc.",
                "Phone": null
            },
            "CreationDate": [
                "2017-01-21T16:26:19.0Z"
            ],
            "ExpirationDate": " 2018-01-21T23:59:59.0Z",
            "NameServers": [
                " PDNS1.REGISTRAR-SERVERS.COM"
            ],
            "Registrant": {
                "Country": " PA",
                "Email": " [REDACTED]@whoisguard.com",
                "Name": null,
                "Phone": null
            },
            "Registrar": {
                "AbuseEmail": " abuse@namecheap.com",
                "AbusePhone": " +1.6613102107",
                "Name": [
                    " Namecheap",
                    " NAMECHEAP INC"
                ]
            },
            "UpdatedDate": [
                " 2017-03-06T21:52:39.0Z"
            ]
        }
    },
    "GoogleThreatIntelligence": {
        "Domain": {
            "attributes": {
                "categories": {
                    "Dr.Web": "known infection source",
                    "Forcepoint ThreatSeeker": "information technology",
                    "alphaMountain.ai": "Malicious",
                    "sophos": "malware callhome, command and control"
                },
                "creation_date": 1485015979,
                "favicon": {
                    "dhash": "f4cca89496a0ccb2",
                    "raw_md5": "6eb4a43cb64c97f76562af703893c8fd"
                },
                "jarm": "29d21b20d29d29d21c41d21b21b41d494e0df9532e75299f15ba73156cee38",
                "last_analysis_stats": {
                    "harmless": 66,
                    "malicious": 8,
                    "suspicious": 0,
                    "timeout": 0,
                    "undetected": 8
                },
                "last_dns_records": [
                    {
                        "ttl": 3599,
                        "type": "A",
                        "value": "value"
                    }
                ],
                "last_dns_records_date": 1615900633,
                "last_modification_date": 1615900633,
                "last_update_date": 1488837159,
                "popularity_ranks": {},
                "registrar": "Namecheap",
                "reputation": 0,
                "tags": [],
                "total_votes": {
                    "harmless": 0,
                    "malicious": 0
                },
                "whois": "**whoisstring**"
            },
            "id": "example.com",
            "links": {
                "self": "https://www.virustotal.com/api/v3/domains/example.com"
            },
            "type": "domain"
        }
    }
}

Human Readable Output

Domain data of example.com

Id Registrant Country LastModified LastAnalysisStats
example.com PA 2021-03-16 13:17:13Z harmless: 66malicious: 8
suspicious: 0
undetected: 8
timeout: 0

cve

Retrieves CVE information from Google Threat Intelligence.

Base Command

cve

Input

Argument Name Description Required
cve Provide CVE ID. Supports comma-separated values. Required

Context Output

Path Type Description
CVE.CVSS.Score Number CVSS score indicating the severity of the vulnerability.
CVE.CVSS.Vector String CVSS vector string representing attack metrics and impact.
CVE.Description String Full textual description of the CVE, including affected components and exploitation details.
CVE.ID String Unique identifier for the CVE (e.g., CVE-2025-14205).
CVE.Modified Date Timestamp when the CVE record was last modified (e.g., 1766963614).
CVE.Published Date Timestamp when the CVE was originally published (e.g., 1766963614).
CVE.Relationships.EntityA String First entity in the relationship (usually the CVE ID).
CVE.Relationships.EntityAType String Type of the first entity (e.g., CVE).
CVE.Relationships.EntityB String Second entity in the relationship (e.g., file, IP, domain).
CVE.Relationships.EntityBType String Type of the second entity (e.g., File, Domain, IP).
CVE.Relationships.Relationship String Nature of the relationship between EntityA and EntityB (e.g., related-to).
CVE.Relationships.STIXID String STIX ID associated with the CVE relationship.
DBotScore.Indicator String The indicator that was tested.
DBotScore.Reliability String Reliability rating of the threat intelligence source (e.g., A - Completely reliable, B - Usually reliable).
DBotScore.Score Number The actual score.
DBotScore.Type String The indicator type.
DBotScore.Vendor String The vendor used to calculate the score.
GoogleThreatIntelligence.CVE.id String ID of the CVE.
GoogleThreatIntelligence.CVE.type String Data type returned (usually ‘cve’).
GoogleThreatIntelligence.CVE.links.self String API link to the detailed CVE resource.
GoogleThreatIntelligence.CVE.attributes.urls_count Number Number of URLs associated with the CVE.
GoogleThreatIntelligence.CVE.attributes.is_content_translated Boolean Indicates if the CVE content has been machine-translated.
GoogleThreatIntelligence.CVE.attributes.autogenerated_tags List Tags automatically generated for this CVE.
GoogleThreatIntelligence.CVE.attributes.subscribers_count Number Number of GTI users subscribed to updates for this CVE.
GoogleThreatIntelligence.CVE.attributes.risk_rating String GTI-assigned risk rating (e.g., Low/Medium/High/Critical).
GoogleThreatIntelligence.CVE.attributes.sources.title String Title of the external reference source.
GoogleThreatIntelligence.CVE.attributes.sources.name String Name of the external reference source.
GoogleThreatIntelligence.CVE.attributes.sources.url String URL of the external reference source.
GoogleThreatIntelligence.CVE.attributes.sources.source_description String Description of the reference source.
GoogleThreatIntelligence.CVE.attributes.sources.cvss.cvssv2_0.base_score Number CVSS v2 base score from the source.
GoogleThreatIntelligence.CVE.attributes.sources.cvss.cvssv2_0.temporal_score Number CVSS v2 temporal score from the source.
GoogleThreatIntelligence.CVE.attributes.sources.cvss.cvssv2_0.vector String CVSS v2 vector string.
GoogleThreatIntelligence.CVE.attributes.sources.cvss.cvssv3_x.base_score Number CVSS v3 base score from the source.
GoogleThreatIntelligence.CVE.attributes.sources.cvss.cvssv3_x.temporal_score Number CVSS v3 temporal score from the source.
GoogleThreatIntelligence.CVE.attributes.sources.cvss.cvssv3_x.vector String CVSS v3 vector string.
GoogleThreatIntelligence.CVE.attributes.sources.cvss.cvssv4_x.score Number CVSS v4 base score from the source.
GoogleThreatIntelligence.CVE.attributes.sources.cvss.cvssv4_x.vector String CVSS v4 vector string.
GoogleThreatIntelligence.CVE.attributes.sources.cvss.cvssv4_x.threat.exploit_maturity String Threat metrics associated with CVSS v4.
GoogleThreatIntelligence.CVE.attributes.sources.cvss.cvssv3_x_translated.temporal_score Number Machine-translated CVSS v3 metrics.
GoogleThreatIntelligence.CVE.attributes.sources.cvss.cvssv3_x_translated.base_score Number Machine-translated CVSS v3 metrics.
GoogleThreatIntelligence.CVE.attributes.sources.cvss.cvssv3_x_translated.vector String Machine-translated CVSS v3 metrics.
GoogleThreatIntelligence.CVE.attributes.sources.published_date String Source publication date for the CVE information.
GoogleThreatIntelligence.CVE.attributes.sources.md5 String MD5 hash associated with the source content.
GoogleThreatIntelligence.CVE.attributes.sources.unique_id String Unique identifier for the source entry.
GoogleThreatIntelligence.CVE.attributes.name String Name/title of the CVE entry inside GTI.
GoogleThreatIntelligence.CVE.attributes.capabilities List Attacker capabilities related to the CVE.
GoogleThreatIntelligence.CVE.attributes.technologies List Technologies impacted by the CVE.
GoogleThreatIntelligence.CVE.attributes.counters.files Number Number of malicious files associated with the CVE.
GoogleThreatIntelligence.CVE.attributes.counters.domains Number Number of domains associated with the CVE.
GoogleThreatIntelligence.CVE.attributes.counters.ip_addresses Number Number of IP addresses linked to the CVE.
GoogleThreatIntelligence.CVE.attributes.counters.urls Number Number of URLs related to the CVE.
GoogleThreatIntelligence.CVE.attributes.counters.iocs Number Total indicator count associated with the CVE.
GoogleThreatIntelligence.CVE.attributes.counters.subscribers Number Number of subscribers following the CVE.
GoogleThreatIntelligence.CVE.attributes.counters.attack_techniques Number Count of associated attack techniques (MITRE etc.).
GoogleThreatIntelligence.CVE.attributes.cve_id String The CVE identifier (e.g., CVE-2024-12345).
GoogleThreatIntelligence.CVE.attributes.domains_count Number Number of domains involved in CVE activity.
GoogleThreatIntelligence.CVE.attributes.version_history.date Number Date when the version entry was updated.
GoogleThreatIntelligence.CVE.attributes.version_history.version_notes String Notes about changes in CVE version history.
GoogleThreatIntelligence.CVE.attributes.alt_names List Alternate names or aliases for the CVE.
GoogleThreatIntelligence.CVE.attributes.recent_activity_summary Number Recent activity score or summary related to exploitation.
GoogleThreatIntelligence.CVE.attributes.exploitation.exploit_release_date String Date when exploit code was released.
GoogleThreatIntelligence.CVE.attributes.exploitation.first_exploitation String Date when the CVE was first exploited.
GoogleThreatIntelligence.CVE.attributes.exploitation.tech_details_release_date String Date technical details were publicly released.
GoogleThreatIntelligence.CVE.attributes.mitigations List Mitigation steps for the CVE.
GoogleThreatIntelligence.CVE.attributes.top_icon_md5 List MD5 hash of the top-listed malicious sample.
GoogleThreatIntelligence.CVE.attributes.description String Full CVE description.
GoogleThreatIntelligence.CVE.attributes.targeted_regions List Geographic regions targeted by exploitation.
GoogleThreatIntelligence.CVE.attributes.detection_names List Security vendor detection names linked to the CVE.
GoogleThreatIntelligence.CVE.attributes.vendor_fix_references List Vendor-published fix or patch references.
GoogleThreatIntelligence.CVE.attributes.malware_roles List Malware roles (dropper, loader, etc.) related to the CVE.
GoogleThreatIntelligence.CVE.attributes.collection_links List Related collection or reference links from GTI.
GoogleThreatIntelligence.CVE.attributes.source_regions_hierarchy List Hierarchy of affected regions sourced by GTI.
GoogleThreatIntelligence.CVE.attributes.references_count Number Number of references for the CVE.
GoogleThreatIntelligence.CVE.attributes.creation_date Number Date when the CVE entry was created in GTI.
GoogleThreatIntelligence.CVE.attributes.risk_factors String List of risk factors contributing to severity.
GoogleThreatIntelligence.CVE.attributes.exploit_availability String Availability status of exploit (e.g., Available/None).
GoogleThreatIntelligence.CVE.attributes.merged_actors List Threat actors linked to this vulnerability.
GoogleThreatIntelligence.CVE.attributes.first_seen_details List Details on when this CVE was first observed.
GoogleThreatIntelligence.CVE.attributes.available_mitigation List Available mitigations for exploitation prevention.
GoogleThreatIntelligence.CVE.attributes.last_modification_date Number Last updated timestamp for the CVE in GTI.
GoogleThreatIntelligence.CVE.attributes.mve_id String MVE (Multi-Vulnerability Event) ID for grouping related issues.
GoogleThreatIntelligence.CVE.attributes.tags List Tags associated with the CVE inside GTI.
GoogleThreatIntelligence.CVE.attributes.cvss.cvssv2_0.base_score Number CVSS v2 base score.
GoogleThreatIntelligence.CVE.attributes.cvss.cvssv2_0.temporal_score Number CVSS v2 temporal score.
GoogleThreatIntelligence.CVE.attributes.cvss.cvssv2_0.vector String CVSS v2 vector notation.
GoogleThreatIntelligence.CVE.attributes.cvss.cvssv3_x.base_score Number CVSS v3 base score.
GoogleThreatIntelligence.CVE.attributes.cvss.cvssv3_x.temporal_score Number CVSS v3 temporal score.
GoogleThreatIntelligence.CVE.attributes.cvss.cvssv3_x.vector String CVSS v3 vector string.
GoogleThreatIntelligence.CVE.attributes.cvss.cvssv4_x.score Number CVSS v4 score.
GoogleThreatIntelligence.CVE.attributes.cvss.cvssv4_x.supplemental.provider_urgency String Provider urgency supplemental metric.
GoogleThreatIntelligence.CVE.attributes.cvss.cvssv4_x.supplemental.response_effort String Response effort supplemental metric.
GoogleThreatIntelligence.CVE.attributes.cvss.cvssv4_x.supplemental.recovery String Recovery supplemental metric.
GoogleThreatIntelligence.CVE.attributes.cvss.cvssv4_x.supplemental.safety String Safety supplemental metric.
GoogleThreatIntelligence.CVE.attributes.cvss.cvssv4_x.supplemental.value_density String Value density supplemental metric.
GoogleThreatIntelligence.CVE.attributes.cvss.cvssv4_x.supplemental.automatable String Indicates if exploitation can be automated.
GoogleThreatIntelligence.CVE.attributes.cvss.cvssv4_x.vector String CVSS v4 vector string.
GoogleThreatIntelligence.CVE.attributes.cvss.cvssv4_x.threat.exploit_maturity String Exploit maturity level (e.g., High/Functional/Proof of Concept).
GoogleThreatIntelligence.CVE.attributes.cvss.cvssv3_x_translated.base_score Number Machine-translated CVSS v3 base score.
GoogleThreatIntelligence.CVE.attributes.cvss.cvssv3_x_translated.temporal_score Number Machine-translated CVSS v3 temporal score.
GoogleThreatIntelligence.CVE.attributes.cvss.cvssv3_x_translated.vector String Machine-translated CVSS v3 vector.
GoogleThreatIntelligence.CVE.attributes.collection_type String Type of GTI collection this CVE belongs to.
GoogleThreatIntelligence.CVE.attributes.targeted_industries List Industries targeted by exploitation of this CVE.
GoogleThreatIntelligence.CVE.attributes.cwe.title String Title of the mapped CWE (root cause).
GoogleThreatIntelligence.CVE.attributes.cwe.id String CWE identifier linked to the CVE.
GoogleThreatIntelligence.CVE.attributes.affected_systems List Systems or platforms affected by the vulnerability.
GoogleThreatIntelligence.CVE.attributes.tags_details List Detailed metadata for GTI tags.
GoogleThreatIntelligence.CVE.attributes.executive_summary String High-level summary of the vulnerability impact.
GoogleThreatIntelligence.CVE.attributes.priority String GTI-assigned priority score/category.
GoogleThreatIntelligence.CVE.attributes.alt_names_details List Additional details about alternate CVE names.
GoogleThreatIntelligence.CVE.attributes.targeted_regions_hierarchy List Hierarchy of targeted regions for exploitation.
GoogleThreatIntelligence.CVE.attributes.epss.percentile Number EPSS percentile (Exploit Prediction Scoring System).
GoogleThreatIntelligence.CVE.attributes.epss.score Number EPSS score indicating exploitation likelihood.
GoogleThreatIntelligence.CVE.attributes.date_of_disclosure Number Date when the vulnerability was publicly disclosed.
GoogleThreatIntelligence.CVE.attributes.days_to_report Number Time taken from discovery to reporting.
GoogleThreatIntelligence.CVE.attributes.targeted_industries_tree List Hierarchical breakdown of targeted industries.
GoogleThreatIntelligence.CVE.attributes.status String Current vulnerability status (e.g., Active, Resolved).
GoogleThreatIntelligence.CVE.attributes.intended_effects List Intent or malicious outcomes achieved by exploiting the CVE.
GoogleThreatIntelligence.CVE.attributes.private Boolean Whether the CVE entry is private in GTI.
GoogleThreatIntelligence.CVE.attributes.targeted_informations List Types of information targeted by attackers.
GoogleThreatIntelligence.CVE.attributes.ip_addresses_count Number Number of IPs related to the vulnerability.
GoogleThreatIntelligence.CVE.attributes.mati_genids_dict.report_id String MATI report ID linked to the CVE.
GoogleThreatIntelligence.CVE.attributes.mati_genids_dict.cve_id String CVE ID mapped within MATI dataset.
GoogleThreatIntelligence.CVE.attributes.mati_genids_dict.mve_id String MVE ID mapped within MATI dataset.
GoogleThreatIntelligence.CVE.attributes.exploitation_state String Current exploitation state (Known Exploited / No Evidence).
GoogleThreatIntelligence.CVE.attributes.field_sources.source.sources List Source list for specific enriched fields.
GoogleThreatIntelligence.CVE.attributes.field_sources.source.source_url String URL of the field’s data source.
GoogleThreatIntelligence.CVE.attributes.field_sources.source.field_type String Type of field data (e.g., text, reference).
GoogleThreatIntelligence.CVE.attributes.field_sources.source.source_name String Name of the field’s data source provider.
GoogleThreatIntelligence.CVE.attributes.field_sources.field String Field name being sourced.
GoogleThreatIntelligence.CVE.attributes.field_sources.source.sources.source_names String Names of the sources contributing to this field.
GoogleThreatIntelligence.CVE.attributes.field_sources.source.sources.source_urls List URLs of the sources contributing to this field.
GoogleThreatIntelligence.CVE.attributes.exploitation_vectors String Methods or vectors used to exploit the vulnerability.
GoogleThreatIntelligence.CVE.attributes.threat_scape String Threat landscape and context around the CVE.
GoogleThreatIntelligence.CVE.attributes.operating_systems List Operating systems impacted by the CVE.
GoogleThreatIntelligence.CVE.attributes.last_seen_details List Last observed exploitation activity details.
GoogleThreatIntelligence.CVE.attributes.workarounds List Workarounds available to mitigate the vulnerability.
GoogleThreatIntelligence.CVE.attributes.motivations List Attacker motivations behind exploiting this CVE.
GoogleThreatIntelligence.CVE.attributes.predicted_risk_rating String AI-generated predicted risk rating.
GoogleThreatIntelligence.CVE.attributes.files_count Number Number of files linked to the CVE.
GoogleThreatIntelligence.CVE.attributes.exploitation_consequence String Possible consequences of exploitation.
GoogleThreatIntelligence.CVE.attributes.origin String Origin/source of the CVE data.
GoogleThreatIntelligence.CVE.attributes.aggregations List Aggregated threat or metadata information.
GoogleThreatIntelligence.CVE.context_attributes.shared_with_me Boolean Indicates if the CVE is shared with the user.
GoogleThreatIntelligence.CVE.context_attributes.role String User role for viewing this CVE in GTI.

Command Example

!cve cve=CVE-2022-30190

Context Example

{
    "CVE": {
        "CVSS": {
            "Score": 7.8,
            "Vector": "CVSS:3.1/AV:L/AC:L/PR:N/UI:R/S:U/C:H/I:H/A:H/E:F/RL:O/RC:C"
        },
        "Description": "google has provided the follow description:  \n*A remote code execution vulnerability exists when MSDT is called using the URL protocol from a calling application such as Word.",
        "ID": "CVE-2022-30190",
        "Modified": "2025-10-29T18:46:49.000Z",
        "Published": "2022-05-27T00:00:00.000Z",
        "Relationships": [
            {
                "EntityA": "CVE-2022-30190",
                "EntityAType": "CVE",
                "EntityB": "test_md5_001",
                "EntityBType": "File",
                "Relationship": "related-to"
            },
            {
                "EntityA": "CVE-2022-30190",
                "EntityAType": "CVE",
                "EntityB": "test_md5_002",
                "EntityBType": "File",
                "Relationship": "related-to"
            }
        ],
        "STIXID": "CVE-2022-30190",
        "Tags": [
            "observed_in_the_wild",
            "has_exploits",
            "was_zero_day",
            "media_attention"
        ]
    },
    "DBotScore": {
        "Indicator": "CVE-2022-30190",
        "Reliability": "C - Fairly reliable",
        "Score": 2,
        "Type": "cve",
        "Vendor": "GoogleThreatIntelligence"
    },
    "GoogleThreatIntelligence": {
        "CVE": {
            "id": "vulnerability--cve-2022-30190",
            "type": "collection",
            "links": {
                "self": "https://www.virustotal.com/api/v3/collections/vulnerability--cve-2022-30190"
            },
            "attributes": {
                "description": "google has provided the following description:  \n*A remote code execution vulnerability exists when MSDT is called using the URL protocol from a calling application such as Word.",
                "risk_factors": [
                    "User Interaction Required"
                ],
                "predicted_risk_rating": "",
                "exploitation_state": "Confirmed",
                "version_history": [
                    {
                        "date": 1761763609,
                        "version_notes": [
                            "cisa_known_exploited.ransomware_use: Unknown -> Known"
                        ]
                    }
                ],
                "recent_activity_relative_change": 0.0714285714285714,
                "cisa_known_exploited": {
                    "added_date": 1655164800,
                    "due_date": 1656979200,
                    "ransomware_use": "Known"
                },
                "origin": "Google Threat Intelligence",
                "exploitation": {
                    "tech_details_release_date": 1689120000,
                    "first_exploitation": 1651276800,
                    "exploit_release_date": 1653868800
                },
                "available_mitigation": [
                    "Workaround",
                    "Patch"
                ],
                "alt_names_details": [
                    {
                        "value": "Follina",
                        "confidence": "possible"
                    }
                ],
                "mve_id": "MVE-2022-4552",
                "tags": [
                    "observed_in_the_wild",
                    "has_exploits",
                    "was_zero_day",
                    "media_attention"
                ],
                "executive_summary": "* An Improper Control of Generation of Code ('Code Injection') vulnerability exists that, when exploited, allows a remote attacker to execute arbitrary code.",
                "autogenerated_tags": [
                    "cve-2021-40444"
                ],
                "workarounds": [
                    "<p>google recommends disabling the MSDT URL Protocol as a method to mitigate the chance of exploitation. For more information see their advisory."
                ],
                "date_of_disclosure": 1653609600,
                "vendor_fix_references": [
                    {
                        "url": "https://portal.msrc.google.com/en-US/security-guidance/advisory/CVE-2022-30190",
                        "name": "google Corp.",
                        "published_date": 1653894000,
                        "title": "google Windows Support Diagnostic Tool (MSDT) Remote Code Execution Vulnerability (CVE-2022-30190)"
                    }
                ],
                "cpes": [
                    {
                        "start_cpe": {
                            "version": "R2",
                            "uri": "cpe:2.3:o:google:windows_server_2012:r2:*:*:*:*:*:*:*",
                            "product": "Windows Server 2012 (OS)",
                            "vendor": "google"
                        },
                        "start_rel": "="
                    }
                ],
                "field_sources": [
                    {
                        "field": "cvss.cvssv3_x",
                        "source": {
                            "field_type": "Ranked",
                            "source_name": "Google Threat Intelligence Group (GTIG)",
                            "source_url": ""
                        }
                    }
                ],
                "ip_addresses_count": 0,
                "private": true,
                "cve_id": "CVE-2022-30190",
                "sources": [
                    {
                        "md5": "test_md5_001",
                        "url": "https://github.com/cisagov/vulnrichment/blob/develop/2022/30xxx/test_CVE_2022_30190.json",
                        "name": "Cybersecurity and Infrastructure Security Agency (CISA)",
                        "published_date": 1654114217,
                        "title": "google Windows Support Diagnostic Tool (MSDT) Remote Code Execution Vulnerability",
                        "cvss": {
                            "cvssv3_x": {
                                "base_score": 7.8,
                                "vector": "CVSS:3.1/AV:L/AC:L/PR:N/UI:R/S:U/C:H/I:H/A:H/E:P/RL:O/RC:C"
                            }
                        }
                    },
                    {
                        "md5": "test_md5_002",
                        "url": "https://github.com/CVEProject/cvelistV5/blob/main/cves/2022/30xxx/test_CVE_2022_30190.json",
                        "name": "Mitre Corporation",
                        "published_date": 1654114217,
                        "title": "google Windows Support Diagnostic Tool (MSDT) Remote Code Execution Vulnerability",
                        "cvss": {
                            "cvssv3_x": {
                                "base_score": 7.8,
                                "vector": "CVSS:3.1/AV:L/AC:L/PR:N/UI:R/S:U/C:H/I:H/A:H/E:P/RL:O/RC:C"
                            }
                        }
                    }
                ],
                "alt_names": [
                    "Follina"
                ],
                "exploitation_consequence": "Code Execution",
                "name": "CVE-2022-30190",
                "tags_details": [
                    {
                        "value": "has_exploits",
                        "confidence": "possible"
                    }
                ],
                "analysis": "An attacker could exploit this vulnerability to execute arbitrary code. An attacker would need to create a specially url calling MSDT and cause a user to open it on a vulnerable system.",
                "summary_stats": {
                    "first_submission_date": {
                        "min": 0,
                        "max": 1746722000,
                        "avg": 733834342.875
                    },
                    "last_submission_date": {
                        "min": 0,
                        "max": 1746722000,
                        "avg": 735827136.25
                    },
                    "files_detections": {
                        "min": 0,
                        "max": 48,
                        "avg": 16.5625
                    }
                },
                "files_count": 18,
                "creation_date": 1653927632,
                "exploitation_vectors": [
                    "File Share",
                    "Web",
                    "Email",
                    "Malicious File"
                ],
                "recent_activity_summary": [],
                "days_to_report": 3,
                "last_modification_date": 1761763609,
                "is_content_translated": false,
                "risk_rating": "MEDIUM",
                "exploit_availability": "Publicly Available",
                "vulnerable_products": "",
                "references_count": 0,
                "urls_count": 0,
                "days_to_patch": 3,
                "collection_type": "vulnerability",
                "counters": {
                    "files": 18,
                    "domains": 0,
                    "ip_addresses": 0,
                    "urls": 0,
                    "iocs": 18,
                    "subscribers": 0,
                    "attack_techniques": 0
                },
                "status": "COMPUTED",
                "epss": {
                    "score": 0.93187,
                    "percentile": 0.99784
                },
                "mati_genids_dict": {
                    "mve_id": "vulnerability--test_mve_id",
                    "cve_id": "vulnerability--test_cve_id",
                    "report_id": "report--test_report_id"
                },
                "cvss": {
                    "cvssv3_x": {
                        "base_score": 7.8,
                        "vector": "CVSS:3.1/AV:L/AC:L/PR:N/UI:R/S:U/C:H/I:H/A:H/E:F/RL:O/RC:C",
                        "temporal_score": 7.2
                    },
                    "cvssv2_0": {
                        "base_score": 6.8,
                        "vector": "AV:N/AC:M/Au:N/C:P/I:P/A:P/E:F/RL:OF/RC:C",
                        "temporal_score": 5.6
                    }
                },
                "domains_count": 0,
                "subscribers_count": 0,
                "priority": "P1",
                "cwe": {
                    "title": "Improper Control of Generation of Code ('Code Injection')",
                    "id": "CWE-94"
                }
            },
            "context_attributes": {
                "shared_with_me": false,
                "role": "viewer"
            }
        }
    }
}

Human Readable Output

CVE Information: CVE-2022-30190

CVE ID Risk Rating Priority Exploitation State Exploit Availability CVSS v3.x Score CVSS v4.x Score CVSS v3.x Vector Date Of Disclosure Creation Date Last Modified Sources Description Related Files Related Domains Related IPs Related URLs Executive Summary
CVE-2022-30190 MEDIUM P1 Confirmed Publicly Available 7.8 0 CVSS:3.1/AV:L/AC:L/PR:N/UI:R/S:U/C:H/I:H/A:H/E:F/RL:O/RC:C 2022-05-27T00:00:00.000Z 2022-05-30T16:20:32.000Z 2025-10-29T18:46:49.000Z 2 google has provided the following description:
*A remote code execution vulnerability exists when MSDT is called using the URL protocol from a calling application such as Word.		 2 0 0 0 * An Improper Control of Generation of Code (‘Code Injection’) vulnerability exists that, when exploited, allows a remote attacker to execute arbitrary code.

url-scan

Scans a specified URL. Use the gti-analysis-get command to get the scan results.

Base Command

url-scan

Input

Argument Name Description Required
url The URL to scan. Required

Context Output

Path Type Description
GoogleThreatIntelligence.Submission.Type String The type of the submission (analysis).
GoogleThreatIntelligence.Submission.id String The ID of the submission.
GoogleThreatIntelligence.Submission.hash String The indicator sent to rescan.

Command Example

!url-scan url=https://example.com

Context Example

{
    "GoogleThreatIntelligence": {
        "Submission": {
            "id": "u-0f115db062b7c0dd030b16878c99dea5c354b49dc37b38eb8846179c7783e9d7-1617088890",
            "type": "analysis",
            "url": "https://example.com"
        }
    },
    "gtiScanID": "u-0f115db062b7c0dd030b16878c99dea5c354b49dc37b38eb8846179c7783e9d7-1617088890"
}

Human Readable Output

New url submission

id url
u-0f115db062b7c0dd030b16878c99dea5c354b49dc37b38eb8846179c7783e9d7-1617088890 https://example.com

gti-comments-add

Adds comments to files and URLs.

Base Command

gti-comments-add

Input

Argument Name Description Required
resource The file hash (MD5, SHA1, orSHA256), Domain, URL or IP on which you’re commenting on. If not supplied, will try to determine if it’s a hash or a url. Required
resource_type The type of the resource on which you’re commenting. Possible values are: ip, url, domain, hash. Optional
comment The actual review that you can tag by using the “#” twitter-like syntax, for example, #disinfection #zbot, and reference users using the “@” syntax, for example, @GoogleThreatIntelligenceTeam. Required

Context Output

Path Type Description
GoogleThreatIntelligence.Comments.comments.attributes.date Number The date of the comment in epoch format.
GoogleThreatIntelligence.Comments.comments.attributes.text String The text of the comment.
GoogleThreatIntelligence.Comments.comments.attributes.votes.positive Number Number of positive votes.
GoogleThreatIntelligence.Comments.comments.attributes.votes.abuse Number Number of abuse votes.
GoogleThreatIntelligence.Comments.comments.attributes.votes.negative Number Number of negative votes.
GoogleThreatIntelligence.Comments.comments.attributes.html String The HTML content.
GoogleThreatIntelligence.Comments.comments.type String The type of the comment.
GoogleThreatIntelligence.Comments.comments.id String ID of the comment.
GoogleThreatIntelligence.Comments.comments.links.self String Link to the request.

Command Example

!gti-comments-add resource=paloaltonetworks.com resource_type=domain comment="this is a comment"

Context Example

{
    "GoogleThreatIntelligence": {
        "Comments": {
            "comments": {
                "attributes": {
                    "date": 1617088894,
                    "html": "this is a comment",
                    "tags": [],
                    "text": "this is a comment",
                    "votes": {
                        "abuse": 0,
                        "negative": 0,
                        "positive": 0
                    }
                },
                "id": "d-paloaltonetworks.com-e757b16b",
                "links": {
                    "self": "https://www.virustotal.com/api/v3/comments/d-paloaltonetworks.com-e757b16b"
                },
                "type": "comment"
            }
        }
    }
}

Human Readable Output

Comment has been added

Date Text Positive Votes Abuse Votes Negative Votes
2021-03-30 07:21:34Z this is a comment 0 0 0

gti-file-scan-upload-url

Premium API. Get a special URL for files larger than 32 MB.

Base Command

gti-file-scan-upload-url

Input

There are no input arguments for this command.

Context Output

Path Type Description
GoogleThreatIntelligence.FileUploadURL unknown The special upload URL for large files.

Command Example


#### Context Example

```json
{
    "GoogleThreatIntelligence": {
        "FileUploadURL": "https://www.virustotal.com/_ah/upload/**upload-hash**"
    },
    "gtiUploadURL": "https://www.virustotal.com/_ah/upload/**upload-hash**"
}

Human Readable Output

New upload url acquired

Upload url
https://www.virustotal.com/_ah/upload/**upload-hash**/

gti-comments-delete

Delete a comment.

Base Command

gti-comments-delete

Input

Argument Name Description Required
id Comment ID. Required

Context Output

There is no context output for this command.

Command Example

!gti-comments-delete id=d-paloaltonetworks.com-7886a33c

Human Readable Output

Comment d-paloaltonetworks.com-7886a33c has been deleted!

gti-comments-get

Retrieves comments for a given resource.

Base Command

gti-comments-get

Input

Argument Name Description Required
resource The file hash (MD5, SHA1, orSHA256), Domain, URL or IP on which you’re commenting on. If not supplied, will try to determine if it’s a hash or a url. Required
resource_type The type of the resource on which you’re commenting. If not supplied, will determine if it’s a url or a file. Possible values are: ip, url, domain, file. Optional
limit Maximum comments to fetch. Default is 10. Optional
before Fetch only comments before the given time. Optional

Context Output

Path Type Description
GoogleThreatIntelligence.Comments.id String ID that contains the comment (the given hash, domain, url, or ip).
GoogleThreatIntelligence.Comments.comments.attributes.date Number The date of the comment in epoch format.
GoogleThreatIntelligence.Comments.comments.attributes.text String The text of the comment.
GoogleThreatIntelligence.Comments.comments.attributes.votes.positive Number Number of positive votes.
GoogleThreatIntelligence.Comments.comments.attributes.votes.abuse Number Number of abuse votes.
GoogleThreatIntelligence.Comments.comments.attributes.votes.negative Number Number of negative votes.
GoogleThreatIntelligence.Comments.comments.attributes.html String The HTML content.
GoogleThreatIntelligence.Comments.comments.type String The type of the comment.
GoogleThreatIntelligence.Comments.comments.id String ID of the commented.
GoogleThreatIntelligence.Comments.comments.links.self String Link to the request

Command Example

!gti-comments-get resource=https://paloaltonetworks.com

Context Example

{
    "GoogleThreatIntelligence": {
        "Comments": {
            "comments": [
                {
                    "attributes": {
                        "date": 1616325673,
                        "html": "another comment",
                        "tags": [],
                        "text": "another comment",
                        "votes": {
                            "abuse": 0,
                            "negative": 0,
                            "positive": 0
                        }
                    },
                    "id": "u-c5fad1f7084153e328563fbacdb07a9ad6428dc3f0a88e756266efb7c0553d9d-fe2d6a9e",
                    "links": {
                        "self": "https://www.virustotal.com/api/v3/comments/u-c5fad1f7084153e328563fbacdb07a9ad6428dc3f0a88e756266efb7c0553d9d-fe2d6a9e"
                    },
                    "type": "comment"
                },
                {
                    "attributes": {
                        "date": 1616325673,
                        "html": "another comment",
                        "tags": [],
                        "text": "another comment",
                        "votes": {
                            "abuse": 0,
                            "negative": 0,
                            "positive": 0
                        }
                    },
                    "id": "u-c5fad1f7084153e328563fbacdb07a9ad6428dc3f0a88e756266efb7c0553d9d-d63782a9",
                    "links": {
                        "self": "https://www.virustotal.com/api/v3/comments/u-c5fad1f7084153e328563fbacdb07a9ad6428dc3f0a88e756266efb7c0553d9d-d63782a9"
                    },
                    "type": "comment"
                },
                {
                    "attributes": {
                        "date": 1616313101,
                        "html": "a new comment",
                        "tags": [],
                        "text": "a new comment",
                        "votes": {
                            "abuse": 0,
                            "negative": 0,
                            "positive": 0
                        }
                    },
                    "id": "u-c5fad1f7084153e328563fbacdb07a9ad6428dc3f0a88e756266efb7c0553d9d-97a331a3",
                    "links": {
                        "self": "https://www.virustotal.com/api/v3/comments/u-c5fad1f7084153e328563fbacdb07a9ad6428dc3f0a88e756266efb7c0553d9d-97a331a3"
                    },
                    "type": "comment"
                },
                {
                    "attributes": {
                        "date": 1616313067,
                        "html": "a comment",
                        "tags": [],
                        "text": "a comment",
                        "votes": {
                            "abuse": 0,
                            "negative": 0,
                            "positive": 0
                        }
                    },
                    "id": "u-c5fad1f7084153e328563fbacdb07a9ad6428dc3f0a88e756266efb7c0553d9d-ae0de9fc",
                    "links": {
                        "self": "https://www.virustotal.com/api/v3/comments/u-c5fad1f7084153e328563fbacdb07a9ad6428dc3f0a88e756266efb7c0553d9d-ae0de9fc"
                    },
                    "type": "comment"
                }
            ],
            "indicator": "https://paloaltonetworks.com"
        }
    }
}

Human Readable Output

GoogleThreatIntelligence comments of url: “https://paloaltonetworks.com”

Date Text Positive Votes Abuse Votes Negative Votes
2021-03-21 11:21:13Z another comment 0 0 0
2021-03-21 11:21:13Z another comment 0 0 0
2021-03-21 07:51:41Z a new comment 0 0 0
2021-03-21 07:51:07Z a comment 0 0 0

gti-comments-get-by-id

Retrieves a comment by comment ID.

Base Command

gti-comments-get-by-id

Input

Argument Name Description Required
id The comment’s ID. Can be retrieved using the gti-comments-get command. Required

Context Output

Path Type Description
GoogleThreatIntelligence.Comments.comments.id String ID of the comment.
GoogleThreatIntelligence.Comments.comments.attributes.date Number The date of the comment in epoch format.
GoogleThreatIntelligence.Comments.comments.attributes.text String The text of the comment.
GoogleThreatIntelligence.Comments.comments.attributes.votes.positive Number Number of positive votes.
GoogleThreatIntelligence.Comments.comments.attributes.votes.abuse Number Number of abuse votes.
GoogleThreatIntelligence.Comments.comments.attributes.votes.negative Number Number of negative votes.
GoogleThreatIntelligence.Comments.comments.attributes.html String The HTML content.
GoogleThreatIntelligence.Comments.comments.type String The type of the comment.
GoogleThreatIntelligence.Comments.comments.links.self String Link to the request.

Command Example

!gti-comments-get-by-id id=d-paloaltonetworks.com-64591897

Context Example

{
    "GoogleThreatIntelligence": {
        "Comments": {
            "comments": {
                "attributes": {
                    "date": 1615195751,
                    "html": "a new comment!",
                    "tags": [],
                    "text": "a new comment!",
                    "votes": {
                        "abuse": 0,
                        "negative": 0,
                        "positive": 0
                    }
                },
                "id": "d-paloaltonetworks.com-64591897",
                "links": {
                    "self": "https://www.virustotal.com/api/v3/comments/d-paloaltonetworks.com-64591897"
                },
                "type": "comment"
            }
        }
    }
}

Human Readable Output

Comment of ID d-paloaltonetworks.com-64591897

Date Text Positive Votes Abuse Votes Negative Votes
2021-03-08 09:29:11Z a new comment! 0 0 0

gti-search

Search for an indicator in GoogleThreatIntelligence.

Base Command

gti-search

Input

Argument Name Description Required
query This endpoint searches any of the following: A file hash, URL, domain, IP address, tag comments. Required
extended_data Whether to return extended data (last_analysis_results). Possible values are: true, false. Optional
limit Maximum number of results to fetch. Default is 10. Optional

Context Output

Path Type Description
GoogleThreatIntelligence.SearchResults.attributes.last_analysis_stats.harmless Number Number of engines that found the indicator to be harmless.
GoogleThreatIntelligence.SearchResults.attributes.last_analysis_stats.malicious Number Number of engines that found the indicator to be malicious.
GoogleThreatIntelligence.SearchResults.attributes.last_analysis_stats.suspicious Number Number of engines that found the indicator to be suspicious.
GoogleThreatIntelligence.SearchResults.attributes.last_analysis_stats.undetected Number Number of engines that could not detect the indicator.
GoogleThreatIntelligence.SearchResults.attributes.last_analysis_stats.timeout Number Number of engines that timed out.
GoogleThreatIntelligence.SearchResults.attributes.reputation Number The indicator’s reputation
GoogleThreatIntelligence.SearchResults.attributes.last_modification_date Number The last modification date in epoch format.
GoogleThreatIntelligence.SearchResults.attributes.total_votes.harmless Number Total number of harmless votes.
GoogleThreatIntelligence.SearchResults.attributes.total_votes.malicious Number Total number of malicious votes.
GoogleThreatIntelligence.SearchResults.type String The type of the indicator (ip, domain, url, file).
GoogleThreatIntelligence.SearchResults.id String ID of the indicator.
GoogleThreatIntelligence.SearchResults.links.self String Link to the response.

Command Example

!gti-search query=paloaltonetworks.com

Context Example

{
    "GoogleThreatIntelligence": {
        "SearchResults": {
            "attributes": {
                "categories": {
                    "BitDefender": "marketing",
                    "Forcepoint ThreatSeeker": "information technology",
                    "alphaMountain.ai": "Business/Economy, Information Technology",
                    "sophos": "information technology"
                },
                "creation_date": 1108953730,
                "favicon": {
                    "dhash": "02e9ecb69ac869a8",
                    "raw_md5": "920c3c89139c32d356fa4b8b61616f37"
                },
                "jarm": "29d3fd00029d29d00042d43d00041d598ac0c1012db967bb1ad0ff2491b3ae",
                "last_analysis_stats": {
                    "harmless": 75,
                    "malicious": 0,
                    "suspicious": 0,
                    "timeout": 0,
                    "undetected": 7
                },
                "last_dns_records": [
                    {
                        "ttl": 14399,
                        "type": "TXT",
                        "value": "atlassian-domain-verification=WeW32v7AwYQEviMzlNjYyXNMUngcnmIMtNZKJ69TuQUoda5T6DFFV/A6rRvOzwvs"
                    }
],
                "last_dns_records_date": 1616986415,
                "last_https_certificate": {
                    "cert_signature": {
                        "signature": "signature",
                        "signature_algorithm": "sha256RSA"
                    },
                    "extensions": {
                        "**exten**": "0482016a0168007600a4b90990b418581487bb13a2cc67700a3c359804f91bdf",
                        "CA": true,
                        "authority_key_identifier": {
                            "keyid": "40c2bd278ecc348330a233d7fb6cb3f0b42c80ce"
                        },
                        "ca_information_access": {
                            "CA Issuers": "http://certificates.example.com/repository/gdig2.crt",
                            "OCSP": "http://ocsp.example.com/"
                        },
                        "certificate_policies": [
                            "**policy**"
                        ],
                        "crl_distribution_points": [
                            "http://example.com/gdig2s1-1677.crl"
                        ],
                        "extended_key_usage": [
                            "serverAuth",
                            "clientAuth"
                        ],
                        "key_usage": [
                            "ff"
                        ],
                        "subject_alternative_name": [
                            "www.paloaltonetworks.com"
                        ],
                        "subject_key_identifier": "ed89d4b918aab2968bd1dfde421a179c51445be0",
                        "tags": []
                    },
                    "issuer": {
                        "C": "US",
                        "CN": "Go Daddy Secure Certificate Authority - G2",
                        "L": "Scottsdale",
                        "O": "example.com, Inc.",
                        "OU": "http://certs.example.com/repository/",
                        "ST": "Arizona"
                    },
                    "public_key": {
                        "algorithm": "RSA",
                        "rsa": {
                            "exponent": "010001",
                            "key_size": 2048,
                            "modulus": "modulus"
                        }
                    },
                    "serial_number": "f5fa379466d9884a",
                    "signature_algorithm": "sha256RSA",
                    "size": 1963,
                    "subject": {
                        "CN": "www.paloaltonetworks.com",
                        "OU": "Domain Control Validated"
                    },
                    "tags": [],
                    "thumbprint": "0296c20e3a4a607b8d9e2af86155cde04594535e",
                    "thumbprint_sha256": "17bb7bda507abc602bdf1b160d7f51edaccac39fd34f8dab1e793c3612cfc8c2",
                    "validity": {
                        "not_after": "2022-01-27 16:52:24",
                        "not_before": "2020-01-27 16:52:24"
                    },
                    "version": "V3"
                },
                "last_https_certificate_date": 1616986415,
                "last_modification_date": 1617084294,
                "last_update_date": 1594825871,
                "popularity_ranks": {
                    "Alexa": {
                        "rank": 32577,
                        "timestamp": 1617032161
                    }
                },
                "registrar": "MarkMonitor Inc.",
                "reputation": 0,
                "tags": [],
                "total_votes": {
                    "harmless": 0,
                    "malicious": 0
                },
                "whois": "whois string",
                "whois_date": 1615321176
            },
            "id": "paloaltonetworks.com",
            "links": {
                "self": "https://www.virustotal.com/api/v3/domains/paloaltonetworks.com"
            },
            "type": "domain"
        }
    }
}

Human Readable Output

Search result of query paloaltonetworks.com

Categories CreationDate LastAnalysisStats    
Forcepoint ThreatSeeker: information technology
sophos: information technology
BitDefender: marketing
alphaMountain.ai: Business/Economy, Information Technology		 1108953730 harmless: 75
malicious: 0
suspicious: 0
undetected: 7
timeout: 0		   1615321176

gti-file-sandbox-report

Retrieves a behavioral relationship of the given file hash.

Base Command

gti-file-sandbox-report

Input

Argument Name Description Required
file Hash of the file to query. Supports MD5, SHA1, and SHA256. Required
limit Maximum number of results to fetch. Default is 10. Optional

Context Output

Path Type Description
SandboxReport.attributes.analysis_date Number The date of the analysis in epoch format.
SandboxReport.attributes.behash String Behash of the attribute.
SandboxReport.attributes.command_executions String Which command were executed.
SandboxReport.attributes.dns_lookups.hostname String Host names found in the lookup.
SandboxReport.attributes.dns_lookups.resolved_ips String The IPs that were resolved.
SandboxReport.attributes.files_attribute_changed String The file attributes that were changed.
SandboxReport.attributes.has_html_report Boolean Whether there is an HTML report.
SandboxReport.attributes.has_pcap Boolean Whether the IP has a PCAP file.
SandboxReport.attributes.http_conversations.request_method String The request method of the HTTP conversation.
SandboxReport.attributes.http_conversations.response_headers.Cache-Control String The cache-control method of the response header.
SandboxReport.attributes.http_conversations.response_headers.Connection String The connection of the response header.
SandboxReport.attributes.http_conversations.response_headers.Content-Length String THe Content-Length of the response header.
SandboxReport.attributes.http_conversations.response_headers.Content-Type String The Content-Type of the response header.
SandboxReport.attributes.http_conversations.response_headers.Pragma String The pragma of the response header.
SandboxReport.attributes.http_conversations.response_headers.Server String The server of the response header.
SandboxReport.attributes.http_conversations.response_headers.Status-Line String The Status-Line of the response header.
SandboxReport.attributes.http_conversations.response_status_code Number The response status code.
SandboxReport.attributes.http_conversations.url String The conversation URL.
SandboxReport.attributes.last_modification_date Number Last modified data in epoch format.
SandboxReport.attributes.modules_loaded String Loaded modules.
SandboxReport.attributes.mutexes_created String The mutexes that were created.
SandboxReport.attributes.mutexes_opened String The mutexes that were opened.
SandboxReport.attributes.processes_created String The processes that were created.
SandboxReport.attributes.processes_tree.name String The name of the process tree.
SandboxReport.attributes.processes_tree.process_id String The ID of the process.
SandboxReport.attributes.registry_keys_deleted String Deleted registry keys.
SandboxReport.attributes.registry_keys_set.key String Key of the registry key.
SandboxReport.attributes.registry_keys_set.value String Value of the registry key.
SandboxReport.attributes.sandbox_name String The name of the sandbox.
SandboxReport.attributes.services_started String The services that were started.
SandboxReport.attributes.verdicts String The verdicts.
SandboxReport.id String The IP analyzed.
SandboxReport.links.self String Link to the response.
SandboxReport.attributes.files_dropped.path String Path of the file dropped.
SandboxReport.attributes.files_dropped.sha256 String SHA-256 hash of the dropped files.
SandboxReport.attributes.files_opened String The files that were opened.
SandboxReport.attributes.files_written String The files that were written.
SandboxReport.attributes.ip_traffic.destination_ip String Destination IP in the traffic.
SandboxReport.attributes.ip_traffic.destination_port Number Destination port in the traffic.
SandboxReport.attributes.ip_traffic.transport_layer_protocol String Transport layer protocol in the traffic.
SandboxReport.attributes.registry_keys_opened String The registry keys that were opened.
SandboxReport.attributes.tags String The tags of the DNS data.
SandboxReport.attributes.files_copied.destination String Destination of the files copied.
SandboxReport.attributes.files_copied.source String Source of the files copied.
SandboxReport.attributes.permissions_requested String The permissions that where requested.
SandboxReport.attributes.processes_injected String The processes that were injected.
SandboxReport.attributes.processes_terminated String The processes that were terminated.
SandboxReport.attributes.processes_tree.children.name String The name of the children of the process.
SandboxReport.attributes.processes_tree.children.process_id String The ID of the children of the process.
SandboxReport.attributes.services_opened String The services that were opened.
SandboxReport.attributes.text_highlighted String The text that was highlighted.
SandboxReport.attributes.calls_highlighted String The calls that were highlighted.
SandboxReport.attributes.processes_tree.children.time_offset Number The time offset of the children in the process.
SandboxReport.links.self String The link to the response.
SandboxReport.meta.count Number The number of objects that were found in the attributes.

Command Example

!gti-file-sandbox-report file=2b294b3499d1cce794badffc959b7618

Context Example

{
    "GoogleThreatIntelligence": {
        "SandboxReport": [
            {
                "attributes": {
                    "analysis_date": 1558429832,
                    "behash": "079386becc949a2aafdcd2c6042cf0a9",
                    "command_executions": [
                        "C:\\DOCUME~1\\Miller\\LOCALS~1\\Temp\\Win32.AgentTesla.exe",
                    ],
                    "dns_lookups": [
                        {
                            "hostname": "checkip.dyndns.org",
                            "resolved_ips": [
                                "**ip**"
                            ]
                        },
                        {
                            "hostname": "checkip.dyndns.org",
                            "resolved_ips": [
                                "**ip**"
                            ]
                        }
                    ],
                    "files_attribute_changed": [
                        "C:\\Documents and Settings\\Miller\\Local Settings\\Temp\\xws\\xws.exe"
                    ],
                    "has_html_report": false,
                    "has_pcap": false,
                    "http_conversations": [
                        {
                            "request_method": "GET",
                            "response_headers": {
                                "Cache-Control": "no-cache",
                                "Connection": "close",
                                "Content-Length": "107",
                                "Content-Type": "text/html",
                                "Pragma": "no-cache",
                                "Server": "DynDNS-CheckIP/1.0.1",
                                "Status-Line": "HTTP/1.1 200"
                            },
                            "response_status_code": 200,
                            "url": "http://checkip.dyndns.org/"
                        },
                        {
                            "request_method": "GET",
                            "response_headers": {
                                "Cache-Control": "no-cache",
                                "Connection": "close",
                                "Content-Length": "105",
                                "Content-Type": "text/html",
                                "Pragma": "no-cache",
                                "Server": "DynDNS-CheckIP/1.0.1",
                                "Status-Line": "HTTP/1.1 200"
                            },
                            "response_status_code": 200,
                            "url": "http://checkip.dyndns.org/"
                        }
                    ],
                    "last_modification_date": 1588377117,
                    "modules_loaded": [
                        "c:\\windows\\system32\\imm32.dll"
                    ],
                    "mutexes_created": [
                        "CTF.Compart.MutexDefaultS-1-5-21-1229272821-1563985344-1801674531-1003"
                    ],
                    "mutexes_opened": [
                        "ShimCacheMutex"
                    ],
                    "processes_created": [
                        "C:\\DOCUME~1\\Miller\\LOCALS~1\\Temp\\Win32.AgentTesla.exe"
                    ],
                    "processes_tree": [
                        {
                            "name": "C:\\DOCUME~1\\Miller\\LOCALS~1\\Temp\\Win32.AgentTesla.exe",
                            "process_id": "272"
                        }
                    ],
                    "registry_keys_deleted": [
                        "HKU\\S-1-5-21-3712457824-2419000099-45725732-1005\\SOFTWARE\\CLASSES\\MSCFILE\\SHELL\\OPEN\\COMMAND"
                    ],
                    "registry_keys_set": [
                        {
                            "key": "HKU\\S-1-5-21-1229272821-1563985344-1801674531-1003\\SOFTWARE\\MICROSOFT\\WINDOWS\\CURRENTVERSION\\RUN",
                            "value": "xws"
                        }
                    ],
                    "sandbox_name": "Lastline",
                    "services_started": [
                        "RASMAN",
                        "WinHttpAutoProxySvc"
                    ],
                    "verdicts": [
                        "MALWARE",
                        "TROJAN"
                    ]
                },
                "id": "699ec052ecc898bdbdafea0027c4ab44c3d01ae011c17745dd2b7fbddaa077f3_Lastline",
                "links": {
                    "self": "https://www.virustotal.com/api/v3/file_behaviours/699ec052ecc898bdbdafea0027c4ab44c3d01ae011c17745dd2b7fbddaa077f3_Lastline"
                },
                "type": "file_behaviour"
            },
            {
                "attributes": {
                    "analysis_date": 1561405459,
                    "files_dropped": [
                        {
                            "path": "\\Users\\Petra\\AppData\\Local\\Temp\\xws\\xws.exe",
                            "sha256": "699ec052ecc898bdbdafea0027c4ab44c3d01ae011c17745dd2b7fbddaa077f3"
                        }
                    ],
                    "files_opened": [
                        "C:\\Windows\\Microsoft.NET\\Framework\\v4.0.30319\\config\\machine.config"
                    ],
                    "files_written": [
                        "C:\\Users\\<USER>\\AppData\\Local\\Temp\\xws\\xws.exe"
                    ],
                    "has_html_report": false,
                    "has_pcap": false,
                    "ip_traffic": [
                        {
                            "destination_ip": "**ip**",
                            "destination_port": 80,
                            "transport_layer_protocol": "TCP"
                        }
                    ],
                    "last_modification_date": 1563272815,
                    "processes_tree": [
                        {
                            "name": "1526312897-2b294b349.pe32",
                            "process_id": "2624"
                        }
                    ],
                    "registry_keys_opened": [
                        "\\REGISTRY\\MACHINE\\SOFTWARE\\Microsoft\\OLE",
                    ],
                    "registry_keys_set": [
                        {
                            "key": "\\REGISTRY\\USER\\S-1-5-21-1119815420-2032815650-2779196966-1000\\Software\\Microsoft\\Windows\\CurrentVersion\\Run",
                            "value": "xws"
                        }
                    ],
                    "sandbox_name": "SNDBOX",
                    "tags": [
                        "PERSISTENCE"
                    ]
                },
                "id": "699ec052ecc898bdbdafea0027c4ab44c3d01ae011c17745dd2b7fbddaa077f3_SNDBOX",
                "links": {
                    "self": "https://www.virustotal.com/api/v3/file_behaviours/699ec052ecc898bdbdafea0027c4ab44c3d01ae011c17745dd2b7fbddaa077f3_SNDBOX"
                },
                "type": "file_behaviour"
            },
            {
                "attributes": {
                    "analysis_date": 1601545446,
                    "behash": "7617055bb3994dea99c19877fd7ec55a",
                    "command_executions": [
                        "\"C:\\Documents and Settings\\Administrator\\Local Settings\\Temp\\EB93A6\\996E.exe\"",
                        "Shutdown -r -t 5"
                    ],
                    "dns_lookups": [
                        {
                            "hostname": "checkip.dyndns.org"
                        }
                    ],
                    "files_copied": [
                        {
                            "destination": "C:\\Documents and Settings\\Administrator\\Local Settings\\Temp\\xws\\xws.exe ",
                            "source": "C:\\Documents and Settings\\Administrator\\Local Settings\\Temp\\EB93A6\\996E.exe "
                        }
                    ],
                    "files_opened": [
                        "C:\\WINDOWS\\system32\\winime32.dll"
                    ],
                    "files_written": [
                        "C:\\Documents and Settings\\Administrator\\Local Settings\\Temp\\xws\\xws.exe",
                        "C:\\Documents and Settings\\Administrator\\Local Settings\\Temp\\Ktx.exe"
                    ],
                    "has_html_report": true,
                    "has_pcap": false,
                    "last_modification_date": 1601545448,
                    "modules_loaded": [
                        "ADVAPI32.dll"
                    ],
                    "mutexes_created": [
                        "CTF.LBES.MutexDefaultS-1-5-21-1482476501-1645522239-1417001333-500",

                    ],
                    "mutexes_opened": [
                        "ShimCacheMutex"
                    ],
                    "permissions_requested": [
                        "SE_DEBUG_PRIVILEGE"
                    ],
                    "processes_created": [
                        "C:\\Documents and Settings\\Administrator\\Local Settings\\Temp\\EB93A6\\996E.exe"
                    ],
                    "processes_injected": [
                        "C:\\Documents and Settings\\Administrator\\Local Settings\\Temp\\EB93A6\\996E.exe"
                    ],
                    "processes_terminated": [
                        "C:\\Documents and Settings\\Administrator\\Local Settings\\Temp\\EB93A6\\996E.exe"
                    ],
                    "processes_tree": [
                        {
                            "children": [
                                {
                                    "children": [
                                        {
                                            "name": "shutdown.exe",
                                            "process_id": "2336"
                                        }
                                    ],
                                    "name": "****.exe",
                                    "process_id": "1024"
                                }
                            ],
                            "name": "****.exe",
                            "process_id": "628"
                        }
                    ],
                    "registry_keys_opened": [
                        "\\Registry\\Machine\\Software\\Microsoft\\Windows NT\\CurrentVersion\\Image File Execution Options\\996E.exe"
                    ],
                    "registry_keys_set": [
                        {
                            "key": "HKCU\\Software\\Microsoft\\Windows\\CurrentVersion\\Run\\xws",
                            "value": "C:\\Users\\<USER>\\AppData\\Local\\Temp\\xws\\xws.exe"
                        }
                    ],
                    "sandbox_name": "GoogleThreatIntelligence Jujubox",
                    "tags": [
                        "DIRECT_CPU_CLOCK_ACCESS"
                    ],
                    "text_highlighted": [
                        "C:\\Windows\\system32\\cmd.exe"
                    ]
                },
                "id": "699ec052ecc898bdbdafea0027c4ab44c3d01ae011c17745dd2b7fbddaa077f3_GoogleThreatIntelligence Jujubox",
                "links": {
                    "self": "https://www.virustotal.com/api/v3/file_behaviours/699ec052ecc898bdbdafea0027c4ab44c3d01ae011c17745dd2b7fbddaa077f3_GoogleThreatIntelligence Jujubox"
                },
                "type": "file_behaviour"
            }
        ]
    }
}

Human Readable Output

Sandbox Reports for file hash: 2b294b3499d1cce794badffc959b7618

AnalysisDate LastModificationDate SandboxName Link
1558429832 1588377117 Lastline https://www.virustotal.com/api/v3/file_behaviours/699ec052ecc898bdbdafea0027c4ab44c3d01ae011c17745dd2b7fbddaa077f3_Lastline
1561405459 1563272815 SNDBOX https://www.virustotal.com/api/v3/file_behaviours/699ec052ecc898bdbdafea0027c4ab44c3d01ae011c17745dd2b7fbddaa077f3_SNDBOX
1601545446 1601545448 Tencent HABO https://www.virustotal.com/api/v3/file_behaviours/699ec052ecc898bdbdafea0027c4ab44c3d01ae011c17745dd2b7fbddaa077f3_Tencent HABO
1592373137 1592373137 GoogleThreatIntelligence Jujubox https://www.virustotal.com/api/v3/file_behaviours/699ec052ecc898bdbdafea0027c4ab44c3d01ae011c17745dd2b7fbddaa077f3_GoogleThreatIntelligence Jujubox

gti-passive-dns-data

Returns passive DNS records by indicator.

Base Command

gti-passive-dns-data

Input

Argument Name Description Required
id IP or domain for which to get its DNS data. Optional
ip IP for which to get its DNS data. Optional
domain Domain for which to get its DNS data. Optional
limit Maximum number of results to fetch. Default is 10. Optional

Context Output

Path Type Description
GoogleThreatIntelligence.PassiveDNS.attributes.date Number Date of the DNS analysis in epoch format.
GoogleThreatIntelligence.PassiveDNS.attributes.host_name String The DNS host name.
GoogleThreatIntelligence.PassiveDNS.attributes.ip_address String The DNS IP address.
GoogleThreatIntelligence.PassiveDNS.attributes.resolver String The name of the resolver.
GoogleThreatIntelligence.PassiveDNS.id String The ID of the resolution.
GoogleThreatIntelligence.PassiveDNS.links.self String The link to the resolution.
GoogleThreatIntelligence.PassiveDNS.type String The type of the resolution.

Command Example

!gti-passive-dns-data ip=1.1.1.1

Context Example

{
    "GoogleThreatIntelligence": {
        "PassiveDNS": [
            {
                "attributes": {
                    "date": 1617085962,
                    "host_name": "muhaha.xyz",
                    "ip_address": "1.1.1.1",
                    "resolver": "GoogleThreatIntelligence"
                },
                "id": "1.1.1.1muhaha.xyz",
                "links": {
                    "self": "https://www.virustotal.com/api/v3/resolutions/1.1.1.1muhaha.xyz"
                },
                "type": "resolution"
            }
        ]
    }
}

Human Readable Output

Passive DNS data for IP 1.1.1.1

Id Date HostName IpAddress Resolver
1.1.1.1muhaha.xyz 1617085962 muhaha.xyz 1.1.1.1 GoogleThreatIntelligence

gti-analysis-get

Retrieves resolutions of the given IP.

Base Command

gti-analysis-get

Input

Argument Name Description Required
id ID of the analysis (from file-scan, file-rescan, or url-scan). Required
extended_data Whether to return extended data (last_analysis_results). Optional

Context Output

Path Type Description
GoogleThreatIntelligence.Analysis.data.attributes.date Number Date of the analysis in epoch format.
GoogleThreatIntelligence.Analysis.data.attributes.stats.harmless Number Number of engines that found the indicator to be harmless.
GoogleThreatIntelligence.Analysis.data.attributes.stats.malicious Number Number of engines that found the indicator to be malicious.
GoogleThreatIntelligence.Analysis.data.attributes.stats.suspicious Number Number of engines that found the indicator to be suspicious.
GoogleThreatIntelligence.Analysis.data.attributes.stats.timeout Number he number of engines that timed out for the indicator.
GoogleThreatIntelligence.Analysis.data.attributes.stats.undetected Number Number of engines the found the indicator to be undetected.
GoogleThreatIntelligence.Analysis.data.attributes.status String Status of the analysis.
GoogleThreatIntelligence.Analysis.data.id String ID of the analysis.
GoogleThreatIntelligence.Analysis.data.type String Type of object (analysis).
GoogleThreatIntelligence.Analysis.meta.file_info.sha256 String SHA-256 hash of the file (if it is a file).
GoogleThreatIntelligence.Analysis.meta.file_info.sha1 String SHA-1 hash of the file (if it is a file).
GoogleThreatIntelligence.Analysis.meta.file_info.md5 String MD5 hash of the file (if it is a file).
GoogleThreatIntelligence.Analysis.meta.file_info.name unknown Name of the file (if it is a file).
GoogleThreatIntelligence.Analysis.meta.file_info.size String Size of the file (if it is a file).
GoogleThreatIntelligence.Analysis.meta.url_info.id String ID of the url (if it is a URL).
GoogleThreatIntelligence.Analysis.meta.url_info.url String The URL (if it is a URL).
GoogleThreatIntelligence.Analysis.id String The analysis ID.

Command Example

!gti-analysis-get id=u-20694f234fbac92b1dcc16f424aa1c85e9dd7af75b360745df6484dcae410853-1613980758

Context Example

{
    "GoogleThreatIntelligence": {
        "Analysis": {
            "data": {
                "attributes": {
                    "date": 1613980758,
                    "results": {
                        "ADMINUSLabs": {
                            "category": "harmless",
                            "engine_name": "ADMINUSLabs",
                            "method": "blacklist",
                            "result": "clean"
                        }
                    },
                    "stats": {
                        "harmless": 69,
                        "malicious": 7,
                        "suspicious": 0,
                        "timeout": 0,
                        "undetected": 7
                    },
                    "status": "completed"
                },
                "id": "u-20694f234fbac92b1dcc16f424aa1c85e9dd7af75b360745df6484dcae410853-1613980758",
                "links": {
                    "self": "https://www.virustotal.com/api/v3/analyses/u-20694f234fbac92b1dcc16f424aa1c85e9dd7af75b360745df6484dcae410853-1613980758"
                },
                "type": "analysis"
            },
            "id": "u-20694f234fbac92b1dcc16f424aa1c85e9dd7af75b360745df6484dcae410853-1613980758",
            "meta": {
                "url_info": {
                    "id": "20694f234fbac92b1dcc16f424aa1c85e9dd7af75b360745df6484dcae410853"
                }
            }
        }
    }
}

Human Readable Output

Analysis results

Id Stats Status
u-20694f234fbac92b1dcc16f424aa1c85e9dd7af75b360745df6484dcae410853-1613980758 harmless: 69
malicious: 7
suspicious: 0
undetected: 7
timeout: 0		 completed

gti-file-sigma-analysis

Retrieves result of the last Sigma analysis.

Base Command

gti-file-sigma-analysis

Input

Argument Name Description Required
file File hash (md5, sha1, sha256). Required
only_stats Print only Sigma analysis summary stats. Optional

Context Output

Path Type Description
GoogleThreatIntelligence.SigmaAnalysis.data.attributes.last_modification_date Number Date of the last update in epoch format.
GoogleThreatIntelligence.SigmaAnalysis.data.attributes.analysis_date Number Date of the last update in epoch format.
GoogleThreatIntelligence.SigmaAnalysis.data.attributes.stats.rule_matches.match_context String Matched strings from the log file.
GoogleThreatIntelligence.SigmaAnalysis.data.attributes.stats.rule_matches.rule_author String Rule authors separated by commas.
GoogleThreatIntelligence.SigmaAnalysis.data.attributes.stats.rule_matches.rule_description String Brief summary about what the rule detects.
GoogleThreatIntelligence.SigmaAnalysis.data.attributes.stats.rule_matches.rule_id String Rule ID in GoogleThreatIntelligence’s database.
GoogleThreatIntelligence.SigmaAnalysis.data.attributes.stats.rule_matches.rule_level String Rule severity. Can be “low”, “medium”, “high” or “critical”.
GoogleThreatIntelligence.SigmaAnalysis.data.attributes.stats.rule_matches.rule_source String Ruleset where the rule belongs.
GoogleThreatIntelligence.SigmaAnalysis.data.attributes.stats.rule_matches.rule_title String Rule title.
GoogleThreatIntelligence.SigmaAnalysis.data.attributes.stats.severity_stats.critical Number Number of matched rules having a “critical” severity.
GoogleThreatIntelligence.SigmaAnalysis.data.attributes.stats.severity_stats.high Number Number of matched rules having a “high” severity.
GoogleThreatIntelligence.SigmaAnalysis.data.attributes.stats.severity_stats.low Number Number of matched rules having a “low” severity.
GoogleThreatIntelligence.SigmaAnalysis.data.attributes.stats.severity_stats.medium Number Number of matched rules having a “medium” severity.
GoogleThreatIntelligence.SigmaAnalysis.data.attributes.stats.source_severity_stats unknown Same as severity_stats but grouping stats by ruleset. Keys are ruleset names as string and values are stats in a dictionary.
GoogleThreatIntelligence.SigmaAnalysis.data.id String ID of the analysis.

Command Example

!gti-file-sigma-analysis file=f912398cb3542ab704fe917af4a60d4feee21ac577535b10453170f10c6fd6de

Context Example

{
    "GoogleThreatIntelligence": {
        "SigmaAnalysis": {
            "meta": {
                "count": 1
            },
            "data": {
                "attributes": {
                    "last_modification_date": 1650970667,
                    "analysis_date": 1650968852,
                    "rule_matches": [
                        {
                            "match_context": "$EventID: '1117'",
                            "rule_level": "high",
                            "rule_description": "Detects all actions taken by Windows Defender malware detection engines",
                            "rule_source": "Sigma Integrated Rule Set (GitHub)",
                            "rule_title": "Windows Defender Threat Detected",
                            "rule_id": "cf90b923dcb2c8192e6651425886607684aac6680bf25b20c39ae3f8743aebf1",
                            "rule_author": "Ján Trenčanský"
                        },
                        {
                            "match_context": "$EventID: '2002'",
                            "rule_level": "low",
                            "rule_description": "Setting have been change in Windows Firewall",
                            "rule_source": "Sigma Integrated Rule Set (GitHub)",
                            "rule_title": "Setting Change in Windows Firewall with Advanced Security",
                            "rule_id": "693c36f61ac022fd66354b440464f490058c22b984ba1bef05ca246aba210ed1",
                            "rule_author": "frack113"
                        }
                    ],
                    "source_severity_stats": {
                        "Sigma Integrated Rule Set (GitHub)": {
                            "high": 1,
                            "medium": 0,
                            "critical": 0,
                            "low": 1
                        },
                    },
                    "severity_stats": {
                        "high": 1,
                        "medium": 0,
                        "critical": 0,
                        "low": 1
                    }
                },
                "type": "sigma_analysis",
                "id": "f912398cb3542ab704fe917af4a60d4feee21ac577535b10453170f10c6fd6de",
                "links": {
                    "self": "https://www.virustotal.com/api/v3/sigma_analyses/f912398cb3542ab704fe917af4a60d4feee21ac577535b10453170f10c6fd6de"
                }
            },
            "links": {
                "self": "https://www.virustotal.com/api/v3/files/f912398cb3542ab704fe917af4a60d4feee21ac577535b10453170f10c6fd6de/sigma_analysis"
            }
        }
    }
}

Human Readable Output

Last Sigma analysis results

MatchContext RuleLevel RuleDescription RuleSource RuleTitle RuleId RuleAuthor
$EventID: ‘1117’ high Detects all actions taken by Windows Defender malware detection engines Sigma Integrated Rule Set (GitHub) Windows Defender Threat Detected 693c36f61ac022fd66354b440464f490058c22b984ba1bef05ca246aba210ed1 Ján Trenčanský

gti-privatescanning-file

Checks the file reputation of the specified private hash.

See files through the eyes of GoogleThreatIntelligence without uploading them to the main threat corpus, keeping them entirely private. Static, dynamic, network and similarity analysis included, as well as automated threat intel enrichment, but NOT multi-antivirus analysis.

Base Command

gti-privatescanning-file

Input

Argument Name Description Required
file File hash (md5, sha1, sha256). Required

Context Output

Path Type Description
GoogleThreatIntelligence.File.attributes.type_description String Description of the type of the file.
GoogleThreatIntelligence.File.attributes.tlsh String The locality-sensitive hashing.
GoogleThreatIntelligence.File.attributes.exiftool.MIMEType String MIME type of the file.
GoogleThreatIntelligence.File.attributes.names String Names of the file.
GoogleThreatIntelligence.File.attributes.javascript_info.tags String Tags of the JavaScript.
GoogleThreatIntelligence.File.attributes.exiftool.FileType String The file type.
GoogleThreatIntelligence.File.attributes.exiftool.WordCount Number Total number of words in the file.
GoogleThreatIntelligence.File.attributes.exiftool.LineCount Number Total number of lines in file.
GoogleThreatIntelligence.File.attributes.exiftool.MIMEEncoding String The MIME encoding.
GoogleThreatIntelligence.File.attributes.exiftool.FileTypeExtension String The file type extension.
GoogleThreatIntelligence.File.attributes.exiftool.Newlines Number Number of newlines signs.
GoogleThreatIntelligence.File.attributes.crowdsourced_ids_stats.info Number Number of IDS that marked the file as “info”.
GoogleThreatIntelligence.File.attributes.crowdsourced_ids_stats.high Number Number of IDS that marked the file as “high”.
GoogleThreatIntelligence.File.attributes.crowdsourced_ids_stats.medium Number Number of IDS that marked the file as “medium”.
GoogleThreatIntelligence.File.attributes.crowdsourced_ids_stats.low Number Number of IDS that marked the file as “low”.
GoogleThreatIntelligence.File.attributes.trid.file_type String The TrID file type.
GoogleThreatIntelligence.File.attributes.trid.probability Number The TrID probability.
GoogleThreatIntelligence.File.attributes.crowdsourced_yara_results.description String Description of the YARA rule.
GoogleThreatIntelligence.File.attributes.crowdsourced_yara_results.source String Source of the YARA rule.
GoogleThreatIntelligence.File.attributes.crowdsourced_yara_results.author String Author of the YARA rule.
GoogleThreatIntelligence.File.attributes.crowdsourced_yara_results.ruleset_name String Rule set name of the YARA rule.
GoogleThreatIntelligence.File.attributes.crowdsourced_yara_results.rule_name String Name of the YARA rule.
GoogleThreatIntelligence.File.attributes.crowdsourced_yara_results.ruleset_id String ID of the YARA rule.
GoogleThreatIntelligence.File.attributes.names String Name of the file.
GoogleThreatIntelligence.File.attributes.type_tag String Tag of the type.
GoogleThreatIntelligence.File.attributes.size Number Size of the file.
GoogleThreatIntelligence.File.attributes.sha256 String SHA-256 hash of the file.
GoogleThreatIntelligence.File.attributes.type_extension String Extension of the type.
GoogleThreatIntelligence.File.attributes.tags String File tags.
GoogleThreatIntelligence.File.attributes.last_analysis_date Number Last analysis date in epoch format.
GoogleThreatIntelligence.File.attributes.ssdeep String SSDeep hash of the file.
GoogleThreatIntelligence.File.attributes.md5 String MD5 hash of the file.
GoogleThreatIntelligence.File.attributes.sha1 String SHA-1 hash of the file.
GoogleThreatIntelligence.File.attributes.magic String Identification of file by the magic number.
GoogleThreatIntelligence.File.attributes.meaningful_name String Meaningful name of the file.
GoogleThreatIntelligence.File.attributes.threat_severity.threat_severity_level String Threat severity level of the file.
GoogleThreatIntelligence.File.attributes.threat_severity.threat_severity_data.popular_threat_category String Popular threat category of the file.
GoogleThreatIntelligence.File.attributes.threat_verdict String Threat verdict of the file.
GoogleThreatIntelligence.File.type String Type of the file.
GoogleThreatIntelligence.File.id String ID of the file.
GoogleThreatIntelligence.File.links.self String Link to the response.

Command Example

!gti-privatescanning-file file=example-file-hash

Context Example

{
    "GoogleThreatIntelligence": {
        "File": {
            "attributes": {
                "type_description": "ELF",
                "tlsh": "Example tlsh",
                "vhash": "Example vhash",
                "exiftool": {
                    "MIMEType": "application/octet-stream",
                    "CPUByteOrder": "Little endian",
                    "ObjectFileType": "Executable file",
                    "CPUArchitecture": "32 bit",
                    "CPUType": "i386",
                    "FileType": "ELF executable"
                },
                "trid": [
                    {
                        "file_type": "ELF Executable and Linkable format (Linux)",
                        "probability": 55
                    },
                    {
                        "file_type": "ELF Executable and Linkable format (generic)",
                        "probability": 45
                    }
                ],
                "crowdsourced_yara_results": [
                    {
                        "description": "Detects a suspicious ELF binary with UPX compression",
                        "source": "https://www.example.com",
                        "author": "Author X",
                        "ruleset_name": "gen_elf_file_anomalies",
                        "rule_name": "SUSP_ELF_LNX_UPX_Compressed_File",
                        "ruleset_id": "0224a54ba7"
                    }
                ],
                "threat_severity": {
                    "threat_severity_level": "SEVERITY_HIGH",
                    "threat_severity_data": {
                        "has_dropped_files_with_detections": true,
                        "type_tag": "elf",
                        "has_execution_parents_with_detections": true,
                        "can_be_detonated": true,
                        "popular_threat_category": "trojan"
                    },
                    "last_analysis_date": "1681045097",
                    "version": 1
                },
                "names": [
                    "private",
                    "/usr/lib/sample.so",
                    "private_sample.bin",
                ],
                "owner": "virustotal",
                "type_tag": "elf",
                "elf_info": {
                    "header": {
                        "hdr_version": "1 (current)",
                        "type": "EXEC (Executable file)",
                        "obj_version": "0x1",
                        "data": "2's complement, little endian",
                        "machine": "Intel 80386",
                        "num_section_headers": 0,
                        "os_abi": "UNIX - Linux",
                        "abi_version": 0,
                        "entrypoint": 4633,
                        "num_prog_headers": 2,
                        "class": "ELF32"
                    },
                    "packers": [
                        "upx"
                    ],
                    "segment_list": [
                        {
                            "segment_type": "LOAD"
                        }
                    ]
                },
                "size": 255510,
                "type_extension": "so",
                "threat_verdict": "VERDICT_MALICIOUS",
                "detectiteasy": {
                    "filetype": "ELF32",
                    "values": [
                        {
                            "info": "EXEC 386-32",
                            "version": "3.05",
                            "type": "Packer",
                            "name": "UPX"
                        }
                    ]
                },
                "crowdsourced_ids_stats": {
                    "high": 0,
                    "info": 0,
                    "medium": 1,
                    "low": 1
                },
                "type_tags": [
                    "executable",
                    "linux",
                    "elf"
                ],
                "sandbox_verdicts": {
                    "Zenbox Linux": {
                        "category": "malicious",
                        "confidence": 81,
                        "sandbox_name": "Zenbox Linux",
                        "malware_classification": [
                            "MALWARE",
                            "TROJAN",
                            "EVADER"
                        ],
                        "malware_names": [
                            "MalwareName"
                        ]
                    }
                },
                "sha256": "Example_sha256",
                "tags": [
                    "elf",
                    "upx"
                ],
                "crowdsourced_ids_results": [
                    {
                        "rule_category": "Misc Attack",
                        "alert_severity": "medium",
                        "rule_msg": "Known Compromised or Hostile Host Traffic",
                        "rule_raw": "alert ip [8.8.8.8] any -> $HOME_NET any"
                    },
                    {
                        "rule_category": "Misc Attack",
                        "alert_severity": "low",
                        "rule_msg": "Poor Reputation IP",
                        "rule_raw": "alert ip [1.1.1.1] any -> $HOME_NET any)"
                    },
                ],
                "last_analysis_date": 1681386314,
                "ssdeep": "Example ssdeep",
                "packers": {
                    "Gandelf": "upx"
                },
                "md5": "Example_md5",
                "sha1": "Example_sha1",
                "magic": "ELF 32-bit LSB executable, Intel 80386, version 1 (GNU/Linux), statically linked, stripped",
                "meaningful_name": "private"
            },
            "type": "private_file",
            "id": "Example_sha256",
            "links": {
                "self": "https://www.virustotal.com/api/v3/private/files/Example_sha256"
            }
        }
    }
}

Human Readable Output

Results of file hash Example_sha256

Sha1 Sha256 Md5 Meaningful Name Threat Severity Level Popular Threat Category Threat Verdict
Example_sha1 Example_sha256 Example_md5 private HIGH trojan MALICIOUS

gti-privatescanning-file-scan

Submits a file for private scanning. Use the gti-privatescanning-analysis-get command to get the scan results.

Base Command

gti-privatescanning-file-scan

Input

Argument Name Description Required
entryID The file entry ID to submit. Required

Context Output

Path Type Description
GoogleThreatIntelligence.Submission.type String The type of the submission (analysis).
GoogleThreatIntelligence.Submission.id String The ID of the submission.
GoogleThreatIntelligence.Submission.EntryID String The entry ID of the file detonated.
GoogleThreatIntelligence.Submission.Extension String File extension.
GoogleThreatIntelligence.Submission.Info String File info.
GoogleThreatIntelligence.Submission.MD5 String MD5 hash of the file.
GoogleThreatIntelligence.Submission.Name String Name of the file.
GoogleThreatIntelligence.Submission.SHA1 String SHA-1 of the file.
GoogleThreatIntelligence.Submission.SHA256 String SHA-256 of the file.
GoogleThreatIntelligence.Submission.SHA512 String SHA-512 of the file.
GoogleThreatIntelligence.Submission.SSDeep String SSDeep of the file.
GoogleThreatIntelligence.Submission.Size String Size of the file.
GoogleThreatIntelligence.Submission.Type String Type of the file.

Command Example

!gti-privatescanning-file-scan entryID=example-entry-id

Context Example

{
    "GoogleThreatIntelligence": {
        "Submission": {
            "type": "private_analysis",
            "id": "example-analysis-id",
            "EntryID": "example-entry-id",
            "Extension": "txt",
            "Info": "ASCII text, with no line terminators",
            "MD5": "Example_md5",
            "Name": "Testing.txt",
            "SHA1": "Example_sha1",
            "SHA256": "Example_sha256",
            "SHA512": "Example_sha512",
            "SSDeep": "Example ssdeep",
            "Size": "71 bytes",
            "Type": "text/plain; charset=utf-8"
        }
    }
}

Human Readable Output

The file has been submitted “Testing.txt”

id EntryID MD5 SHA1 SHA256
example-analysis-id example-entry-id Example_md5 Example_sha1 Example_sha256

gti-privatescanning-analysis-get

Get analysis of a private file or URL submitted to GoogleThreatIntelligence.

Base Command

gti-privatescanning-analysis-get

Input

Argument Name Description Required
id ID of the analysis. Required

Context Output

Path Type Description
GoogleThreatIntelligence.Analysis.data.attributes.date Number Date of the analysis in epoch format.
GoogleThreatIntelligence.Analysis.data.attributes.status String Status of the analysis.
GoogleThreatIntelligence.Analysis.data.attributes.sha256 String SHA-256 hash of the private file.
GoogleThreatIntelligence.Analysis.data.attributes.threat_severity_level String Threat severity level of the private file (if analysis is completed).
GoogleThreatIntelligence.Analysis.data.attributes.popular_threat_category String Popular threat category of the private file (if analysis is completed).
GoogleThreatIntelligence.Analysis.data.attributes.threat_verdict String Threat verdict of the private file (if analysis is completed).
GoogleThreatIntelligence.Analysis.data.attributes.url String URL submitted.
GoogleThreatIntelligence.Analysis.data.attributes.title String Title of the private URL (if analysis is completed).
GoogleThreatIntelligence.Analysis.data.attributes.last_http_response_content_sha256 String Last HTTP response content SHA-256 hash of the private URL (if analysis is completed).
GoogleThreatIntelligence.Analysis.data.attributes.positives String Ratio of malicious detections to the total number of engines that scanned the private URL (if analysis is completed).
GoogleThreatIntelligence.Analysis.data.id String ID of the analysis.
GoogleThreatIntelligence.Analysis.data.type String Type of object (private_analysis).
GoogleThreatIntelligence.Analysis.meta.file_info.sha256 String SHA-256 hash of the file.
GoogleThreatIntelligence.Analysis.meta.file_info.sha1 String SHA-1 hash of the file.
GoogleThreatIntelligence.Analysis.meta.file_info.md5 String MD5 hash of the file.
GoogleThreatIntelligence.Analysis.meta.file_info.size Number Size of the file.
GoogleThreatIntelligence.Analysis.meta.url_info.id String ID of the URL.
GoogleThreatIntelligence.Analysis.meta.url_info.url String URL submitted.
GoogleThreatIntelligence.Analysis.id String The analysis ID.

gti-curated-threat-actors-get

Retrieves GTI curated threat actors for a given resource.

Base Command

gti-curated-threat-actors-get

Input

Argument Name Description Required
resource The file hash (MD5, SHA1, or SHA256), Domain, URL or IP. Required
resource_type The type of the resource. If not supplied, will determine it’s a file. Possible values are: ip, url, domain, file, hash. Optional

Context Output

Path Type Description
GoogleThreatIntelligence.Collection.id String ID that contains the assessment (the given hash, domain, url, or ip).
GoogleThreatIntelligence.Collection.collections.id String ID of the curated threat actors.
GoogleThreatIntelligence.Collection.collections.attributes.name String Name of the curated threat actors.
GoogleThreatIntelligence.Collection.collections.attributes.description String Description of the curated threat actors.
GoogleThreatIntelligence.Collection.collections.attributes.last_modification_date String Last modification date of the curated threat actors.
GoogleThreatIntelligence.Collection.collections.attributes.targeted_regions list Targeted regions of the curated threat actors.
GoogleThreatIntelligence.Collection.collections.attributes.targeted_industries list Targeted industries of the curated threat actors.

gti-curated-malware-families-get

Retrieves GTI curated malware families for a given resource.

Base Command

gti-curated-malware-families-get

Input

Argument Name Description Required
resource The file hash (MD5, SHA1, or SHA256), Domain, URL or IP. Required
resource_type The type of the resource. If not supplied, will determine it’s a file. Possible values are: ip, url, domain, file, hash. Optional

Context Output

Path Type Description
GoogleThreatIntelligence.Collection.id String ID that contains the assessment (the given hash, domain, url, or ip).
GoogleThreatIntelligence.Collection.collections.id String ID of the curated malware families.
GoogleThreatIntelligence.Collection.collections.attributes.name String Name of the curated malware families.
GoogleThreatIntelligence.Collection.collections.attributes.description String Description of the curated malware families.
GoogleThreatIntelligence.Collection.collections.attributes.last_modification_date String Last modification date of the curated malware families.
GoogleThreatIntelligence.Collection.collections.attributes.targeted_regions list Targeted regions of the curated malware families.
GoogleThreatIntelligence.Collection.collections.attributes.targeted_industries list Targeted industries of the curated malware families.

gti-curated-campaigns-get

Retrieves GTI curated campaigns for a given resource.

Base Command

gti-curated-campaigns-get

Input

Argument Name Description Required
resource The file hash (MD5, SHA1, or SHA256), Domain, URL or IP. Required
resource_type The type of the resource. If not supplied, will determine it’s a file. Possible values are: ip, url, domain, file, hash. Optional

Context Output

Path Type Description
GoogleThreatIntelligence.Collection.id String ID that contains the assessment (the given hash, domain, url, or ip).
GoogleThreatIntelligence.Collection.collections.id String ID of the curated campaign.
GoogleThreatIntelligence.Collection.collections.attributes.name String Name of the curated campaign.
GoogleThreatIntelligence.Collection.collections.attributes.description String Description of the curated campaign.
GoogleThreatIntelligence.Collection.collections.attributes.last_modification_date String Last modification date of the curated campaign.
GoogleThreatIntelligence.Collection.collections.attributes.targeted_regions list Targeted regions of the curated campaign.
GoogleThreatIntelligence.Collection.collections.attributes.targeted_industries list Targeted industries of the curated campaign.

gti-url-scan-and-analysis-get

Scan and get the analysis of a URL submitted to GoogleThreatIntelligence.

Base Command

gti-url-scan-and-analysis-get

Input

Argument Name Description Required
url The URL to scan. Required
id This is an internal argument used for the polling process, not to be used by the user. Optional
extended_data Whether to return extended data. Possible values are: true, false. Optional
interval_in_seconds Interval in seconds between each poll. Default is 60. Optional

Context Output

Path Type Description
URL.Data unknown Bad URLs found.
URL.Malicious.Vendor unknown For malicious URLs, the vendor that made the decision.
URL.Malicious.Description unknown For malicious URLs, the reason that the vendor made the decision.
URL.Relationships.EntityA string The source of the relationship.
URL.Relationships.EntityB string The destination of the relationship.
URL.Relationships.Relationship string The name of the relationship.
URL.Relationships.EntityAType string The type of the source of the relationship.
URL.Relationships.EntityBType string The type of the destination of the relationship.
DBotScore.Indicator unknown The indicator that was tested.
DBotScore.Type unknown The indicator type.
DBotScore.Vendor unknown The vendor used to calculate the score.
DBotScore.Score Number The actual score.
DBotScore.Reliability String Reliability of the source providing the intelligence data.
GoogleThreatIntelligence.URL.attributes.favicon.raw_md5 String The MD5 hash of the URL.
GoogleThreatIntelligence.URL.attributes.favicon.dhash String Difference hash.
GoogleThreatIntelligence.URL.attributes.last_modification_date Number Last modification date in epoch format.
GoogleThreatIntelligence.URL.attributes.times_submitted Number The number of times the url has been submitted.
GoogleThreatIntelligence.URL.attributes.total_votes.harmless Number Total number of harmless votes.
GoogleThreatIntelligence.URL.attributes.total_votes.malicious Number Total number of malicious votes.
GoogleThreatIntelligence.URL.attributes.threat_names String Name of the threats found.
GoogleThreatIntelligence.URL.attributes.last_submission_date Number The last submission date in epoch format.
GoogleThreatIntelligence.URL.attributes.last_http_response_content_length Number The last HTTPS response length.
GoogleThreatIntelligence.URL.attributes.last_http_response_headers.date Date The last response header date.
GoogleThreatIntelligence.URL.attributes.last_http_response_headers.x-sinkhole String DNS sinkhole from last response.
GoogleThreatIntelligence.URL.attributes.last_http_response_headers.content-length String The content length of the last response.
GoogleThreatIntelligence.URL.attributes.last_http_response_headers.content-type String The content type of the last response.
GoogleThreatIntelligence.URL.attributes.reputation Number Reputation of the indicator.
GoogleThreatIntelligence.URL.attributes.last_analysis_date Number The date of the last analysis in epoch format.
GoogleThreatIntelligence.URL.attributes.has_content Boolean Whether the url has content in it.
GoogleThreatIntelligence.URL.attributes.first_submission_date Number The first submission date in epoch format.
GoogleThreatIntelligence.URL.attributes.last_http_response_content_sha256 String The SHA-256 hash of the content of the last response.
GoogleThreatIntelligence.URL.attributes.last_http_response_code Number Last response status code.
GoogleThreatIntelligence.URL.attributes.last_final_url String Last final URL.
GoogleThreatIntelligence.URL.attributes.url String The URL itself.
GoogleThreatIntelligence.URL.attributes.title String Title of the page.
GoogleThreatIntelligence.URL.attributes.last_analysis_stats.harmless Number The number of engines that found the domain to be harmless.
GoogleThreatIntelligence.URL.attributes.last_analysis_stats.malicious Number The number of engines that found the indicator to be malicious.
GoogleThreatIntelligence.URL.attributes.last_analysis_stats.suspicious Number The number of engines that found the indicator to be suspicious.
GoogleThreatIntelligence.URL.attributes.last_analysis_stats.undetected Number The number of engines that could not detect the indicator.
GoogleThreatIntelligence.URL.attributes.last_analysis_stats.timeout Number The number of engines that timed out for the indicator.
GoogleThreatIntelligence.URL.attributes.outgoing_links String Outgoing links of the URL page.
GoogleThreatIntelligence.URL.attributes.gti_assessment.threat_score.value Number GTI threat score of the URL.
GoogleThreatIntelligence.URL.attributes.gti_assessment.severity.value String GTI severity of the URL.
GoogleThreatIntelligence.URL.attributes.gti_assessment.verdict.value String GTI verdict of the URL.
GoogleThreatIntelligence.URL.type String Type of the indicator (url).
GoogleThreatIntelligence.URL.id String ID of the indicator.
GoogleThreatIntelligence.URL.links.self String Link to the response.
GoogleThreatIntelligence.Analysis.data.attributes.date Number Date of the analysis in epoch format.
GoogleThreatIntelligence.Analysis.data.attributes.stats.harmless Number Number of engines that found the indicator to be harmless.
GoogleThreatIntelligence.Analysis.data.attributes.stats.malicious Number Number of engines that found the indicator to be malicious.
GoogleThreatIntelligence.Analysis.data.attributes.stats.suspicious Number Number of engines that found the indicator to be suspicious.
GoogleThreatIntelligence.Analysis.data.attributes.stats.timeout Number he number of engines that timed out for the indicator.
GoogleThreatIntelligence.Analysis.data.attributes.stats.undetected Number Number of engines the found the indicator to be undetected.
GoogleThreatIntelligence.Analysis.data.attributes.status String Status of the analysis.
GoogleThreatIntelligence.Analysis.data.id String ID of the analysis.
GoogleThreatIntelligence.Analysis.data.type String Type of object (analysis).
GoogleThreatIntelligence.Analysis.meta.url_info.id String ID of the URL.
GoogleThreatIntelligence.Analysis.meta.url_info.url String The URL.
GoogleThreatIntelligence.Analysis.id String The analysis ID.

gti-file-scan-and-analysis-get

Scan and get the analysis of a file submitted to GoogleThreatIntelligence.

Base Command

gti-file-scan-and-analysis-get

Input

Argument Name Description Required
entryID The file entry ID to submit. Required
uploadURL Special upload URL for files larger than 32 MB. Can be acquired from the gti-file-scan-upload-url command. Optional
id This is an internal argument used for the polling process, not to be used by the user. Optional
file This is an internal argument used for the polling process, not to be used by the user. Optional
extended_data Whether to return extended data. Possible values are: true, false. Optional
interval_in_seconds Interval in seconds between each poll. Default is 60. Optional

Context Output

Path Type Description
File.MD5 unknown Bad MD5 hash.
File.SHA1 unknown Bad SHA1 hash.
File.SHA256 unknown Bad SHA256 hash.
File.Relationships.EntityA string The source of the relationship.
File.Relationships.EntityB string The destination of the relationship.
File.Relationships.Relationship string The name of the relationship.
File.Relationships.EntityAType string The type of the source of the relationship.
File.Relationships.EntityBType string The type of the destination of the relationship.
File.Malicious.Vendor unknown For malicious files, the vendor that made the decision.
File.Malicious.Detections unknown For malicious files, the total number of detections.
File.Malicious.TotalEngines unknown For malicious files, the total number of engines that checked the file hash.
DBotScore.Indicator unknown The indicator that was tested.
DBotScore.Type unknown The indicator type.
DBotScore.Vendor unknown The vendor used to calculate the score.
DBotScore.Score Number The actual score.
DBotScore.Reliability String Reliability of the source providing the intelligence data.
GoogleThreatIntelligence.File.attributes.type_description String Description of the type of the file.
GoogleThreatIntelligence.File.attributes.tlsh String The locality-sensitive hashing.
GoogleThreatIntelligence.File.attributes.exiftool.MIMEType String MIME type of the file.
GoogleThreatIntelligence.File.attributes.names String Names of the file.
GoogleThreatIntelligence.File.attributes.javascript_info.tags String Tags of the JavaScript.
GoogleThreatIntelligence.File.attributes.exiftool.FileType String The file type.
GoogleThreatIntelligence.File.attributes.exiftool.WordCount String Total number of words in the file.
GoogleThreatIntelligence.File.attributes.exiftool.LineCount String Total number of lines in file.
GoogleThreatIntelligence.File.attributes.crowdsourced_ids_stats.info Number Number of IDS that marked the file as “info”.
GoogleThreatIntelligence.File.attributes.crowdsourced_ids_stats.high Number Number of IDS that marked the file as “high”.
GoogleThreatIntelligence.File.attributes.crowdsourced_ids_stats.medium Number Number of IDS that marked the file as “medium”.
GoogleThreatIntelligence.File.attributes.crowdsourced_ids_stats.low Number Number of IDS that marked the file as “low”.
GoogleThreatIntelligence.File.attributes.sigma_analysis_stats.critical Number Number of Sigma analysis that marked the file as “critical”.
GoogleThreatIntelligence.File.attributes.sigma_analysis_stats.high Number Number of Sigma analysis that marked the file as “high”.
GoogleThreatIntelligence.File.attributes.sigma_analysis_stats.medium Number Number of Sigma analysis that marked the file as “medium”.
GoogleThreatIntelligence.File.attributes.sigma_analysis_stats.low Number Number of Sigma analysis that marked the file as “low”.
GoogleThreatIntelligence.File.attributes.exiftool.MIMEEncoding String The MIME encoding.
GoogleThreatIntelligence.File.attributes.exiftool.FileTypeExtension String The file type extension.
GoogleThreatIntelligence.File.attributes.exiftool.Newlines String Number of newlines signs.
GoogleThreatIntelligence.File.attributes.trid.file_type String The TrID file type.
GoogleThreatIntelligence.File.attributes.trid.probability Number The TrID probability.
GoogleThreatIntelligence.File.attributes.crowdsourced_yara_results.description String Description of the YARA rule.
GoogleThreatIntelligence.File.attributes.crowdsourced_yara_results.source String Source of the YARA rule.
GoogleThreatIntelligence.File.attributes.crowdsourced_yara_results.author String Author of the YARA rule.
GoogleThreatIntelligence.File.attributes.crowdsourced_yara_results.ruleset_name String Rule set name of the YARA rule.
GoogleThreatIntelligence.File.attributes.crowdsourced_yara_results.rule_name String Name of the YARA rule.
GoogleThreatIntelligence.File.attributes.crowdsourced_yara_results.ruleset_id String ID of the YARA rule.
GoogleThreatIntelligence.File.attributes.names String Name of the file.
GoogleThreatIntelligence.File.attributes.last_modification_date Number The last modification date in epoch format.
GoogleThreatIntelligence.File.attributes.type_tag String Tag of the type.
GoogleThreatIntelligence.File.attributes.total_votes.harmless Number Total number of harmless votes.
GoogleThreatIntelligence.File.attributes.total_votes.malicious Number Total number of malicious votes.
GoogleThreatIntelligence.File.attributes.size Number Size of the file.
GoogleThreatIntelligence.File.attributes.popular_threat_classification.suggested_threat_label String Suggested thread label.
GoogleThreatIntelligence.File.attributes.popular_threat_classification.popular_threat_name Number The popular thread name.
GoogleThreatIntelligence.File.attributes.times_submitted Number Number of times the file was submitted.
GoogleThreatIntelligence.File.attributes.last_submission_date Number Last submission date in epoch format.
GoogleThreatIntelligence.File.attributes.downloadable Boolean Whether the file is downloadable.
GoogleThreatIntelligence.File.attributes.sha256 String SHA-256 hash of the file.
GoogleThreatIntelligence.File.attributes.type_extension String Extension of the type.
GoogleThreatIntelligence.File.attributes.tags String File tags.
GoogleThreatIntelligence.File.attributes.last_analysis_date Number Last analysis date in epoch format.
GoogleThreatIntelligence.File.attributes.unique_sources Number Unique sources.
GoogleThreatIntelligence.File.attributes.first_submission_date Number First submission date in epoch format.
GoogleThreatIntelligence.File.attributes.ssdeep String SSDeep hash of the file.
GoogleThreatIntelligence.File.attributes.md5 String MD5 hash of the file.
GoogleThreatIntelligence.File.attributes.sha1 String SHA-1 hash of the file.
GoogleThreatIntelligence.File.attributes.magic String Identification of file by the magic number.
GoogleThreatIntelligence.File.attributes.last_analysis_stats.harmless Number The number of engines that found the indicator to be harmless.
GoogleThreatIntelligence.File.attributes.last_analysis_stats.type-unsupported Number The number of engines that found the indicator to be of type unsupported.
GoogleThreatIntelligence.File.attributes.last_analysis_stats.suspicious Number The number of engines that found the indicator to be suspicious.
GoogleThreatIntelligence.File.attributes.last_analysis_stats.confirmed-timeout Number The number of engines that confirmed the timeout of the indicator.
GoogleThreatIntelligence.File.attributes.last_analysis_stats.timeout Number The number of engines that timed out for the indicator.
GoogleThreatIntelligence.File.attributes.last_analysis_stats.failure Number The number of failed analysis engines.
GoogleThreatIntelligence.File.attributes.last_analysis_stats.malicious Number The number of engines that found the indicator to be malicious.
GoogleThreatIntelligence.File.attributes.last_analysis_stats.undetected Number The number of engines that could not detect the indicator.
GoogleThreatIntelligence.File.attributes.meaningful_name String Meaningful name of the file.
GoogleThreatIntelligence.File.attributes.reputation Number The reputation of the file.
GoogleThreatIntelligence.File.attributes.gti_assessment.threat_score.value Number GTI threat score of the file.
GoogleThreatIntelligence.File.attributes.gti_assessment.severity.value String GTI severity of the file.
GoogleThreatIntelligence.File.attributes.gti_assessment.verdict.value String GTI verdict of the file.
GoogleThreatIntelligence.File.type String Type of the indicator (file).
GoogleThreatIntelligence.File.id String Type ID of the indicator.
GoogleThreatIntelligence.File.links.self String Link to the response.
GoogleThreatIntelligence.Analysis.data.attributes.date Number Date of the analysis in epoch format.
GoogleThreatIntelligence.Analysis.data.attributes.stats.harmless Number Number of engines that found the indicator to be harmless.
GoogleThreatIntelligence.Analysis.data.attributes.stats.malicious Number Number of engines that found the indicator to be malicious.
GoogleThreatIntelligence.Analysis.data.attributes.stats.suspicious Number Number of engines that found the indicator to be suspicious.
GoogleThreatIntelligence.Analysis.data.attributes.stats.timeout Number he number of engines that timed out for the indicator.
GoogleThreatIntelligence.Analysis.data.attributes.stats.undetected Number Number of engines the found the indicator to be undetected.
GoogleThreatIntelligence.Analysis.data.attributes.status String Status of the analysis.
GoogleThreatIntelligence.Analysis.data.id String ID of the analysis.
GoogleThreatIntelligence.Analysis.data.type String Type of object (analysis).
GoogleThreatIntelligence.Analysis.meta.file_info.sha256 String SHA-256 hash of the file.
GoogleThreatIntelligence.Analysis.meta.file_info.sha1 String SHA-1 hash of the file.
GoogleThreatIntelligence.Analysis.meta.file_info.md5 String MD5 hash of the file.
GoogleThreatIntelligence.Analysis.meta.file_info.name unknown Name of the file.
GoogleThreatIntelligence.Analysis.meta.file_info.size Number Size of the file.
GoogleThreatIntelligence.Analysis.id String The analysis ID.

gti-private-file-scan-and-analysis-get

Scan and get the analysis of a private file submitted to GoogleThreatIntelligence.

Base Command

gti-private-file-scan-and-analysis-get

Input

Argument Name Description Required
entryID The file entry ID to submit. Required
id This is an internal argument used for the polling process, not to be used by the user. Optional
extended_data Whether to return extended data. Possible values are: true, false. Optional
interval_in_seconds Interval in seconds between each poll. Default is 60. Optional

Context Output

Path Type Description
GoogleThreatIntelligence.Analysis.data.attributes.date Number Date of the analysis in epoch format.
GoogleThreatIntelligence.Analysis.data.attributes.status String Status of the analysis.
GoogleThreatIntelligence.Analysis.data.attributes.sha256 String SHA-256 hash of the private file.
GoogleThreatIntelligence.Analysis.data.attributes.threat_severity_level String Threat severity level of the private file (if analysis is completed).
GoogleThreatIntelligence.Analysis.data.attributes.popular_threat_category String Popular threat category of the private file (if analysis is completed).
GoogleThreatIntelligence.Analysis.data.attributes.threat_verdict String Threat verdict of the private file (if analysis is completed).
GoogleThreatIntelligence.Analysis.data.id String ID of the analysis.
GoogleThreatIntelligence.Analysis.data.type String Type of object (private_analysis).
GoogleThreatIntelligence.Analysis.meta.file_info.sha256 String SHA-256 hash of the file.
GoogleThreatIntelligence.Analysis.meta.file_info.sha1 String SHA-1 hash of the file.
GoogleThreatIntelligence.Analysis.meta.file_info.md5 String MD5 hash of the file.
GoogleThreatIntelligence.Analysis.meta.file_info.size Number Size of the file.
GoogleThreatIntelligence.Analysis.id String The analysis ID.

gti-private-file-scan-and-analysis-get

Scan and get the analysis of a private file submitted to GoogleThreatIntelligence.

Base Command

gti-private-file-scan-and-analysis-get

Input

Argument Name Description Required
entryID The file entry ID to submit. Required
id This is an internal argument used for the polling process, not to be used by the user. Optional
extended_data Whether to return extended data. Possible values are: true, false. Optional
interval_in_seconds Interval in seconds between each poll. Default is 60. Optional

Context Output

Path Type Description
GoogleThreatIntelligence.Analysis.data.attributes.date Number Date of the analysis in epoch format.
GoogleThreatIntelligence.Analysis.data.attributes.status String Status of the analysis.
GoogleThreatIntelligence.Analysis.data.attributes.threat_severity_level String Threat severity level of the private file.
GoogleThreatIntelligence.Analysis.data.attributes.popular_threat_category String Popular threat category of the private file.
GoogleThreatIntelligence.Analysis.data.attributes.threat_verdict String Threat verdict of the private file.
GoogleThreatIntelligence.Analysis.data.id String ID of the analysis.
GoogleThreatIntelligence.Analysis.data.type String Type of object (analysis).
GoogleThreatIntelligence.Analysis.meta.file_info.sha256 String SHA-256 hash of the file.
GoogleThreatIntelligence.Analysis.meta.file_info.sha1 String SHA-1 hash of the file.
GoogleThreatIntelligence.Analysis.meta.file_info.md5 String MD5 hash of the file.
GoogleThreatIntelligence.Analysis.meta.file_info.size Number Size of the file.
GoogleThreatIntelligence.Analysis.id String The analysis ID.

gti-assessment-get

Retrieves GTI assessment for a given resource.

Base Command

gti-assessment-get

Input

Argument Name Description Required
resource The file hash (MD5, SHA1, or SHA256), Domain, URL or IP. Required
resource_type The type of the resource. If not supplied, will determine it’s a file. Possible values are: ip, url, domain, file, hash. Optional

Context Output

Path Type Description
GoogleThreatIntelligence.Assessment.id String ID that contains the assessment (the given hash, domain, url, or ip).
GoogleThreatIntelligence.Assessment.attributes.gti_assessment.threat_score.value Number The threat score of the assessment.
GoogleThreatIntelligence.Assessment.attributes.gti_assessment.severity.value String The severity of the assessment.
GoogleThreatIntelligence.Assessment.attributes.gti_assessment.verdict.value String The verdict of the assessment.

gti-private-url-scan-and-analysis-get

Scan and get the analysis of a private URL submitted to GoogleThreatIntelligence.

Base Command

gti-private-url-scan-and-analysis-get

Input

Argument Name Description Required
url The URL to scan. Required
id This is an internal argument used for the polling process, not to be used by the user. Optional
extended_data Whether to return extended data. Possible values are: true, false. Optional
interval_in_seconds Interval in seconds between each poll. Default is 60. Optional

Context Output

Path Type Description
GoogleThreatIntelligence.Analysis.data.attributes.date Number Date of the analysis in epoch format.
GoogleThreatIntelligence.Analysis.data.attributes.status String Status of the analysis.
GoogleThreatIntelligence.Analysis.data.attributes.url String URL submitted.
GoogleThreatIntelligence.Analysis.data.attributes.title String Title of the private URL (if analysis is completed).
GoogleThreatIntelligence.Analysis.data.attributes.last_http_response_content_sha256 String Last HTTP response content SHA-256 hash of the private URL (if analysis is completed).
GoogleThreatIntelligence.Analysis.data.attributes.positives String Ratio of malicious detections to the total number of engines that scanned the private URL (if analysis is completed).
GoogleThreatIntelligence.Analysis.data.id String ID of the analysis.
GoogleThreatIntelligence.Analysis.data.type String Type of object (private_analysis).
GoogleThreatIntelligence.Analysis.meta.url_info.id String ID of the URL.
GoogleThreatIntelligence.Analysis.meta.url_info.url String URL submitted.
GoogleThreatIntelligence.Analysis.id String The analysis ID.

gti-privatescanning-url-scan

Base Command

gti-privatescanning-url-scan

Input

Argument Name Description Required
url The private URL to scan. Required

Context Output

Path Type Description
GoogleThreatIntelligence.Submission.Type String The type of the submission (private_analysis).
GoogleThreatIntelligence.Submission.id String The ID of the submission.

gti-privatescanning-url

Checks the reputation of a private URL.

Base Command

gti-privatescanning-url

Input

Argument Name Description Required
url Private URL to check. Required

Context Output

Path Type Description
GoogleThreatIntelligence.URL.attributes.favicon.raw_md5 String The MD5 hash of the URL.
GoogleThreatIntelligence.URL.attributes.favicon.dhash String Difference hash.
GoogleThreatIntelligence.URL.attributes.last_http_response_content_length Number The last HTTPS response length.
GoogleThreatIntelligence.URL.attributes.last_http_response_headers.date Date The last response header date.
GoogleThreatIntelligence.URL.attributes.last_http_response_headers.x-sinkhole String DNS sinkhole from last response.
GoogleThreatIntelligence.URL.attributes.last_http_response_headers.content-length String The content length of the last response.
GoogleThreatIntelligence.URL.attributes.last_http_response_headers.content-type String The content type of the last response.
GoogleThreatIntelligence.URL.attributes.last_http_response_content_sha256 String The SHA-256 hash of the content of the last response.
GoogleThreatIntelligence.URL.attributes.last_http_response_code Number Last response status code.
GoogleThreatIntelligence.URL.attributes.last_final_url String Last final URL.
GoogleThreatIntelligence.URL.attributes.url String The URL itself.
GoogleThreatIntelligence.URL.attributes.title String Title of the page.
GoogleThreatIntelligence.URL.attributes.last_analysis_stats.harmless Number The number of engines that found the domain to be harmless.
GoogleThreatIntelligence.URL.attributes.last_analysis_stats.malicious Number The number of engines that found the indicator to be malicious.
GoogleThreatIntelligence.URL.attributes.last_analysis_stats.suspicious Number The number of engines that found the indicator to be suspicious.
GoogleThreatIntelligence.URL.attributes.last_analysis_stats.undetected Number The number of engines that could not detect the indicator.
GoogleThreatIntelligence.URL.attributes.last_analysis_stats.timeout Number The number of engines that timed out for the indicator.
GoogleThreatIntelligence.URL.attributes.outgoing_links String Outgoing links of the URL page.
GoogleThreatIntelligence.URL.type String Type of the indicator (private_url).
GoogleThreatIntelligence.URL.id String ID of the indicator.
GoogleThreatIntelligence.URL.links.self String Link to the response.

Configuration parameters

  • credentials — API Key (leave empty. Fill in the API key in the password field.) (required)
  • feedReliability — Source Reliability
  • gti_malicious — GTI Malicious Verdict. Check Google Threat Intelligence verdict to consider the file malicious.
  • gti_suspicious — GTI Suspicious Verdict. Check Google Threat Intelligence verdict to consider the file suspicious.
  • fileThreshold — File Malicious Threshold. Minimum number of positive results from VT scanners to consider the file malicious.
  • fileSuspiciousThreshold — File Suspicious Threshold. Minimum number of positive and suspicious results from VT scanners to consider the file suspicious.
  • ipThreshold — IP Malicious Threshold. Minimum number of positive results from VT scanners to consider the IP malicious.
  • ipSuspiciousThreshold — IP Suspicious Threshold. Minimum number of positive and suspicious results from VT scanners to consider the IP suspicious.
  • disable_private_ip_lookup — Disable reputation lookups for private IP addresses
  • urlThreshold — URL Malicious Threshold. Minimum number of positive results from VT scanners to consider the URL malicious.
  • urlSuspiciousThreshold — URL Suspicious Threshold. Minimum number of positive and suspicious results from VT scanners to consider the URL suspicious.
  • domainThreshold — Domain Malicious Threshold. Minimum number of positive results from VT scanners to consider the Domain malicious.
  • domainSuspiciousThreshold — Domain Suspicious Threshold. Minimum number of positive and suspicious results from VT scanners to consider the Domain suspicious.
  • preferredVendors — Preferred Vendors List. CSV list of vendors who are considered more trustworthy.
  • preferredVendorsThreshold — Preferred Vendor Threshold. The minimum number of highly trusted vendors required to consider a domain, IP address, URL, or file as malicious.
  • crowdsourced_yara_rules_enabled — Enable score analyzing by Crowdsourced Yara Rules, Sigma, and IDS.
  • yaraRulesThreshold — Crowdsourced Yara Rules Threshold
  • SigmaIDSThreshold — Sigma and Intrusion Detection Rules Threshold
  • domain_popularity_ranking — Domain Popularity Ranking Threshold
  • ip_relationships — IP Relationships
  • domain_relationships — Domain Relationships
  • url_relationships — URL Relationships
  • file_relationships — File Relationships
  • proxy — Use system proxy settings
  • insecure — Trust any certificate (not secure)

Commands (31)

  • cve

    Retrieves CVE information from Google Threat Intelligence.

  • domain

    Checks the reputation of a domain.

  • file

    Checks the file reputation of the specified hash.

  • file-rescan

    Rescans an already submitted file. This avoids having to upload the file again. Use the gti-analysis-get command to get the scan results.

  • file-scan

    Submits a file for scanning. Use the gti-analysis-get command to get the scan results.

  • gti-analysis-get

    Scan and get the analysis of a file submitted to GoogleThreatIntelligence.

  • gti-assessment-get

    Retrieves GTI assessment for a given resource.

  • gti-comments-add

    Adds comments to files and URLs.

  • gti-comments-delete

    Delete a comment.

  • gti-comments-get

    Retrieves comments for a given resource.

  • gti-comments-get-by-id

    Retrieves a comment by comment ID.

  • gti-curated-campaigns-get

    Retrieves GTI curated campaigns for a given resource.

  • gti-curated-malware-families-get

    Retrieves GTI curated malware families for a given resource.

  • gti-curated-threat-actors-get

    Retrieves GTI curated threat actors for a given resource.

  • gti-file-sandbox-report

    Retrieves a behavioral relationship of the given file hash.

  • gti-file-scan-and-analysis-get

    Scan and get the analysis of a file submitted to GoogleThreatIntelligence.

  • gti-file-scan-upload-url

    Get a special URL for files larger than 32 MB.

  • gti-file-sigma-analysis

    Result of the last Sigma analysis in markdown format.

  • gti-passive-dns-data

    Returns passive DNS records by indicator.

  • gti-private-file-scan-and-analysis-get

    Scan and get the analysis of a private file submitted to GoogleThreatIntelligence.

  • gti-private-url-scan-and-analysis-get

    Scan and get the analysis of a private URL submitted to GoogleThreatIntelligence.

  • gti-privatescanning-analysis-get

    Get analysis of a private file or URL submitted to GoogleThreatIntelligence.

  • gti-privatescanning-file

    Checks the file reputation of the specified private hash.

  • gti-privatescanning-file-scan

    Submits a file for private scanning. Use the gti-privatescanning-analysis-get command to get the scan results.

  • gti-privatescanning-url

    Checks the reputation of a private URL.

  • gti-privatescanning-url-scan

    Submits an URL for private scanning. Use the gti-privatescanning-analysis-get command to get the scan results.

  • gti-search

    Search for an indicator in Google Threat Intelligence.

  • gti-url-scan-and-analysis-get

    Scan and get the analysis of a URL submitted to GoogleThreatIntelligence.

  • ip

    Checks the reputation of an IP address.

  • url

    Checks the reputation of a URL.

  • url-scan

    Scans a specified URL. Use the gti-analysis-get command to get the scan results.

Source

GoogleThreatIntelligence.py GoogleThreatIntelligence_test.py GoogleThreatIntelligence.yml GoogleThreatIntelligence_description.md command_examples.txt
Download History Raw 
import json
import os
import demistomock as demisto
import pytest
from CommonServerPython import DemistoException, argToList
from GoogleThreatIntelligence import (
    ScoreCalculator,
    create_relationships,
    encode_url_to_base64,
    epoch_to_timestamp,
    get_whois,
    get_working_id,
    raise_if_hash_not_valid,
    raise_if_ip_not_valid,
)

INTEGRATION_NAME = "GoogleThreatIntelligence"


@pytest.fixture(autouse=True)
def handle_calling_context(mocker):
    mocker.patch.object(demisto, "callingContext", {"context": {"IntegrationBrand": INTEGRATION_NAME}})


class TestScoreCalculator:
    """Tests the ScoreCalculator class"""

    score_calculator: ScoreCalculator

    @classmethod
    def setup_class(cls):
        cls.score_calculator = ScoreCalculator(
            {
                "preferredVendors": "vt1, v2, vt3",
                "preferredVendorsThreshold": 2,
                "fileThreshold": 1,
                "ipThreshold": 1,
                "urlThreshold": 1,
                "domainThreshold": 1,
                "fileSuspiciousThreshold": 0,
                "ipSuspiciousThreshold": 0,
                "urlSuspiciousThreshold": 0,
                "domainSuspiciousThreshold": 0,
                "crowdsourced_yara_rules_enabled": True,
                "yaraRulesThreshold": 1,
                "SigmaIDSThreshold": 1,
                "domain_popularity_ranking": 1,
                "relationship_threshold": 1,
                "relationship_suspicious_threshold": 0,
                "gti_malicious": True,
                "gti_suspicious": True,
            }
        )

    def test_there_are_logs(self):
        with open("./test_data/file.json") as f:
            self.score_calculator.file_score("given hash", json.load(f))
        assert self.score_calculator.logs
        self.score_calculator.logs = []

    @pytest.mark.parametrize("malicious, suspicious, threshold, result", [(0, 5, 5, True), (10, 0, 5, True), (0, 0, 2, False)])
    def test_is_suspicious_by_threshold(self, malicious: int, suspicious: int, threshold: int, result: bool):
        analysis_results = {"malicious": malicious, "suspicious": suspicious}
        assert self.score_calculator.is_suspicious_by_threshold(analysis_results, threshold) is result

    @pytest.mark.parametrize("malicious, threshold, result", [(5, 5, True), (10, 5, True), (0, 2, False)])
    def test_is_malicious_by_threshold(self, malicious: int, threshold: int, result: bool):
        analysis_results = {"malicious": malicious}
        assert self.score_calculator.is_malicious_by_threshold(analysis_results, threshold) is result

    @pytest.mark.parametrize(
        "ranks, result",
        [
            ({"vendor1": {"rank": 10000}}, False),
            ({"vendor1": {"rank": 3000}, "vendor2": {"rank": 7000}}, True),
            ({"vendor1": {"rank": 0}}, True),
            ({"vendor1": {"rank": 300}, "vendor2": {"rank": 300}}, True),
            ({}, None),
        ],
    )
    def test_is_good_by_popularity_ranks(self, ranks: dict[str, dict], result: bool):
        self.score_calculator.domain_popularity_ranking = 5000
        assert self.score_calculator.is_good_by_popularity_ranks(ranks) is result

    @pytest.mark.parametrize("yara_rules_found, result", [(1, False), (3, True), (2, True)])
    def test_is_suspicious_by_rules_yara(self, yara_rules_found: int, result: bool):
        # enable indicators process and set to 2
        self.score_calculator.crowdsourced_yara_rules_enabled = True
        self.score_calculator.crowdsourced_yara_rules_threshold = 2
        # process
        response = {"data": {"crowdsourced_yara_results": [1] * yara_rules_found}}
        assert self.score_calculator.is_suspicious_by_rules(response) is result

    @pytest.mark.parametrize(
        "high, critical, result",
        [
            (2, 0, True),
            (0, 2, True),
            (1, 1, True),
            (0, 0, False),
        ],
    )
    def test_is_suspicious_by_rules_sigma(self, high: int, critical: int, result: bool):
        # enable indicators process and set to 2
        self.score_calculator.crowdsourced_yara_rules_enabled = True
        self.score_calculator.sigma_ids_threshold = 2
        response = {"data": {"sigma_analysis_stats": {"high": high, "critical": critical}}}
        # process
        assert self.score_calculator.is_suspicious_by_rules(response) is result

    @pytest.mark.parametrize("threshold", (1, 2))
    def test_is_preferred_vendors_pass_malicious(self, threshold: int):
        # setup
        self.score_calculator.trusted_vendors_threshold = threshold
        self.score_calculator.trusted_vendors = ["v1", "v2"]
        # process
        analysis_results = {"v1": {"category": "malicious"}, "v2": {"category": "malicious"}}
        assert self.score_calculator.is_preferred_vendors_pass_malicious(analysis_results)

    def test_is_preferred_vendors_pass_malicious_below_threshold(self):
        # setup
        self.score_calculator.trusted_vendors_threshold = 3
        self.score_calculator.trusted_vendors = ["v1", "v2"]
        # process
        analysis_results = {"v1": {"category": "malicious"}, "v2": {"category": "malicious"}}
        assert not self.score_calculator.is_preferred_vendors_pass_malicious(analysis_results)

    def test_is_malicious_by_gti(self):
        assert self.score_calculator.is_malicious_by_gti({"verdict": {"value": "VERDICT_MALICIOUS"}}) is True
        assert self.score_calculator.is_malicious_by_gti({"verdict": {"value": "VERDICT_SUSPICIOUS"}}) is False
        assert self.score_calculator.is_malicious_by_gti({}) is False
        self.score_calculator.gti_malicious = False
        assert self.score_calculator.is_malicious_by_gti({"verdict": {"value": "VERDICT_MALICIOUS"}}) is False

    def test_is_suspicious_by_gti(self):
        assert self.score_calculator.is_suspicious_by_gti({"verdict": {"value": "VERDICT_MALICIOUS"}}) is False
        assert self.score_calculator.is_suspicious_by_gti({"verdict": {"value": "VERDICT_SUSPICIOUS"}}) is True
        assert self.score_calculator.is_suspicious_by_gti({}) is False
        self.score_calculator.gti_suspicious = False
        assert self.score_calculator.is_suspicious_by_gti({"verdict": {"value": "VERDICT_SUSPICIOUS"}}) is False


class TestHelpers:
    def test_encode_url_to_base64(self):
        assert encode_url_to_base64("https://example.com") == "aHR0cHM6Ly9leGFtcGxlLmNvbQ"

    def test_raise_if_hash_not_valid_valid_input(self):
        raise_if_hash_not_valid("7e641f6b9706d860baf09fe418b6cc87")

    def test_raise_if_hash_not_valid_invalid_input(self):
        with pytest.raises(ValueError, match="not of type"):
            raise_if_hash_not_valid("not a valid hash")

    def test_raise_if_ip_not_valid_valid_input(self):
        raise_if_ip_not_valid("8.8.8.8")

    def test_raise_if_ip_not_valid_invalid_input(self):
        with pytest.raises(ValueError, match="is not valid"):
            raise_if_ip_not_valid("not ip at all")

    @pytest.mark.parametrize(
        "epoch_time, output", [(0, "1970-01-01 00:00:00Z"), (999113584, "2001-08-29 19:33:04Z"), ("a string", None)]
    )
    def test_epoch_to_timestamp(self, epoch_time: int, output: str):
        assert epoch_to_timestamp(epoch_time) == output

    def test_get_working_id(self):
        assert get_working_id("314huoh432ou", "") == "314huoh432ou"

    def test_get_working_id_no_entry(self):
        with pytest.raises(DemistoException):
            assert get_working_id("1451", "")


def test_create_relationships():
    """
    Given:
    - The IP response from the API.

    When:
    - create relationships function.

    Then:
    - Validate that the relationships were created as expected.
    """
    expected_name = ["communicates-with", "communicates-with", "related-to", "related-to"]
    with open("./test_data/relationships.json") as f:
        relationships = create_relationships(
            entity_a="Test", entity_a_type="IP", relationships_response=json.load(f), reliability="B - Usually reliable"
        )
    relation_entry = [relation.to_entry() for relation in relationships]

    for relation, expected_relation_name in zip(relation_entry, expected_name):
        assert relation.get("name") == expected_relation_name
        assert relation.get("entityA") == "Test"
        assert relation.get("entityBType") == "File"


def test_get_whois_unexpected_value():
    """
    Given:
    - Whois string.

    When:
    - Whois string returned is a reserved Whois string returned by GoogleThreatIntelligence services.

    Then:
    - Validate empty dict is returned
    """
    assert get_whois("g. [Organization] Reserved Domain Name\nl. [Organization Type] Reserved Domain Name") == {}


def util_load_json(path):
    with open(path, encoding="utf-8") as f:
        return json.loads(f.read())


DEFAULT_PARAMS = {
    "credentials": {"password": "somepassword"},
    "domain_relationships": "* cname records",
    "ip_relationships": "* cname records",
    "url_relationships": "* cname records",
    "preferredVendors": "vt1, v2, vt3",
    "preferredVendorsThreshold": 2,
    "fileThreshold": 1,
    "ipThreshold": 1,
    "urlThreshold": 1,
    "domainThreshold": 1,
    "fileSuspiciousThreshold": 0,
    "ipSuspiciousThreshold": 0,
    "urlSuspiciousThreshold": 0,
    "domainSuspiciousThreshold": 0,
    "crowdsourced_yara_rules_enabled": True,
    "yaraRulesThreshold": 1,
    "SigmaIDSThreshold": 1,
    "domain_popularity_ranking": 1,
    "relationship_threshold": 1,
    "relationship_suspicious_threshold": 0,
    "feedReliability": "A - Completely reliable",
    "insecure": "false",
    "proxy": "false",
    "gti_malicious": True,
    "gti_suspicious": True,
}


def test_file_command(mocker, requests_mock):
    """
    Given:
    - A valid file hash

    When:
    - Running the !file command

    Then:
    - Validate the command results are valid and contains metric data
    """
    import CommonServerPython
    from GoogleThreatIntelligence import Client, ScoreCalculator, file_command

    file_hash = "0000000000000000000000000000000000000000000000000000000000000000"
    mocker.patch.object(demisto, "params", return_value=DEFAULT_PARAMS)
    mocker.patch.object(CommonServerPython, "is_demisto_version_ge", return_value=True)

    params = demisto.params()
    mocked_score_calculator = ScoreCalculator(params=params)
    file_relationships = (",".join(argToList(params.get("file_relationships")))).replace("* ", "").replace(" ", "_")
    client = Client(params=params)

    mock_response = util_load_json("test_data/file.json")
    requests_mock.get(
        f"https://www.virustotal.com/api/v3/files/{file_hash}?relationships={file_relationships}", json=mock_response
    )

    for extended_data in [True, False]:
        file_hash = "0000000000000000000000000000000000000000000000000000000000000000"
        mocker.patch.object(demisto, "args", return_value={"file": file_hash, "extended_data": extended_data})

        if extended_data:
            expected_results = util_load_json("test_data/file_extended_results.json")
        else:
            expected_results = util_load_json("test_data/file_results.json")

        # Run command and collect result array
        results = file_command(
            client=client, score_calculator=mocked_score_calculator, args=demisto.args(), relationships=file_relationships
        )

        assert results[1].execution_metrics == [{"APICallsCount": 1, "Type": "Successful"}]
        assert results[0].execution_metrics is None
        assert results[0].outputs == expected_results
        assert results[0].indicator.dbot_score.score == 3


def test_not_found_file_command(mocker, requests_mock):
    """
    Given:
    - A not found file hash

    When:
    - Running the !file command

    Then:
    - Display "Not found" message to user
    """
    import CommonServerPython
    from GoogleThreatIntelligence import Client, ScoreCalculator, file_command

    # Setup Mocks
    file_hash = "0000000000000000000000000000000000000000000000000000000000000000"
    mocker.patch.object(demisto, "args", return_value={"file": file_hash, "extended_data": "false"})
    mocker.patch.object(demisto, "params", return_value=DEFAULT_PARAMS)
    mocker.patch.object(CommonServerPython, "is_demisto_version_ge", return_value=True)

    # Assign arguments
    params = demisto.params()
    mocked_score_calculator = ScoreCalculator(params=params)
    file_relationships = (",".join(argToList(params.get("file_relationships")))).replace("* ", "").replace(" ", "_")
    client = Client(params=params)

    mock_response = {"error": {"code": "NotFoundError"}}
    requests_mock.get(
        f"https://www.virustotal.com/api/v3/files/{file_hash}?relationships={file_relationships}", json=mock_response
    )

    results = file_command(
        client=client, score_calculator=mocked_score_calculator, args=demisto.args(), relationships=file_relationships
    )

    assert results[0].execution_metrics is None
    assert results[0].readable_output == f'File "{file_hash}" was not found in GoogleThreatIntelligence.'
    assert results[0].indicator.dbot_score.score == 0


def test_domain_command(mocker, requests_mock):
    """
    Given:
    - A valid Testing domain (testing.com)

    When:
    - Running the !domain command

    Then:
    - Validate the command results are valid and contains metric data
    """
    import CommonServerPython
    from GoogleThreatIntelligence import Client, ScoreCalculator, domain_command

    # Setup Mocks
    mocker.patch.object(demisto, "args", return_value={"domain": "testing.com", "extended_data": "false"})
    mocker.patch.object(demisto, "params", return_value=DEFAULT_PARAMS)
    mocker.patch.object(CommonServerPython, "is_demisto_version_ge", return_value=True)

    # Assign arguments
    params = demisto.params()
    mocked_score_calculator = ScoreCalculator(params=params)
    domain_relationships = (",".join(argToList(params.get("domain_relationships")))).replace("* ", "").replace(" ", "_")
    client = Client(params=params)

    # Load assertions and mocked request data
    mock_response = util_load_json("test_data/domain.json")
    expected_results = util_load_json("test_data/domain_results.json")
    requests_mock.get(
        f"https://www.virustotal.com/api/v3/domains/testing.com?relationships={domain_relationships}", json=mock_response
    )

    # Run command and collect result array
    results = domain_command(
        client=client, score_calculator=mocked_score_calculator, args=demisto.args(), relationships=domain_relationships
    )

    assert results[1].execution_metrics == [{"APICallsCount": 1, "Type": "Successful"}]
    assert results[0].execution_metrics is None
    assert results[0].outputs == expected_results
    assert results[0].indicator.dbot_score.score == 3


def test_not_found_domain_command(mocker, requests_mock):
    """
    Given:
    - A not found domain (testing.com)

    When:
    - Running the !domain command

    Then:
    - Display "Not found" message to user
    """
    import CommonServerPython
    from GoogleThreatIntelligence import Client, ScoreCalculator, domain_command

    # Setup Mocks
    mocker.patch.object(demisto, "args", return_value={"domain": "testing.com", "extended_data": "false"})
    mocker.patch.object(demisto, "params", return_value=DEFAULT_PARAMS)
    mocker.patch.object(CommonServerPython, "is_demisto_version_ge", return_value=True)

    # Assign arguments
    params = demisto.params()
    mocked_score_calculator = ScoreCalculator(params=params)
    domain_relationships = (",".join(argToList(params.get("domain_relationships")))).replace("* ", "").replace(" ", "_")
    client = Client(params=params)

    mock_response = {"error": {"code": "NotFoundError"}}
    requests_mock.get(
        f"https://www.virustotal.com/api/v3/domains/testing.com?relationships={domain_relationships}", json=mock_response
    )

    results = domain_command(
        client=client, score_calculator=mocked_score_calculator, args=demisto.args(), relationships=domain_relationships
    )

    assert results[0].execution_metrics is None
    assert results[0].readable_output == 'Domain "testing.com" was not found in GoogleThreatIntelligence.'
    assert results[0].indicator.dbot_score.score == 0


def test_ip_command(mocker, requests_mock):
    """
    Given:
    - A valid (and private) ip (192.168.0.1)

    When:
    - Running the !ip command

    Then:
    - Validate the command results are valid and contains metric data
    """
    import CommonServerPython
    from GoogleThreatIntelligence import Client, ScoreCalculator, ip_command

    # Setup Mocks
    mocker.patch.object(demisto, "args", return_value={"ip": "192.168.0.1", "extended_data": "false"})
    mocker.patch.object(demisto, "params", return_value=DEFAULT_PARAMS)
    mocker.patch.object(CommonServerPython, "is_demisto_version_ge", return_value=True)

    # Assign arguments
    params = demisto.params()
    mocked_score_calculator = ScoreCalculator(params=params)
    ip_relationships = (",".join(argToList(params.get("ip_relationships")))).replace("* ", "").replace(" ", "_")
    client = Client(params=params)

    # Load assertions and mocked request data
    mock_response = util_load_json("test_data/ip.json")
    expected_results = util_load_json("test_data/ip_results.json")
    requests_mock.get(
        f"https://www.virustotal.com/api/v3/ip_addresses/192.168.0.1?relationships={ip_relationships}", json=mock_response
    )

    # Run command and collect result array
    results = ip_command(
        client=client,
        score_calculator=mocked_score_calculator,
        args=demisto.args(),
        relationships=ip_relationships,
        disable_private_ip_lookup=False,
    )

    assert results[1].execution_metrics == [{"APICallsCount": 1, "Type": "Successful"}]
    assert results[0].execution_metrics is None
    assert results[0].outputs == expected_results
    assert results[0].indicator.dbot_score.score == 3


def test_ip_command_private_ip_lookup(mocker):
    """
    Given:
    - A valid (and private) ip (192.168.0.1) and enabling private ip lookup

    When:
    - Running the !ip command

    Then:
    - Display "Reputation lookups disabled" message to user
    """
    import CommonServerPython
    from GoogleThreatIntelligence import Client, ScoreCalculator, ip_command

    # Setup Mocks
    mocker.patch.object(demisto, "args", return_value={"ip": "192.168.0.1", "extended_data": "false"})
    mocker.patch.object(demisto, "params", return_value=DEFAULT_PARAMS)
    mocker.patch.object(CommonServerPython, "is_demisto_version_ge", return_value=True)

    # Assign arguments
    params = demisto.params()
    mocked_score_calculator = ScoreCalculator(params=params)
    ip_relationships = (",".join(argToList(params.get("ip_relationships")))).replace("* ", "").replace(" ", "_")
    client = Client(params=params)

    # Run command but disabling private IP enrichment
    results = ip_command(
        client=client,
        score_calculator=mocked_score_calculator,
        args=demisto.args(),
        relationships=ip_relationships,
        disable_private_ip_lookup=True,
    )

    assert results[1].execution_metrics == [{"APICallsCount": 1, "Type": "Successful"}]
    assert results[0].execution_metrics is None
    assert results[0].readable_output == (
        'IP "192.168.0.1" was not enriched. Reputation lookups have been disabled for private IP addresses.'
    )
    assert results[0].indicator.dbot_score.score == 0


def test_ip_command_override_private_lookup(mocker, requests_mock):
    """
    Given:
    - A valid (and private) ip (192.168.0.1) and enabling private ip lookup

    When:
    - Running the !ip command

    Then:
    - Display "Reputation lookups disabled" message to user
    """
    import CommonServerPython
    from GoogleThreatIntelligence import Client, ScoreCalculator, ip_command

    # Setup Mocks
    mocker.patch.object(
        demisto, "args", return_value={"ip": "192.168.0.1", "extended_data": "false", "override_private_lookup": "true"}
    )
    mocker.patch.object(demisto, "params", return_value=DEFAULT_PARAMS)
    mocker.patch.object(CommonServerPython, "is_demisto_version_ge", return_value=True)

    # Assign arguments
    params = demisto.params()
    mocked_score_calculator = ScoreCalculator(params=params)
    ip_relationships = (",".join(argToList(params.get("ip_relationships")))).replace("* ", "").replace(" ", "_")
    client = Client(params=params)

    # Load assertions and mocked request data
    mock_response = util_load_json("test_data/ip.json")
    expected_results = util_load_json("test_data/ip_results.json")
    requests_mock.get(
        f"https://www.virustotal.com/api/v3/ip_addresses/192.168.0.1?relationships={ip_relationships}", json=mock_response
    )

    # Run command but enabling private IP enrichment after disabling it
    results = ip_command(
        client=client,
        score_calculator=mocked_score_calculator,
        args=demisto.args(),
        relationships=ip_relationships,
        disable_private_ip_lookup=True,
    )

    assert results[1].execution_metrics == [{"APICallsCount": 1, "Type": "Successful"}]
    assert results[0].execution_metrics is None
    assert results[0].outputs == expected_results
    assert results[0].indicator.dbot_score.score == 3


def test_not_found_ip_command(mocker, requests_mock):
    """
    Given:
    - A not found ip (192.168.0.1)

    When:
    - Running the !ip command

    Then:
    - Display "Not found" message to user
    """
    import CommonServerPython
    from GoogleThreatIntelligence import Client, ScoreCalculator, ip_command

    # Setup Mocks
    mocker.patch.object(demisto, "args", return_value={"ip": "192.168.0.1", "extended_data": "false"})
    mocker.patch.object(demisto, "params", return_value=DEFAULT_PARAMS)
    mocker.patch.object(CommonServerPython, "is_demisto_version_ge", return_value=True)

    # Assign arguments
    params = demisto.params()
    mocked_score_calculator = ScoreCalculator(params=params)
    ip_relationships = (",".join(argToList(params.get("ip_relationships")))).replace("* ", "").replace(" ", "_")
    client = Client(params=params)

    mock_response = {"error": {"code": "NotFoundError"}}
    requests_mock.get(
        f"https://www.virustotal.com/api/v3/ip_addresses/192.168.0.1?relationships={ip_relationships}", json=mock_response
    )

    results = ip_command(
        client=client,
        score_calculator=mocked_score_calculator,
        args=demisto.args(),
        relationships=ip_relationships,
        disable_private_ip_lookup=False,
    )

    assert results[0].execution_metrics is None
    assert results[0].readable_output == 'IP "192.168.0.1" was not found in GoogleThreatIntelligence.'
    assert results[0].indicator.dbot_score.score == 0


def test_url_command(mocker, requests_mock):
    """
    Given:
    - A valid testing url (https://vt_is_awesome.com/uts)

    When:
    - Running the !url command

    Then:
    - Validate the command results are valid and contains metric data
    """
    import CommonServerPython
    from GoogleThreatIntelligence import Client, ScoreCalculator, url_command

    # Setup Mocks
    mocker.patch.object(demisto, "args", return_value={"url": "https://vt_is_awesome.com/uts", "extended_data": "false"})
    mocker.patch.object(demisto, "params", return_value=DEFAULT_PARAMS)
    mocker.patch.object(CommonServerPython, "is_demisto_version_ge", return_value=True)

    # Assign arguments
    testing_url = "https://vt_is_awesome.com/uts"
    params = demisto.params()
    mocked_score_calculator = ScoreCalculator(params=params)
    url_relationships = (",".join(argToList(params.get("url_relationships")))).replace("* ", "").replace(" ", "_")
    client = Client(params=params)

    # Load assertions and mocked request data
    mock_response = util_load_json("test_data/url.json")
    expected_results = util_load_json("test_data/url_results.json")
    requests_mock.get(
        f"https://www.virustotal.com/api/v3/urls/{encode_url_to_base64(testing_url)}?relationships={url_relationships}",
        json=mock_response,
    )

    # Run command and collect result array
    results = url_command(
        client=client, score_calculator=mocked_score_calculator, args=demisto.args(), relationships=url_relationships
    )

    assert results[1].execution_metrics == [{"APICallsCount": 1, "Type": "Successful"}]
    assert results[0].execution_metrics is None
    assert results[0].outputs == expected_results
    assert results[0].indicator.dbot_score.score == 3


def test_not_found_url_command(mocker, requests_mock):
    """
    Given:
    - A not found url (https://vt_is_awesome.com/uts)

    When:
    - Running the !url command

    Then:
    - Display "Not found" message to user
    """
    import CommonServerPython
    from GoogleThreatIntelligence import Client, ScoreCalculator, url_command

    # Setup Mocks
    mocker.patch.object(demisto, "args", return_value={"url": "https://vt_is_awesome.com/uts", "extended_data": "false"})
    mocker.patch.object(demisto, "params", return_value=DEFAULT_PARAMS)
    mocker.patch.object(CommonServerPython, "is_demisto_version_ge", return_value=True)

    # Assign arguments
    testing_url = "https://vt_is_awesome.com/uts"
    params = demisto.params()
    mocked_score_calculator = ScoreCalculator(params=params)
    url_relationships = (",".join(argToList(params.get("url_relationships")))).replace("* ", "").replace(" ", "_")
    client = Client(params=params)

    mock_response = {"error": {"code": "NotFoundError"}}
    requests_mock.get(
        f"https://www.virustotal.com/api/v3/urls/{encode_url_to_base64(testing_url)}?relationships={url_relationships}",
        json=mock_response,
    )

    results = url_command(
        client=client, score_calculator=mocked_score_calculator, args=demisto.args(), relationships=url_relationships
    )

    assert results[0].execution_metrics is None
    assert results[0].readable_output == f'URL "{testing_url}" was not found in GoogleThreatIntelligence.'
    assert results[0].indicator.dbot_score.score == 0


def test_private_file_command(mocker, requests_mock):
    """
    Given:
    - A valid Testing private file

    When:
    - Running the !gti-privatescanning-file command

    Then:
    - Validate the command results are valid and contains metric data
    """
    import CommonServerPython
    from GoogleThreatIntelligence import Client, private_file_command

    # Setup Mocks
    sha256 = "Example_sha256_with_64_characters_000000000000000000000000000000"
    mocker.patch.object(demisto, "args", return_value={"file": sha256})
    mocker.patch.object(demisto, "params", return_value=DEFAULT_PARAMS)
    mocker.patch.object(CommonServerPython, "is_demisto_version_ge", return_value=True)

    # Assign arguments
    params = demisto.params()
    client = Client(params=params)

    # Load assertions and mocked request data
    mock_response = util_load_json("test_data/private_file.json")
    expected_results = util_load_json("test_data/private_file_results.json")
    requests_mock.get(f"https://www.virustotal.com/api/v3/private/files/{sha256}", json=mock_response)

    # Run command and collect result array
    results = private_file_command(client=client, args=demisto.args())

    assert results[1].execution_metrics == [{"APICallsCount": 1, "Type": "Successful"}]
    assert results[0].execution_metrics is None
    assert results[0].outputs == expected_results


def test_not_found_private_file_command(mocker, requests_mock):
    """
    Given:
    - A valid Testing private file

    When:
    - Running the !gti-privatescanning-file command

    Then:
    - Display "Not found" message to user
    """
    import CommonServerPython
    from GoogleThreatIntelligence import Client, private_file_command

    # Setup Mocks
    sha256 = "Example_sha256_with_64_characters_000000000000000000000000000000"
    mocker.patch.object(demisto, "args", return_value={"file": sha256})
    mocker.patch.object(demisto, "params", return_value=DEFAULT_PARAMS)
    mocker.patch.object(CommonServerPython, "is_demisto_version_ge", return_value=True)

    # Assign arguments
    params = demisto.params()
    client = Client(params=params)

    mock_response = {"error": {"code": "NotFoundError"}}
    requests_mock.get(f"https://www.virustotal.com/api/v3/private/files/{sha256}", json=mock_response)

    results = private_file_command(client=client, args=demisto.args())

    assert results[0].execution_metrics is None
    assert results[0].readable_output == f'File "{sha256}" was not found in GoogleThreatIntelligence.'
    assert results[0].indicator.dbot_score.score == 0


def test_invalid_file_command(mocker):
    """
    Given:
    - A invalid Testing file

    When:
    - Running the !file command

    Then:
    - Display "Invalid hash" message to user
    """
    import CommonServerPython
    from GoogleThreatIntelligence import Client, file_command

    # Setup Mocks
    sha256 = "Invalid random hash"
    mocker.patch.object(demisto, "args", return_value={"file": sha256})
    mocker.patch.object(demisto, "params", return_value=DEFAULT_PARAMS)
    mocker.patch.object(CommonServerPython, "is_demisto_version_ge", return_value=True)

    # Assign arguments
    params = demisto.params()
    mocked_score_calculator = ScoreCalculator(params=params)
    client = Client(params=params)

    results = file_command(
        client=client,
        score_calculator=mocked_score_calculator,
        args=demisto.args(),
        relationships=None,
    )

    assert results[0].execution_metrics is None
    assert results[0].readable_output == (
        f'File "{sha256}" could not be processed. Error: Hash "{sha256}" is not of type SHA-256, SHA-1 or MD5'
    )
    assert results[0].indicator.dbot_score.score == 0


def test_invalid_private_file_command(mocker):
    """
    Given:
    - A invalid Testing private file

    When:
    - Running the !gti-privatescanning-file command

    Then:
    - Display "Invalid hash" message to user
    """
    import CommonServerPython
    from GoogleThreatIntelligence import Client, private_file_command

    # Setup Mocks
    sha256 = "Invalid random hash"
    mocker.patch.object(demisto, "args", return_value={"file": sha256})
    mocker.patch.object(demisto, "params", return_value=DEFAULT_PARAMS)
    mocker.patch.object(CommonServerPython, "is_demisto_version_ge", return_value=True)

    # Assign arguments
    params = demisto.params()
    client = Client(params=params)

    results = private_file_command(client=client, args=demisto.args())

    assert results[0].execution_metrics is None
    assert results[0].readable_output == (
        f'File "{sha256}" could not be processed. Error: Hash "{sha256}" is not of type SHA-256, SHA-1 or MD5'
    )
    assert results[0].indicator.dbot_score.score == 0


def test_private_url_command(mocker, requests_mock):
    """
    Given:
    - A valid Testing private URL

    When:
    - Running the !gti-privatescanning-url command

    Then:
    - Validate the command results are valid and contains metric data
    """
    import CommonServerPython
    from GoogleThreatIntelligence import Client, private_url_command

    # Setup Mocks
    url = "https://www.example.com"
    mocker.patch.object(demisto, "args", return_value={"url": url})
    mocker.patch.object(demisto, "params", return_value=DEFAULT_PARAMS)
    mocker.patch.object(CommonServerPython, "is_demisto_version_ge", return_value=True)

    # Assign arguments
    params = demisto.params()
    client = Client(params=params)

    # Load assertions and mocked request data
    mock_response = util_load_json("test_data/private_url.json")
    expected_results = util_load_json("test_data/private_url_results.json")
    requests_mock.get(f"https://www.virustotal.com/api/v3/private/urls/{encode_url_to_base64(url)}", json=mock_response)

    # Run command and collect result array
    results = private_url_command(client=client, args=demisto.args())

    assert results[1].execution_metrics == [{"APICallsCount": 1, "Type": "Successful"}]
    assert results[0].execution_metrics is None
    assert results[0].outputs == expected_results


def test_not_found_private_url_command(mocker, requests_mock):
    """
    Given:
    - A valid Testing private file

    When:
    - Running the !gti-privatescanning-url command

    Then:
    - Display "Not found" message to user
    """
    import CommonServerPython
    from GoogleThreatIntelligence import Client, private_url_command

    # Setup Mocks
    url = "https://www.example.com"
    mocker.patch.object(demisto, "args", return_value={"url": url})
    mocker.patch.object(demisto, "params", return_value=DEFAULT_PARAMS)
    mocker.patch.object(CommonServerPython, "is_demisto_version_ge", return_value=True)

    # Assign arguments
    params = demisto.params()
    client = Client(params=params)

    mock_response = {"error": {"code": "NotFoundError"}}
    requests_mock.get(f"https://www.virustotal.com/api/v3/private/urls/{encode_url_to_base64(url)}", json=mock_response)

    results = private_url_command(client=client, args=demisto.args())

    assert results[0].execution_metrics is None
    assert results[0].readable_output == f'URL "{url}" was not found in GoogleThreatIntelligence.'
    assert results[0].indicator.dbot_score.score == 0


def test_not_found_file_sandbox_report_command(mocker, requests_mock):
    """
    Given:
    - A valid Testing hash

    When:
    - Running the !gti-file-sandbox-report command

    Then:
    - Display "Not found" message to user
    """
    import CommonServerPython
    from GoogleThreatIntelligence import Client, file_sandbox_report_command

    # Setup Mocks
    sha256 = "Example_sha256_with_64_characters_000000000000000000000000000000"
    mocker.patch.object(demisto, "args", return_value={"file": sha256, "limit": "10"})
    mocker.patch.object(demisto, "params", return_value=DEFAULT_PARAMS)
    mocker.patch.object(CommonServerPython, "is_demisto_version_ge", return_value=True)

    # Assign arguments
    params = demisto.params()
    client = Client(params=params)

    mock_response = {"error": {"code": "NotFoundError"}}
    requests_mock.get(f"https://www.virustotal.com/api/v3/files/{sha256}/behaviours", json=mock_response)

    results = file_sandbox_report_command(client=client, args=demisto.args())

    assert results[0].execution_metrics is None
    assert results[0].readable_output == f'File "{sha256}" was not found in GoogleThreatIntelligence.'


def test_gti_assessment_command(mocker, requests_mock):
    """
    Given:
    - A valid or not found IoC

    When:
    - Running the !gti-assessment-get command

    Then:
    - Validate the command results are valid
    """
    import CommonServerPython
    from GoogleThreatIntelligence import Client, ScoreCalculator, encode_url_to_base64, get_assessment_command

    for resource, resource_type, endpoint in [
        ("0000000000000000000000000000000000000000000000000000000000000000", "file", "files"),
        ("8.8.8.8", "ip", "ip_addresses"),
        ("www.example.com", "domain", "domains"),
        ("https://www.example.com", "url", "urls"),
    ]:
        error_resource_type = resource_type.upper() if resource_type in ["url", "ip"] else resource_type.capitalize()
        for mock_response, expected_results in [
            (
                util_load_json(f"test_data/{resource_type}.json"),
                util_load_json(f"test_data/{resource_type}_assessment_results.json"),
            ),
            (
                {"error": {"code": "NotFoundError"}},
                f'{error_resource_type} "{resource}" was not found in GoogleThreatIntelligence.',
            ),
        ]:
            mocker.patch.object(demisto, "args", return_value={"resource": resource, "resource_type": resource_type})
            mocker.patch.object(demisto, "params", return_value=DEFAULT_PARAMS)
            mocker.patch.object(CommonServerPython, "is_demisto_version_ge", return_value=True)

            # Assign arguments
            params = demisto.params()
            mocked_score_calculator = ScoreCalculator(params=params)
            client = Client(params=params)

            # Load assertions and mocked request data
            endpoint_resource = encode_url_to_base64(resource) if resource_type == "url" else resource
            requests_mock.get(
                f"https://www.virustotal.com/api/v3/{endpoint}/{endpoint_resource}?relationships=", json=mock_response
            )

            # Run command and collect result array
            results = get_assessment_command(client=client, score_calculator=mocked_score_calculator, args=demisto.args())

            assert results.execution_metrics is None
            if "error" in mock_response:
                assert results.readable_output == expected_results
                assert results.indicator.dbot_score.score == 0
            else:
                assert results.outputs == expected_results
                assert results.indicator.dbot_score.score == 3


def test_gti_comments_command(mocker, requests_mock):
    """
    Given:
    - A valid IoC

    When:
    - Running the !gti-comments-get command

    Then:
    - Validate the command results are valid
    """
    import CommonServerPython
    from GoogleThreatIntelligence import Client, encode_url_to_base64, get_comments_command

    mocker.patch.object(demisto, "params", return_value=DEFAULT_PARAMS)
    mocker.patch.object(CommonServerPython, "is_demisto_version_ge", return_value=True)
    params = demisto.params()
    client = Client(params=params)

    mock_response = {
        "data": [
            {
                "attributes": {
                    "date": 0,
                    "text": "Hello",
                    "votes": {
                        "positive": 10,
                        "negative": 5,
                        "abuse": 1,
                    },
                }
            }
        ]
    }

    for resource, resource_type, endpoint in [
        ("0000000000000000000000000000000000000000000000000000000000000000", "file", "files"),
        ("8.8.8.8", "ip", "ip_addresses"),
        ("www.example.com", "domain", "domains"),
        ("https://www.example.com", "url", "urls"),
    ]:
        mocker.patch.object(
            demisto,
            "args",
            return_value={
                "resource": resource,
                "resource_type": resource_type,
                "limit": 10,
            },
        )

        endpoint_resource = encode_url_to_base64(resource) if resource_type == "url" else resource
        requests_mock.get(f"https://www.virustotal.com/api/v3/{endpoint}/{endpoint_resource}/comments", json=mock_response)

        results = get_comments_command(client=client, args=demisto.args())

        assert results.execution_metrics is None
        assert results.outputs == {"indicator": resource, "comments": mock_response["data"]}


def test_gti_add_comments_command(mocker, requests_mock):
    """
    Given:
    - A valid IoC and comment

    When:
    - Running the !gti-comments-add command

    Then:
    - Validate the command results are valid
    """
    import CommonServerPython
    from GoogleThreatIntelligence import Client, add_comments_command

    mocker.patch.object(demisto, "params", return_value=DEFAULT_PARAMS)
    mocker.patch.object(CommonServerPython, "is_demisto_version_ge", return_value=True)
    params = demisto.params()
    client = Client(params=params)

    mock_response = {
        "data": {
            "attributes": {
                "date": 0,
                "text": "Hello",
                "votes": {
                    "positive": 10,
                    "negative": 5,
                    "abuse": 1,
                },
            }
        }
    }

    for resource, resource_type, endpoint in [
        ("0000000000000000000000000000000000000000000000000000000000000000", "file", "files"),
        ("8.8.8.8", "ip", "ip_addresses"),
        ("www.example.com", "domain", "domains"),
        ("https://www.example.com", "url", "urls"),
    ]:
        mocker.patch.object(
            demisto,
            "args",
            return_value={
                "resource": resource,
                "resource_type": resource_type,
                "comment": "Hello",
            },
        )

        endpoint_resource = encode_url_to_base64(resource) if resource_type == "url" else resource
        requests_mock.post(f"https://www.virustotal.com/api/v3/{endpoint}/{endpoint_resource}/comments", json=mock_response)

        results = add_comments_command(client=client, args=demisto.args())

        assert results.execution_metrics is None
        assert results.outputs == mock_response["data"]


def test_gti_comments_by_id_command(mocker, requests_mock):
    """
    Given:
    - A valid IoC

    When:
    - Running the !gti-comments-get-by-id command

    Then:
    - Validate the command results are valid
    """
    import CommonServerPython
    from GoogleThreatIntelligence import Client, get_comments_by_id_command

    mocker.patch.object(demisto, "params", return_value=DEFAULT_PARAMS)
    mocker.patch.object(CommonServerPython, "is_demisto_version_ge", return_value=True)
    params = demisto.params()
    client = Client(params=params)

    mock_response = {
        "data": {
            "attributes": {
                "date": 0,
                "text": "Hello",
                "votes": {
                    "positive": 10,
                    "negative": 5,
                    "abuse": 1,
                },
            }
        }
    }

    mocker.patch.object(demisto, "args", return_value={"id": "random_id"})
    requests_mock.get("https://www.virustotal.com/api/v3/comments/random_id", json=mock_response)

    results = get_comments_by_id_command(client=client, args=demisto.args())

    assert results.execution_metrics is None
    assert results.outputs == mock_response["data"]


def test_gti_passive_dns(mocker, requests_mock):
    """
    Given:
    - A valid IP address (8.8.8.8)

    When:
    - Running the !gti-passive-dns-data command

    Then:
    - Validate the command results are valid
    """
    import CommonServerPython
    from GoogleThreatIntelligence import Client, passive_dns_data

    mocker.patch.object(demisto, "params", return_value=DEFAULT_PARAMS)
    mocker.patch.object(CommonServerPython, "is_demisto_version_ge", return_value=True)
    params = demisto.params()
    client = Client(params=params)

    mock_response = util_load_json("test_data/passive_dns_ip.json")
    expected_response = util_load_json("test_data/passive_dns_ip_results.json")

    mocker.patch.object(demisto, "args", return_value={"id": "8.8.8.8", "limit": 10})
    requests_mock.get("https://www.virustotal.com/api/v3/ip_addresses/8.8.8.8/resolutions?limit=10", json=mock_response)

    results = passive_dns_data(client=client, args=demisto.args())

    assert results.execution_metrics is None
    assert results.outputs == expected_response


def test_gti_analysis_get(mocker, requests_mock):
    """
    Given:
    - A valid analysis ID

    When:
    - Running the !gti-analysis-get command

    Then:
    - Validate the command results are valid
    """
    import CommonServerPython
    from GoogleThreatIntelligence import Client, get_analysis_command

    mocker.patch.object(demisto, "params", return_value=DEFAULT_PARAMS)
    mocker.patch.object(CommonServerPython, "is_demisto_version_ge", return_value=True)
    params = demisto.params()
    client = Client(params=params)

    mock_response = {
        "data": {
            "attributes": {
                "status": "completed",
            }
        }
    }

    mocker.patch.object(demisto, "args", return_value={"id": "random_id"})
    requests_mock.get("https://www.virustotal.com/api/v3/analyses/random_id", json=mock_response)

    results = get_analysis_command(client=client, args=demisto.args())

    assert results.execution_metrics is None
    assert results.outputs == {"id": "random_id", **mock_response}


def test_pending_gti_private_analysis_get(mocker, requests_mock):
    """
    Given:
    - A valid analysis ID

    When:
    - Running the !gti-privatescanning-analysis-get command (pending)

    Then:
    - Validate the command results are valid
    """
    import CommonServerPython
    from GoogleThreatIntelligence import Client, private_get_analysis_command

    mocker.patch.object(demisto, "params", return_value=DEFAULT_PARAMS)
    mocker.patch.object(CommonServerPython, "is_demisto_version_ge", return_value=True)
    params = demisto.params()
    client = Client(params=params)

    mock_response = {
        "data": {
            "attributes": {
                "status": "pending",
            }
        }
    }
    expected_response = mock_response.copy()
    expected_response["id"] = "random_id"

    mocker.patch.object(demisto, "args", return_value={"id": "random_id"})
    requests_mock.get("https://www.virustotal.com/api/v3/private/analyses/random_id", json=mock_response)

    results = private_get_analysis_command(client=client, args=demisto.args())

    assert results.execution_metrics is None
    assert results.outputs == expected_response


def test_completed_gti_private_analysis_get(mocker, requests_mock):
    """
    Given:
    - A valid analysis ID

    When:
    - Running the !gti-privatescanning-analysis-get command (completed)

    Then:
    - Validate the command results are valid
    """
    import CommonServerPython
    from GoogleThreatIntelligence import Client, private_get_analysis_command

    mocker.patch.object(demisto, "params", return_value=DEFAULT_PARAMS)
    mocker.patch.object(CommonServerPython, "is_demisto_version_ge", return_value=True)
    params = demisto.params()
    client = Client(params=params)

    mock_analysis_response = {
        "data": {
            "attributes": {
                "status": "completed",
            }
        }
    }
    mock_item_response = {
        "data": {
            "attributes": {
                # File attributes
                "sha256": "random_sha256",
                "threat_severity": {
                    "threat_severity_level": "SEVERITY_LOW",
                    "threat_severity_data": {
                        "popular_threat_category": "random_category",
                    },
                },
                "threat_verdict": "VERDICT_UNDETECTED",
                # URL attributes
                "url": "random_url",
                "title": "random_title",
                "last_http_response_content_sha256": "random_content_sha256",
                "last_analysis_stats": {
                    "malicious": 1,
                    "undetected": 4,
                },
            }
        }
    }
    expected_response = mock_analysis_response.copy()
    expected_response["id"] = "random_id"
    expected_response["data"]["attributes"].update(
        {
            "sha256": "random_sha256",
            "threat_severity_level": "LOW",
            "popular_threat_category": "random_category",
            "threat_verdict": "UNDETECTED",
            "url": "random_url",
            "title": "random_title",
            "last_http_response_content_sha256": "random_content_sha256",
            "positives": "1/5",
        }
    )

    mocker.patch.object(demisto, "args", return_value={"id": "random_id"})
    requests_mock.get("https://www.virustotal.com/api/v3/private/analyses/random_id", json=mock_analysis_response)
    requests_mock.get("https://www.virustotal.com/api/v3/private/analyses/random_id/item", json=mock_item_response)

    results = private_get_analysis_command(client=client, args=demisto.args())

    assert results.execution_metrics is None
    assert results.outputs == expected_response


def test_url_scan_command(mocker, requests_mock):
    """
    Given:
    - A valid URL

    When:
    - Running the !url-scan command

    Then:
    - Validate the command results are valid
    """
    import CommonServerPython
    from GoogleThreatIntelligence import Client, scan_url_command

    mocker.patch.object(demisto, "params", return_value=DEFAULT_PARAMS)
    mocker.patch.object(CommonServerPython, "is_demisto_version_ge", return_value=True)
    params = demisto.params()
    client = Client(params=params)

    url = "https://www.example.com"
    mock_response = {
        "data": {
            "id": "random_id",
            "url": url,
        }
    }

    mocker.patch.object(demisto, "args", return_value={"url": url})
    requests_mock.post("https://www.virustotal.com/api/v3/urls", json=mock_response)

    results = scan_url_command(client=client, args=demisto.args())

    assert results.execution_metrics is None
    assert results.outputs == {
        "GoogleThreatIntelligence.Submission(val.id && val.id === obj.id)": mock_response["data"],
        "vtScanID": "random_id",
    }


def test_private_url_scan_command(mocker, requests_mock):
    """
    Given:
    - A valid URL

    When:
    - Running the !gti-privatescanning-url-scan command

    Then:
    - Validate the command results are valid
    """
    import CommonServerPython
    from GoogleThreatIntelligence import Client, private_scan_url_command

    mocker.patch.object(demisto, "params", return_value=DEFAULT_PARAMS)
    mocker.patch.object(CommonServerPython, "is_demisto_version_ge", return_value=True)
    params = demisto.params()
    client = Client(params=params)

    url = "https://www.example.com"
    mock_response = {
        "data": {
            "id": "random_id",
            "url": url,
        }
    }

    mocker.patch.object(demisto, "args", return_value={"url": url})
    requests_mock.post("https://www.virustotal.com/api/v3/private/urls", json=mock_response)

    results = private_scan_url_command(client=client, args=demisto.args())

    assert results.execution_metrics is None
    assert results.outputs == {
        "GoogleThreatIntelligence.Submission(val.id && val.id === obj.id)": mock_response["data"],
        "vtScanID": "random_id",
    }


def test_file_sigma_analysis_command(mocker, requests_mock):
    """
    Given:
    - A valid file hash

    When:
    - Running the !gti-file-sigma-analysis command

    Then:
    - Validate the command results are valid and contains metric data
    """
    import CommonServerPython
    from GoogleThreatIntelligence import Client, file_sigma_analysis_command

    file_hash = "0000000000000000000000000000000000000000000000000000000000000000"
    mocker.patch.object(demisto, "params", return_value=DEFAULT_PARAMS)
    mocker.patch.object(CommonServerPython, "is_demisto_version_ge", return_value=True)

    params = demisto.params()
    client = Client(params=params)

    mock_response = util_load_json("test_data/file.json")
    expected_results = util_load_json("test_data/file_extended_results.json")
    requests_mock.get(f"https://www.virustotal.com/api/v3/files/{file_hash}?relationships=", json=mock_response)

    for only_stats in [True, False]:
        mocker.patch.object(demisto, "args", return_value={"file": file_hash, "only_stats": only_stats})

        results = file_sigma_analysis_command(client=client, args=demisto.args())

        assert results.execution_metrics is None
        assert results.outputs == expected_results


def test_search_command(mocker, requests_mock):
    """
    Given:
    - A valid query

    When:
    - Running the !gti-search command

    Then:
    - Validate the command results are valid
    """
    import CommonServerPython
    from GoogleThreatIntelligence import Client, search_command

    mocker.patch.object(demisto, "params", return_value=DEFAULT_PARAMS)
    mocker.patch.object(CommonServerPython, "is_demisto_version_ge", return_value=True)
    params = demisto.params()
    client = Client(params=params)

    mock_response = {
        "data": [
            {
                "id": "random_id",
                "attributes": {},
            }
        ]
    }

    mocker.patch.object(demisto, "args", return_value={"query": "random", "limit": 2})
    requests_mock.get("https://www.virustotal.com/api/v3/search?query=random&limit=2", json=mock_response)

    results = search_command(client=client, args=demisto.args())

    assert results.execution_metrics is None
    assert results.outputs == mock_response["data"]


def test_get_upload_url(mocker, requests_mock):
    """
    Given:
    - A valid query

    When:
    - Running the !gti-file-scan-upload-url command

    Then:
    - Validate the command results are valid
    """
    import CommonServerPython
    from GoogleThreatIntelligence import Client, get_upload_url

    mocker.patch.object(demisto, "params", return_value=DEFAULT_PARAMS)
    mocker.patch.object(CommonServerPython, "is_demisto_version_ge", return_value=True)
    params = demisto.params()
    client = Client(params=params)

    mock_response = {
        "data": "https://www.upload_url.com",
    }

    requests_mock.get("https://www.virustotal.com/api/v3/files/upload_url", json=mock_response)

    results = get_upload_url(client=client)

    assert results.execution_metrics is None
    assert results.outputs == {
        "GoogleThreatIntelligence.FileUploadURL": "https://www.upload_url.com",
        "vtUploadURL": "https://www.upload_url.com",
    }


def test_gti_curated_collections_commands(mocker, requests_mock):
    """
    Given:
    - A valid IoC

    When:
    - Running the !gti-curated-campaigns-get command
    - Running the !gti-curated-malware-families-get command
    - Running the !gti-curated-threat-actors-get command

    Then:
    - Validate the command results are valid
    """
    import CommonServerPython
    from GoogleThreatIntelligence import (
        Client,
        get_curated_campaigns_command,
        get_curated_malware_families_command,
        get_curated_threat_actors_command,
    )

    data_json = {
        "data": [
            {
                "id": "collection-1",
                "attributes": {
                    "name": "Name 1",
                    "description": "Description 1",
                    "last_modification_date": 1718719985,
                    "targeted_regions_hierarchy": [
                        {"country_iso2": "UK"},
                        {"country_iso2": "FR"},
                    ],
                    "targeted_industries_tree": [
                        {"industry_group": "Industry 1"},
                        {"industry_group": "Industry 2"},
                    ],
                },
            },
            {
                "id": "collection-2",
                "attributes": {
                    "name": "Name 2",
                    "description": "Description 2",
                    "last_modification_date": 1718720000,
                    "targeted_regions_hierarchy": [
                        {"country_iso2": "FR"},
                    ],
                    "targeted_industries": [],
                },
            },
        ],
    }

    for func, collection_type in [
        (get_curated_campaigns_command, "campaign"),
        (get_curated_malware_families_command, "malware-family"),
        (get_curated_threat_actors_command, "threat-actor"),
    ]:
        for resource, resource_type, endpoint in [
            ("0000000000000000000000000000000000000000000000000000000000000000", "file", "files"),
            ("8.8.8.8", "ip", "ip_addresses"),
            ("www.example.com", "domain", "domains"),
            ("https://www.example.com", "url", "urls"),
        ]:
            mocker.patch.object(demisto, "args", return_value={"resource": resource, "resource_type": resource_type})
            mocker.patch.object(demisto, "params", return_value=DEFAULT_PARAMS)
            mocker.patch.object(CommonServerPython, "is_demisto_version_ge", return_value=True)

            # Assign arguments
            params = demisto.params()
            client = Client(params=params)

            # Load assertions and mocked request data
            endpoint_resource = encode_url_to_base64(resource) if resource_type == "url" else resource
            filter_query = "owner%3AMandiant%20"
            if collection_type == "malware-family":
                filter_query += "%28collection_type%3Amalware-family%20OR%20collection_type%3Asoftware-tookit%29"
            else:
                filter_query += f"collection_type%3A{collection_type}"
            args = f"filter={filter_query}&exclude_attributes=aggregations"
            requests_mock.get(
                f"https://www.virustotal.com/api/v3/{endpoint}/{endpoint_resource}/associations?{args}",
                json=data_json,
            )

            # Run command and collect result array
            results = func(client=client, args=demisto.args())

            assert results.execution_metrics is None
            assert results.outputs == {
                "id": resource,
                "collections": data_json["data"],
            }


def test_cve_command(mocker, requests_mock):
    """
    Given:
    - A valid CVE identifier (CVE-2022-30190)

    When:
    - Running the !cve command

    Then:
    - Validate the command results are valid and contains metric data
    """
    import CommonServerPython
    from GoogleThreatIntelligence import Client, ScoreCalculator, cve_command

    # Setup Mocks
    cve_id = "CVE-2022-30190"
    mocker.patch.object(demisto, "args", return_value={"cve": cve_id})
    mocker.patch.object(demisto, "params", return_value=DEFAULT_PARAMS)
    mocker.patch.object(CommonServerPython, "is_demisto_version_ge", return_value=True)

    # Assign arguments
    params = demisto.params()
    mocked_score_calculator = ScoreCalculator(params=params)
    client = Client(params=params)

    # Mock CVE API response with comprehensive data
    mock_response = util_load_json("test_data/cve.json")
    mock_output_response = util_load_json("test_data/cve_output_response.json")
    with open(os.path.join(os.path.dirname(os.path.realpath(__file__)), "test_data/cve_readable_output.md")) as f:
        cve_hr = f.read()

    requests_mock.get(f"https://www.virustotal.com/api/v3/collections/vulnerability--{cve_id.lower()}", json=mock_response)

    # Run command and collect result array
    results = cve_command(client=client, score_calculator=mocked_score_calculator, args=demisto.args())

    assert results[0].outputs == mock_output_response
    assert results[1].execution_metrics == [{"APICallsCount": 1, "Type": "Successful"}]
    assert results[0].execution_metrics is None
    assert results[0].readable_output == cve_hr
    assert results[0].raw_response == mock_response
    assert results[0].indicator.cvss == "7.8"
    assert results[0].outputs_prefix == "GoogleThreatIntelligence.CVE"
    assert isinstance(results[0].outputs, dict)
    assert results[0].indicator.id == cve_id
    assert results[0].indicator.dbot_score.indicator == cve_id
    assert results[0].indicator.dbot_score.indicator_type == "cve"
    assert results[0].indicator.dbot_score.integration_name == "GoogleThreatIntelligence"
    assert results[0].indicator.dbot_score.score == 2
    assert results[0].indicator.dbot_score.reliability == "A - Completely reliable"
    assert "google has provided the following description" in results[0].indicator.description
    assert results[0].indicator.published == "2022-05-27T00:00:00.000Z"

    # Validate CVE relationships (CVE to File MD5 hashes from sources)
    assert len(results[0].indicator.relationships) == 2

    # First relationship: CVE -> File (CISA MD5)
    assert results[0].indicator.relationships[0]._name == "related-to"
    assert results[0].indicator.relationships[0]._entity_a == cve_id
    assert results[0].indicator.relationships[0]._entity_a_type == "CVE"
    assert results[0].indicator.relationships[0]._entity_b == "test_md5_001"
    assert results[0].indicator.relationships[0]._entity_b_type == "File"
    assert results[0].indicator.relationships[0]._brand == "GoogleThreatIntelligence"

    # Second relationship: CVE -> File (Mitre MD5)
    assert results[0].indicator.relationships[1]._name == "related-to"
    assert results[0].indicator.relationships[1]._entity_a == cve_id
    assert results[0].indicator.relationships[1]._entity_a_type == "CVE"
    assert results[0].indicator.relationships[1]._entity_b == "test_md5_002"
    assert results[0].indicator.relationships[1]._entity_b_type == "File"
    assert results[0].indicator.relationships[1]._brand == "GoogleThreatIntelligence"


def test_invalid_cve_command(mocker):
    """
    Given:
    - An invalid CVE format (INVALID-CVE-FORMAT)

    When:
    - Running the !cve command

    Then:
    - Display warning message and return empty results if all CVEs are invalid
    """
    import CommonServerPython
    from GoogleThreatIntelligence import Client, ScoreCalculator, cve_command

    # Setup Mocks
    invalid_cve = "INVALID-CVE-FORMAT"
    mocker.patch.object(demisto, "args", return_value={"cve": invalid_cve})
    mocker.patch.object(demisto, "params", return_value=DEFAULT_PARAMS)
    mocker.patch.object(CommonServerPython, "is_demisto_version_ge", return_value=True)

    # Mock return_warning to capture the warning call
    mock_return_warning = mocker.patch("GoogleThreatIntelligence.return_warning")

    # Assign arguments
    params = demisto.params()
    mocked_score_calculator = ScoreCalculator(params=params)
    client = Client(params=params)

    # Execute command - no longer expecting exception
    cve_command(client=client, score_calculator=mocked_score_calculator, args=demisto.args())

    # Verify warning was called with correct message and exit=True (since all CVEs are invalid)
    mock_return_warning.assert_called_once_with("The following CVEs were found invalid: INVALID-CVE-FORMAT", exit=True)