目次 1 背景与范围背景说明适用范围术语和定义客户交易终端交易软件直连模式中继代理模式 AppID/RelayAppID 授权

Size: px

Start display at page:

Download "目次 1 背景与范围背景说明适用范围术语和定义客户交易终端交易软件直连模式中继代理模式 AppID/RelayAppID 授权"

亶易
5 years ago
Views:

1 期货公司客户交易终端信息采集及接入认证技术规范 2018 年 9 月中国期货市场监控中心发布

2 目次 1 背景与范围背景说明适用范围术语和定义客户交易终端交易软件直连模式中继代理模式 AppID/RelayAppID 授权码交易软件厂商 ID 信息采集及接入认证概述信息采集及接入认证流程信息采集概述接入认证概述信息采集采集指标术语解释采集指标采集方法信息报送信息安全要求接入认证认证方法认证流程附录 A ( 规范性附录 ) A.1 加密密钥申请流程 A.2 信息处理示例附录 B ( 参考性附录 ) B.1 采集流程示例 B.2 认证流程示例 B.3 信息采集函数参考... 28

3 1 背景与范围 1.1 背景说明根据关于加强证券期货经营机构客户交易终端信息等客户信息管理的规定 ( 证监会公告 [2013]30 号 ) 的有关要求, 为进一步加强期货市场看穿式监管要求, 指导期货公司按要求规范其客户交易终端信息的采集记录存储和报送等工作, 制订本技术规范本技术规范将对期货公司客户交易终端信息的采集范围采集标准和采集内容做出统一规定, 以进一步促进交易终端信息规范化管理 1.2 适用范围本规范旨在明确各业务场景下需要采集的客户交易终端信息内容, 限定客户交易终端信息的采集范围, 统一客户交易终端信息记录与存储的格式要求, 针对客户交易终端信息的采集记录和存储过程给出明确的技术要求本规范的适用条件为通过期货公司入场交易的客户适用范围包括客户交易终端的信息采集交易终端与期货公司之间的信息通讯期货公司内部的数据记录及期货公司与中国期货市场监控中心 ( 以下简称监控中心 ) 系统之间的信息通讯 2 术语和定义 2.1 客户交易终端客户交易终端是指客户下达交易指令的终端设备其中, 交易指令包括账户登录交易委托银期转账和密码修改等 2.2 交易软件本规范所称交易软件, 是指能够接收处理和转发客户交易指令到期货交易所 ( 以下简称交易所 ) 的软件, 不包括客户交易终端软件 2.3 直连模式客户交易终端软件与期货公司交易软件直接通讯, 进行交易的模式 2.4 中继代理模式客户交易终端软件与期货公司交易软件间接通讯, 进行交易的模式本规范将客户交易终端软件和期货公司交易软件之间的通讯组件称为期货公司中继代理 ( 以下简称中继代理 ) 2.5 AppID/RelayAppID AppID 是客户交易终端软件的唯一标识码, 由终端软件商按照规范要求编制,AppID 由终端厂商名称终端软件名称和版本号三部分构成 RelayAppID 是中继代理软件的唯一标识码, 由中继代理软件商按照规范要求编制,RelayAppID 由中继厂商名称中继软件名称和版本号三部分构成 1

4 2.6 授权码授权码由期货公司依据终端软件商或中继代理软件商提交的 AppID 或 RelayAppID 生成派发, 用于 AppID 或 RelayAppID 的合法性校验 2.7 交易软件厂商 ID 交易软件厂商 ID 是交易软件商的唯一标识, 由交易软件商向监控中心申请加密密钥时同步获取 3 信息采集及接入认证概述 3.1 信息采集及接入认证流程图 3-1 信息采集及接入认证流程图 3.2 信息采集概述 a) 监控中心为每家交易软件商产生一对单独的非对称密钥, 解密密钥由监控中心保存, 加密密钥公开给交易软件商, 集成在动态链接库中 b) 交易软件商开发动态链接库, 提供给终端软件商使用由动态链接库主动采集客户交易终端信息并加密 c) 终端软件登录时采集信息, 并将信息密文即时报送给期货公司交易软件 d) 交易软件在终端软件接入时补充获取其交易软件厂商 ID 公网 IP 登入时间和客户内部资金账户等, 逐条填充至相应终端上报的信息数据中, 汇总上报至结算软件 e) 结算软件将信息密文报送给监控中心 f) 监控中心系统解密密文 3.3 接入认证概述 a) 期货公司组织对终端软件的接入认证, 审查其软件功能, 测试评估其是否已集成符合监管要求的信息采集动态链接库, 是否能够准确采集客户终端信息对于符合上述要求的终端软件, 在交易软件中, 配置其 AppID 和授权码, 开通准入权限 b) 客户使用交易终端软件登录时, 携带交易终端软件的 AppID 和授权码, 期货公司交易软件进行验证 2

