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

CCS

35

ingestion

push

profile

目 次

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

II

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

前言GB/T

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

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

2146—2023 1 范圍本文件規(guī)定了政務(wù)數(shù)據(jù)匯聚推送接口配置的推送服務(wù)和傳輸協(xié)議。本文件適用于政務(wù)數(shù)據(jù)匯聚推送接口的開發(fā)、測試和應(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：全局唯一標識符（Globally

Unique

）JSON：JavaScript對象表示法（JavaScript

Notation）KVP：鍵值對（

Value

Pair）PKCS：公鑰加密標準（

Cryptography

）SOAP：簡單對象訪問協(xié)議（Simple

Access

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

Services

Language）XML：可擴展標記語言（

）DB35/T

2146—2023XSD：可擴展標記語言模式定義（XML

Schema

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

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

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

公鑰交換接口對接前，默認按GB/T

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

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

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

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

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

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

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

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

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

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

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

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

SM2

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

用戶身份驗證請求配置參數(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

用戶身份驗證請求配置參數(shù)表

A.3

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

SM4

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

數(shù)據(jù)推送請求配置參數(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

公鑰請求示例操作名：公鑰獲取請求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 數(shù)據(jù)推送請求示例操作名：數(shù)據(jù)推送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>