All Products
Search
Document Center

Security Center:Threatbook component

Last Updated:Aug 25, 2026

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 System Configuration > Feature Settings > Multi-cloud Configuration Management 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:

  1. Click Add Authorization and select IDC. In the asset access panel, configure the following parameters:

    Note

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

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

Note

Save the sample data as a JSON file first.

Sample data

{
    "cells": [{
        "position": {
            "x": -400,
            "y": -155
        },
        "size": {
            "width": 36,
            "height": 36
        },
        "attrs": {
            "body": {
                "fill": "white",
                "strokeOpacity": 0.95,
                "stroke": "#63ba4d",
                "strokeWidth": 2
            },
            "label": {
                "text": "start",
                "fontSize": 12,
                "refX": 0.5,
                "refY": "100%",
                "refY2": 4,
                "textAnchor": "middle",
                "textVerticalAnchor": "top"
            },
            "path": {
                "stroke": "#63ba4d"
            }
        },
        "visible": true,
        "shape": "circle",
        "id": "58d87b7d-28d9-4f0e-b135-4adc4f1a70e4",
        "zIndex": 1,
        "data": {
            "nodeType": "startEvent",
            "appType": "basic",
            "nodeName": "start",
            "icon": "icon-circle",
            "description": "The start node of the playbook. A playbook must have one and only one start node. Configure input data for the playbook.",
            "cascaderValue": []
        },
        "markup": [{
            "tagName": "circle",
            "selector": "body"
        }, {
            "tagName": "text",
            "selector": "label"
        }],
        "isNode": true
    }, {
        "shape": "custom-edge",
        "attrs": {
            "line": {
                "stroke": "#63ba4d",
                "targetMarker": {
                    "stroke": "#63ba4d"
                }
            }
        },
        "zIndex": 1,
        "id": "5293c3f9-e1c9-4a49-b0eb-635067dc67e8",
        "data": {
            "nodeType": "sequenceFlow",
            "appType": "basic",
            "icon": "icon-upper-right-arrow",
            "isRequired": true
        },
        "isNode": false,
        "source": {
            "cell": "58d87b7d-28d9-4f0e-b135-4adc4f1a70e4"
        },
        "target": {
            "cell": "19fca1bc-4cf1-491e-9ae4-ee5d3f0c2f61"
        },
        "router": {
            "name": "normal"
        },
        "visible": true,
        "vertices": [{
            "x": -382,
            "y": -247
        }]
    }, {
        "position": {
            "x": 140,
            "y": -155
        },
        "size": {
            "width": 36,
            "height": 36
        },
        "attrs": {
            "body": {
                "fill": "white",
                "strokeOpacity": 0.95,
                "stroke": "#d93026",
                "strokeWidth": 2
            },
            "path": {
                "r": 12,
                "refX": "50%",
                "refY": "50%",
                "fill": "#d93026",
                "strokeOpacity": 0.95,
                "stroke": "#d93026",
                "strokeWidth": 4
            },
            "label": {
                "text": "end",
                "fontSize": 12,
                "refX": 0.5,
                "refY": "100%",
                "refY2": 4,
                "textAnchor": "middle",
                "textVerticalAnchor": "top"
            }
        },
        "visible": true,
        "shape": "circle",
        "id": "317dd1be-2d20-460e-977e-1fc936ffb583",
        "zIndex": 1,
        "data": {
            "nodeType": "endEvent",
            "appType": "basic",
            "nodeName": "end",
            "icon": "icon-radio-off-full",
            "description": "end"
        },
        "markup": [{
            "tagName": "circle",
            "selector": "body"
        }, {
            "tagName": "circle",
            "selector": "path"
        }, {
            "tagName": "text",
            "selector": "label"
        }],
        "isNode": true
    }, {
        "position": {
            "x": -190,
            "y": -280
        },
        "size": {
            "width": 137,
            "height": 66
        },
        "view": "react-shape-view",
        "attrs": {
            "label": {
                "text": "file_report"
            }
        },
        "shape": "activity",
        "id": "19fca1bc-4cf1-491e-9ae4-ee5d3f0c2f61",
        "zIndex": 1,
        "data": {
            "isDebug": false,
            "nodeType": "action",
            "appType": "component",
            "nodeName": "file_report",
            "valueData": {
                "userId": "",
                "resource": "${event.file}",
                "cloudUserId": "7f7cd2ebedc544f7bf9be74dab7fcca4"
            },
            "icon": "https://sophon-gen-cloud-zhangjiakou-v2.oss-cn-zhangjiakou.aliyuncs.com/componentUpload/1755245577536_Threatbook_logo.svg",
            "description": "Retrieve detailed static and dynamic analysis reports for a file, including file summary, network behavior, behavioral signatures, static information, dropped file behavior, process behavior, and antivirus scan engine detection results.",
            "advance": {
                "inputParamMode": false,
                "onError": "stop_cur_flow",
                "rspStatusType": 3,
                "rspStatusThreshold": 0
            },
            "componentName": "Threatbook",
            "actionName": "fileReport",
            "cascaderValue": [{
                "label": "configuration",
                "value": "${configuration}",
                "children": [{
                    "label": "configuration.datalist.*.triggerType",
                    "name": "configuration.datalist.*.triggerType",
                    "value": "${configuration.datalist.*.triggerType}"
                }, {
                    "label": "configuration.datalist.*._req_uuid",
                    "name": "configuration.datalist.*._req_uuid",
                    "value": "${configuration.datalist.*._req_uuid}"
                }]
            }],
            "status": "success"
        },
        "isNode": true
    }, {
        "position": {
            "x": -190,
            "y": -170
        },
        "size": {
            "width": 137,
            "height": 66
        },
        "view": "react-shape-view",
        "attrs": {
            "label": {
                "text": "ioc_report"
            }
        },
        "shape": "activity",
        "id": "e0082b2e-d82c-464f-a22f-9b67eb47a363",
        "zIndex": 1,
        "data": {
            "isDebug": false,
            "nodeType": "action",
            "appType": "component",
            "nodeName": "ioc_report",
            "valueData": {
                "cloudUserId": "7f7cd2ebedc544f7bf9be74dab7fcca4",
                "resource": "${event.ioc}"
            },
            "icon": "https://sophon-gen-cloud-zhangjiakou-v2.oss-cn-zhangjiakou.aliyuncs.com/componentUpload/1755245577536_Threatbook_logo.svg",
            "description": "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.",
            "advance": {
                "inputParamMode": false,
                "onError": "stop_cur_flow",
                "rspStatusType": 3,
                "rspStatusThreshold": 0
            },
            "componentName": "Threatbook",
            "actionName": "iocReport",
            "status": "failed"
        },
        "isNode": true
    }, {
        "position": {
            "x": -190,
            "y": -55
        },
        "size": {
            "width": 137,
            "height": 66
        },
        "view": "react-shape-view",
        "attrs": {
            "label": {
                "text": "ip_reputation"
            }
        },
        "shape": "activity",
        "id": "8afdafcc-32aa-4ab2-b8b2-abafc4314e85",
        "zIndex": 1,
        "data": {
            "nodeType": "action",
            "appType": "component",
            "nodeName": "ip_reputation",
            "valueData": {
                "cloudUserId": "7f7cd2ebedc544f7bf9be74dab7fcca4",
                "resource": "${event.ip}"
            },
            "icon": "https://sophon-gen-cloud-zhangjiakou-v2.oss-cn-zhangjiakou.aliyuncs.com/componentUpload/1755245577536_Threatbook_logo.svg",
            "description": "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.",
            "advance": {
                "inputParamMode": false,
                "onError": "stop_cur_flow",
                "rspStatusType": 3,
                "rspStatusThreshold": 0
            },
            "componentName": "Threatbook",
            "actionName": "ipReputation",
            "status": "failed"
        },
        "isNode": true
    }, {
        "shape": "custom-edge",
        "attrs": {
            "line": {
                "stroke": "#d93026",
                "targetMarker": {
                    "stroke": "#d93026"
                }
            }
        },
        "zIndex": 1,
        "id": "ae6ca05c-ebd1-41f1-a94d-489fdc308861",
        "data": {
            "nodeType": "sequenceFlow",
            "appType": "basic"
        },
        "router": {
            "name": "manhattan",
            "args": {
                "padding": 5,
                "excludeHiddenNodes": true,
                "excludeNodes": ["clone_node_id"]
            }
        },
        "source": {
            "cell": "58d87b7d-28d9-4f0e-b135-4adc4f1a70e4"
        },
        "visible": true,
        "target": {
            "cell": "e0082b2e-d82c-464f-a22f-9b67eb47a363"
        }
    }, {
        "shape": "custom-edge",
        "attrs": {
            "line": {
                "stroke": "#d93026",
                "targetMarker": {
                    "stroke": "#d93026"
                }
            }
        },
        "zIndex": 1,
        "id": "8f084c6d-9afd-4ecb-8c9d-3c7824f9de2f",
        "data": {
            "nodeType": "sequenceFlow",
            "appType": "basic"
        },
        "router": {
            "name": "normal"
        },
        "source": {
            "cell": "58d87b7d-28d9-4f0e-b135-4adc4f1a70e4"
        },
        "visible": true,
        "target": {
            "cell": "8afdafcc-32aa-4ab2-b8b2-abafc4314e85"
        },
        "vertices": [{
            "x": -382,
            "y": -22
        }]
    }, {
        "shape": "custom-edge",
        "attrs": {
            "line": {
                "stroke": "#63ba4d",
                "targetMarker": {
                    "stroke": "#63ba4d"
                }
            }
        },
        "zIndex": 1,
        "id": "e55e80d8-fab6-42ac-91ab-da7697ec80dd",
        "data": {
            "nodeType": "sequenceFlow",
            "appType": "basic"
        },
        "router": {
            "name": "normal"
        },
        "source": {
            "cell": "19fca1bc-4cf1-491e-9ae4-ee5d3f0c2f61"
        },
        "visible": true,
        "target": {
            "cell": "317dd1be-2d20-460e-977e-1fc936ffb583"
        },
        "vertices": [{
            "x": 158,
            "y": -247
        }]
    }, {
        "shape": "custom-edge",
        "attrs": {
            "line": {
                "stroke": "#d93026",
                "targetMarker": {
                    "stroke": "#d93026"
                }
            }
        },
        "zIndex": 1,
        "id": "ba2021dc-533b-4ba3-a1a7-69f05f3c7515",
        "data": {
            "nodeType": "sequenceFlow",
            "appType": "basic"
        },
        "router": {
            "name": "manhattan",
            "args": {
                "padding": 5,
                "excludeHiddenNodes": true,
                "excludeNodes": ["clone_node_id"]
            }
        },
        "source": {
            "cell": "8afdafcc-32aa-4ab2-b8b2-abafc4314e85"
        },
        "visible": true,
        "target": {
            "cell": "317dd1be-2d20-460e-977e-1fc936ffb583"
        }
    }, {
        "shape": "custom-edge",
        "attrs": {
            "line": {
                "stroke": "#d93026",
                "targetMarker": {
                    "stroke": "#d93026"
                }
            }
        },
        "zIndex": 1,
        "id": "c3c22836-585a-4f5e-a3ec-92ecedfad6ba",
        "data": {
            "nodeType": "sequenceFlow",
            "appType": "basic"
        },
        "router": {
            "name": "manhattan",
            "args": {
                "padding": 5,
                "excludeHiddenNodes": true,
                "excludeNodes": ["clone_node_id"]
            }
        },
        "source": {
            "cell": "e0082b2e-d82c-464f-a22f-9b67eb47a363"
        },
        "visible": true,
        "target": {
            "cell": "317dd1be-2d20-460e-977e-1fc936ffb583"
        }
    }]
}

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.