5 4 信息采集 4.1 采集指标术语解释名词解释即互联网通讯协议地址 (Internet Protocol Address), 是指根据互 IP 地址联网协议为访问互联网的每台主机分配的一个逻辑地址根据 IP 协议的不同版本, 地址可分为 IPV4 和 IPV6 端口包括物理端口和逻辑端口物理端口是用于连接物理设备之间的端口号接口, 逻辑端口是逻辑上用于区分服务的端口本规范所指端口号为逻辑端口号即媒介访问控制地址 (Medium/Media Access Control), 是指网络接 MAC 地址口的物理地址, 或称为硬件地址在 OSI 模型和 TCP/IP 协议栈中,MAC 地址分别对应于数据链路层和网络接口层, 用于在该层进行信息转发设备名是指客户对终端设备自定义的名字管理和控制计算机硬件与软件资源的计算机程序, 是直接运行在裸操作系统版本机上的最基本的系统软件, 任何其他软件都必须在操作系统的支持下才能运行本文所述的操作系统版本, 特指发行版本即中央处理器 (Central Processing Unit) 序列号, 简称 CPUID, 包含 CPU 序列号该 CPU 的版本主频外频二级缓冲等关键信息是指 PC 终端设备硬盘设备的编码, 是用于标识硬盘产品信息的唯一识硬盘序列号别码, 一般包含生产地和生产日期等信息, 不同厂商的硬盘产品具有不同的编码方法 BIOS 序列号本规范所指 BIOS 序列号, 是指计算机的 BIOS 芯片里的序列号分区信息 (PartitionInformation), 是指对硬盘进行分区或格式化处理后产生的与分区相关的信息, 包括盘符分区序列号分区格式分区信息分区容量等参数其中, 分区序列号是指分区时自动生成的分区标识信息, 由一串十六进制字符组成, 常见的分区格式有 FAT FAT32 NTFS 等是指设备的唯一标识 PC 端是指 MAC OS 系统的终端设备序列号, 移动设备序列号端是指移动终端的序列号网络运营商是进行网络运营和提供服务的实体网络运营商不仅需要网络运营商从网络角度知道网络运行状况, 还需要从服务角度知道网络运行状况设备类型本规范所指移动终端设备类型, 是指 pad, pod, phone 等地理位置信息以经纬度为度量标准的绝对地理位置信息即通用唯一识别码 (UniversallyUnique Identifier), 是指广泛应用 UUID 在分布式计算环境中用来标识存储设备的编码, 由一串十六进制字符串组成即国际移动设备识别码 (International Mobile Equipment IMEI Identity), 是区别移动设备的标志 GSM 和 WCDMA 手机终端使用该码即移动设备识别码 (Mobile Equipment Identifier), 是 CDMA 手机的身 MEID 份识别码, 也是每台 CDMA 手机或通讯平板唯一的识别码是区别移动用户的标志, 储存在 SIM 卡中, 可用于区别移动用户的有效 IMSI 信息 3

6 ICCID 微信 OpenID 异常标识用户类型操作员 ICCID 为 IC 卡的唯一识别号码, 共有 20 位数字组成, 其编码格式为 : XXXXXX 0MFSS YYGXX XXXX 是指微信用户在微信公众号中的唯一识别码, 通过微信 OpenID 可查询到客户的姓名昵称头像性别城市等信息本规范中是指信息采集和获取的过程中, 出现可识别异常后, 按编码规则要求填写的错误代码本规范中是指区分下单客户身份类型的标识在期货公司交易软件内, 为若干具备交易编码的客户代理下单的角色 4.2 采集指标终端采集指标在信息采集过程中, 按照客户交易终端信息的重要程度及技术可行性, 针对于不同的平台, 设定了不同的采集内容, 所有内容均需要采集客户交易终端设备按照类型可分为 PC 终端移动终端和其他终端 a) PC 终端分为 Windows Linux Mac OS 等操作系统版本 b) 移动终端分为 ios Android 等操作系统版本 c) 其他终端分为微信线下委托等 PC 端采集指标 PC 终端包括 PC 应用程序和浏览器, 其中浏览器需要通过必要的技术手段保证终端信息的采集, 如加载经过认证的插件等各种操作系统需要采集的内容如下表 : 操作系统 Windows Linux Mac OS 信息采集时间信息采集时间信息采集时间私网 IP 私网 IP 私网 IP 网卡 MAC 地址网卡 MAC 地址网卡 MAC 地址设备名设备名设备名采集指标操作系统版本操作系统版本操作系统版本硬盘序列号硬盘序列号硬盘序列号 CPU 序列号 CPU 序列号设备序列号 BIOS 序列号 BIOS 序列号系统盘分区信息移动终端采集指标移动终端包括移动应用程序和浏览器, 其中浏览器需要通过必要的技术手段保证终端信息的采集, 如加载经过认证的插件等各种操作系统需要采集的内容如下表 : 操作系统 ios Android 采集指标信息采集时间移动终端 IP 地理位置信息操作系统版本信息采集时间移动终端 IP 地理位置信息操作系统版本 4

7 设备名设备类型网络运营商通用唯一识别码 (UUID) 设备名设备类型国际移动设备识别码 (IMEI) 移动设备识别码 (MEID) 设备 MAC 地址手机号码设备序列号国际移动用户识别码 (IMSI) IC 卡的唯一识别号码 (ICCID) 其他终端采集指标其他业务类型需要采集的内容如下表 : 业务类型线下委托微信委托采集指标补充说明信息采集时间 ( 线下委托时间 ) 电话号码 ( 客户电话号码 ) 通过电话邮件 QQ 及各类通讯工具在线下传达下单通知的, 需要采集客户的电话号码信息采集时间 OpenID 地理位置信息无补充获取指标直连模式获取指标获取位置获取指标交易软件交易软件厂商 ID( 从交易软件获取 ) 加密密钥版本 ( 从终端获取 ) 异常标识 ( 从终端获取, 可本地重置 ) AppID( 从终端获取 ) 客户交易终端公网 IP( 从交易软件获取 ) 客户交易终端公网端口号 ( 从交易软件获取 ) 客户交易终端登入时间 ( 从交易软件获取 ) 客户内部资金账户 ( 从交易软件获取 ) 用户类型 ( 从交易软件获取 ) 中继代理模式获取指标 a) 中继代理获取位置获取指标中继代理加密密钥版本 ( 从终端获取, 转发 ) 异常标识 ( 从终端获取, 可本地重置 ) AppID( 从终端获取, 转发 ) 客户交易终端公网 IP( 从中继代理获取, 转发 ) 客户交易终端公网端口号 ( 从中继代理获取, 转发 ) 客户交易终端登入时间 ( 从中继代理获取, 转发 ) 5

