威胁情报云查与本地引擎 快速入门

·威胁情报云查接口（API）：腾讯云提供的云端威胁情报查询服务，支持域名、IP、URL、文件Hash 等多维度 IOC 实时查询。

·本地引擎集成服务（SDK）：腾讯云提供的本地情报查询集成服务，支持域名、IP、URL、文件Hash 等多维度 IOC 本地化快速查询。

一、开通获取授权

通过 威胁情报云查与本地引擎申请页面 联系威胁情报产品团队获取授权。授权通过后，团队将会提供：

·API 接入所需的 AppID/AppKey

·SDK 接入授权证书

·SDK 开发套件

二、API 接入测试

API 基于 RESTful 协议，简单易用，支持跨平台和跨语言调用。采用 HTTP/HTTPS 协议，支持 TCP/IP 的设备或语言（如 Java、Python、Go、JavaScript 及移动端等）均可快速集成到第三方平台。

你可以使用 HTTP 客户端工具快速访问 API，并将情报查询场景下的各类 API 快速集成到本地项目。以下是通过 HTTP 客户端工具构造 HTTPS 请求的示例：

注意：说明：

注意：API 查询场景与接口 JSON 返回结构及服务响应码对照参考 腾讯云安全_威胁情报中心。

三、环境要求

确认本地依赖环境满足以下条件：

四、C 语言集成示例

安装与本地环境匹配的腾讯云威胁情报本地引擎 SDK。以下以 C 语言为例说明 SDK 的安装和使用方法：

1. 联系威胁情报产品团队获取对应架构的 SDK 集成套件压缩包。

2. 将压缩包解压至项目合适位置。

3. 解压后的目录结构可参考示例。

五、获取设备指纹和证书信息

#include <dlfcn.h>#include <stdio.h>#include <stdlib.h> int main(void){ void *h = dlopen("./libtisdk.so", RTLD_LAZY); if (!h) { fprintf(stderr, "%s\\n", dlerror()); return 1; } /* 1. 取指纹 */ char *(*fp)(void) = (char *(*)(void))dlsym(h, "TI_GetDeviceFingerprint"); if (!fp) { fprintf(stderr, "%s\\n", dlerror()); dlclose(h); return 1; } char *f = fp(); if (!f) { puts("GetDeviceFingerprint failed"); dlclose(h); return 1; } printf("DeviceFingerprint: %s\\n", f); free(f); /* 2. 取许可证信息 */ char *(*lic)(const char *) = (char *(*)(const char *))dlsym(h, "TI_GetLicenseInfo"); if (!lic) { fprintf(stderr, "%s\\n", dlerror()); dlclose(h); return 1; } const char *licPath = "./license.lic"; /* 换成你的实际路径 */ char *info = lic(licPath); if (!info) { puts("GetLicenseInfo failed"); dlclose(h); return 1; } printf("LicenseInfo: %s\\n", info); free(info); dlclose(h); return 0;} # 编译（动态链接 dl）gcc main.c -ldl -o prepare # 运行./prepare # 输出DeviceFingerprint: 7zMG0okHgAzbb2CMaos+Jbkpdz8IuSzbL8MmBq++M=LicenseInfo: {"ThreatPackageType":"IOC","AppKey":"xxxxxxx","ExpireTime":"2026-05-01"}

六、云端激活

wget –content-disposition \\"https://eti.qq.com/sdk/authorize/activationCode?appkey=<AppKey>&equip_id=<DeviceFingerprint>&expire_time=<ExpireTime>"

注意：说明：

注意：激活码文件响应类型 Content-Type: application/octet-stream

七、配置 SDK

# config.yamlapp_name: SDK # SDKversion: v2.8.1 # SDK 版本号file_path: # SDK加载数据位置 db_path: "/data/ti_sdk/db/" # 存放激活码文件位置,云端激活获取的激活码文件 authorize_file_path: "/data/ti_sdk/authorize/"

八、准备离线情报数据包

以失陷类型情报数据包举例。

wget –content-disposition \\'https://eti.qq.com/sdk/package/download?appkey=<AppKey>&package_type=1'

九、测试启动 SDK

进入 SDK 集成套件，解压后进入 test 子目录进行测试。

cd test && make && ./ti_sdk_test ../license/PcMgrLicense.qcer ../conf/config.yaml ./IOC_sdk_20250410_1649590412_v1.0.dat./checklist.txt