The Threatbook component calls ThreatBook APIs to retrieve file analysis reports and assess threats from IP addresses and domain names. Use this component in Agentic SOC playbooks to automate threat intelligence lookups during security investigations.
Prerequisites
To use the Threatbook component, go to and complete IDC off-cloud asset authorization in the Multi-cloud Assets module. Skip this step if you have already completed IDC off-cloud asset authorization for ThreatBook. Configuration steps:
-
Click Add Authorization and select IDC. In the asset access panel, configure the following parameters:
NoteThreatBook is authorized for Agentic SOC by default. Other features are not supported.
Configuration item
Description
Vendor
ThreatBook.
Product
Threat Intelligence Cloud API.
Account ID
ThreatBook account ID.
API KEY
ThreatBook API KEY.
-
Configuration strategy: To prevent AccessKey invalidation from affecting your business, we recommend that you enable AK Service Status Check.
Supported actions
|
Action |
Description |
|
fileReport |
Retrieve detailed static and dynamic analysis reports for a file. Reports include file summary, network behavior, behavioral signatures, static information, dropped file behavior, process behavior, and antivirus scan engine detection results. |
|
iocReport |
Analyze IP addresses or domain names in outbound traffic scenarios such as office networks or production environments. Determine whether an IP address or domain name is malicious, assess risk severity and confidence level, identify C2 servers, malware, and miner pool threats, and return related security event or threat actor tags. |
|
ipReport |
Analyze inbound IP addresses. Provide geographic location and ASN information. Determine whether an IP address is malicious, assess risk severity and confidence level, and identify threat types such as vulnerability exploits and zombies, along with related security event or threat actor tags. |
Configuration example
This section provides a sample playbook that demonstrates all three Threatbook actions. You can import the sample to review and test each action's configuration parameters in the visual workflow editor. For instructions, see Import a playbook.
Save the sample data as a JSON file first.
fileReport
Retrieve detailed static and dynamic analysis reports for a file. Reports include file summary, network behavior, behavioral signatures, static information, dropped file behavior, process behavior, and antivirus scan engine detection results.
For the ThreatBook API reference, see File Reputation Report.
Input parameters
|
Parameter |
Description |
Example |
|
userId |
The associated Alibaba Cloud account ID. Important
|
XXX |
|
cloudUserId |
The ThreatBook account ID. For details, see Prerequisites. |
7f7c*************7fcca4 |
|
resource |
The file hash for retrieving the analysis report. Supported algorithms: SHA256, SHA1, MD5. |
44d88612*************1278abb02f |
Output parameters
|
Parameter |
Description |
|
multiengines |
Antivirus scan engine detection results. A JSON object with the following fields:
|
|
summary |
Summary information. A JSON object with the following fields:
|
|
signature |
Behavioral signatures. A JSON array. Each item contains:
|
|
static |
Static information. A JSON object. |
|
pstree |
Process behavior. |
|
network |
Network behavior.
|
|
dropped |
Dropped file behavior. A JSON array. Each item contains:
|
|
strings |
String-related information. A JSON object. Each item contains:
|
|
permalink |
URL of the web sandbox report page. |
iocReport
Analyze IP addresses or domain names in outbound traffic scenarios such as office networks or production environments. Determine whether an IP address or domain name is malicious, assess risk severity and confidence level, identify C2 servers, malware, and miner pool threats, and return related security event or threat actor tags.
For the ThreatBook API reference, see ThreatBook Cloud API.
Input parameters
|
Parameter |
Description |
Example |
|
userId |
The associated Alibaba Cloud account ID. Important
|
XXX |
|
cloudUserId |
The ThreatBook account ID. For details, see Prerequisites. |
7f7c*************7fcca4 |
|
resource |
An IP address or domain name. Query up to 100 resources per batch, separated by commas. Note
Include the port with an IP address for higher-confidence results. |
test.com or 0.0.0.0:80 |
Output parameters
|
Type |
Parameter |
Description |
|
ip |
is_malicious |
Whether the IP is malicious.
|
|
confidence_level |
Confidence level.
|
|
|
severity |
Comprehensive threat severity.
|
|
|
judgments |
Threat type based on the IOC's malicious attributes:
|
|
|
tags_classes |
Related threat actor or security event information. A JSON array. Each item contains:
|
|
|
permalink |
Intelligence details link. URL of the complete threat intelligence analysis page for the IP address or domain name. |
|
|
domain |
categories |
|
ipReport
Analyze inbound IP addresses. Provide geographic location and ASN information. Determine whether an IP address is malicious, assess risk severity and confidence level, and identify threat types such as vulnerability exploits and zombies, along with related security event or threat actor tags.
For the ThreatBook API reference, see ThreatBook Cloud API.
Input parameters
|
Parameter |
Description |
Example |
|
userId |
The associated Alibaba Cloud account ID. Important
|
XXX |
|
cloudUserId |
The ThreatBook account ID. For details, see Prerequisites. |
7f7c*************7fcca4 |
|
resource |
An IP address. Query up to 100 IP addresses per batch, separated by commas. |
0.0.0.0 |
Output parameters
|
Parameter |
Description |
|
basic |
A JSON object with the following fields:
|
|
is_malicious |
Whether the IP is malicious.
|
|
confidence_level |
Confidence level determined by intelligence source and confidence model.
|
|
severity |
Threat severity indicating the danger level of the intelligence.
|
|
judgments |
Comprehensive threat type extracted from threat intelligence analysis (JSON array).
|
|
tags_classes |
Related threat actor or security event information. A JSON array. Each item contains:
|
|
asn |
ASN information. A JSON object containing:
|
|
update_time |
Last update time of the intelligence. |
|
scene |
Application scenario, such as leased line or data center. |
|
feature |
Asset features. A JSON array. Each item contains:
|
|
entity |
Attributed entity. A JSON array. Each item contains:
|
|
hist_behavior |
Attack behavior history. A JSON array. Each item contains:
|
|
evaluation |
Impact assessment. A JSON object containing:
|
|
fraud |
Fraudulent behavior. A JSON array. Each item contains:
|
|
permalink |
URL of the intelligence query result page for the IP address. |