8 b) 交易软件获取位置获取指标交易软件交易软件厂商 ID( 从交易软件获取 ) 加密密钥版本 ( 中继代理获取 ) 异常标识 ( 从中继代理获取, 可本地重置 ) AppID( 从中继代理获取 ) 客户交易终端公网 IP( 从中继代理获取 ) 客户交易终端公网端口号 ( 从中继代理获取 ) 客户交易终端登入时间 ( 从中继代理获取 ) RelayAppID( 从中继获取 ) 中继代理公网 IP( 从交易软件获取, 获取交易软件下一级中继 ) 中继代理公网端口号 ( 从交易软件获取, 获取交易软件下一级中继 ) 中继代理登入时间 ( 从交易软件获取, 获取交易软件下一级中继 ) 客户内部资金账户 ( 从交易软件获取 ) 用户类型 ( 从交易软件获取 ) 类型信息编码 a) 在终端信息字符串中, 终端类型编码约定如下表所示 : 终端类型终端类型编码 Windows 终端 1 Linux 终端 2 Mac OS 终端 3 移动 ios 终端 4 移动 Android 终端 5 线下委托终端 6 微信终端 7 b) 在操作员为客户下单的模式中, 补充获取信息中用户类型填写为操作员, 用户类型编码约定如下表所示 : 用户类型用户类型编码客户 1 操作员 2 c) 在终端信息字符串中, 异常标识编码约定如下表所示 : 异常标识类型异常标识编码正常 0 终端信息采集为空 1 终端采集数据加密密钥版本异常 2 终端信息数据异常采集指标格式终端设备名称等超长信息, 其长度大于限定字节数时, 按照要求截取字符串前 N 个字节为信息字符串终端信息字符串中各个指标信息最大长度 ( 单位 : 字节 ) 说明如下 : 6

9 终端类型最大长度 1 信息示例 1 信息采集时间最大长度 19 信息示例 :00:00( 统一为东八区时间 ) IP 地址最大长度 39 信息示例信息示例 CDCD:910A:2222:5498:8475:1111:0010: PC 终端信息中的私网 IP 地址默认获取 2 个, 应首选采集处于激活状态的网卡信息 2. 补充获取时, 对于没有公网 IP 的, 采集其专线 IP 3. IP 地址处理要求 IPV4 地址以点分十进制表示 x.x.x.x 的形特殊说明式记录 IPV6 地址以冒号分十六进制表示为 n: n: n: n: n: n: n: n 的形式记录,n 表示四个十六位地址元素之一的十六进制值, 可采用零压缩法 ( 如果几个连续段位的值都是 0, 那么这些 0 就可以简单的以 :: 来表示 ) 的形式记录端口号最大长度 5 信息示例 1025 MAC 地址最大长度 12 信息示例 C PC 终端信息中的 MAC 地址默认获取 2 个, 应首选采集处于激活状态的网卡信息特殊说明 2. 移动端用户需要开通授权 3. MAC 地址处理要求 MAC 地址去掉地址中的 - 或 : 进行记录设备名最大长度 9 信息示例 cfmmc.pc 设备名为超长信息, 其长度大于限定字节数时, 需要注意截取处应避免特殊说明出现汉字被截断的情况操作系统版本最大长度 5 信息示例 10.0* CPU 序列号最大长度 16 信息示例 BFEBFBFF000406E3 特殊说明多颗 CPU 情况下, 采集物理编号为 0 的 CPU 信息 7

10 硬盘序列号最大长度 16 信息示例 86D6C8Z6T 系统盘分区信息最大长度 24 信息示例 C,201C3A22,FAT32,80 系统盘分区信息 ( 只记录承载操作系统的磁盘信息 ) 包括 : 盘符分区序特殊说明列号分区格式分区容量 (G), 各信息间以逗号隔, 即盘符, 分区序列号, 分区格式, 分区容量 BIOS 序列号最大长度 10 信息示例 PCOCJEY5 设备序列号最大长度 12 信息示例 C02RY79KF43V 最大长度 12 信息示例中国移动最大长度 12 信息示例 phone 网络运营商设备类型地理位置信息最大长度 17 信息示例 N35.461,E 需要用户开通授权特殊说明 2. 北纬用 N 表示, 南纬用 S 表示, 东经用 E 表示, 西经用 W 表示 3. 小数点后保留三位有效数字 IMEI 最大长度 15 信息示例特殊说明需要用户开通授权 MEID 最大长度 14 信息示例特殊说明需要用户开通授权手机号码最大长度 11 信息示例

