SDK使用流程

SDK使用流程分为四个步骤：获取授权、数据升级、数据查询、授权激活。

获取授权

联网联网

调用获取授权的接口GetAuth(sn) *C.char。其中，sn为用户设备的唯一标识，不可重复。返回结果见下文授权接口返回示例，其中lid、sn、apikey和salt用于数据升级使用。expire_time为授权的过期时间，type包含授权的数据包类型。注：调用GetAuth接口的授权为测试授权，仅供测试使用。授权接口返回结果示例：

{
    "errno": 2000,
    "msg": "success",
    "result": {
        "expire_time": 1661270399,
        "apikey": "c4c8b7b1d83b828397b752dd12bae8e1",
        "salt": "82e849203ff785a3545601ea2c29059c",
        "sn": "LUBEI-TIP-SDK-01",
        "lid": "28999C92-D752-55EF-8716-159758C58F5E",
        "is_first_create": true,
        "type": [
            "ioc",
            "ip_reputation",
            "ip_intelligence_v3"
        ]
    }
}

离线场景

调用获取设备ID接口GetDeviceId(sn)*C.char。传入用户设备唯一标识，将返回结果中的device_id发送邮件给情报云对接同事，获取关联设备的证书文件。后续通过离线升级[证书文件]方式升级情报。设备ID接口返回结果示例：

{
    "errno": 2000,
    "msg": "success",
    "result": {
        "device_id": "*******"
    }
}
 

数据升级

在线升级

针对SDK部署环境可以联网的情况下使用。调用在线升级接口OnLineUpgrade(lid, sn, key, salt string,pkgSize int) *C.char将数据升级到本地。

使用建议：数据包的更新时间为小时级别。在线升级建议在每小时的第25分钟调用一次。升级函数不能同时调用多次。多个全量包升级时间不超过15分钟，增量包升级时间大约1-2分钟。

离线升级

针对SDK部署环境不能联网的情况下使用。

需要登录https://update.ti.360.net/，使用证书编号（lid）认证。

下载对应的数据包到服务器指定路径。失陷检测数据包用于域名、URL、IP+PORT格式查询。IP情报包用于IP格式查询。

调用离线升级接口OffLineUpgrade(data_path,lid,sn,salt string,pkgSize int)将数据包升级到本地。下图为离线升级需要下载的数据包。

使用建议：离线环境下至少需要每天下载最新的全量包进行离线升级，以保证数据的精准。

查询使用

情报数据升级完成后，可对情报进行查询。查询接口为QueryIOC (query string) *C.char以及QueryIP(query string)*C.char以及GetReputationList（）*C.char。

激活授权

调用激活授权接口GetAuthActive(sn string) 后，测试授权即更新为正式授权，正式授权会更新授权的有效期。