收藏 分销(赏)

DB4201∕T 536.2-2017 -云端武汉-政务数据资源目录体系与数据交换技术规范 第2部分:数据共享交换(武汉市).pdf

上传人:曲**** 文档编号:641225 上传时间:2024-01-22 格式:PDF 页数:43 大小:596.95KB
下载 相关 举报
DB4201∕T 536.2-2017 -云端武汉-政务数据资源目录体系与数据交换技术规范 第2部分:数据共享交换(武汉市).pdf_第1页
第1页 / 共43页
DB4201∕T 536.2-2017 -云端武汉-政务数据资源目录体系与数据交换技术规范 第2部分:数据共享交换(武汉市).pdf_第2页
第2页 / 共43页
DB4201∕T 536.2-2017 -云端武汉-政务数据资源目录体系与数据交换技术规范 第2部分:数据共享交换(武汉市).pdf_第3页
第3页 / 共43页
DB4201∕T 536.2-2017 -云端武汉-政务数据资源目录体系与数据交换技术规范 第2部分:数据共享交换(武汉市).pdf_第4页
第4页 / 共43页
DB4201∕T 536.2-2017 -云端武汉-政务数据资源目录体系与数据交换技术规范 第2部分:数据共享交换(武汉市).pdf_第5页
第5页 / 共43页
点击查看更多>>
资源描述

1、ICS 35.240.01 L 67 备案号:0071-2017 DB4201 武汉市地方技术规范 DB4201/T 536.22017“云端武汉”政务数据资源目录体系 与数据交换技术规范 第 2 部分:数据共享交换 Technical specifications for Wuhan government cloud government data resource catalog system and data exchange Part 2:data share and exchange 2017-11-16 发布 2017-12-15 实施 武 汉 市 质 量 技 术 监 督 局 武汉

2、市互联网信息办公室 发 布 DB4201/T 536.22017 I 目 次 前言.III 1 范围.1 2 规范性引用文件.1 3 术语与定义.1 4 缩略语.3 5 数据交换体系总体框架.3 5.1 总体技术架构.3 5.2 共享交换服务建设流程.3 6 数据共享交换技术规范.6 6.1 概述.6 6.2 交换模式.6 6.3 数据接口交换规则.7 6.4 前置数据库交换规则.16 7 数据资源交换管理规范.24 7.1 概述.24 7.2 角色职责.24 7.3 管理环节.25 7.4 制度建设.26 附录 A(资料性附录)政务共享交换服务表单示例.27 附录 B(资料性附录)数据接口参

3、数示例.28 附录 C(资料性附录)SDK 调用示例.32 参考文献.35 DB4201/T 536.22017 III 前 言 本标准按照GB/T 1.1-2009 标准化工作导则 第1部分:标准的结构和编写给出的规则起草。本标准由武汉市互联网信息办公室提出并归口。本标准起草单位:武汉市信息中心、武汉市标准化研究院。本标准主要起草人:王留军、袁远明、崔新强、黄勇、张洁、肖迎霜、董波涛、向小雪、李文、刘肖骏。DB4201/T 536.22017 1 “云端武汉”政务数据资源目录体系与数据交换技术规范 第 2 部分:数据共享交换 1 范围 本标准规定了“云端武汉”政务数据共享交换中的术语与定义、

4、缩略语、数据交换体系总体框架、数据共享交换技术规范、数据资源交换管理规范。本标准规范适用于武汉市各行政机关或其他依法经授权、受委托行使行政职能的组织采集、归集和共享交换政务数据资源。2 规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件,仅所注日期的版本适用于本文件。凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。武政办2015146号 武汉市政务数据资源共享管理暂行办法 武网发20169号 武汉市政务云平台数据资源安全管理实施细则 3 术语与定义 下列术语和定义适用于本文件。3.1 行政主管部门 administrative department

5、行政机关或者其他依法经授权、受委托行使行政职能的组织。3.2 武汉政务云数据中心 Wuhan government cloud data center 指按“物理分散、逻辑集中”的原则将各行政主管部门政务数据资源进行归集,为各行政主管部门的数据共享提供支撑的技术服务平台。简称“数据中心”。3.3 政务数据资源 government data resource 行政主管部门通过数据中心进行传输、交换、存储的非涉密数据,是具有某个作用功能的元数据集合。3.4 DB4201/T 536.22017 2 数据项 data item 各行政主管部门可共享的单个政务数据资源不可再分割的组成元素。3.5 服

6、务及服务项 service and service item 服务项主要是指数据提供单位可对外公开的单个服务,为实现政务数据资源的交换而提供的一组对数据项操作的集合,数据项可来自于多个政务数据资源,而服务是整个服务项集合的总称。3.6 数据需求方 data demand side 指通过数据中心获取政务数据资源的各行政主管部门。3.7 管理者 manager 指数据中心的运维单位。3.8 数据提供方 data provider 指向数据中心提供数据资源的各行政主管部门。3.9 共享交换服务 shared exchange service 各行政主管部门之间根据自身的办事事项进行政务数据资源交换