11 特殊说明 1. 需要用户开通授权 2. 仅安装一张 SIM 卡时, 采集已安装 SIM 卡的手机号安装两张卡时, 采集 SIM1 卡的手机号 UUID 最大长度 32 信息示例 E39DC982705E5B008C13AFDE0DF2FEA1 IMSI 最大长度 15 信息示例需要用户开通授权特殊说明 2. 仅安装一张 SIM 卡时, 采集已安装 SIM 卡的 IMSI 安装两张卡时, 采集 SIM1 卡的 IMSI ICCID 最大长度 20 信息示例 f10115f 需要用户开通授权特殊说明 2. 安装一张 SIM 卡时, 采集已安装 SIM 卡的 ICCID 安装多张卡时, 采集编号最小的 SIM 卡的 ICCID 电话号码最大长度 20 信息示例微信 OpenID 最大长度 28 信息示例 eb429bl00968f2c0ef38 客户内部资金账户最大长度 18 信息示例注 : 空格处理要求单个终端信息中有多个空格时, 需处理为单个空格 ; 单个终端信息的起始和结尾不能包含空格 4.3 采集方法采集原则客户交易终端信息是登录信息的重要组成部分为兼顾运行效率和采集准确性, 仅在客户每次登录时采集客户交易终端信息对于线下委托和微信委托在下达交易指令时, 进行信息采集采集流程直连模式采集流程 9

12 直连模式交易终端信息采集的业务流程如下图所示 : 图 4-1 信息采集业务流程 a) 交易软件商向监控中心发起获取加密密钥的正式申请, 监控中心审核身份通过后, 派发加密密钥 b) 交易软件商开发动态链接库, 提供给终端软件商使用动态链接库负责采集客户交易终端信息, 并使用加密密钥对采集信息进行整体加密, 如果信息采集失败则应返回相应错误信息 c) 终端软件商将信息采集动态链接库集成至终端软件, 实现客户登录时采集终端信息, 并将信息密文即时报送期货公司交易软件如因权限问题, 采集终端信息失败, 则应提示用户开启信息采集的相应权限 d) 交易软件在终端软件接入时补充获取交易软件厂商 ID 加密密钥版本异常标识 AppID 客户交易终端公网 IP 客户交易终端公网端口号客户交易终端登入时间客户内部资金账户和用户类型, 对相应指标进行加密, 并汇总至结算软件 e) 结算软件盘后将信息密文报送给监控中心 f) 监控中心系统使用解密密钥解密密文中继代理模式采集流程 10

13 中继代理模式交易终端信息采集的业务流程如下图所示 : 图 4-2 信息采集业务流程 a) 交易软件商向监控中心发起获取加密密钥的正式申请, 监控中心审核身份通过后, 派发加密密钥 b) 交易软件商开发动态链接库, 提供给终端软件商使用动态链接库负责采集客户交易终端信息, 并使用加密密钥对采集信息进行整体加密如果信息采集失败则应返回相应错误信息 c) 交易软件商开发终端信息上报接口, 提供给中继代理商使用中继代理通过上报接口将客户交易终端采集信息, 上报给期货公司交易软件 d) 终端软件商将信息采集动态链接库集成至终端软件, 实现客户登录时采集终端信息, 并将信息密文即时报送期货公司中继代理如因权限问题, 采集终端信息失败, 则应提示用户开启信息采集的相应权限 e) 中继代理补充获取终端软件异常标识 AppID 客户交易终端公网 IP 客户交易终端公网端口号和客户交易终端登入时间, 并将补充获取信息和终端上报信息发送给期货公司交易软件 f) 交易软件在中继代理接入时补充获取交易软件厂商 ID 加密密钥版本异常标识 RelayAppID 中继代理公网 IP 中继代理公网端口号中继代理登入时间客户内部资金账户和用户类型, 对相应指标进行加密, 并汇总至结算软件 g) 结算软件盘后将信息密文报送给监控中心 h) 监控中心系统使用解密密钥解密密文 4.4 信息报送报送原则 a) 信息采集数据应满足向监管机构报送要求, 存储于交易软件中, 每天盘后由主席结算软件把主次席的报送信息汇总成统一文件后, 进行上报, 监控中心收到文件后进行解密, 并共享给相应交易所生成的信息采集数据报送文件字符集为 UTF-8, 生成的报送文件名称格式为期货公司统一标识 clientinfo 日期.txt b) 采集指标应以统一的顺序和格式组装成信息采集字符串, 并以 RSA 2048 PKCS#1 方式进行加密, 为了兼顾后期替换为国密算法, 软件商在开发时应保留一定的兼容性加密后, 使用 BASE64 方式进行转码, 转码后的数据需要禁止出现换行符 11

14 c) T-1 日 15:30 至 T 日 15:30 的信息采集数据, 应于 T 日报送信息采集数据于每交易日与期货保证金监控系统数据一同报送报送格式终端采集字符串由终端采集指标分隔拼接构成, 并使用加密密钥进行加密除交易软件厂商 ID 和加密密钥版本外, 补充获取字符串由补充获取指标分隔拼接构成, 并由交易软件使用加密密钥进行加密终端采集字符串和补充获取字符串格式如下图 : 图 4-3 终端采集字符串和补充获取字符串格式信息采集数据由交易软件厂商 ID 加密密钥版本终端采集信息密文和补充获取信息密文组成, 其中终端采集信息密文和补充获取信息密文需要先进行 BASE64 转码, 转码后再按顺序以一定格式拼接信息采集数据格式如下图 : 图 4-4 分隔各采集指标中继代理和交易软件本地另行获取的补充指标, 由交易软件将其填充至相应上报信息数据中, 汇总至结算软件根据终端设备类型的分类, 各类型终端设备的详细信息整个字符串的描述顺序分别约定如下表所示 : 终端设备类型详细终端设备信息采集内容及记录顺序交易软件厂商 ID@ 私网 IP1@ 私网 IP2@ 网卡 MAC 地址 1@ 网卡 MAC 地址 2@ 客户交 Windows 易终端公网 IP@ 中继代理公网 IP@ 用户类型交易软件厂商 ID@ 私网 IP1@ 私网 IP2@ 网卡 MAC 地址 1@ 网卡 MAC 地址 2@ 硬盘序列 Linux 客户交易终端公网 IP@ 中继代理公网 IP@ 用户类型交易软件厂商 ID@ 私网 IP1@ 私网 IP2@ 网卡 MAC 地址 1@ 网卡 MAC 地址 2@ 硬盘序列 Mac OS 客户交易终端公网 IP@ 中继代理公网 IP@ 用户类型 12