Note

For the ThreatBook API reference, see File Reputation Report.

Input parameters

Parameter

Description

Example

userId

The associated Alibaba Cloud account ID.

Important
  • You can specify a member account ID managed by the current Alibaba Cloud account. For instructions on adding member accounts, see Multi-account security management.

  • If left blank, the current Alibaba Cloud account is used.

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:

  • result: detection result for each scan engine:

    No threat detected: displayed as safe.

    Threat detected: displays the specific virus label.

  • scan_time: the time the multi-engine scan was performed, for example 2019-10-22 16:17:48.

summary

Summary information. A JSON object with the following fields:

  • threat_level: threat level, a comprehensive assessment based on static analysis, multi-engine antivirus scans, and multi-sandbox dynamic analysis.

    • malicious: malicious

    • suspicious: suspicious

    • clean: safe

    • unknown: unknown

  • malware_type: threat classification. For the complete list, see Threat classification.

  • malware_family: virus family, such as Xorddos.

  • is_whitelist: whether the file is on the whitelist.

    • true = whitelisted.

    • false = not whitelisted.

  • submit_time: file submission time, for example 2019-01-22 17:36:21.

  • file_name: file name.

  • file_type: file type.

  • sample_sha256: file SHA256 hash.

  • md5: file MD5 hash.

  • sha1: file SHA1 hash.

  • scenes: scenario detection.

    • Cybercrime: cybercrime sample.

    • CS_Detect: CobaltStrike trojan sample.

    • RT_Tools: red team tool.

    • Exploit: vulnerability exploit.

    • HW202X: major security event sample, year varies.

  • tag: tags. A JSON object containing:

    • s: static tags. JSON array. For common tags, .

    • x: antivirus engine detection tags.

  • threat_score: numerical threat score.

  • sandbox_type: the sandbox environment used for this analysis.

  • sandbox_type_list: list of all sandbox environments where the sample was successfully analyzed.

  • multi_engines: antivirus scan engine detection rate.

