sangfor_SIP_深信服自定义协议接入接口文档.pdfVIP

深信服科技股份有限公司版权所有 深信服安全感知第三方日志接入使用说明 修订记录 修订版本号 作者 日期 简要说明 v1.0 李晓东 2018-02-05 新增全部接口 V2.0 李晓东 2019-05-22 优化认证接口等、添加接口数据实例 深信服科技股份有限公司版权所有 1.概述 该接口主要用于对接第三方厂商（如IBM、交换机、绿盟等），第三方厂商作为探针， 把对接的安全日志审计日志统一上报到深信服安全感知平台，通过深信服安全感知平台进 行日志统一管理安全关联分析； 2.索引 0. 接口约定于说明 1. 登陆认证（/api/v1/device/login） 2. 安全事件描述更新（/api/v1/device/update） 3. 安全事件（/api/v1/device/secevent） 4. Netflow （/api/v1/device/netflow） 5. Dnsflow （/api/v1/device/dnsflow） 6. 心跳（/api/v1/device/heartbeat） 3.接口约定于说明 （）以 协议的方式调用，所有请求都以 方式提交，以 的数据格式返回，请 1 HTTPS Post json 求和相应都是用utf-8编码。 （）上报数据前，先进行登陆认证，获取 ，第一次接入时，需要管理员在感知平台设 2 token 备管理处允许设备的接入。 有效时间为 分钟，失效前需要通过心跳接口来获取新 token 10 的token。 （）数据上报以下面的格式为准，一次请求可以包含多条数据。 3 { token:..., data_list:[ { ... }, ... ] } -交互流程图： 深信服科技股份有限公司版权所有 注意：传输安全事件前，必须保证安全事件对应的描述信息已经通过update接口将安全事 件描述信息传输到安全感知平台，其中安全事件和描述信息通过event_id对应。所以对于安 全事件的使用： 首先调用4.2安全事件描述更新（/api/v1/device/update） 接口更新安全事件描述； 然后在调用4.3安全事件（/api/v1/device/secevent）接口同步安全事件； 4. 接口定义 4.1.登陆认证（/api/v1/device/login） 请求参数列表 变量名 含义 类型 备注 dev_name 设备名称 string(256) dev_type 设备类型 string(256) { dev_name:总部出口设备, dev_type:SANGFORAF } 响应参数列表 变量名 含义 类型 备注 state 状态 number 认证成功返回200 token token string(256) 深信服科技股份有限公司版权所有 msg 错误信息 string(256) expires token有效时间