DB35-T 2146-2023 政務(wù)數(shù)據(jù)匯聚 推送接口配置

CCS

35

ingestion

push

profile

目 次

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

II

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

前言GB/T

部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定本文件由福建省信息化標(biāo)準(zhǔn)化技術(shù)委員會(huì)（

本文件起草單位：數(shù)字中國(guó)研究院（福建）、福建理工大學(xué)、福州福大經(jīng)緯信息科技有限公司、建省標(biāo)準(zhǔn)化研究院、福州大學(xué)DB35/T

2146—2023 1 范圍本文件規(guī)定了政務(wù)數(shù)據(jù)匯聚推送接口配置的推送服務(wù)和傳輸協(xié)議。本文件適用于政務(wù)數(shù)據(jù)匯聚推送接口的開發(fā)、測(cè)試和應(yīng)用。2規(guī)范性引用文件文件。GB/T

32907 信息安全技術(shù)

分組密碼算法GB/T

35276 信息安全技術(shù)

密碼算法使用規(guī)范DB35/T

1777 政務(wù)數(shù)據(jù)匯聚：數(shù)據(jù)集的規(guī)范化描述DB35/T

1884 政務(wù)數(shù)據(jù)匯聚

核心接口描述3 術(shù)語和定義DB35/T

1884界定的以及下列術(shù)語和定義適用于本文件。3.1接口配置 interface

基于相關(guān)規(guī)范的接口定制。3.2推送服務(wù) push

service將相關(guān)信息推送到政務(wù)數(shù)據(jù)匯聚指定接口地址的相關(guān)操作。4 縮略語下列縮略語適用于本文件。ECB：電子密碼本（

Codebook）FTP：文件傳輸協(xié)議（File

Transfer

Protocol）GDI：政務(wù)數(shù)據(jù)匯聚（Governmental

Data

Ingestion）GUID：全局唯一標(biāo)識(shí)符（Globally

Unique

）JSON：JavaScript對(duì)象表示法（JavaScript

Notation）KVP：鍵值對(duì)（

Value

Pair）PKCS：公鑰加密標(biāo)準(zhǔn)（

Cryptography

）SOAP：簡(jiǎn)單對(duì)象訪問協(xié)議（Simple

Access

Protocol）WSDL：Web服務(wù)描述語言（Web

Services

Language）XML：可擴(kuò)展標(biāo)記語言（

）DB35/T

2146—2023XSD：可擴(kuò)展標(biāo)記語言模式定義（XML

Schema

）5 推送服務(wù)5.1概述推送服務(wù)包括但不限于服務(wù)描述、公鑰交換、用戶身份驗(yàn)證、密鑰獲取和數(shù)據(jù)推送等操作。5.2 服務(wù)描述采用DB35/T

1884規(guī)定的服務(wù)描述配置請(qǐng)求參數(shù)。采用DB35/T

1884規(guī)定的服務(wù)描述定制返回結(jié)果，包括接口地址、支持協(xié)議、二進(jìn)制字段編碼和每次推送的最大記錄數(shù)，并應(yīng)符合附錄AA.1的規(guī)定。5.3 SM2

公鑰交換接口對(duì)接前，默認(rèn)按GB/T

35276生成密鑰對(duì)，進(jìn)行公鑰交換。SM2SM2AA.2附錄B的B.1。SM2Base645.4 用戶身份驗(yàn)證在推送前，應(yīng)根據(jù)提供的用戶名、密碼調(diào)用身份驗(yàn)證接口，獲取身份驗(yàn)證字符串。合附錄AA.3的規(guī)定，示例見附錄B的?！坝脩羯矸蒡?yàn)證成功的返回結(jié)果為GUID2AAA12CD-008F-4571-BB48-43FE83780BDA”；“身份驗(yàn)證失敗，應(yīng)返回失敗內(nèi)容，格式為“ERR:具體原因”，如“ERR:賬號(hào)不存在！”。用戶身份驗(yàn)證請(qǐng)求參數(shù)及返回結(jié)果默認(rèn)采用GB/T