15 交易软件厂商移动终端 IP@ 异 ios 客户交易终端公网 IP@ 中继代理公网 IP@ 用户类型交易软件厂商 ID@ 移动终端 IP@ 设备 Mac 客户 Android 交易终端公网 IP@ 客户登入时间中继代理公网 IP@ 用户类型交易软件厂商 ID@ 用户类型交易软件厂商 ID@ 用户类型注 : a) 标有底色的字段需要使用加密密钥进行加密, 并 BASE64 转码 b) 交易软件使用的加密密钥应与动态链接库的加密密钥一致特殊情况说明为保证信息存储解读的一致性, 对详细终端信息格式可能面临的一些特殊情况的说明限定如下 : a) 空指标处理要求终端采集指标或补充获取指标, 出现异常情况指标为空时, 需要保留分隔符举例 : 格式为移动终端 IP, 当信息采集时间为空时, 拼接字符串为移动终端 IP b) 分隔符及转换处理要求作为分割符, 第一个信息前和最后一个信息后无分割符分隔符时, 使用 &at 进行转义替换终端信息字符串解析时会根据转换规则还原对应信息, 避免字符串解析错误 4.5 信息安全要求图 4-5 信息采集安全要求在整个终端信息传输及存储的过程中, 要求如下 : a) 数据流从交易终端到中继代理, 中继代理到交易软件, 应采用高安全性, 稳定性的传输协议, 确保传输通道的安全性同时, 终端信息在传输过程中, 应对终端信息数据本身采取一定安全措施, 以进一步加强数据的安全性 b) 为了数据的安全性, 信息采集过程中, 交易软件商应采取二次加密密钥混淆等安全措施, 加强对加密密钥的保护 ( 禁止将密钥写入 JAR 中 ) 数据在交易软件数据库或结算软件报送文件等存储系统中, 需要以密文的形式存储 13

16 5 接入认证 5.1 认证方法认证原则 a) 期货公司应负责组织对终端软件的功能核验及身份认证期货公司需要测试评估终端软件是否已集成符合监管要求的信息采集动态链接库, 是否能够准确采集客户终端信息 b) 对于直接连接交易软件的终端软件, 在交易软件中根据核验的结果设置终端软件的准入权限 ; 对于通过中继代理连接交易软件的终端软件, 在交易软件中根据核验的结果设置中继代理的准入权限, 在中继代理中设置终端软件的准入权限 c) 由于 AppID 与 RelayAppID 是由终端与中继厂商按照技术规范的要求编制后, 上报给期货公司的唯一标识码期货公司在组织功能核验时, 需要审核终端厂商与中继厂商是否符合技术规范不同终端软件或中继代理的 AppID/RelayAppID 在同一期货公司内部不允许重复同一款终端软件或中继代理的 AppID/RelayAppID 在不同的期货公司应保持一致格式规范 AppID 和 RelayAppID 格式约定如下表所示 : 字段名称终端 / 中继厂商名称终端 / 中继软件名版本号最大长度格式终端 / 中继厂商名称 _ 终端 / 中继软件名称 _ 版本号示例 abcdef_ghijkl_1.6.0 特殊说明个人开发的终端软件, 厂商名称为 client 5.2 认证流程采集功能核验 a) 直连模式 1) 客户交易终端厂商向期货公司发起认证申请 2) 终端厂商根据规范要求编制 AppID, 上报期货公司 3) 期货公司依据 AppID 发放授权码, 终端厂商将其集成至终端软件 4) 期货公司审核客户交易终端功能, 对于符合监管规定的终端软件, 在交易软件中, 配置其 AppID 和授权码, 开通准入权限 5) 终端软件应具有提示用户开通相关信息采集权限的功能, 并具有若用户不开通相关权限可禁止用户登录的功能 b) 中继代理模式 1) 终端厂商联合中继代理厂商向期货公司发起认证申请 2) 终端厂商根据规范要求编制 AppID, 中继代理厂商根据规范要求编制 RelayAppID, 上报期货公司 3) 期货公司依据 AppID 和 RelayAppID 分别发放授权码, 终端厂商和中继代理厂商将其分别集成至终端软件和中继代理中 4) 期货公司审核中继代理功能, 对于符合监管规定的中继代理, 在交易软件中, 配置其 RelayAppID 和授权码, 开通准入权限 14