7、工作的统称。共享交换服务所涉及的数据资源由各行政主管部门自身的业务信息系统所提供、产生、发布并进行运行管理。3.10 共享信息服务系统 shared information service system 对各行政主管部门提供的共享交换服务及接口统一维护管理的平台系统。3.11 接口 interface 又称服务接口,本标准中专指各行政主管部门间政务数据资源共享交换的技术实现手段,具体技术形式包含:数据接口、前置数据库两种。3.12 访问密钥标识/秘密访问密钥 API_key/API_secret 根据非对称加密的方法来验证某个请求者身份。DB4201/T 536.22017 3 3.13 会话

8、 session 指用户与服务器进行的一次交互,包括从发起到退出的整个过程。4 缩略语 下列缩略语适用于本文件。HTTP:超文本传输协议(HyperText Transfer Protocol)API:应用程序编程接口(Application Programming Interface)URL:统一资源定位符(Uniform Resource Locator)XML:可扩展标记语言(Extensible Markup Language)5 数据交换体系总体框架 5.1 总体技术架构 5.1.1 组成 政务数据共享交换体系技术总体架构包括交换信息库和共享交换服务系统两方面组成。5.1.2 交换信

9、息库 交换信息库是各行政主管部门为实现政务数据共享交换而建立的前置虚拟交换区,交换区内存储可提供的共享交换服务信息。5.1.3 共享交换服务系统 5.1.3.1 前置数据库子系统 由交换前置服务器、交换信息库、交换适配器及相关中间件等组成。前置数据库子系统与各行政主管部门业务应用系统之间通过建立虚拟共享交换区,实现数据采集交换,保证部门业务数据库和业务应用系统的独立性。5.1.3.2 数据接口子系统 为各行政主管部门对外共享交换服务数据接口提供注册、挂接、配置、授权等管理。5.1.3.3 交换管理子系统 实现对整个数据交换过程的配置、部署、执行和整个共享交换服务系统运行进行监控、管理。5.2

10、共享交换服务建设流程 如图1所示,共享交换服务建设包括4个环节:a)申请:数据需求方整理各自办事业务、应用系统、服务事项等需要,依法依规提出政务数据共享交换申请,按照“政务数据共享交换申请单”模版格式要求填写相关信息,单位盖章后报至市政务数据主管部门;DB4201/T 536.22017 4 b)确认:市政务数据主管部门受理共享交换申请后,对需求合理性进行初审,通过后转交数据提供方确认,数据提供方应在 5 个工作日内反馈意见。如有分歧,由市政务数据主管部门组织需求方、提供方协商达成一致,双方依据协商结果填写政务数据共享交换确认单,加盖公章后提交市政务数据主管部门备案;c)实施:共享交换需求确认

11、后,对于数据中心上已发布的数据服务,由数据中心直接完成权限配置和数据推送;对于数据中心上未发布的数据服务,由市政务数据主管部门指导数据提供方开展设计开发,并由数据中心工作人员完成该项数据服务的对接工作,全部工作应在 30 个工作日内完成;d)考核:市政务数据主管部门对各部门数据共享工作响应程度、实施进度、工作质量进行考核。对不按照要求进行数据共享交换的部门,予以通报批评;情节特别严重的部门,市政务数据主管部门将取消其通过数据中心共享其他部门数据的资格。DB4201/T 536.22017 5 数据需求方数据中心数据提供方行政机关开始创建服务申请单整理办事事项涉及的共享数据资源及相关信息登记所需

12、数据项和对应政务部门审核服务申请单与需求方、提供方协商通知结果给服务涉及相关政务部门结束拒绝服务接口实施挂接同意是否已有相关服务没有已有各政务部门分别进行新建服务工作收集各政务部门反馈结果提供方结合需求方申请内容,给出反馈意见申请与反馈意见一并提交审核协商结果形成需求方、提供方、管理方的三方确认单 图1 共享交换服务建设流程图 5.2.1 政务数据共享交换申请单 各行政主管部门登记共享交换服务申请内容,需按照附录A中表A.1进行相关信息填写。5.2.2 政务数据共享交换确认单 数据需求方、提供方就政务数据共享交换申请内容达成一致意见后,需按照附录A中表A.2进行相关信息填写。DB4201/T

