Skip to main content

Google Threat Intelligence

Google Threat Intelligence integrates with the VirusTotal platform to synchronize real-time vulnerability threat data and Attack Surface Management (ASM) findings and entity assets into the Brinqa Platform. You can bring CVE records, vulnerability findings, violation findings, alert findings, and 27 types of ASM entity assets from Google Threat Intelligence into Brinqa to gain a unified view of your attack surface, thus strengthening your cybersecurity posture.

This document details the information you must provide for the connector to authenticate with Google Threat Intelligence and how to obtain that information from Google. See create a data integration for step-by-step instructions on setting up the integration.

Required connection settings

When setting up a data integration, select Google Threat Intelligence from the Connector dropdown. If you cannot find the connector in the dropdown, make sure that you have installed it first. You must provide the following information to authenticate Google Threat Intelligence with Brinqa:

  • URL: The Google Threat Intelligence API URL. The default URL is https://www.virustotal.com.

  • API Key: The API key for authenticating with the VirusTotal / Google Threat Intelligence API.

Obtain the API key from Google Threat Intelligence

The connector authenticates using an API key provided by VirusTotal / Google Threat Intelligence. All API requests include the API key as a custom header:

X-APIKEY: <your-api-key>

To obtain the API key, log in to your VirusTotal account and navigate to your profile settings to find or generate your API key.

Additional settings

The Google Threat Intelligence connector contains additional options for specific configuration:

  • Page size: The maximum number of records to get per API request. The default setting is 1000. It is not recommended to go over 1000.

  • Maximum retries: The maximum number of times that the integration attempts to connect to the Google Threat Intelligence API before giving up and reporting a failure. The default setting is 5.

Types of data to retrieve

The Google Threat Intelligence connector can retrieve the following types of data from the VirusTotal API:

Table 1: Data retrieved from Google Threat Intelligence

CategoryConnector ObjectRequiredMaps to Data Model
Alert ManagementAlertYesAlert
Alert DefinitionYesAlert Definition
ASM Entity AssetsApi EndpointNoAPI Endpoint
App EndpointNoSite
Autonomous SystemNoCloud Resource
Aws EC2 InstanceNoHost
Aws Rds Db InstanceNoHost
Aws S3 BucketNoCloud Resource
Azure Storage AccountNoCloud Resource
Azure Virtual MachineNoHost
Dns RecordNoSite
DomainNoSite
Email AddressNoPerson
GCP API GatewayNoCloud Resource
GCP App Engine ApplicationNoCloud Resource
GCP Cloud FunctionNoCloud Resource
GCP Cloud SQL InstanceNoHost
GCP Compute Engine InstanceNoHost
GCP Storage BucketNoCloud Resource
Github AccountNoCloud Resource
Github RepositoryNoCode Project
Ip AddressNoHost
NameserverNoSite
Net BlockNoIP Range
Network ServiceNoHost
Ssl CertificateNoSite Certificate
Unique KeywordNoCloud Resource
Unique TokenNoCloud Resource
UriNoSite
Compliance MonitoringViolationYesViolation
Violation DefinitionYesViolation Definition
Vulnerability IntelligenceCveRecordYesCVE Record
Vulnerability ManagementVulnerabilityYesVulnerability
Vulnerability DefinitionYesVulnerability Definition

This diagram shows how Alert, Violation, and Vulnerability connector objects relate to their definitions, CVE Records, and the ASM entity assets they are found in.

Figure 1: Connector object relationships

info

For detailed steps on how to view the data retrieved from Google Threat Intelligence in the Brinqa Platform, see How to view your data.

Attribute mappings

Expand the sections below to view the mappings between the source and the Brinqa data model attributes.

Alert Management

Alert

Table 2: Alert attribute mappings

Source FieldAttribute Name
issue.summary.categoryCATEGORIES
Current timestampLAST_CAPTURED
issue.pretty_name (fallback: issue.uid)NAME
issue.summary.status_newPROVIDER_STATUS
issue.descriptionRESULTS
issue.first_seenSOURCE_CREATED_DATE
issue.last_seenSOURCE_LAST_MODIFIED
normalizeFindingStatus(issue.summary.status_new)SOURCE_STATUS
issue.tagsTAGS
issue.entity_nameTARGET_NAME
issue.entity_typeTARGET_TYPE
issue.entity_uidTARGETS
issue.pretty_name (fallback: issue.name, issue.uid)TYPE
issue.uidUID
Alert Definition

Table 3: Alert Definition attribute mappings