signature

Behavioral signatures. A JSON array. Each item contains:

  • severity: severity level (integer, higher = more severe).

  • references: references (JSON array).

  • sig_class: signature classification.

  • name: signature name.

  • description: behavior description.

  • markcount: mark count.

  • marks: raw signature data (JSON array).

  • families: sample families (JSON array).

  • attck_id: ATT&CK ID.

  • attck_info: ATT&CK details (JSON array).

static

Static information. A JSON object.

pstree

Process behavior.

network

Network behavior.

  • fingerprint: fingerprint information (JSON array).

  • tls: TLS protocol (JSON array).

  • udp: UDP protocol (JSON array).

  • dns_servers: DNS service (JSON array).

  • http: HTTP protocol (JSON array).

  • irc: IRC protocol (JSON array).

  • smtp: SMTP protocol (JSON array).

  • tcp: TCP protocol (JSON array).

  • smtp_ex: extended SMTP protocol data (JSON array).

  • mitm: man-in-the-middle (JSON array).

  • hosts: network hosts (JSON array).

  • dns: Domain Name System (JSON array).

  • http_ex: extended HTTP protocol data (JSON array).

  • domains: domain names (JSON array).

  • dead_hosts: dead hosts (JSON array).

  • icmp: ICMP protocol (JSON array).

  • https_ex: extended HTTPS protocol data (JSON array).