17 5) 期货公司审核客户交易终端功能, 对于符合监管规定的终端软件, 在中继代理中, 配置其 AppID 和授权码, 开通准入权限 6) 终端软件应具有提示用户开通相关信息采集权限的功能, 并具有若用户不开通相关权限可禁止用户登录的功能接入身份认证 a) 直连模式图 5-1 终端认证业务流程图客户交易终端软件登录时, 携带其 AppID 和授权码, 连接期货公司交易软件, 认证通过后, 方可登录交易软件此外, 考虑到客户交易终端软件接入认证功能需要明文使用 AppID, 该指标从终端采集无需加密, 由交易软件统一进行加密操作 b) 中继代理模式图 5-2 终端认证业务流程图客户交易终端软件携带 AppID 和授权码, 连接期货公司中继代理, 认证通过后, 方可登录中继代理中继代理软件携带 RelayAppID 和授权码, 连接期货公司交易软件, 认证通过后, 方可登录交易软件上报终端采集信息此外, 考虑到客户交易终端软件和中继代理接入认证功能需要明文使用 AppID 和 RelayAppID, 该两项指标从终端和中继代理采集无需加密, 由交易软件统一进行加密操作 15

18 附录 A ( 规范性附录 ) A.1 加密密钥申请流程 a) 交易软件商登录申请账号, 并按照系统提示填写相应信息 ( 附件 1), 申请获取信息采集加密密钥加密密钥版本交易软件厂商 ID 及信息采集函数名信息 ( 为避免动态链接库函数名重复, 建议命名规则为交易软件厂商 ID_getsysteminfo ) b) 监控中心核验交易软件商身份, 交易软件商需要按要求配合提供纸质材料, 身份核验通过后, 由监控中心执行系统操作进行信息派发交易软件商按照指定的安全方式获取加密密钥加密密钥版本交易软件厂商 ID 及信息采集函数名信息 c) 如交易软件商需要重发密钥或撤销密钥, 可登录 com 申请 d) 交易软件商应保管好自己的加密密钥, 防止加密密钥泄露交易软件商成功获得加密密钥后,1 年内不得重新申请新加密密钥 ; 每次重新申请新加密密钥, 旧加密密钥将于 1 年后失效交易软件商在任何时间的有效加密密钥最多不可以超过 2 个 e) 交易软件商的联系方式是接收加密密钥的重要途径, 当公司基本信息与人员基本信息发生变更时, 交易软件商应及时登录进行信息变更 16

19 附件 1. 公司基本信息 * 统一社会信用代码 * 单位全称 ( 中文 ) 单位简称 ( 中文 ) * 单位全称 ( 英文 ) * 单位简称 ( 英文 ) 单位类型独立软件供应商会员单位其他单位注册地址 * 已接入交易所上海期货交易所郑州商品交易所大连商品交易所中国金融期货交易所上海国际能源交易中心人员基本信息技术负责人信息 * 姓名职务 * 电子邮件 * 手机号码工作联系人信息 * 姓名座机号码 * 手机号码 * 电子邮件注 : 标 * 为必填项, 各交易软件商应准确填写相关信息, 避免因信息有误影响加密密钥及厂商 ID 的申请工作 17

20 A.2 信息处理示例 ( 以 Windows 为例 ) a) 直连模式 1) 客户交易终端 2) 期货公司交易软件图 A-1 客户交易终端信息采集流程 18 图 A-2 期货公司交易软件信息处理流程

21 b) 中继模式 1) 客户交易终端 2) 期货公司中继代理图 A-3 客户交易终端信息采集流程图 A-4 期货公司中继代理信息处理流程 19

22 3) 期货公司交易软件图 A-5 期货公司交易软件信息处理流程 20

23 附录 B ( 参考性附录 ) 本附录仅供参考, 不作为规范要求 B.1 采集流程示例用户可以直接使用 CTP 交易 API 进行交易, 也可以通过中继服务器间接调用交易 API 进行交易这就需要将信息采集动态链接库和 CTP 的交易 API 分离开来, 因此信息的采集和上报有可能需要分为两步,API 需要增加新的交易 API 接口 (SubmitUserSystemInfo) 让用户终端填写上报终端系统信息为了保证上报的信息是来自信息动态链接库,CTP 在信息采集动态链接库中对已经使用密钥加密的信息进行二次加密另外, 在直接使用 CTP 交易 API 进行交易时 ( 直连模式 ), 用户不需要调用 SubmitUserSystemInfo 交易 API 接口上报系统信息如果用户调用了 SubmitUserSystemInfo 交易 API 接口, 根据登录之前终端认证通过的 AppID 或者 RelayAppID 可以区分该终端是直连模式中继代理模式对于直连模式调用 SubmitUserSystemInfo 接口, 直接返回失败在调用登录接口时仍会自动采集本机的终端信息 a) 直接使用 CTP 交易 API 直连模式直接使用交易 API 进行交易时,API 会直接调用 GetSystemInfo() 采集终端信息, 并将信息填入 LocalSystemInnerInfo 字段, 通过 ReqUserLogin() 将采集到的信息送给前置前置收到交易 API 的 ReqUserLogin 请求后采集客户端的公网 IP, 并将该信息填写到登录请求的 LocalSystemOuterInfo, 然后将登录请求发送给交易核心交易核心收到用户登录请求后, 验证密码等信息若通过验证则将请求中的客户端信息发送给 TMDB( 内存数据回写数据库组件 ),TMDB( 内存数据回写数据库组件 ) 用监控中心发布的加密密钥对 LocalSystemOuterInfo 字段的信息进行加密, 然后将该信息与其他信息一起回写数据库, 结算软件读取数据库, 将信息上报给监控中心流程如下图 : 21