13、536.22017 6 6 数据共享交换技术规范 6.1 概述 结合武汉市政务数据资源共享交换工作特点,将各行政主管部门利用数据中心进行数据共享交换的方式划分为:数据接口、前置数据库两种类型。本部分逐一介绍每个交换方式的技术规范要求,各行政主管部门在利用数据中心进行数据共享交换时,需要结合自身采用的数据交换方式,遵循相对应的技术规范要求,同时也为第三方相关单位的研发工作提供标准依据。6.2 交换模式 6.2.1 数据接口类型 各行政主管部门的数据接口,应遵循如图2所示的交换模式进行政务数据资源交换。各数据提供方的数据接口在共享信息服务系统中集中注册、挂接、发布,其相关访问地址、帐号、密码等信息

14、不对外公布,只显示业务描述、请求参数、响应参数等基本信息。各数据需求方访问共享信息服务系统公示的统一访问地址,调取自身权限范围内的数据接口,共享信息服务系统将数据提供方返回的结果信息进行封装整理后,统一返回至各数据需求方。公安数据接口共享信息服务系统.API认证机制工商数据接口民政数据接口数据提供方统一访问共享信息服务系统,调取授权范围内的数据接口共享信息服务系统封装返回结果,统一返回各政务部门共享信息服务系统根据注册发布的数据接口信息,分别调取访问.接口注册发布接口接口订阅授权管理监控管理公安数据接口工商数据接口民政数据接口数据需求方.图2 数据接口交换模式示意图 DB4201/T 536.

15、22017 7 6.2.2 前置数据库类型 利用数据中心采用数据库模式进行政务数据交换的各行政主管部门,应遵循如图 3 所示的交换模式进行政务数据资源交换。各数据提供方的数据库及业务表信息在共享信息服务系统中集中注册、挂接、发布,根据定时抓取、定时推送或 FTP 上传文件导入三种形式,将各行政主管部门业务数据传至共享信息服务系统提供的前置交换区中,各数据需求方利用共享信息服务系统提供的直接访问数据库、调取接口、FTP 文件导出三种方式,访问自身权限范围内的数据业务表信息。公安数据库共享信息服务系统.前置交换区工商数据库民政数据库数据提供方统一访问共享信息服务系统,查阅授权范围内的业务表共享信息

16、服务系统封装返回结果,统一返回各政务部门根据定时抓取、定时推送或FTP文件导入等方式,将提供方政务数据传至前置交换区.数据库注册发布数据业务表业务表订阅授权管理监控管理公安数据库工商数据库民政数据库数据需求方.图3 前置数据库交换模式示意图 6.3 数据接口交换规则 6.3.1 数据接口管理流程 6.3.1.1 数据接口注册、发布流程 各数据提供方的数据接口在共享信息服务系统中集中注册、挂接、发布,其工作流程如图4所示,注册发布包括6个环节:DB4201/T 536.22017 8 a)指定类目:共享信息服务系统结合各行政主管部门数据特性,按照“服务分类”标准为每个行政主管部门初始相关的接口类

17、目,后期若行政主管部门需要新增服务接口类目,可直接向数据中心管理员申请;b)登记、注册:由各数据提供方行政主管部门登记自身对外提供的接口及相关参数信息;c)提交:由行政主管部门提交发布申请至数据中心;d)审核:由平台中心对各行政主管部门的数据接口内容进行审核;e)配置、测试:审核通过后,由数据中心管理员结合数据接口内容,配置并测试各数据提供方接口是否运行正常;f)发布:数据接口配置、测试成功后,其数据接口才发布完成。其他行政主管部门可定位该数据接口,查阅相关的描述说明,并申请数据接口的访问权限。DB4201/T 536.22017 9 数据提供方数据中心开始类目是否已存在登记对外发布数据接口相

18、关参数结束不存在通过申请新类目审核新类目配置、测试接口审核接口内容选择对外发布数据接口所属类目提交审核已存在通过不通过提交审核测试成功发布不通过 图4 数据接口注册、发布流程图 DB4201/T 536.22017 10 6.3.1.2 数据接口订阅、授权流程 各数据需求方通过共享信息服务系统统一提出申请,由数据中心管理员进行审核,对所选数据接口进行调取授权,其工作流程如图5所示,订阅授权包括4个环节:a)申请:各数据需求方通过共享信息服务系统统一提出对已发布数据接口的调取申请;b)审核:由平台中心对各行政主管部门的数据接口订阅请求进行审核;c)授权:为各数据需求方授权相应的数据接口调取权限;

19、d)配置、测试:数据中心管理员配合各数据需求方进行数据接口调取的测试工作,保证数据需求方成功获取所需的接口数据。数据需求方数据中心开始分配访问权限结束审核订阅申请配置、测试接口选择所需数据接口通过测试成功提出订阅申请提交审核不通过 图5 数据接口订阅、授权流程图 DB4201/T 536.22017 11 6.3.2 技术要求 6.3.2.1 提供方数据接口发布规范 6.3.2.1.1 数据接口示例 数据提供方所发布的数据接口内容,参照附录B表B.1示例进行描述。6.3.2.1.2 接口命名规范 数据提供方数据接口的命名遵循以下规则:a)应由半角格式的英文或数字组成,不允许包含全角格式、汉字或