dropped

Dropped file behavior. A JSON array. Each item contains:

  • sha1: file SHA1 hash (string).

  • sha256: file SHA256 hash (string).

  • md5: file MD5 hash (string).

  • urls: extracted URLs (JSON array).

  • size: file size (integer).

  • filepath: file path (string).

  • name: file name (string).

  • crc32: file CRC32 hash (string).

  • ssdeep: file SSDeep hash (string).

  • type: file type (string).

  • yara: YARA results (JSON array).

strings

String-related information. A JSON object. Each item contains:

  • sha256: strings extracted from the file, corresponding to static strings based on the SHA256 hash (array).

  • pcap: strings extracted from network traffic (array).

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.

Note

For the ThreatBook API reference, see ThreatBook Cloud API.

Input parameters

Parameter

Description

Example

userId

The associated Alibaba Cloud account ID.

Important
  • You can specify a member account ID managed by the current Alibaba Cloud account. For instructions on adding member accounts, see Multi-account security management.

  • If left blank, the current Alibaba Cloud account is used.

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.

  • true = malicious.

  • false = not malicious.

confidence_level

Confidence level.

  • high

  • medium

  • low

severity

Comprehensive threat severity.

  • critical

  • high

  • medium

  • low

  • info (no threat)

judgments

Threat type based on the IOC's malicious attributes:

  • Malicious types:

    • C2 (remote control)

    • Sinkhole C2 (C2 server sinkholed by a security organization)

    • MiningPool (miner pool)

    • CoinMiner (private miner pool)

    • Malware

  • Non-malicious types:

    • Whitelist

    • Info (basic information)