Source FieldAttribute Name
issue.summary.categoryCATEGORIES
issue.summary.confidenceCONFIDENCE
issue.descriptionDESCRIPTION
Current timestampLAST_CAPTURED
issue.pretty_nameNAME
issue.descriptionRECOMMENDATION
normalizeFindingSeverity(issue.summary.severity)SEVERITY
getFindingSeverityScore(normalizedSeverity)SEVERITY_SCORE
issue.summary.severitySOURCE_SEVERITY
issue.tagsTAGS
issue.pretty_name (fallback: issue.name, issue.uid)UID

ASM Entity Assets

Common Asset Attributes

The following attributes are shared across all 27 ASM entity asset connector objects.

Table 4: Common asset attribute mappings

Source FieldAttribute Name
entity.alias_groupALIAS_GROUP
entity.summary.geolocation.cityCITY
entity.summary.technology.cloud_providersCLOUD_PROVIDER
entity.collectionCOLLECTION_NAME
entity.summary.geolocation.country_codeCOUNTRY_CODE
entity.typeENTITY_TYPE
entity.exfil_lookup_identifierEXFIL_LOOKUP_IDENTIFIER
entity.first_seenFIRST_SEEN
Current timestampLAST_CAPTURED
entity.last_seenLAST_SEEN
entity.summary.geolocation.latitudeLATITUDE
entity.summary.geolocation.country_nameLOCATION
entity.summary.geolocation.longitudeLONGITUDE
entity.name (fallback: entity.uid)NAME
entity.summary.network.asnNETWORK_ASN
entity.summary.network.nameNETWORK_NAME
entity.summary.network.routeNETWORK_ROUTE
entity.summary.network.typeNETWORK_TYPE
entity.summary.resolutionsRESOLUTIONS
entity.summary.scopedSCOPED
entity.seedSEED
Hardcoded ACTIVESTATUS
entity.tagsTAGS
entity.summary.ports.tcpTCP_PORTS
entity.summary.technology.technologiesTECHNOLOGIES
entity.summary.ports.udpUDP_PORTS
entity.uidUID
Api Endpoint

Includes all Common Asset Attributes plus:

Table 5: Api Endpoint attribute mappings

Source FieldAttribute Name
ASSET_CATEGORY_API_ENDPOINTCATEGORIES
Extracted from entity.nameDNS_NAMES
Extracted from entity.nameHOSTNAMES
Extracted from entity.nameIP_ADDRESSES
Extracted from entity.namePRIVATE_DNS_NAMES
Extracted from entity.namePRIVATE_IP_ADDRESSES
Extracted from entity.namePUBLIC_DNS_NAMES
Extracted from entity.namePUBLIC_IP_ADDRESSES
App Endpoint

Includes all Common Asset Attributes plus:

Table 6: App Endpoint attribute mappings

Source FieldAttribute Name
ASSET_CATEGORY_API_ENDPOINTCATEGORIES
Extracted from entity.nameDNS_NAMES
Extracted from entity.nameHOSTNAMES
Extracted from entity.nameIP_ADDRESSES
Extracted from entity.namePRIVATE_DNS_NAMES
Extracted from entity.namePRIVATE_IP_ADDRESSES
Extracted from entity.namePUBLIC_DNS_NAMES
Extracted from entity.namePUBLIC_IP_ADDRESSES
Autonomous System

Includes all Common Asset Attributes plus:

Table 7: Autonomous System attribute mappings

Source FieldAttribute Name
ASSET_CATEGORY_CLOUD_RESOURCECATEGORIES
Aws EC2 Instance

Includes all Common Asset Attributes plus:

Table 8: Aws EC2 Instance attribute mappings

Source FieldAttribute Name
ASSET_CATEGORY_HOSTCATEGORIES
Extracted from entity.nameDNS_NAMES
Extracted from entity.nameHOSTNAMES
Extracted from entity.nameIP_ADDRESSES
Extracted from entity.namePRIVATE_DNS_NAMES
Extracted from entity.namePRIVATE_IP_ADDRESSES
Extracted from entity.namePUBLIC_DNS_NAMES
Extracted from entity.namePUBLIC_IP_ADDRESSES
Aws Rds Db Instance

Includes all Common Asset Attributes plus:

Table 9: Aws Rds Db Instance attribute mappings

Source FieldAttribute Name
ASSET_CATEGORY_HOSTCATEGORIES
Extracted from entity.nameDNS_NAMES
Extracted from entity.nameHOSTNAMES
Extracted from entity.nameIP_ADDRESSES
Extracted from entity.namePRIVATE_DNS_NAMES
Extracted from entity.namePRIVATE_IP_ADDRESSES
Extracted from entity.namePUBLIC_DNS_NAMES
Extracted from entity.namePUBLIC_IP_ADDRESSES
Aws S3 Bucket