20、特殊字符,所有数据接口的命名为无缝连写,首词汇采用小写字母,其余每个词汇的缩写的首字母采用大写;b)命名在本规则范围内应唯一,若不同行政主管部门的数据接口名称出现重复,可在数据接口名称前增加“虚拟名称”用于区分不同的行政主管部门。最终格式例如:“虚拟名称.真实数据接口名称(gaj.getPersonByIDCard)”;c)虚拟名称命名应为半角格式的英文无缝连写;d)本规则范围内不允许接口的命名与其对应版本号同时重复。6.3.2.1.3 数据接口基础属性规范 数据接口的基础属性除命名外,还包括:接口版本号、接口描述、接口类型、返回报文类型、访问地址、访问帐号、访问密码、提供方名称、技术联系人、

21、联系人电话,属性具体说明如下:a)接口版本号 定义:描述数据接口的版本信息 注解:必选项;最大出现次数为1 b)接口描述 定义:描述数据接口的功能作用 注解:必选项;最大出现次数为1 c)接口类型 定义:描述数据接口的访问方式类型 注解:必选项;最大出现次数为1 d)返回报文类型 定义:描述调取本数据接口返回报文的格式类型(xml或josn格式)注解:必选项;最大出现次数为1 e)访问地址 定义:描述数据接口的调取访问地址 注解:必选项;最大出现次数为1 f)访问帐号 定义:描述调取数据接口时所需的帐号 注解:必选项;最大出现次数为1 g)访问密码 定义:描述调取数据接口时所需的密码 注解:必

22、选项;最大出现次数为1 h)提供方名称 定义:数据接口提供单位名称 DB4201/T 536.22017 12 注解:必选项;最大出现次数为1 i)技术联系人 定义:负责数据接口对接调试工作技术人员姓名 注解:必选项;最大出现次数为1 j)联系人电话 定义:负责数据接口对接调试工作技术人员的手机号码或座机号码 注解:必选项;最大出现次数为1 6.3.2.1.4 请求参数规范 调取数据提供方数据接口所需的各请求参数描述应遵循以下规则:a)各参数命名应由半角格式的英文、数字或“_”符号组成,不允许包含全角格式、汉字或其他特殊字符,所有数据接口的请求参数为无缝连写;b)各参数首词汇全部采用小写字母,

23、其余每个词汇的缩写的首字母采用大写;c)每个请求参数的属性包括:名称、类型、数据长度、是否必须、默认值、描述,属性具体说明如下:1)名称 定义:描述请求参数的英文名称 注解:必选项;最大出现次数为 1 2)类型 定义:描述请求参数对应的数据类型 注解:必选项;最大出现次数为 1 3)数据长度 定义:描述请求参数最大长度限制 注解:必选项;最大出现次数为 1 4)是否必须 定义:描述请求参数是否为必填项 注解:必选项;最大出现次数为 1 5)默认值 定义:描述请求参数的默认数值,说明当调取数据接口时该参数不传值的情况下,默认的数值内容 注解:可选项;最大出现次数为 1 6)描述 定义:说明请求参

24、数的含义及用途 注解:必选项;最大出现次数为 1 6.3.2.1.5 响应参数规范 数据提供方数据接口的响应返回结果中各参数描述应遵循以下规则:a)各参数命名应由半角格式的英文、数字或“_”符号组成,不允许包含全角格式、汉字或其他特殊字符,所有数据接口的响应参数为无缝连写;b)各参数首词汇全部采用小写字母,其余每个词汇的缩写的首字母采用大写;c)所有的响应数据编码皆为 utf-8 格式;d)每个响应参数的属性包括:名称、类型、数据长度、示例值、描述,属性具体说明如下:DB4201/T 536.22017 13 1)名称 定义:描述响应参数的英文名称 注解:必选项;最大出现次数为 1 2)类型

25、定义:描述请求参数对应的数据类型 注解:必选项;最大出现次数为 1 3)数据长度 定义:描述响应参数最大长度限制 注解:必选项;最大出现次数为 1 4)示例值 定义:描述响应参数的示例数值,为需求方提供返回示例 注解:必选项;最大出现次数为 1 5)描述 定义:说明响应参数的含义及用途 注解:必选项;最大出现次数为 1 6.3.2.1.6 错误结果参数规范 调取数据提供方数据接口出现错误时,其返回结果内容应遵循以下规则:a)各参数命名应为半角格式的英文、数字或“_”符号组成,不允许包含全角格式、汉字或其他特殊字符,所有数据接口的错误结果参数为无缝连写;b)各参数首词汇全部采用小写字母,其余每个