24 图 B-1 直接使用交易 API 模式 LocalSystemInnerInfo 里面存储的为加密密钥加密后的终端数据 LocalSystemOuterInfo 里面存储的为明文的公网 IP 和登录时间, 入库之前需要用加密密钥加密带下划线的函数, 为 CTP 交易系统内部函数如 _SubmitUserSystemInfo 步骤 : 1) 当终端软件通过交易 API 发起登录请求时, 交易 API 调用 GetSystemInfo() 采集终端信息, 将该信息填写到登录请求的 LocalSystemInnerInfo 字段中上报用户系统信息给交易前置 22

25 2) 交易前置收到用户系统信息上报后, 采集终端的公网 IP 填入 LocalSystemOuterInfo 字段, 缓存该用户的系统信息, 每个用户只缓存一条信息 3) 交易 API 发送登录请求给交易前置交易前置转发给交易核心 4) 交易核心验证登录请求, 并返回登录响应 5) 如果交易前置收到成功的登录响应, 将响应中的登录时间与 LocalSystemOuterInfo 合并, 通过 tresult 发送给 TMDB 6) TMDB 用监控中心的加密密钥加密 LocalSystemOuterInfo 信息, 然后将所有的用户系统信息回写到物理数据库中 7) 结算软件读取物理数据库中的信息, 每日汇总所有的采集信息, 将信息报送给保证金监控中心 b) 使用中继服务器操作员登录模式采用中继服务器操作员模式时, 信息采集的流程分为两个步骤 : 1) 中继服务器以操作员的的身份调用 TradeAPI 登录 CTP 交易系统, 这时交易后台对信息采集的处理方式同上 2) 中继服务器成功登录 CTP 交易系统后, 须将客户的终端信息报送上来流程如下图所示 : 图 B-2 中继服务器操作员登录模式 23

26 具体步骤 : 1) 中继服务器先以操作员的身份调用交易 API 登录 CTP 系统, 登录时采集信息的方式与用户直接连接时相同 2) 中继服务器须采集客户端的信息, 然后调用 SubmitUserSystemInfo() 上报终端信息 ( 包含客户终端采集的信息终端的 AppID 终端的登录时间和公网 IP 中继服务器的 RelayAppID 等 ) 3) Front 采集中继服务器的公网 IP, 并将信息填入 LocalSystemOuterInfo 字段中, 然后将信息发送给 tkernel 4) tkernel 收到数据上报消息时, 判断该登录账户是否有数据上报权限 ( 只有操作员和超级用户有为其他用户上报信息的权限 ) 如果没有权限, 直接丢弃消息如果有权限则将信息发给 TMDB 5) TMDB 用监控中心的加密密钥加密 LocalSystemOuterIno 和 RemoteSystemOuterI nfo 等字段, 然后将加密后的信息和采集的终端信息写入物理数据库, 结算软件读取该数据库, 将信息上报给监控中心 6) SubmitUserSystemInfo 交易 API 接口只对操作员类型的中继服务器开放使用, 其他类型的终端或者中继调用会直接返回失败 c) 使用中继服务器非操作员模式 24

27 图 B-3 中继服务器非操作员模式具体步骤 : 1) 中继服务器先为用户调用交易 API 的 RegisterUserSystemInfo() 接口 ( 填写信息包含客户终端采集的信息终端的 AppID 终端的登录时间和公网 IP 中继服务器的 RelayAppID 等 ) 2) 其余过程与用户直接连接时相同 3) RegisterUserSystemInfo 交易 API 接口只对多对多类型的中继服务器开放调用, 其他类型的终端或者中继调用会直接返回失败 25

28 B.2 认证流程示例登录前认证当客户直接使用 CTP 交易 API 时, 客户的终端软件 ( 或者中继服务器 ) 必须存有期货公司分配的授权码, 在调用 ReqAuthenticate() 时填入 AppID 和对应的授权码, 交易 API 将该授权码 ( 暂定 16 字节 ) 缓存下来作为加密的 AES_KEY, 以对后续信息进行 AES 加密接入认证的流程如下 : 图 B-4 认证流程 26

29 处理流程 : a) 在终端登录之前, 用户通过交易 API 发起终端认证请求 ReqAuthenticate 需要用户填写 AppID(RelayAppID) 和授权码 (authcode), 该授权码只会缓存交易 API 中, 不会在网络中直接传输授权码 b) 交易前置随机生成 128 字节的 TimeStamp, 将 TimeStamp 保存在 session 信息中, 并将其通过 RspAuthenticate 回调信息返回给终端 c) 终端收到 RspAuthenticate 回调信息后, 使用 AES_KEY 加密 TimeStamp, 并将其赋值到 AuthInfo 字段, 再次发起 ReqAuthenticate 请求 d) 交易前置收到第二次的 FTD_TID_ReqAuthenticate 之后, 将之前 session 保存的 TimeStamp 赋值到请求里面的 TimeStamp 字段中将认证消息发送给交易核心 e) 交易核心使用内存数据库中终端信息对应的授权码加密 TimeStamp 字段, 并将加密结果与 AuthInfo 比较如果相同设置当前终端为已经认证并返回 RspAuthenticate 成功结果给交易前置 f) 交易前置通过 API 回调, 将认证结果返回给用户 g) 对于认证失败的连接, 不允许进行登录 27