Includes all Common Asset Attributes plus:

Table 10: Aws S3 Bucket attribute mappings

Source FieldAttribute Name
ASSET_CATEGORY_CLOUD_RESOURCECATEGORIES
Azure Storage Account

Includes all Common Asset Attributes plus:

Table 11: Azure Storage Account attribute mappings

Source FieldAttribute Name
ASSET_CATEGORY_CLOUD_RESOURCECATEGORIES
Azure Virtual Machine

Includes all Common Asset Attributes plus:

Table 12: Azure Virtual Machine attribute mappings

Source FieldAttribute Name
ASSET_CATEGORY_HOSTCATEGORIES
Dns Record

Includes all Common Asset Attributes plus:

Table 13: Dns Record attribute mappings

Source FieldAttribute Name
ASSET_CATEGORY_WEB_APPLICATIONCATEGORIES
Domain

Includes all Common Asset Attributes plus:

Table 14: Domain attribute mappings

Source FieldAttribute Name
ASSET_CATEGORY_WEB_APPLICATIONCATEGORIES
Extracted from entity.nameDNS_NAMES
Extracted from entity.nameHOSTNAMES
Extracted from entity.nameIP_ADDRESSES
Extracted from entity.namePRIVATE_DNS_NAMES
Extracted from entity.namePRIVATE_IP_ADDRESSES
Extracted from entity.namePUBLIC_DNS_NAMES
Extracted from entity.namePUBLIC_IP_ADDRESSES
Email Address

Includes all Common Asset Attributes plus:

Table 15: Email Address attribute mappings

Source FieldAttribute Name
ASSET_CATEGORY_PERSONCATEGORIES
GCP API Gateway

Includes all Common Asset Attributes plus:

Table 16: GCP API Gateway attribute mappings

Source FieldAttribute Name
ASSET_CATEGORY_CLOUD_RESOURCECATEGORIES
GCP App Engine Application

Includes all Common Asset Attributes plus:

Table 17: GCP App Engine Application attribute mappings

Source FieldAttribute Name
ASSET_CATEGORY_CLOUD_RESOURCECATEGORIES
GCP Cloud Function

Includes all Common Asset Attributes plus:

Table 18: GCP Cloud Function attribute mappings

Source FieldAttribute Name
ASSET_CATEGORY_CLOUD_RESOURCECATEGORIES
GCP Cloud SQL Instance

Includes all Common Asset Attributes plus:

Table 19: GCP Cloud SQL Instance attribute mappings

Source FieldAttribute Name
ASSET_CATEGORY_HOSTCATEGORIES
GCP Compute Engine Instance

Includes all Common Asset Attributes plus:

Table 20: GCP Compute Engine Instance attribute mappings

Source FieldAttribute Name
ASSET_CATEGORY_HOSTCATEGORIES
GCP Storage Bucket

Includes all Common Asset Attributes plus:

Table 21: GCP Storage Bucket attribute mappings

Source FieldAttribute Name
ASSET_CATEGORY_CLOUD_RESOURCECATEGORIES
Github Account

Includes all Common Asset Attributes plus:

Table 22: Github Account attribute mappings

Source FieldAttribute Name
ASSET_CATEGORY_CLOUD_RESOURCECATEGORIES
Github Repository

Includes all Common Asset Attributes plus:

Table 23: Github Repository attribute mappings

Source FieldAttribute Name
ASSET_CATEGORY_CODE_REPOSITORYCATEGORIES
Ip Address

Includes all Common Asset Attributes plus:

Table 24: Ip Address attribute mappings

Source FieldAttribute Name
ASSET_CATEGORY_HOSTCATEGORIES
Extracted from entity.nameDNS_NAMES
Extracted from entity.nameHOSTNAMES
Extracted from entity.nameIP_ADDRESSES
Extracted from entity.namePRIVATE_DNS_NAMES
Extracted from entity.namePRIVATE_IP_ADDRESSES
Extracted from entity.namePUBLIC_DNS_NAMES
Extracted from entity.namePUBLIC_IP_ADDRESSES
Nameserver

Includes all Common Asset Attributes plus:

Table 25: Nameserver attribute mappings

Source FieldAttribute Name
ASSET_CATEGORY_WEB_APPLICATIONCATEGORIES
Net Block

Includes all Common Asset Attributes plus:

Table 26: Net Block attribute mappings

Source FieldAttribute Name
ASSET_CATEGORY_NETWORKCATEGORIES
Network Service

Includes all Common Asset Attributes plus:

Table 27: Network Service attribute mappings

Source FieldAttribute Name
ASSET_CATEGORY_HOSTCATEGORIES
Extracted from entity.nameDNS_NAMES
Extracted from entity.nameHOSTNAMES
Extracted from entity.nameIP_ADDRESSES
Extracted from entity.namePRIVATE_DNS_NAMES
Extracted from entity.namePRIVATE_IP_ADDRESSES
Extracted from entity.namePUBLIC_DNS_NAMES
Extracted from entity.namePUBLIC_IP_ADDRESSES
Ssl Certificate

Includes all Common Asset Attributes plus:

Table 28: Ssl Certificate attribute mappings

Source FieldAttribute Name
ASSET_CATEGORY_CERTIFICATECATEGORIES
Unique Keyword

Includes all Common Asset Attributes plus:

Table 29: Unique Keyword attribute mappings

Source FieldAttribute Name
ASSET_CATEGORY_CLOUD_RESOURCECATEGORIES
Unique Token

Includes all Common Asset Attributes plus:

Table 30: Unique Token attribute mappings

Source FieldAttribute Name
ASSET_CATEGORY_CLOUD_RESOURCECATEGORIES
Uri

Includes all Common Asset Attributes plus:

Table 31: Uri attribute mappings

Source FieldAttribute Name
ASSET_CATEGORY_WEB_APPLICATIONCATEGORIES
Extracted from entity.nameDNS_NAMES
Extracted from entity.nameHOSTNAMES
Extracted from entity.nameIP_ADDRESSES
Extracted from entity.namePRIVATE_DNS_NAMES
Extracted from entity.namePRIVATE_IP_ADDRESSES
Extracted from entity.namePUBLIC_DNS_NAMES
Extracted from entity.namePUBLIC_IP_ADDRESSES

Compliance Monitoring

Violation

Table 32: Violation attribute mappings

Source FieldAttribute Name
issue.summary.categoryCATEGORIES
issue.first_seenFIRST_FOUND
Current timestampLAST_CAPTURED
issue.last_seenLAST_FOUND
issue.pretty_name (fallback: issue.uid)NAME
issue.summary.status_newPROVIDER_STATUS
issue.descriptionRESULTS
normalizeFindingStatus(issue.summary.status_new)SOURCE_STATUS
issue.tagsTAGS
issue.entity_nameTARGET_NAME
issue.entity_typeTARGET_TYPE
issue.entity_uidTARGETS
issue.pretty_name (fallback: issue.name, issue.uid)TYPE
issue.uidUID
Violation Definition

Table 33: Violation Definition attribute mappings

Source FieldAttribute Name
issue.summary.categoryCATEGORIES
issue.summary.confidenceCONFIDENCE
issue.descriptionDESCRIPTION
Current timestampLAST_CAPTURED
issue.pretty_nameNAME
issue.descriptionRECOMMENDATION
normalizeFindingSeverity(issue.summary.severity)SEVERITY
getFindingSeverityScore(normalizedSeverity)SEVERITY_SCORE
issue.summary.severitySOURCE_SEVERITY
issue.tagsTAGS
issue.pretty_name (fallback: issue.name, issue.uid)UID

Vulnerability Intelligence

CveRecord

Table 34: CveRecord attribute mappings