26、词汇的缩写的首字母采用大写;c)每个错误结果参数的属性包括:名称、类型、数据长度、示例值、描述,属性具体说明如下:1)名称 定义:描述错误结果参数的英文名称 注解:必选项;最大出现次数为 1 2)类型 定义:描述错误结果参数对应的数据类型 注解:必选项;最大出现次数为 1 3)数据长度 定义:描述错误结果参数最大长度限制 注解:必选项;最大出现次数为 1 4)示例值 定义:描述错误结果参数的示例数值,为需求方提供返回错误结果示例 注解:必选项;最大出现次数为 1 5)描述 定义:说明错误结果参数的含义及用途 注解:必选项;最大出现次数为 1 6.3.2.1.7 错误代码定义 数据提供方数据接口

27、应包括错误代码及其对应的描述说明,每个错误代码定义的属性包括:错误代码、错误消息、错误说明,属性具体说明如下:a)错误代码 DB4201/T 536.22017 14 定义:描述错误结果参数的代码编号 注解:必选项;最大出现次数为 1 b)错误消息 定义:描述错误代码对应的错误消息内容 注解:可选项;最大出现次数为 1 c)错误说明 定义:描述错误代码对应的中文描述 注解:必选项;最大出现次数为 1 6.3.2.2 需求方数据接口使用规范 6.3.2.2.1 访问地址规范 数据需求方调取提供方数据接口时,其访问地址为共享信息服务系统提供的统一访问 URL。URL的格式例如:公共访问 IP 地址

28、(http:/localhost:9099/api/ws/rest)?公共请求参数+业务请求参数。URL 地址参数说明:a)URL 地址中各参数应由半角格式的英文、数字或“_”符号组成,不允许包含全角格式、汉字或其他特殊字符,所有数据接口的请求参数为无缝连写;b)URL 地址中各参数首词汇全部采用小写字母,其余每个词汇的缩写的首字母采用大写;c)URL 里的所有请求参数名和参数值的数据编码皆为 utf-8 格式;d)参数名与参数值拼装起来的 URL 长度小于 1024 个字符时,可以用 GET 发起请求;参数类型含byte类型或拼装完成的请求 URL 过长时,应用 POST 发起请求;e)公共

29、请求参数详见 6.3.2.2.2 公共请求参数规范章节;f)业务请求参数详见 6.3.2.1.4 请求参数规范章节。6.3.2.2.2 公共请求参数规范 数据需求方在调取数据接口时,应按照共享信息服务系统要求,传入系统所需的公共请求参数,公共请求参数描述遵循以下规则:a)各参数命名应由半角格式的英文、数字或“_”符号组成,不允许包含全角格式、汉字或其他特殊字符,所有公共请求参数为无缝连写;b)各参数首词汇全部采用小写字母,其余每个词汇的缩写的首字母采用大写;c)每个公共请求参数的属性包括:名称、类型、是否必须、默认值、描述,属性具体说明如下:1)名称 定义:描述公共请求参数的英文名称 注解:必

30、选项;最大出现次数为 1 2)类型 定义:描述公共请求参数对应的数据类型 注解:必选项;最大出现次数为 1 3)数据长度 定义:描述公共请求参数最大长度限制 注解:必选项;最大出现次数为 1 4)是否必须 定义:描述公共请求参数是否为必填项 注解:必选项;最大出现次数为 1 DB4201/T 536.22017 15 5)默认值 定义:描述公共请求参数的默认数值,说明当调取数据接口时该参数不传值的情况下,默认的数值内容 注解:可选项;最大出现次数为 1 6)描述 定义:说明公共请求参数的含义及用途 注解:必选项;最大出现次数为 1 d)目前梳理的公共请求参数如表 1 所示。表1 数据接口访问公

31、共请求参数表 名称名称 类型类型 数据长度数据长度 是否必须是否必须 默认值默认值 描述描述 method String 20 是 无 待调取数据接口名称 api_key String 50 是 无 分配给应用的API_Key timestamp String 10 是 无 时间戳,格式为YYYY-MM-DD HH:mm:ss,时区为GMT+8,例如:2016-01-01 12:00:00。服务端允许客户端请求最大时间误差为10分钟 v String 5 是 1.0 数据接口版本 sign String 2048 是 无 输入参数签名结果,签名算法参照下面的介绍。6.3.2.2.3 数据接口示

32、例 共享信息服务系统向数据需求方提供所需数据接口调取方式,如附录 B 表 B.2 示例所示。6.3.2.3 认证机制 6.3.2.3.1 API 认证简介 为保证数据接口访问调取的安全性,防止恶意、超权限访问数据接口,各数据需求方行政主管部门通过共享信息服务系统调取相关数据接口之前,应进行资质认证。系统通过使用 API_Key/API_Secret加密的方法来验证各行政主管部门身份,API_Key(以下简称为“AK”)是系统为每个访问者分配的唯一标识;API_Secret(以下简称为“AS”)是用于加密的认证字符串,调取数据接口时,根据特定算法将“AS”与请求参数信息组合加密形成需求方的验证密

