流监测对外服务与对接平台交互接口设计_v7全解.docVIP

流监测对外服务与对接平台交互接口设计 概述 流监测系统对外提供流量监测服务以及拒绝服务攻击追溯服务，由于核心服务器部署在安全内网，需要通过对接平台提供相应的服务功能。 系统整体呈现三个部分： 客户：使用本系统的服务，接收流量报表，提交拒绝服务攻击追溯请求及接收查询结果。 服务层：流监测系统，负责对外提供具体服务 对接平台：负责将客户的请求转发给流监测系统，并将流监测系统的结果转发给客户。 接口形式 客户需首先通过对接平台向服务层提交注册申请，注册通过后才能进行后续服务交互，每个客户都具有唯一的UUID作为其标识。服务层和客户的接口都采用文件形式，所有该客户有关的文件名中都有该UUID标志，对接平台需控制只有授权用户才能访问自己的数据文件，以免客户数据文件泄漏或者被非授权篡改。关于客户身份验证方式，请参见3.1客户注册部分内容。 业务文件内容结构 客户注册 新客户需要首先提交注册申请，只有注册成功、获得审批的客户，才能提交查询服务和获取下发的数据。 客户提交注册的资料用于流监测系统内部审核使用，通过审核后。该客户可以通过对接平台向流监测系统发送历史流量查询请求和DDOS攻击定位请求，以及接收日常报表。 注册文件命名格式为:reg_uuid_datetime.json.ok，例如：reg_018c2998-9bd0-11e3-bab6-00e04c0b916_20141212153200.json.ok ================================================================= 客户注册提交json文件中包含： 客户名称（customer_name）， 客户UUID(customer_uuid)， 客户IP(customer_ip)， 客户密码(customer_password)， 客户申请业务(task_type)， 客户查询IP范围（ip_searchrange。如客户：某政务网站，该网站IP为-00，该客户可以根据自身网站的IP范围提交查询的IP范围，等待工作人员审批。审批后提交的任务查询IP范围只能在该范围内）。 范例如下： [ { customer_name:某政务网站, customer_uuid:018c2998-9bd0-11e3-bab6-00e04c0b9160, customer_password:x3ad3241 customer_ip:33, task_type:flowsearch, ddostask, report, #分为三类，flowsearch为流量查询业务，ddostask为DDOS定位业务，report为日常报表 ip_searchrange:-00, } ] 注册申请文件放于reg/up/目录中，审批通过后，应答文件放于reg/down/目录中，文件格式与请求文件相同。 ================================================================= 应答文件内包含审批过后的审核日志和客户ID等信息，文件内容为 [ { task_status” :”success” “task_log”:”task_finished” customer_name:某政务网站, customer_uuid:018c2998-9bd0-11e3-bab6-00e04c0b9160, customer_ip:33, } ] 新增一行注册状态task_status 值为success ,failed。详细原因会在task_log中给出。 文件内容为 [ { task_status” :”failed” “task_log”:”客户申请业务的IP地址范围超出许可范围” customer_name:某政务网站, customer_uuid:018c2998-9bd0-11e3-bab6-00e04c0b9160, customer_ip:33, } ] 客户注销与业务变更 客户的注销由流监测服务层发起，会在reg/down/下输出文件，名为, reg-customerdelete_018c2998-9bd0-11e3-bab6-00e04c0b916_20141212153200.json.ok [ { customer_uuid:018c2998-9bd0-11e3-bab6-00e04c0b9160, } ] 客户的业务变更由客户发起，在reg/up/下输出文件，请求与应答文件的内容与注册相同，文件类型为reg-change，例如： reg-change_018c2998-9bd0-11e3-bab6-00e04c0b916_20141212153200.js