ICS 01.040.35 CCS L 72 35 福建省 地方标准 DB35/T 2146—2023 政务数据汇聚 推送接口配置 Governmental data ingestion — Data push interface profile 2023 - 10 - 25发布 2024 - 01 - 25实施 福建省市场监督管理局 发布 DB35/T 2146 —2023 I 目次 前言 ................................ ................................ ................. II 1 范围 ................................ ................................ ............... 1 2 规范性引用文件 ................................ ................................ ..... 1 3 术语和定义 ................................ ................................ ......... 1 4 缩略语 ................................ ................................ ............. 1 5 推送服务 ................................ ................................ ........... 2 概述 ................................ ................................ ........... 2 5.1 服务描述 ................................ ................................ ....... 2 5.2 SM2公钥交换 ................................ ................................ .... 2 5.3 用户身份验证 ................................ ................................ ... 2 5.4 SM4密钥获取 ................................ ................................ .... 2 5.5 数据推送 ................................ ................................ ....... 2 5.6 6 传输协议 ................................ ................................ ........... 3 附录A（规范性） 推送接口配置参数 ................................ ..................... 4 附录B（资料性） 推送服务示例 ................................ ......................... 7 参考文献 ................................ ................................ .............. 9 DB35/T 2146 —2023 II 前言 本文件按照 GB/T 1.1 —2020《标准化工作导则 第1部分：标准化文件的结构和起草规则》的规定 起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。 本文件由数字中国研究院（福建）提出。 本文件由福建省信息化标准化技术委员会 （SAFJ/TC 11 ）归口。 本文件起草单位：数字中国研究院（福建）、 福建理工大 学、福州福大经纬信息科技有限公司、 福建省标准化研究院、福州大学。 本文件主要起草人：余劲松弟、涂平、佟瑞菊、吴升、王洪庆、文芳。 DB35/T 2146 —2023 1 政务数据汇聚 推送接口配置 1 范围 本文件规定了政务数据汇聚推送接口配置的推送服务和传输协议。 本文件适用于政务数据汇聚推送接口的开发、测试和应用。 2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。 其中， 注日期的引用文件， 仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本 文件。 GB/T 32907 信息安全技术 SM4分组密码算法 GB/T 35276 信息安全技术 SM2密码算法使用规范 DB35/T 1777 政务数据汇聚 ：数据集的规范化描述 DB35/T 1884 政务数据汇聚 核心接口描述 3 术语和定义 DB35/T 1884 界定的以及下列术语和定义适用于本文件。 3.1 接口配置 interface profile 基于相关规范的接口定制。 3.2 推送服务 push service 将相关信息推送到政务数据汇聚指定接口地址的相关操作。 4 缩略语 下列缩略语适用于本 文件。 ECB：电子密码本（ Electronic Codebook ） FTP：文件传输协议（ File Transfer Protocol ） GDI：政务数据汇聚（ Governmental Data Ingestion ） GUID：全局唯一标识符（ Globally Unique Identifier ） JSON：JavaScript 对象表示法 （JavaScript Object Notation ） KVP：键值对（ Key Value Pair ） PKCS：公钥加密标准（ Public Key Cryptography Standards ） SOAP：简单对象访问协议（ Simple Object Access Protocol ） WSDL：Web服务描述语言（ Web Services Description Language ） XML：可扩展标记语言 （Extensible Markup Language ） DB35/T 2146 —2023 2 XSD：可扩展标记语言 模式定义（ XML Schema Definition ） 5 推送服务 概述 5.1 推送服务包括但不限于服务描述、 SM2公钥交换、用户身份验证、 SM4密钥获取和数据推送等操作。 服务描述 5.2 采用DB35/T 1884 规定的服务描述配置 请求参数。 采用DB35/T 1884 规定的服务描述定制返回结果，包括接口地址、支持协议、二进制字段编码和每 次推送的最大记录数，并应符合附录 A中表A.1的规定。 SM2公钥交换 5.3 接口对接前，默认按 GB/T 35276 生成SM2密钥对，进行公钥交换。 SM2公钥请求配置参数服务名称、版本号、 SM2公钥请求操作， 应符合附录 A中表A.2的规定，示例见 附录B的B.1。 注： 将生成的 SM2公钥进行 Base64编码，用于存储和交换。 用户身份验证 5.4 在推送前，应根据提供的用户名、密码调用身份验证接口，获取身份验证字符串。 用户身份验证请求配置参数包括服务名称、版本号、用户身份验证操作、用户名和用户密码，应符 合附录A中表A.3的规定，示例见附录 B的B.2。 用户身份验证成功的返回结果为 GUID验证字符串， 如： “ 2AAA12CD -008F-4571-BB48-43FE83780BDA ”； 身份验证失败，应返回失败内容，格式为“ ERR:具体原因”，如“ ERR:账号不存在！”。 用户身份验证请求参数及返回结果默认采用 GB/T 35276 规定的SM2公钥加密传输。 SM4密钥获取 5.5 在推送前， 应根据用户身份验证得到的 GUID验证字符串获取 SM４密钥，SM４密钥应符合 GB/T 32907 。 SM4密钥获取请求配置参数包括服务名称、版本号、密钥获取操作、 GUID验证字符串，应符合附录 A 中表A.4的规定，示例见附录 B的B.3。 默认采用 GB/T 35276规定的SM2交换传输 SM4密钥。 SM4密钥有效期宜默认设为 24小时。 数据推送 5.6 通过调用 Web Service 接口，将数据推送到服务描述返回的接口地址 ,并接受返回值。 推送参数包括服务名称、版本号、数据推送操作、数据集、验证字符串和扩展参数，应符合附录 A 中表A.5的规定，示例见附录 B的B.4。 数据集每一条数据记录应包含新增、删除、修改等操作类型，对应的标签属性分别为 add、delete 和update。数据集采用 XML格式，按 DB