33、匙,具体方法详见 6.3.2.3.3 签名算法章节描述。AS 信息严格保密,仅限行政主管部门管理员和数据中心管理员有权查阅。6.3.2.3.2 API 认证方式 共享信息服务系统获取各数据需求方发送的 HTTP 请求后,按以下步骤进行需求方身份资质认证:a)获取数据需求方的 API_Key 信息,判断该数据需求方是否存在,若不存在,系统将拒绝该请求;若存在,则执行后续的验证工作;b)根据签名算法得出本次数据接口调取请求的合法签名内容,与数据需求方请求时提供的 sign值比对,若不一致,系统将拒绝该请求;若一致,则执行后续的验证工作;DB4201/T 536.22017 16 c)判断请求是否超

34、时,即共享信息服务系统服务器收到数据接口调取请求的时间需要符合以下要求:“timestamp-10min服务器接收到请求时间timestamp+10min”;其中,timestamp代表需求方调取数据接口的请求时间。为了防止数据需求方服务器与共享信息服务系统服务器时钟不同步而导致的认证失败,引入10分钟的宽松系数。若共享信息服务系统服务器收到数据接口调取请求的时间不符合以上时间要求,则认为请求超时,系统将拒绝该请求;若符合上述要求,则表示认证成功,系统将按照数据需求方的请求内容进行操作。6.3.2.3.3 签名算法 为了防止调取 API 数据接口过程中被黑客恶意篡改,数据需求方在调取任何一个

35、API 数据接口时都需要携带签名(公共参数中的“sign”参数对应的内容),共享信息服务系统会根据请求参数,对签名进行验证,签名不合法的请求将会被拒绝。共享信息服务系统目前只运用 MD5 签名算法,计算签名内容过程如下:a)对所有 API 请求参数(包括公共参数和业务参数,除去 sign 参数和 byte类型的参数),根据参数名称的 ASCII 码表的顺序排序。如:foo=1,bar=2,foo_bar=3,foobar=4 排序后的顺序是 bar=2,foo=1,foo_bar=3,foobar=4;b)将排序好的参数名和参数值拼装在一起,根据上一步的示例得到的结果为:bar2foo1foo

36、_bar3foobar4;c)把拼装好的字符串采用 utf-8 编码,使用签名算法对编码后的字节流进行摘要。使用 MD5 算法,在拼装的字符串前后加上 API _Secret,再进行摘要,如:md5(AS+bar2foo1foo_bar3foobar4+AS);d)将进行摘要后所得到的字节流结果统一转成大写字母。6.4 前置数据库交换规则 6.4.1 前置数据库管理流程 6.4.1.1 数据库业务表注册、发布流程 6.4.1.1.1 定时抓取模式 各数据提供方的数据库业务表在共享信息服务系统中集中注册、挂接、发布,由共享信息服务系统定时抓取各数据提供方的数据库业务表数据模式的工作流程如图 6

37、所示,注册发布包括 4 个环节:a)提交信息:由各数据提供方向数据中心管理员提供自身业务数据库的基础配置信息(线下填写纸质或电子文档形式完成);b)登记、注册:由数据中心管理员登记各数据提供方的业务数据库相关信息;c)配置、测试:数据中心管理员为每个数据提供方分配前置交换区,创建对应数据库表结构,配置、调试前置交换区抓取各数据提供方数据库业务表数据功能;d)发布:数据库业务表抓取数据功能配置、测试成功后,其前置交换区数据库内所有业务表自动发布完成。其他行政主管部门可定位该数据库业务表,查阅相关的描述说明,并申请业务表的访问权限。DB4201/T 536.22017 17 数据提供方数据中心开始

38、提交自身数据库及业务表相关信息(线下)结束配置、测试数据抓取测试成功发布登记、注册数据库业务表信息 图6 数据库注册、发布流程图(定时抓取模式)6.4.1.1.2 定时推送模式 各数据提供方的数据库业务表在共享信息服务系统中集中注册、挂接、发布,由各数据提供方定时推送自身数据库业务表数据至共享信息服务系统模式的工作流程如图7所示,注册发布包括4个环节:a)提交信息:由各数据提供方向数据中心管理员提供自身业务表的基础配置信息(线下填写纸质或电子文档形式完成);b)分配交换区:各数据提供方配合数据中心管理员为该行政主管部门分配前置交换区,创建相应数据库表结构;c)配置、测试:各数据提供方配合数据中

