DB35-T 2146-2023 政务数据汇聚 推送接口配置

CCS

35

ingestion

push

profile

目 次

.................................................................................

II

...............................................................................

.....................................................................

.........................................................................

.............................................................................

...........................................................................

...........................................................................

.......................................................................

....................................................................

...................................................................

....................................................................

.......................................................................

...........................................................................

.....................................................

.........................................................

..............................................................................

前言GB/T

部分：标准化文件的结构和起草规则》的规定本文件由福建省信息化标准化技术委员会（

本文件起草单位：数字中国研究院（福建）、福建理工大学、福州福大经纬信息科技有限公司、建省标准化研究院、福州大学DB35/T

2146—2023 1 范围本文件规定了政务数据汇聚推送接口配置的推送服务和传输协议。本文件适用于政务数据汇聚推送接口的开发、测试和应用。2规范性引用文件文件。GB/T

32907 信息安全技术

分组密码算法GB/T

35276 信息安全技术

密码算法使用规范DB35/T

1777 政务数据汇聚：数据集的规范化描述DB35/T

1884 政务数据汇聚

核心接口描述3 术语和定义DB35/T

1884界定的以及下列术语和定义适用于本文件。3.1接口配置 interface

基于相关规范的接口定制。3.2推送服务 push

service将相关信息推送到政务数据汇聚指定接口地址的相关操作。4 缩略语下列缩略语适用于本文件。ECB：电子密码本（

Codebook）FTP：文件传输协议（File

Transfer

Protocol）GDI：政务数据汇聚（Governmental

Data

Ingestion）GUID：全局唯一标识符（Globally

Unique

）JSON：JavaScript对象表示法（JavaScript

Notation）KVP：键值对（

Value

Pair）PKCS：公钥加密标准（

Cryptography

）SOAP：简单对象访问协议（Simple

Access

Protocol）WSDL：Web服务描述语言（Web

Services

Language）XML：可扩展标记语言（

）DB35/T

2146—2023XSD：可扩展标记语言模式定义（XML

Schema

）5 推送服务5.1概述推送服务包括但不限于服务描述、公钥交换、用户身份验证、密钥获取和数据推送等操作。5.2 服务描述采用DB35/T

1884规定的服务描述配置请求参数。采用DB35/T

1884规定的服务描述定制返回结果，包括接口地址、支持协议、二进制字段编码和每次推送的最大记录数，并应符合附录AA.1的规定。5.3 SM2

公钥交换接口对接前，默认按GB/T

35276生成密钥对，进行公钥交换。SM2SM2AA.2附录B的B.1。SM2Base645.4 用户身份验证在推送前，应根据提供的用户名、密码调用身份验证接口，获取身份验证字符串。合附录AA.3的规定，示例见附录B的。“用户身份验证成功的返回结果为GUID2AAA12CD-008F-4571-BB48-43FE83780BDA”；“身份验证失败，应返回失败内容，格式为“ERR:具体原因”，如“ERR:账号不存在！”。用户身份验证请求参数及返回结果默认采用GB/T

规定的公钥加密传输。5.5 SM4

密钥获取GUID验证字符串获取SM４密钥，SM４密钥应符合GB/T

32907。SM4GUIDA中表B的。默认采用GB/T

35276规定的SM2交换传输密钥。SM4密钥有效期宜默认设为24小时。5.6 数据推送通过调用

接口，将数据推送到服务描述返回的接口地址,并接受返回值。推送参数包括服务名称、版本号、数据推送操作、数据集、验证字符串和扩展参数，应符合附录A中表B的。数据集每一条数据记录应包含新增、删除、修改等操作类型，对应的标签属性分别为add、和update。数据集采用格式，按DB35/T

1777进行描述。推送返回值包含flag和节点。flag的值为trueflag为false败；msgAA.6推送请求配置参数及返回结果默认采用GB/T

32907规定的SM4充模式默认采用PKCS5Padding。DB35/T

2146—2023如需指定JSON等其它消息格式，应与本文件保持一致。6传输协议推送服务宜采用HTTP

KVP、FTP、SOAP等传输协议，默认采用SOAP协议。推送服务的WSDL的请求语法如下：:port/path?wsdlInterfaceAddressiaddressXMLXMLSupportedProtocolsprotocol{HTTP

FTP,

other}1:NBlob

