GH∕T 1349-2021 村镇综合服务信息平台数据共享技术指南(供销合作).pdf

ICS 65.020.01 CCS B05 GH 中 华 人 民 共 和 国 供 销 合 作 行 业 标 准 GH/T 13492021 村镇综合服务信息平台数据共享技术指南 Technical guidelines for data sharing of rural service information platform 2021-11-08 发布 2022-01-01 实施 中华全国供销合作总社 发 布 GH/T 13492021 I 目次 前言.II 1 范围.1 2 规范性引用文件.1 3 术语和定义.1 4 缩略语.2 5 总体框架.2 6 共享接口.3 总体要求.3 服务接口提供.3 服务接口使用.4 7 安全保障.4 运行环境安全要求.4 数据安全要求.5 传输安全要求.5 网络和硬件安全要求.5 8 平台管理及使用者要求.5 服务提供方.5 服务需求方.5 平台管理方.5 附录A （规范性）服务接口注册信息.6 附录B （规范性）服务接口申请信息.7 参考文献.8 GH/T 13492021 II 前言 本文件按照GB/T 1.12020标准化工作导则 第1部分：标准化文件的结构和起草规则的规定起草。本文件由中华全国供销合作总社提出。本文件由中华全国供销合作总社科教社团部归口。本文件起草单位：北京市农林科学院信息技术研究中心、中华全国供销合作总社北京商业机械研究所、农芯科技（北京）有限责任公司、浙农集团股份有限公司、中农立华生物科技股份有限公司、安徽辉隆农资集团股份有限公司、北京农信互联科技集团有限公司。本文件主要起草人：赵向宇，张祺，薄利军，王开义，王书锋，陈科，刘忠强，潘守慧，杨锋，于春花，夏亦涛，兰蕾，王晓锋，陈迈，卢红霞，许奕华，赵磊，于莹，韩焱云，张秋思，杨硕。GH/T 13492021 1 村镇综合服务信息平台数据共享技术指南 1 范围 本文件提供了村镇综合服务信息平台数据共享的总体框架、共享接口、安全保障和平台管理及使用者要求。本文件适用于村镇综合服务信息平台的构建、数据共享和使用，也适用于各领域村镇服务软件、系统或平台的建设、数据共享和使用。2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T 222392019 信息安全技术 网络安全等级保护基本要求 3 术语和定义 下列术语和定义适用于本文件。村镇综合服务 rural service 建立在一定社会共识基础上，旨在保障全体村镇居民生存和发展基本需求的服务，涉及村镇规划建设、村务管理、住房保障、生产服务、金融服务、商贸物流、健康医疗、教育社保、服务治理、养老防灾、就业服务、农技推广等领域。数据共享 data sharing 不同用户或不同系统按照一定的规则，使用根据协议形成的数据。数据接口 data interface 进行数据传输时，数据提供方和接收方应遵守的接口协议或规定。服务提供方 service provider 通过村镇综合服务信息平台提供村镇服务数据共享接口，且对村镇服务共享数据的真实性、完整性、正确性等负有责任的组织或个人。服务需求方 service demander 向村镇综合服务信息平台申请、经平台管理方审核通过后调用村镇服务共享数据接口的组织或个人。平台管理方 platform manager 负责村镇综合服务信息平台的开发、运行、维护以及安全等事务,并对服务提供方的服务注册和服务需求方的服务调用申请进行审核授权的组织或个人。目录服务 directory service 提供数据共享目录的发现与定位功能的信息服务。服务代理 service agent GH/T 13492021 2 桥接服务提供方和服务需求方，提供统一身份认证和路由服务的支持系统。服务标识 service identifier 服务需求方申请的服务接口和申请方代码联合加密后的访问凭证。4 缩略语 下列缩略语适用于本文件。JSON：JavaScript对象标记（JavaScript Object Notation）RPC：远程过程调用（Remote Procedure Call）RESTFUL：表达性状态传递（Representational State Transfer）SOAP：简单对象访问协议（Simple Object Access Protocol）XML：可扩展置标语言（EXtensible Markup Language）5 总体框架 村镇综合服务信息平台宜支持数据资源的共享与开放，建设多源异构数据整合系统，形成全域联通、开放互联的数据资源池。村镇综合服务信息平台数据共享技术整体框架见图1。图 1 村镇综合服务信息平台数据共享技术整体框架 技术架构 村镇综合服务信息平台聚合各领域村镇服务提供方的数据和服务，并提供“一站式”村镇综合服务；服务提供方和服务需求方通过村镇综合服务信息平台共享数据和服务。服务体系 村镇综合服务信息平台提供目录服务、服务注册、服务维护、审核授权、服务代理、服务申请、服务调用等数据共享的功能支持，与服务提供方、服务需求方、平台管理方共同构建村镇服务数据共享技术体系，具体功能如下：a)目录服务。供服务提供方和服务需求方通过村镇综合服务信息平台查询数据共享的技术规范和已开放共享的服务目录。b)服务注册。服务提供方将服务接口注册到村镇综合服务信息平台。GH/T 13492021 3 c)服务维护。服务提供方对发布的服务接口进行变更或撤销维护，同时向村镇综合服务信息平台进行备案记录。d)审核授权。村镇综合服务信息平台统一受理服务提供方的服务注册、维护需求和服务需求方的服务申请需求，由平台管理方对需求进行审核和授权。e)服务代理。审核通过的服务接口，由服务代理统一封装、更新目录服务、并对外提供服务。f)服务申请。服务需求方向村镇综合服务信息平台提出服务接口调用申请。g)服务调用。审核通过后的服务申请，服务需求方可通过服务代理进行服务调用。6 共享接口 总体要求 共享接口的总体要求包括：a)服务接口类型：可接入的服务接口类型包括RPC、RESTFUL、SOAP WEBSERVICE。b)接口请求方式：支持POST、GET两种接口请求方式。c)数据响应格式：支持JSON、XML两种数据响应格式。d)数据共享类型：支持的数据共享类型包括无条件共享、有条件共享、不共享。e)服务日志支持：支持服务注册、服务维护、审核授权、服务申请、服务调用等日志的记录和检索。f)服务监控支持：为保证服务需求方稳定无间断使用服务接口，服务提供方需提供监控接口，供服务代理定时扫描监控，及时发现错误、产生报警信号。g)运营管理机制：宜制定利益分配等运营管理机制，促进平台数据的不断获取和长效使用。服务接口提供 6.2.1 服务接口注册 服务提供方对外提供服务接口形式的信息资源时，需通过村镇综合服务信息平台注册服务接口，提供的服务接口需是村镇综合服务信息平台能够访问，并已测试通过可被正常调用的服务接口。服务接口注册时需提供的注册信息见附录A。6.2.2 服务接口发布 服务提供方注册的服务接口经平台管理方审核授权后，由服务代理统一封装并正式发布，发布的服务接口信息更新至目录服务中，供服务需求方查询使用。6.2.3 服务接口撤销 服务接口成功发布后，可申请撤销。服务接口撤销过程如下：a)当服务尚无授权的服务调用时，服务接口可直接撤销，需填写撤销理由，村镇综合服务信息平台进行备案记录。b)当服务已有授权的服务调用时，需通知服务需求方取消服务接口调用，说明撤销理由，并告知撤销时间，给予一定期限进行调整。服务接口撤销需经过平台管理方审核，审核通过后撤销成功，并进行备案记录。6.2.4 服务接口变更 服务接口成功发布后，可申请变更。服务接口变更过程如下：GH/T 13492021 4 a)当服务尚无授权的服务调用时，服务接口可直接变更，需填写变更说明，村镇综合服务信息平台进行备案记录。b)当服务已有授权的服务调用时，为不影响服务需求方正常调用，服务提供方宜在村镇综合服务信息平台上发布新版服务接口，同时通知原服务接口使用方在一定期限内取消服务接口调用和申请使用新版服务接口，当确认所有原服务接口使用方已取消使用，服务提供方可撤销原版服务接口，服务提供方需做好版本管理；同时向村镇综合服务信息平台进行备案记录。服务接口使用 6.3.1 服务调用申请 服务需求方可在村镇综合服务信息平台调用目录服务查看已发布的服务接口，填写服务调用申请信息。服务调用申请经平台管理方审核授权后，获得服务标识，可使用服务标识进行服务接口调用。服务接口申请信息表见附录B。6.3.2 服务接口调用 服务需求方需使用服务标识从村镇综合服务信息平台获取动态令牌，再使用动态令牌通过服务代理调用服务资源。服务接口调用步骤如下：a)服务需求方使用申请方代码和服务标识从村镇综合服务信息平台获取动态令牌，调用相同服务接口只需在首次调用时获取一次即可，可反复使用，直至令牌过期。b)村镇综合服务信息平台对服务调用方提供的申请方代码和服务标识进行身份验证，验证通过后返回动态令牌。c)服务需求方按服务提供方要求的格式、位置传入参数，在请求报文中增加动态令牌、申请方代码和服务标识请求服务调用。d)村镇综合服务信息平台获取请求报文中的动态令牌、申请方代码和服务标识信息进行权限认证。e)验证通过后，从请求中获取服务接口调用参数，并将其按服务提供方的要求封装后转发服务接口请求。f)服务提供方获取请求数据进行业务处理。g)服务提供方将服务接口调用结果返回村镇综合服务信息平台。h)由服务代理将服务接口调用结果返回给服务需求方。7 安全保障 总体要求 村镇综合服务信息平台及各领域服务提供方和服务需求方宜符合GB/T 22239-2019规范的第三级安全要求。运行环境安全要求 运行环境安全要求包括：a)设备安全：宜制定安全防护措施和管理办法，保障服务器、交换机、路由器等设备的可靠运行。b)操作系统安全：宜使用稳定的服务器版操作系统，及时升级系统补丁，加强对密码的分级管理措施。GH/T 13492021 5 c)数据库软件安全：宜严格管理数据库系统的密码和访问权限，及时对数据库性能进行调优。d)应用服务器软件安全：宜使用安全性高、可靠性和稳定性好的主流应用服务器软件。e)杀毒软件安全：宜安装高性能杀毒软件，制定安全措施，及时升级病毒库，防止病毒感染。数据安全要求 数据安全要求包括：a)宜制定目录服务和审核记录的详细备份制度和方案，适时进行在线、离线备份,每天自动进行多次增量备份及一次全量备份,以确保数据安全。b)宜提供异地实时备份功能，利用通信网络将重要数据实时备份至备份场地。c)宜定时安排专人对备份文件的可用性进行检查和测试。d)宜对备份服务器空间进行实时监控，空间不足时及时报警提示。传输安全要求 传输安全要求包括：a)通过网络传输数据宜对数据进行加密，以保证数据的保密性和完整性。数据传输时，可采用对称加密算法进行加密，密钥长度不少于56位。b)宜支持数据传输断点续传，以保证传输的可靠性。网络和硬件安全要求 宜设置通信网络审核环节，对入网用户进行安全审核，防止非法设备和用户接入，发现可疑行为及时报警提示。8 平台管理及使用者要求 服务提供方 服务提供方负责所提供服务的注册和维护工作，需保证共享数据的完整性、正确性和真实性；需保证共享服务的稳定性，提供监控接口，供服务代理监控服务运行情况。服务需求方 服务需求方根据对数据的使用需求，提出数据使用申请；对于交换与共享获得的信息内容在授权范围内使用。平台管理方 平台管理方负责村镇综合服务信息平台的运行、维护以及安全等事务；负责对服务提供方的服务注册进行审核及监督，对服务需求方的服务调用申请进行审核及使用范围授权。GH/T 13492021 6 A A 附录A （规范性）服务接口注册信息 服务接口注册信息见表 A.1 所示。表 A.1 服务接口注册信息表 序号序号 信息名称信息名称 说明说明 1 服务名称（中文）服务接口资源的中文名称，不允许重复。建议格式：提供方名称_信息资源名称。2 服务名称（英文）服务接口资源的英文名称。3 服务摘要 服务接口资源的简单描述。4 提供方代码 服务接口资源的提供方统一社会信用代码。5 提供方名称 服务接口资源的提供方名称。6 资源信息分类 服务接口资源的所属资源信息分类。7 服务地址 所提供服务的地址，必须是村镇综合服务信息平台能够访问的地址，否则无法注册或被服务需求方使用。8 协议类型 支持的服务接口类型，如 RPC、RESTFUL、SOAP WEBSERVICE。9 请求方法 支持的接口请求方式，如 POST、GET。10 响应格式 支持的数据响应格式，如 JSON、XML。11 参数表 调用服务接口需提供的参数名称、参数位置和参数类型。12 共享类型 支持的共享类型，如无条件共享、有条件共享、不共享。13 共享条件说明 共享类型是有条件共享时的说明。14 服务接口访问限制 包括服务接口调用的有效截止时间（时间格式为 yyyy-MM-dd HH:mm:ss），服务接口调用频率上限，每次调用间隔时间等。15 服务接口说明文档 详细的服务接口使用说明文档，具体内容宜包括服务接口描述、服务接口协议类型、请求方法及响应格式、服务接口参数说明、服务接口访问限制、服务接口调用示例等。GH/T 13492021 7 B B 附录B （规范性）服务接口申请信息 服务接口申请信息见表 B.1 所示。表 B.1 服务接口申请信息表 序号序号 信息信息名称名称 说明说明 1 服务接口名称 申请使用的服务接口名称，对应服务接口注册信息表中的服务名称（中文）。2 申请方代码 服务需求方统一社会信用代码。3 申请方名称 服务需求方名称。4 申请方联系人 服务需求方申请联系人、联系电话和联系人邮箱。5 数据用途 使用该服务用于哪些事项的办理。6 共享条件说明 对于共享类型是有条件共享时需提供满足共享条件的说明。7 服务接口访问方法 包括服务接口调用的使用期限和调用频次。GH/T 13492021 8 参考文献 1GB/T 21062.32007 政务信息资源交换体系 第 3 部分：数据接口规范 2MZ/T 0532014 社区公共服务综合信息平台基本规范 3DB36/T 11792019 政务数据共享技术规范