39、心管理员配置、调试定时向前置交换区推送自身数据库业务表数据功能是否正常(线下完成);d)发布:数据库推送数据功能配置、测试成功后,其前置交换区数据库内所有业务表自动发布完成。其他行政主管部门可定位该数据库业务表,查阅相关的描述说明,并申请业务表的访问权限。DB4201/T 536.22017 18 数据提供方数据中心开始分配交换区结束配置、测试数据推送测试成功发布提交自身业务表相关信息(线下)图7 数据库注册、发布流程图(定时推送模式)6.4.1.1.3 FTP 文件上传模式 各数据提供方的数据库业务表在共享信息服务系统中集中注册、挂接、发布,由各数据提供方将自身数据库业务表数据制作成相关文件

40、导入至共享信息服务系统模式的工作流程如图 8 所示,注册发布包括 4 个环节:a)提交信息:由各数据提供方向数据中心管理员提供自身业务表的基础配置信息(线下填写纸质或电子文档形式完成);b)分配交换区:各数据提供方配合数据中心管理员为本部门分配前置交换区,创建相应数据库表结构;c)配置、测试:各数据提供方制作相关文件,通过 FTP 上传,配合数据中心管理员调试向前置交换区导入自身数据库业务表数据功能是否正常(线下完成);d)发布:相关数据文件导入业务表数据功能配置、测试成功后,其前置交换区数据库内所有业务表自动发布完成。其他行政主管部门可定位该数据库业务表,查阅相关的描述说明,并申请业务表的访

41、问权限。DB4201/T 536.22017 19 数据提供方数据中心开始分配交换区结束配置、测试FTP上传文件导入测试成功发布提交自身业务表相关信息(线下)图8 数据库注册、发布流程图(FTP 文件上传模式)6.4.1.2 数据库业务表订阅、授权流程 各数据需求方通过共享信息服务系统统一提出申请,由数据中心管理员审核授权对所选数据库业务表进行访问。具体工作流程如图 9 所示,订阅授权包括以下 4 个环节:a)申请:各数据需求方通过共享信息服务系统统一提出对已发布数据库业务表的访问申请;b)审核:由平台中心对各数据需求方的数据库业务表订阅请求进行审核;c)授权:为各数据需求方授权相应的数据库业

42、务表访问权限;d)配置、测试:数据中心管理员配合各数据需求方配置、测试查询数据库业务表数据功能,保证需求方成功获取所需的业务表数据。DB4201/T 536.22017 20 数据需求方数据中心开始分配访问权限结束审核订阅申请配置、测试选择所需数据库业务表通过测试成功提出订阅申请提交审核不通过 图9 数据库业务表订阅、授权流程图 6.4.2 技术要求 6.4.2.1 建表规范 创建前置交换区表结构需遵循以下规范:a)前置交换区数据库类型目前暂定为 Oracle,所有业务表均建成“周期快照事实”,后续可根据实际需要扩展其他类型格式的数据库;b)业务表数据的更新周期若为每天,且每周期全量数据量小于

43、 100 万条,需要按月份分表,按周期分区。每个分区内含本周期全量数据,历史表数据保留半年(例如:8 月 1 日,清空当年 1月份历史数据);c)业务表数据的更新周期若为每天,且每周期全量数据量大于 100 万条,需要按周期分表,不需要分区。每个表内含本周期全量数据,历史表数据根据存储情况制定保留方案;DB4201/T 536.22017 21 d)业务表数据的更新周期若大于每天小于等于每月,且每周期全量数据量小于 100 万条,需要按月分表,按周期分区。每个分区内含该周期全量数据,历史表数据保留半年(例如:8 月 1 日,清空当年 1 月份历史数据);e)业务表数据的更新周期若大于每天小于等

44、于每月,且每周期全量数据量大于 100 万条,需要按月份分表,按周期分区。每个分区内含该周期全量数据,历史表数据根据存储情况制定保留方案;f)业务表数据的更新周期若大于每月,需要按周期分表,不需要分区。每个表内含该周期全量数据,历史表数据根据存储情况制定保留方案;g)每张业务表中新增时间戳字段(insert_time,以下简称“时间戳”),用于记录每条数据的更新传输时间。字段具体的赋值方式详见后文各更新传输数据模式规范中描述介绍;h)每个行政主管部门前置交换区创建一张更新传输数据记录表(以下简称“更新记录表”),用于保存该行政主管部门前置交换区每次更新传输数据的相关信息,包括:更新传输时间等。

45、表内各字段具体的赋值方式详见各更新传输数据模式规范中的描述介绍。6.4.2.2 提供方规范 6.4.2.2.1 数据库配置参数示例 数据中心管理员为每个提供方分配前置交换区数据库,建立相应表结构时,需要各数据提供方按附录 B 表 B.3 示例出示的相关参数填写。6.4.2.2.2 数据库配置参数说明 结合上述数据库配置参数示例,各参数要求如下:a)提供方名称 定义:描述提供数据库信息的单位名称 注解:必选项;最大出现次数为 1 b)数据库名称 定义:描述数据提供方业务数据库英文名称 注解:必选项;最大出现次数为 1 c)数据库类型 定义:描述数据提供方业务数据库类型,目前支持数据库类型为主流数