30 B.3 信息采集函数参考信息采集时间私网 IP 公网 IP time(); gethostname() 和 gethostbyname(); gethostbyname() 和 inet_ntoa(); 网卡 MAC 地址 getadaptersinfo(); 硬盘序列号 1.CreateFile() 和 DeviceIoControl(); 2.system("wmic path win32_physicalmedia get SerialNumber"); PC 终端 (Windows) 操作系统版本 GetVersionEx() VerifyVersionInfo() 和 NetWkstaGetInfo(); 设备名 GetComputerName(); CPU 序列号使用 System 命令 wmic CPU get ProcessorID; 系统盘分区信息 1.GetLogicalDriveStrings();GetDriveType();GetSyst emdirectory 2. 使用 System 命令 Diskpart list volume; BIOS 序列号 wmic bios get serialnumber 信息采集时间私网 IP time(); ioctl(); 公网 IP gethostbyname() 和 inet_ntoa(); PC 终端 (Linux) 网卡 MAC 地址 ioctl(); 1. 通过 hdparm 命令或者 lshw 命令 ; 2. 使用 ioctl(fd, HDIO_GET_IDENTITY, id2) 方式获取 ; 硬盘序列号 3.scsi_io(fd, cdb, sizeof(cdb), SG_DXFER_FROM_DEV, data, &data_size, sense, &sense_len); 操作系统版本 uname(); 28

31 设备名 1. 使用 hostname shell 命令 ; 2.gethostname(); CPU 序列号 1.linux: 使用 <cpuid.h> 的 get_cpuid(level, &eax, &ebx, &ecx, &edx); 2.dmidecode -t 4 grep ID; BIOS 序列号 dmidecode -t 1 grep "Serial Number" 信息采集时间私网 IP time(); NSHost*myhost= [NSHostcurrentHost( 私有 api)] 和 NSString*ad = [myhost address]; 公网 IP gethostbyname() 和 inet_ntoa(); PC 终端 (Mac OS) 网卡 MAC 地址 GetPrimaryMACaddress(); 硬盘序列号 IOKit framework; 设备序列号 IOKit framework; 操作系统版本 Long response=gestalt(gestaltsystemversion,&respo nse); 设备名 IOKit framework; 信息采集时间 1.Calendar.getInstance().getTime(); 2.System.currentTimeMillis; 移动终端 (Android) 公网 IP 移动终端 IP 手机号码 HttpURLConnection; 1.NetworkInterface.getNetworkInterfaces(); 2.getSystemService(Context.WIFI_SERVICE).getConne ctioninfo().getipaddress() NetworkInterface.getN etworkinterfaces().gethostaddress().tostring(); 1.TelephonyManager.getLine1Number() 2.TelephonyManager tm =(TelephonyManager) this.getsystemservice(context.telephony_service)t m.getline1number(); 29

32 移动设备唯一识别码 ( IMEI, MEID) 1.TelephonyManager.getSimSerialNumber(); 2.tm.getDeviceId(); 地理位置信息 LocationManager, Geocoder; 操作系统版本 1.android.os.Build.VERSION.SDK_INT; 2.PackageManager()/UIDevicecurrentDevice; 设备序列号 1.android.os.Build.SERIAL; 2.Secure.getString(getContentResolver(),Secure.AN DROID_ID); 设备 MAC 地址 1.NetworkInterface.getNetworkInterfaces(); 2.NetworkInterface.getByInetAddress(InetAddress.g etbyname(getlocalipaddress())).gethardwareaddress (); 设备名 android.os.build.device; 设备类型 android.os.build.type; IMSI String imsi =telmanager.getsubscriberid(); ICCID Android:String iccid =tm.getsimserialnumber(); 移动终端 (ios) 信息采集时间移动终端 IP 通用唯一识别码 (UUID) [NSDate date]; 1.getifaddrs(); 2. 系统方法获取 sys/socket.h; 可能需要第三方库来保存信息或 [uuid 转化 imei]/uidevicecurrentdevice; 地理位置信息操作系统版本 CLLocationManager; systemversion 或 PackageManager(); 30

33 设备序列号 [UIDevicecurrentDevice] 获取 ; 设备名网络运营商 struct utsname systeminfo; uname(&systeminfo); NSString *devicename = [NSString stringwithcstrin g:systeminfo.machine encoding:nsutf8stringencodin g]; CTTelephonyNetworkInfo *info = [[CTTelephonyNetwo rkinfo alloc] init]; CTCarrier *carrier = [info subscribercellularprov ider]; mobile = [carrier carriername]; 设备类型 NSString *devicetype = [UIDevice currentdevice].m odel; 其他终端 ( 微信委托 ) 其他终端 ( 线下委托 ) 信息采集时间 OpenID 地理位置信息信息采集时间电话号码系统接口 WxOpenIdServlet 微信公众号开发网页授权获得 OPENID 使用微信公众号 JS-SDK 提供相应接口系统接口服务器端采集 31

X-One 系统看穿式监管 V1.6.3 版本客户端及 API 使用相关说明

X-One 系统看穿式监管 V1.6.3 版本客户端及 API 使用相关说明 X-One V1.6.3 版本向下兼容旧版 API(1.6.1 及 1.5.3 版本 ) 及客户端, 对应的终端编号为 dfitc_compatible_1.6.1, 可以在授权码管理菜单界面看到其对应的授权码信息如果删除了该条终端编号的记录或者修改了该授权码状态为禁止准入, 使用旧版 API 及客户端的客户将无法登录

目 次 1 背景与范围 背景说明 适用范围 术语和定义 客户交易终端 交易软件 直连模式 中继代理模式 AppID/RelayAppID 授权

目次 1 背景与范围背景说明适用范围术语和定义客户交易终端交易软件直连模式中继代理模式 AppID/RelayAppID 授权