Encodingbencoding{ASCII,

UTF-8,Decimal,Hexadecimal,Base64,

Base641:1Max

Recordsmrecords5001:10:10:NServiceserviceGDI1:1Versionversionm.n.k1:1Operationoperation1:1User

IDuid1:1ServiceserviceGDI1:1Versionversionm.n.k1:1OperationoperationSM2GetSM2Key1:1DB35/T

2146—2023附录 A（规范性）推送接口配置参数表A.1～表分别为服务描述返回结果信息、SM2SM4密钥获取请求配置参数、数据推送请求配置参数和数据推送返回结果格式及代码说明。表A.1

服务描述返回结果信息表A.1

服务描述返回结果信息表A.2

SM2

公钥请求配置参数表A.3

用户身份验证请求配置参数ServiceserviceGDI1:1Versionversionm.n.k1.0.01:1OperationoperationPushData1:1DatasetdatasetDB35/T

1777XML1:1VerifyingStringguidGUID1:1ParameterExtensionpextensionextension0:1ServiceserviceGDI1:1Versionversionm.n.k1:1OperationoperationSM4GetSM4Key1:1GUIDGUIDguid1:10001XML0203guid04User

Passwordupasswd1:1DB35/T

2146—2023表

A.3

用户身份验证请求配置参数表

A.3

用户身份验证请求配置参数（续）表A.4

SM4

密钥获取请求配置参数表A.5

数据推送请求配置参数表A.6

数据推送返回结果格式及代码说明05<?xml

encoding="utf-8"?><Response><flag>{true,false}</flag><!--<msg>状态代码代码说明</msg><!----></Response>DB35/T

2146—2023表表

A.6

数据推送返回结果格式及代码说明（续）DB35/T

2146—2023附 录 B（资料性）推送服务示例B.1 SM2

公钥请求示例操作名：公钥获取请求SOAP请求：<?xml

version="1.0"

<soapenv:Envelope

:port/path/All.xsd"xmlns:xsi="/2001/XMLSchema-instance"xmlns:gdi=":port/path/1.0"xmlns:soapenv="/soap/envelope/"><soapenv:Header/><soapenv:Body><gdi:

GetSM2Key

version="1.0.0"/></soapenv:Body></soapenv:Envelope>B.2 用户身份验证请求示例操作名：汇聚用户身份验证请求SOAP请求：<?xml

version="1.0"

<soapenv:Envelope

:port/path/All.xsd"xmlns:xsi="/2001/XMLSchema-instance"xmlns:gdi=":port/path/1.0"xmlns:soapenv="/soap/envelope/"><soapenv:Header/><soapenv:Body><gdi:UserAuthentication

version="1.0.0"><gdi:requestParameters><gdi:uid>test</gdi:uid><gdi:upasswd>********</gdi:upasswd>></gdi:requestParameters></gdi:UserAuthentication></soapenv:Body></soapenv:Envelope>B.3 SM4

密钥获取请求示例操作名：密钥获取请求SOAP请求：<?xml

version="1.0"

DB35/T

2146—2023<soapenv:Envelope

xsi:schemaLocation=":port/path?:port/path/All.xsd"xmlns:xsi="/2001/XMLSchema-instance"xmlns:gdi=":port/path/1.0"xmlns:soapenv="/soap/envelope/"><soapenv:Header/><soapenv:Body><gdi:

GetSM4Key

version="1.0.0"><gdi:requestParameters><gdi:guid></gdi:guid></gdi:requestParameters></gdi:GetSM4Key></soapenv:Body></soapenv:Envelope>B.4 数据推送请求示例操作名：数据推送SOAP请求：<?xml

version="1.0"

<soapenv:Envelope

:port/path/All.xsd"xmlns:xsi="/2001/XMLSchema-instance"xmlns:gdi=":port/path/1.0"xmlns:soapenv="/soap/envelope/"><soapenv:Header/><soapenv:Body><gdi:PushData

version="1.0.0"><gdi:requestParameters><gdi:dataset>XML格式，按DB35/T

1777进行描述<gdi:guid>2AAA12CD-008F-4571-BB48-43FE83780BDA</gdi:guid>><gdi:pextension/></gdi:requestParameters></gdi:PushData></soapenv:Body>