46、据库和国产数据库,后续可根据实际需要扩展其他类型格式的数据库 注解:必选项;最大出现次数为 1 d)数据库 IP 地址 定义:描述提供方业务数据库 IP 地址 注解:必选项;最大出现次数为 1 e)数据库 MAC 地址 定义:描述提供方业务数据库 MAC 地址 注解:可选项;最大出现次数为 1 f)端口 定义:描述提供方业务数据库对应端口内容 注解:必选项;最大出现次数为 1 g)用户名 定义:描述访问提供方业务数据库时需登录的用户名 DB4201/T 536.22017 22 注解:必选项;最大出现次数为 1 h)密码 定义:描述访问提供方业务数据库时需登录的密码 注解:必选项;最大出现次数

47、为 1 i)技术联系人 定义:负责数据接口对接调试工作技术人员姓名 注解:必选项;最大出现次数为 1 j)联系人电话 定义:负责数据接口对接调试工作技术人员的手机号码或座机号码 注解:必选项;最大出现次数为 1 k)业务表信息 定义:描述提供方数据库各业务表的相关信息,包含业务表名称、业务表说明、业务表更新频率、业务表当前记录数、业务表每周期更新数据量、业务表数据保存周期六个子属性,以下逐一介绍 注解:必选项;最大出现次数为 N 1)业务表名称 定义:描述数据库业务表英文名称 注解:必选项;最大出现次数为 1 2)业务表说明 定义:数据库业务表存储内容及含义的中文概要说明 注解:必选项;最大出

48、现次数为 1 3)业务表更新频率 定义:描述数据库业务表数据的更新频率周期(天、周、月、年)注解:必选项;最大出现次数为 1 4)业务表当前记录数 定义:描述数据库业务表当前数据量,为分配前置交换区做参考依据 注解:必选项;最大出现次数为 1 5)业务表每周期更新数据量 定义:描述数据库业务表每个更新周期内变动的数据量,为分配前置交换区做参考依据 注解:必选项;最大出现次数为 1 6)业务表数据保存周期 定义:描述数据库业务表数据保存周期,为分配前置交换区做参考依据 注解:必选项;最大出现次数为 1 l)业务表字段信息 定义:描述数据库业务表各字段相关信息,包含字段名称、字段描述、字段类型 3

49、 个子属性,以下逐一介绍 注解:必选项;最大出现次数为 N 1)字段名称 定义:描述业务表字段英文名称 注解:必选项;最大出现次数为 1 2)字段描述 定义:描述业务表字段含义及说明 注解:必选项;最大出现次数为 1 DB4201/T 536.22017 23 3)字段类型 定义:描述业务表字段存储时对应的数据类型 注解:必选项;最大出现次数为 1 6.4.2.2.3 定时抓取模式规范 采用共享信息服务系统“定时抓取”各数据提供方数据库业务表数据信息方式时,结合数据库配置参数示例,需各数据提供方提供数据库属性包括:数据库 IP 地址、端口、数据库名、用户名、密码、业务表信息、业务表字段信息,属

50、性具体说明参照 6.4.2.2.2 章节中的相关描述说明。在本模式下,各业务表的“时间戳”字段和“更新记录表”内容由共享信息服务系统在抓取数据时自动赋值。6.4.2.2.4 定时推送模式规范 采用各数据提供方“定时推送”自身数据库业务表数据信息至共享信息服务系统方式时,需各数据提供方提供数据库属性包括:数据库名称、业务表信息、业务表字段信息,属性具体说明参照 6.4.2.2.2章节中的相关描述说明。在本模式下,各数据提供方推送数据至前置交换区时,需要向各业务表的“时间戳”字段和“更新记录表”进行赋值。6.4.2.2.5 FTP 文件上传模式规范 采用各数据提供方通过 FTP 文件上传方式将自身

展开阅读全文
相似文档                                   自信AI助手自信AI助手
猜你喜欢                                   自信AI导航自信AI导航
搜索标签

当前位置:首页 > 行业资料 > 其他

移动网页_全站_页脚广告1

关于我们      便捷服务       自信AI       AI导航        获赠5币

©2010-2024 宁波自信网络信息技术有限公司  版权所有

客服电话:4008-655-100  投诉/维权电话:4009-655-100

gongan.png浙公网安备33021202000488号   

icp.png浙ICP备2021020529号-1  |  浙B2-20240490  

关注我们 :gzh.png    weibo.png    LOFTER.png 

客服