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

ICS01.040.35CCSL72ICS01.040.35CCSL72福 建 省 地 方 標(biāo) 準(zhǔn)DB35/T2146—2023政務(wù)數(shù)據(jù)匯聚推送接口配置Governmentaldataingestion—Datapushinterfaceprofile20232023102520240125福建省市場(chǎng)監(jiān)督管理局發(fā)布目 次前言 II1范圍 12規(guī)范性引用文件 13術(shù)語(yǔ)和定義 14縮略語(yǔ) 15推送服務(wù) 25.1概述 25.2服務(wù)描述 2SM2公鑰交換 2用戶身份驗(yàn)證 2SM4密鑰獲取 25.6數(shù)據(jù)推送 26傳輸協(xié)議 3附錄A（規(guī)范性）推送接口配置參數(shù) 4附錄B（資料性）推送服務(wù)示例 7參考文獻(xiàn)參考文獻(xiàn) 9前 言本文件按照GB/T1.1—2020《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定起草。請(qǐng)注意本文件的某些內(nèi)容可能涉及專利。本文件的發(fā)布機(jī)構(gòu)不承擔(dān)識(shí)別專利的責(zé)任。本文件由數(shù)字中國(guó)研究院（福建）提出。本文件由福建省信息化標(biāo)準(zhǔn)化技術(shù)委員會(huì)（SAFJ/TC11）歸口。本文件起草單位：數(shù)字中國(guó)研究院（福建）、福建理工大學(xué)、福州福大經(jīng)緯信息科技有限公司、福建省標(biāo)準(zhǔn)化研究院、福州大學(xué)。本文件主要起草人：余勁松弟、涂平、佟瑞菊、吳升、王洪慶、文芳。政務(wù)數(shù)據(jù)匯聚推送接口配置范圍本文件規(guī)定了政務(wù)數(shù)據(jù)匯聚推送接口配置的推送服務(wù)和傳輸協(xié)議。本文件適用于政務(wù)數(shù)據(jù)匯聚推送接口的開(kāi)發(fā)、測(cè)試和應(yīng)用。（GB/T32907信息安全技術(shù)SM4分組密碼算法GB/T35276信息安全技術(shù)SM2密碼算法使用規(guī)范DB35/T1777政務(wù)數(shù)據(jù)匯聚：數(shù)據(jù)集的規(guī)范化描述DB35/T1884政務(wù)數(shù)據(jù)匯聚核心接口描述3術(shù)語(yǔ)和定義3術(shù)語(yǔ)和定義DB35/T1884界定的以及下列術(shù)語(yǔ)和定義適用于本文件。3.1接口配置interfaceprofile基于相關(guān)規(guī)范的接口定制。3.2推送服務(wù)pushservice將相關(guān)信息推送到政務(wù)數(shù)據(jù)匯聚指定接口地址的相關(guān)操作。4縮略語(yǔ)下列縮略語(yǔ)適用于本文件。ECB（ElectronicCodebook）FTP（FileTransferProtocol）GDI：政務(wù)數(shù)據(jù)匯聚（GovernmentalDataIngestion）GUID：全局唯一標(biāo)識(shí)符（GloballyUniqueIdentifier）JSON：JavaScript對(duì)象表示法（JavaScriptObjectNotation）KVP：鍵值對(duì)（KeyValuePair）PKCS：公鑰加密標(biāo)準(zhǔn)（PublicKeyCryptographyStandards）SOAP：簡(jiǎn)單對(duì)象訪問(wèn)協(xié)議（SimpleObjectAccessProtocol）WSDL：Web服務(wù)描述語(yǔ)言（WebServicesDescriptionLanguage）XML：可擴(kuò)展標(biāo)記語(yǔ)言（ExtensibleMarkupLanguage）XSD：可擴(kuò)展標(biāo)記語(yǔ)言模式定義（XMLSchemaDefinition）概述推送服務(wù)包括但不限于服務(wù)描述、SM2公鑰交換、用戶身份驗(yàn)證、SM4密鑰獲取和數(shù)據(jù)推送等操作。采用DB35/T1884規(guī)定的服務(wù)描述配置請(qǐng)求參數(shù)。采用DB35/T1884規(guī)定的服務(wù)描述定制返回結(jié)果，包括接口地址、支持協(xié)議、二進(jìn)制字段編碼和每次推送的最大記錄數(shù)，并應(yīng)符合附錄A中表A.1的規(guī)定。SM2接口對(duì)接前，默認(rèn)按GB/T35276生成SM2密鑰對(duì)，進(jìn)行公鑰交換。SM2SM2AA.2的B.1注：將生成的SM2公鑰進(jìn)行Base64編碼，用于存儲(chǔ)和交換。在推送前，應(yīng)根據(jù)提供的用戶名、密碼調(diào)用身份驗(yàn)證接口，獲取身份驗(yàn)證字符串。A.3B的B.2GUI2AA12D-08-57B4-43E8380BA“ERRERR用戶身份驗(yàn)證請(qǐng)求參數(shù)及返回結(jié)果默認(rèn)采用GB/T35276規(guī)定的SM2公鑰加密傳輸。SM4GUIDSMGB/T32907SM4GUIDA中表A.4的規(guī)定，示例見(jiàn)附錄B的B.3。默認(rèn)采用GB/T35276規(guī)定的SM2交換傳輸SM4密鑰。SM4密鑰有效期宜默認(rèn)設(shè)為24小時(shí)。通過(guò)調(diào)用WebService接口，將數(shù)據(jù)推送到服務(wù)描述返回的接口地址,并接受返回值。推送參數(shù)包括服務(wù)名稱、版本號(hào)、數(shù)據(jù)推送操作、數(shù)據(jù)集、驗(yàn)證字符串和擴(kuò)展參數(shù)，應(yīng)符合附錄A中表A.5的規(guī)定，示例見(jiàn)附錄B的B.4。數(shù)據(jù)集每一條數(shù)據(jù)記錄應(yīng)包含新增、刪除、修改等操作類型，對(duì)應(yīng)的標(biāo)簽屬性分別為add、delete和update。數(shù)據(jù)集采用XML格式，按DB35/T1777進(jìn)行描述。flag和msgflagtruefalsemsAA.XGB/T32907規(guī)定的SM4PKCS5Padding。如需指定JSON等其它消息格式，應(yīng)與本文件保持一致。推送服務(wù)宜采用HTTPKVP、FTP、SOAP等傳輸協(xié)議，默認(rèn)采用SOAP協(xié)議。推送服務(wù)的WSDL的請(qǐng)求語(yǔ)法如下：:port/path?wsdl表A.2表A.2SM2表A.3用戶身份驗(yàn)證請(qǐng)求配置參數(shù)附錄A（）表A.1～表A.6SM2表A.1服務(wù)描述返回結(jié)果信息名稱英文名短名定義數(shù)據(jù)類型值域多重性接口地址InterfaceAddressiaddress推送服務(wù)的接口地址XMLXML元素—支持協(xié)議SupportedProtocolsprotocol推送服務(wù)的傳輸協(xié)議字符串{HTTPKVP,FTP,SOAP,other}1:N二進(jìn)制字段編碼BlobEncodingbencoding推送數(shù)據(jù)中二進(jìn)制字段的編碼字符串{ASCII,UTF-8,Decimal,Hexadecimal,Base64,其它}，默認(rèn)采用Base641:1每次推送最大記錄數(shù)MaxRecordsmrecords每次推送的最大記錄數(shù)量整型默認(rèn)5001:1注：0:10:N表示必選且具有多重性。名稱英文名短名定義數(shù)據(jù)類型值域多重性服務(wù)Serviceservice服務(wù)名稱字符串GDI1:1版本號(hào)Versionversion服務(wù)版本號(hào)字符串m.n.k，如：1.0.01:1操作OperationoperationSM2公鑰請(qǐng)求操作字符串GetSM2Key1:1名稱英文名短名定義數(shù)據(jù)類型值域多重性服務(wù)Serviceservice服務(wù)名稱字符串GDI1:1版本號(hào)Versionversion服務(wù)版本號(hào)字符串m.n.k，如：1.0.01:1操作Operationoperation用戶身份驗(yàn)證操作字符串UserAuthentication1:1用戶名UserIDuid用戶名字符串自由文本,無(wú)特殊字符1:1表A.6數(shù)據(jù)推送返回結(jié)果格式及代碼說(shuō)明表A.3用戶身份驗(yàn)證請(qǐng)求配置參數(shù)（續(xù)）名稱英文名短名定義數(shù)據(jù)類型值域多重性用戶密碼UserPasswordupasswd用戶密碼字符串字母加數(shù)字或符號(hào)的組合，不能單獨(dú)使用數(shù)字、字母或字符，長(zhǎng)度不小于8位1:1表A.4SM4密鑰獲取請(qǐng)求配置參數(shù)名稱英文名短名定義數(shù)據(jù)類型值域多重性服務(wù)Serviceservice服務(wù)名稱字符串GDI1:1版本號(hào)Versionversion服務(wù)版本號(hào)字符串m.n.k，如：1.0.01:1操作OperationoperationSM4密鑰獲取操作字符串GetSM4Key1:1GUID驗(yàn)證字符串GUIDguid身份驗(yàn)證字符串字符串自由文本1:1表A.5數(shù)據(jù)推送請(qǐng)求配置參數(shù)名稱英文名短名定義數(shù)據(jù)類型值域多重性服務(wù)Serviceservice服務(wù)名稱字符串GDI1:1版本號(hào)Versionversion服務(wù)版本號(hào)字符串m.n.k，如：1.0.01:1操作Operationoperation數(shù)據(jù)推送操作字符串PushData1:1數(shù)據(jù)集Datasetdataset數(shù)據(jù)集按DB35/T1777描述數(shù)據(jù)默認(rèn)XML1:1驗(yàn)證字符串VerifyingStringguid返回的驗(yàn)證字符串字符串GUID類型1:1擴(kuò)展參數(shù)ParameterExtensionpextension數(shù)據(jù)請(qǐng)求的參數(shù)extension0:1狀態(tài)代碼代碼說(shuō)明00操作成功01XML格式不正確02數(shù)據(jù)庫(kù)操作失?。壕唧w錯(cuò)誤信息03guid已過(guò)期04目錄中不存在主鍵，無(wú)法刪除表A.6數(shù)據(jù)推送返回結(jié)果格式及代碼說(shuō)明（續(xù)）狀態(tài)代碼代碼說(shuō)明05每次推送數(shù)據(jù)不能超過(guò)最大記錄數(shù)注：返回結(jié)果格式如下：<?xmlversion="1.0"encoding="utf-8"?><Response><flag>{true,false}</flag><!--操作結(jié)果標(biāo)識(shí)--><msg>狀態(tài)代碼，代碼說(shuō)明</msg><!--錯(cuò)誤詳細(xì)信息，具體如下：-->......</Response>附錄B（）SM2操作名：SM2公鑰獲取請(qǐng)求SOAP請(qǐng)求：<?xmlversion="1.0"encoding="UTF-8"?><soapenv:Envelopexsi:schemaLocation=":port/path?:port/path/All.xsd"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xmlns:gdi=":port/path/1.0"xmlns:soapenv="http://s/soap/envelope/"><soapenv:Header/><soapenv:Body><gdi:GetSM2Keyversion="1.0.0"/></soapenv:Body></soapenv:Envelope>操作名：匯聚用戶身份驗(yàn)證請(qǐng)求操作名：匯聚用戶身份驗(yàn)證請(qǐng)求SOAP請(qǐng)求：<?xmlversion="1.0"encoding="UTF-8"?><soapenv:Envelopexsi:schemaLocation=":port/path?:port/path/All.xsd"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xmlns:gdi=":port/path/1.0"xmlns:soapenv="http://s/soap/envelope/"><soapenv:Header/><soapenv:Body><gdi:UserAuthenticationversion="1.0.0"><gdi:requestParameters><gdi:uid>test</gdi:uid><gdi:upasswd>********</gdi:upasswd>></gdi:requestParameters></gdi:UserAuthentication></soapenv:Body></soapenv:Envelope>B.3SM4操作名：SM4密鑰獲取請(qǐng)求SOAP請(qǐng)求：<?xmlversion="1.0"encoding="UTF-8"?><soapenv:Envelopexsi:schemaLocation=":port/path?:port/path/All.xsd"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xmlns:gdi=":port/path/1.0"xmlns:soapenv="http://s/soap/envelope/"><soapenv:Header/><soapenv:Body><gdi:GetSM4Keyversion="1.0.0"><gdi:requestParameters><gdi:guid>2AAA12CD-008F-4571-BB48-43FE83780BDA</gdi:guid></gdi:requestParameters></gdi:GetSM4Key></soapenv:Body></soapenv:Envelope>操作名：數(shù)據(jù)推送SOAP請(qǐng)求：<?xmlversion="1.0"encoding="UTF-8"?>xmlns:xsi="http://www.xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xmlns:gdi=":port/path/1.0"xmlns:soapenv="http://s/soap/envelope/"><soape