Source FieldAttribute Name
attributes.available_mitigationAVAILABLE_MITIGATIONS
attributes.collection_typeCATEGORIES
attributes.cisa_known_exploited.added_dateCISA_ADDED_DATE
attributes.cisa_known_exploited.due_dateCISA_DUE_DATE
attributes.cvss.cvssV2.base_scoreCVSS_V2_BASE_SCORE
attributes.cvss.cvssV2.temporal_scoreCVSS_V2_TEMPORAL_SCORE
attributes.cvss.cvssV2.vectorCVSS_V2_VECTOR
attributes.cvss.cvssV3.base_scoreCVSS_V3_BASE_SCORE
attributes.cvss.cvssV3.temporal_scoreCVSS_V3_TEMPORAL_SCORE
attributes.cvss.cvssV3.vectorCVSS_V3_VECTOR
attributes.cvss.cvssV4.base_scoreCVSS_V4_BASE_SCORE
attributes.cvss.cvssV4.vectorCVSS_V4_VECTOR
attributes.cwe.idCWE_IDS
attributes.descriptionDESCRIPTION
attributes.date_of_disclosureDISCLOSED_DATE
attributes.epss.percentileEPSS_PERCENTILE
attributes.epss.scoreEPSS_SCORE
attributes.executive_summaryEXECUTIVE_SUMMARY
attributes.exploit_availabilityEXPLOIT_AVAILABILITY
attributes.exploitation.exploit_release_dateEXPLOIT_RELEASE_DATE
attributes.cvss.cvssV4.threat.exploit_maturityEXPLOIT_MATURITY
attributes.exploitation_consequenceEXPLOITATION_CONSEQUENCE
attributes.exploitation_stateEXPLOITATION_STATE
attributes.exploitation_vectorsEXPLOITATION_VECTORS
attributes.exploitation.first_exploitationFIRST_EXPLOITATION
Current timestampLAST_CAPTURED
attributes.mve_idMVE_ID
attributes.cve_id (fallback: data.id)NAME
attributes.priorityPRIORITY
attributes.cisa_known_exploited.ransomware_useRANSOMWARE_USE
attributes.sources[].urlREFERENCES
attributes.risk_factorsRISK_FACTORS
normalizeFindingSeverity(attributes.risk_rating)SEVERITY
getFindingSeverityScore(normalizedSeverity)SEVERITY_SCORE
attributes.creation_dateSOURCE_CREATED_DATE
attributes.last_modification_dateSOURCE_LAST_MODIFIED
attributes.risk_ratingSOURCE_RISK_RATING
attributes.risk_ratingSOURCE_SEVERITY
attributes.tagsTAGS
attributes.exploitation.tech_details_release_dateTECH_DETAILS_RELEASE_DATE
data.idUID
attributes.cwe.idWEAKNESSES

Vulnerability Management

Vulnerability

Table 35: Vulnerability attribute mappings

Source FieldAttribute Name
issue.alias_groupALIAS_GROUP
issue.summary.categoryCATEGORIES
issue.collectionCOLLECTION_NAME
issue.descriptionDESCRIPTION
issue.dynamic_idDYNAMIC_ID
issue.first_seenFIRST_FOUND
Current timestampLAST_CAPTURED
issue.last_seenLAST_FOUND
issue.pretty_name (fallback: issue.name, issue.uid)NAME
issue.summary.status_newPROVIDER_STATUS
issue.descriptionRESULTS
issue.summary.severitySOURCE_RISK_RATING
normalizeFindingStatus(issue.summary.status_new)SOURCE_STATUS
issue.entity_nameTARGET_NAME
issue.entity_typeTARGET_TYPE
issue.entity_uidTARGETS
issue.pretty_name (fallback: issue.name, issue.uid)TYPE
issue.uidUID
Vulnerability Definition

Table 36: Vulnerability Definition attribute mappings

Source FieldAttribute Name
issue.summary.categoryCATEGORIES
issue.summary.confidenceCONFIDENCE
issue.summary.identifiers[].name (filtered by type == "CVE")CVE_IDS
issue.summary.identifiers[].name (filtered by type == "CVE")CVE_RECORDS
issue.descriptionDESCRIPTION
Current timestampLAST_CAPTURED
issue.pretty_nameNAME
issue.descriptionRECOMMENDATION
normalizeFindingSeverity(issue.summary.severity)SEVERITY
getFindingSeverityScore(normalizedSeverity)SEVERITY_SCORE
issue.summary.severitySOURCE_SEVERITY
issue.tagsTAGS
issue.pretty_name (fallback: issue.name, issue.uid)UID

APIs

The Google Threat Intelligence connector uses the VirusTotal API v3. Specifically, it uses the following endpoints:

Table 37: Google Threat Intelligence API Endpoints

Connector ObjectAPI Endpoint
Alert / Alert DefinitionGET {baseUrl}/api/v3/asm/search/issues/severity_gte:1
All ASM Entity AssetsGET {baseUrl}/api/v3/asm/search/entities/type:{EntityType} scoped:true hidden:false
CveRecordGET {baseUrl}/api/v3/collections?filter=collection_type:vulnerability
Violation / Violation DefinitionGET {baseUrl}/api/v3/asm/search/issues/severity_gte:1
Vulnerability / Vulnerability DefinitionGET {baseUrl}/api/v3/asm/search/issues/severity_gte:1

Changelog

The Google Threat Intelligence connector has undergone the following changes:

note

This connector is part of a bundled release with other connectors from the same vendor. If a version shows "No change", it means that the connector version was updated for consistency as part of the bundle, but no functional changes were made to this specific connector. You can update to or skip this version without affecting your existing configuration.

Table 38: Google Threat Intelligence Changelog

VersionDescriptionDate Published
3.2.16Resolved a dependency conflict with Jackson annotations that caused sync failures.April 30th, 2026
3.2.13Initial Integration+ release.April 10th, 2026