tags_classes

Related threat actor or security event information. A JSON array. Each item contains:

  • tags_type: tag category, such as industry, gangs (threat actor group), or virus_family.

  • tags: specific threat actor or security event tags, such as APT or OceanLotus.

permalink

Intelligence details link. URL of the complete threat intelligence analysis page for the IP address or domain name.

domain

categories

  • Domain name categorization. A JSON object. Each item contains:

    • first_cats: level 1 category (array)

    • second_cats: level 2 category (string)

  • Other fields are the same as described for ip above.

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.

Note

For the ThreatBook API reference, see ThreatBook Cloud API.

Input parameters

Parameter

Description

Example

userId

The associated Alibaba Cloud account ID.

Important
  • You can specify a member account ID managed by the current Alibaba Cloud account. For instructions on adding member accounts, see Multi-account security management.

  • If left blank, the current Alibaba Cloud account is used.

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:

  • carrier: carrier or service provider.

  • location: IP location information (JSON object):

    • country: country

    • country_code: country code

    • province: province

    • city: city

    • lng: longitude

    • lat: latitude

is_malicious

Whether the IP is malicious.

  • true = malicious.

  • false = not malicious.

confidence_level

Confidence level determined by intelligence source and confidence model.

  • low

  • medium

  • high

severity

Threat severity indicating the danger level of the intelligence.

  • critical

  • high

  • medium

  • low

  • info (no threat)

judgments

Comprehensive threat type extracted from threat intelligence analysis (JSON array).

  • Malicious types:

    • Spam

    • Zombie (compromised computer)

    • Scanner

    • Exploit (vulnerability exploit)

    • Botnet

    • Brute Force (brute-force attack)

  • Non-malicious types:

    • Whitelist

    • Info (basic information)

tags_classes

Related threat actor or security event information. A JSON array. Each item contains:

  • tags_type: tag category, such as industry, gangs (threat actor group), or virus_family.

  • tags: specific threat actor or security event tags, such as Mirai.

asn

ASN information. A JSON object containing:

  • number: ASN number.

  • info: AS name.

  • rank: risk value (0 to 4, higher = higher risk).

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:

  • category: classification.

  • tag_name: specific asset feature tag.

  • tag_desc: tag description.

entity

Attributed entity. A JSON array. Each item contains:

  • category: level 1 classification.

  • type: level 2 classification.

  • tag_name: specific entity tag.

  • tag_desc: tag description.

hist_behavior

Attack behavior history. A JSON array. Each item contains:

  • category: classification.

  • tag_name: specific attack behavior tag.

  • tag_desc: tag description.

  • vuln_id: specific vulnerability ID when category is "Vulnerability Exploit".

evaluation

Impact assessment. A JSON object containing:

  • active: activity level.

    • high

    • medium

    • low

  • honeypot_hit: whether captured by a honeypot.

    • true = captured by a honeypot.

    • false = not captured.

fraud

Fraudulent behavior. A JSON array. Each item contains:

  • tag_name: specific fraud behavior tag.

  • tag_desc: tag description.

permalink

URL of the intelligence query result page for the IP address.