規(guī)定的公鑰加密傳輸。5.5 SM4

密鑰獲取GUID驗(yàn)證字符串獲取SM４密鑰，SM４密鑰應(yīng)符合GB/T

32907。SM4GUIDA中表B的。默認(rèn)采用GB/T

35276規(guī)定的SM2交換傳輸密鑰。SM4密鑰有效期宜默認(rèn)設(shè)為24小時(shí)。5.6 數(shù)據(jù)推送通過調(diào)用

接口，將數(shù)據(jù)推送到服務(wù)描述返回的接口地址,并接受返回值。推送參數(shù)包括服務(wù)名稱、版本號(hào)、數(shù)據(jù)推送操作、數(shù)據(jù)集、驗(yàn)證字符串和擴(kuò)展參數(shù)，應(yīng)符合附錄A中表B的。數(shù)據(jù)集每一條數(shù)據(jù)記錄應(yīng)包含新增、刪除、修改等操作類型，對(duì)應(yīng)的標(biāo)簽屬性分別為add、和update。數(shù)據(jù)集采用格式，按DB35/T

1777進(jìn)行描述。推送返回值包含flag和節(jié)點(diǎn)。flag的值為trueflag為false??；msgAA.6推送請(qǐng)求配置參數(shù)及返回結(jié)果默認(rèn)采用GB/T

32907規(guī)定的SM4充模式默認(rèn)采用PKCS5Padding。DB35/T

2146—2023如需指定JSON等其它消息格式，應(yīng)與本文件保持一致。6傳輸協(xié)議推送服務(wù)宜采用HTTP

KVP、FTP、SOAP等傳輸協(xié)議，默認(rèn)采用SOAP協(xié)議。推送服務(wù)的WSDL的請(qǐng)求語法如下：: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（規(guī)范性）推送接口配置參數(shù)表A.1～表分別為服務(wù)描述返回結(jié)果信息、SM2SM4密鑰獲取請(qǐng)求配置參數(shù)、數(shù)據(jù)推送請(qǐng)求配置參數(shù)和數(shù)據(jù)推送返回結(jié)果格式及代碼說明。表A.1

服務(wù)描述返回結(jié)果信息表A.1

服務(wù)描述返回結(jié)果信息表A.2

SM2

公鑰請(qǐng)求配置參數(shù)表A.3

用戶身份驗(yàn)證請(qǐng)求配置參數(shù)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

用戶身份驗(yàn)證請(qǐng)求配置參數(shù)表

A.3

用戶身份驗(yàn)證請(qǐng)求配置參數(shù)（續(xù)）表A.4

SM4

密鑰獲取請(qǐng)求配置參數(shù)表A.5

數(shù)據(jù)推送請(qǐng)求配置參數(shù)表A.6

數(shù)據(jù)推送返回結(jié)果格式及代碼說明05<?xml

encoding="utf-8"?><Response><flag>{true,false}</flag><!--<msg>狀態(tài)代碼代碼說明</msg><!----></Response>DB35/T

2146—2023表表

A.6

數(shù)據(jù)推送返回結(jié)果格式及代碼說明（續(xù)）DB35/T

2146—2023附 錄 B（資料性）推送服務(wù)示例B.1 SM2

公鑰請(qǐng)求示例操作名：公鑰獲取請(qǐng)求SOAP請(qǐng)求：<?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 用戶身份驗(yàn)證請(qǐng)求示例操作名：匯聚用戶身份驗(yàn)證請(qǐng)求SOAP請(qǐng)求：<?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

密鑰獲取請(qǐng)求示例操作名：密鑰獲取請(qǐng)求SOAP請(qǐng)求：<?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 數(shù)據(jù)推送請(qǐng)求示例操作名：數(shù)據(jù)推送SOAP請(qǐng)求：<?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進(jìn)行描述<gdi:guid>2AAA12CD-008F-4571-BB48-43FE83780BDA</gdi:guid>><gdi:pextension/></gdi:requestParameters></gdi:PushData></soapenv:Body>