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

ICS01.040.35CCSL72ICS01.040.35CCSL72福 建 省 地 方 标 准DB35/T2146—2023政务数据汇聚推送接口配置Governmentaldataingestion—Datapushinterfaceprofile20232023102520240125福建省市场监督管理局发布目 次前言 II1范围 12规范性引用文件 13术语和定义 14缩略语 15推送服务 25.1概述 25.2服务描述 2SM2公钥交换 2用户身份验证 2SM4密钥获取 25.6数据推送 26传输协议 3附录A（规范性）推送接口配置参数 4附录B（资料性）推送服务示例 7参考文献参考文献 9前 言本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由数字中国研究院（福建）提出。本文件由福建省信息化标准化技术委员会（SAFJ/TC11）归口。本文件起草单位：数字中国研究院（福建）、福建理工大学、福州福大经纬信息科技有限公司、福建省标准化研究院、福州大学。本文件主要起草人：余劲松弟、涂平、佟瑞菊、吴升、王洪庆、文芳。政务数据汇聚推送接口配置范围本文件规定了政务数据汇聚推送接口配置的推送服务和传输协议。本文件适用于政务数据汇聚推送接口的开发、测试和应用。（GB/T32907信息安全技术SM4分组密码算法GB/T35276信息安全技术SM2密码算法使用规范DB35/T1777政务数据汇聚：数据集的规范化描述DB35/T1884政务数据汇聚核心接口描述3术语和定义3术语和定义DB35/T1884界定的以及下列术语和定义适用于本文件。3.1接口配置interfaceprofile基于相关规范的接口定制。3.2推送服务pushservice将相关信息推送到政务数据汇聚指定接口地址的相关操作。4缩略语下列缩略语适用于本文件。ECB（ElectronicCodebook）FTP（FileTransferProtocol）GDI：政务数据汇聚（GovernmentalDataIngestion）GUID：全局唯一标识符（GloballyUniqueIdentifier）JSON：JavaScript对象表示法（JavaScriptObjectNotation）KVP：键值对（KeyValuePair）PKCS：公钥加密标准（PublicKeyCryptographyStandards）SOAP：简单对象访问协议（SimpleObjectAccessProtocol）WSDL：Web服务描述语言（WebServicesDescriptionLanguage）XML：可扩展标记语言（ExtensibleMarkupLanguage）XSD：可扩展标记语言模式定义（XMLSchemaDefinition）概述推送服务包括但不限于服务描述、SM2公钥交换、用户身份验证、SM4密钥获取和数据推送等操作。采用DB35/T1884规定的服务描述配置请求参数。采用DB35/T1884规定的服务描述定制返回结果，包括接口地址、支持协议、二进制字段编码和每次推送的最大记录数，并应符合附录A中表A.1的规定。SM2接口对接前，默认按GB/T35276生成SM2密钥对，进行公钥交换。SM2SM2AA.2的B.1注：将生成的SM2公钥进行Base64编码，用于存储和交换。在推送前，应根据提供的用户名、密码调用身份验证接口，获取身份验证字符串。A.3B的B.2GUI2AA12D-08-57B4-43E8380BA“ERRERR用户身份验证请求参数及返回结果默认采用GB/T35276规定的SM2公钥加密传输。SM4GUIDSMGB/T32907SM4GUIDA中表A.4的规定，示例见附录B的B.3。默认采用GB/T35276规定的SM2交换传输SM4密钥。SM4密钥有效期宜默认设为24小时。通过调用WebService接口，将数据推送到服务描述返回的接口地址,并接受返回值。推送参数包括服务名称、版本号、数据推送操作、数据集、验证字符串和扩展参数，应符合附录A中表A.5的规定，示例见附录B的B.4。数据集每一条数据记录应包含新增、删除、修改等操作类型，对应的标签属性分别为add、delete和update。数据集采用XML格式，按DB35/T1777进行描述。flag和msgflagtruefalsemsAA.XGB/T32907规定的SM4PKCS5Padding。如需指定JSON等其它消息格式，应与本文件保持一致。推送服务宜采用HTTPKVP、FTP、SOAP等传输协议，默认采用SOAP协议。推送服务的WSDL的请求语法如下：:port/path?wsdl表A.2表A.2SM2表A.3用户身份验证请求配置参数附录A（）表A.1～表A.6SM2表A.1服务描述返回结果信息名称英文名短名定义数据类型值域多重性接口地址InterfaceAddressiaddress推送服务的接口地址XMLXML元素—支持协议SupportedProtocolsprotocol推送服务的传输协议字符串{HTTPKVP,FTP,SOAP,other}1:N二进制字段编码BlobEncodingbencoding推送数据中二进制字段的编码字符串{ASCII,UTF-8,Decimal,Hexadecimal,Base64,其它}，默认采用Base641:1每次推送最大记录数MaxRecordsmrecords每次推送的最大记录数量整型默认5001:1注：0:10:N表示必选且具有多重性。名称英文名短名定义数据类型值域多重性服务Serviceservice服务名称字符串GDI1:1版本号Versionversion服务版本号字符串m.n.k，如：1.0.01:1操作OperationoperationSM2公钥请求操作字符串GetSM2Key1:1名称英文名短名定义数据类型值域多重性服务Serviceservice服务名称字符串GDI1:1版本号Versionversion服务版本号字符串m.n.k，如：1.0.01:1操作Operationoperation用户身份验证操作字符串UserAuthentication1:1用户名UserIDuid用户名字符串自由文本,无特殊字符1:1表A.6数据推送返回结果格式及代码说明表A.3用户身份验证请求配置参数（续）名称英文名短名定义数据类型值域多重性用户密码UserPasswordupasswd用户密码字符串字母加数字或符号的组合，不能单独使用数字、字母或字符，长度不小于8位1:1表A.4SM4密钥获取请求配置参数名称英文名短名定义数据类型值域多重性服务Serviceservice服务名称字符串GDI1:1版本号Versionversion服务版本号字符串m.n.k，如：1.0.01:1操作OperationoperationSM4密钥获取操作字符串GetSM4Key1:1GUID验证字符串GUIDguid身份验证字符串字符串自由文本1:1表A.5数据推送请求配置参数名称英文名短名定义数据类型值域多重性服务Serviceservice服务名称字符串GDI1:1版本号Versionversion服务版本号字符串m.n.k，如：1.0.01:1操作Operationoperation数据推送操作字符串PushData1:1数据集Datasetdataset数据集按DB35/T1777描述数据默认XML1:1验证字符串VerifyingStringguid返回的验证字符串字符串GUID类型1:1扩展参数ParameterExtensionpextension数据请求的参数extension0:1状态代码代码说明00操作成功01XML格式不正确02数据库操作失败：具体错误信息03guid已过期04目录中不存在主键，无法删除表A.6数据推送返回结果格式及代码说明（续）状态代码代码说明05每次推送数据不能超过最大记录数注：返回结果格式如下：<?xmlversion="1.0"encoding="utf-8"?><Response><flag>{true,false}</flag><!--操作结果标识--><msg>状态代码，代码说明</msg><!--错误详细信息，具体如下：-->......</Response>附录B（）SM2操作名：SM2公钥获取请求SOAP请求：<?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>操作名：汇聚用户身份验证请求操作名：汇聚用户身份验证请求SOAP请求：<?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密钥获取请求SOAP请求：<?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>操作名：数据推送SOAP请求：<?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