DB42-T 1728.1-2021 政务服务移动端建设规范 第1部分：应用接入

35.240.99CCS

L

67DB42/T 42/T

1728.1—2021政务服务移动端建设规范第

1

部分：应用接入Specification

service

terminal

Part

1:Application

发布

实施湖北省市场监督管理局 发

布DB42/T

1728.1—2021 前言

III引言

IV1

12 规范性引用文件

13 术语和定义

14 鄂汇办接入概述

24.1

系统总体接入架构

24.2

鄂汇办开放平台功能定位

24.3

应用资源服务平台功能定位

34.4

应用接入方式

34.5

总体流程

34.6

应用接入申请

44.7

接口封装和应用开发

44.8

应用上传、审核与发布

54.9

接口性能要求

54.10

接口可用性要求

55 接口对接

55.1

接口对接流程

55.2

接口接入申请、审核

65.3

接口注册、联调

65.4

接口发布、调用

76 应用开发

86.1

应用接入前准备

86.2

应用接入申请

86.3

应用接入审核

96.4

应用开发

96.5

用户接入

97 应用上传审核与发布

117.1

应用上传部署

117.2

应用审核

117.3

应用灰度发布

117.4

应用正式上线

117.5

应用更新与下线

118 应用接入审核标准

11DB42/T

1728.1—20218.1

应用可用性

118.2

应用易用性

128.3

应用接入安全性

128.4

结果数据准确性

138.5

应用系统稳定性

138.6

应用兼容性

138.7

应用抗压性

138.8

文档完整性

139 应用接入安全

139.1

身份鉴别

139.2

访问控制

139.3

审计日志

149.4

数据安全

149.5

代码安全

149.6

通信安全性

159.7

恶意行为防范

15附录

A（规范性） 接入申请表

17附录

B（规范性） 鄂汇办开放平台接口说明

19附录

C（资料性） 政务服务应用接入清单示例

27附录

D（规范性） 接入清单

29参考文献

30IIDB42/T

1728.1—2021 本文件按照GB/T

《标准化工作导则

第1部分：标准化文件的结构和起草规则》的规定起草。本文件是DB42/T

1728《政务服务移动端建设规范》的第1部分。DB42/T

1728已经发布了以下部分：——第

1

部分：应用接入；——第

2

部分：旗舰店建设。本文件由湖北省大数据中心提出。本文件由湖北省政务管理办公室归口。本文件起草单位：湖北省大数据中心、湖北省标准化与质量研究院、湖北省楚天云有限公司。陈旭东、肖世达、罗亮、韩吉威、王国淑莹。本文件实施应用中的疑问，可咨询湖北省政务管理办公室，联系电话邮箱：szwbjy@；对本文件的有关修改意见建议请反馈至湖北省大数据中心，联系电话邮箱：342718797@。IIIDB42/T

1728.1—2021 提高网上政务服务能力和方便群众办事的目的，加快建设全省统一政务服务移动端成为重要任务。DB42/T

1728.1-2021为规范政务服务移动端建设提供指引，文件拟由两个部分构成。第1部分：应用接入。目的在于确立第三方应用接入政务服务移动端的要求和操作规范。第2部分：旗舰店建设。目的在于统一各级鄂汇办旗舰店的建设风格和功能要求。IVDB42/T

1728.1—2021

1 范围传审核与发布、应用接入审核、应用接入安全的要求。本文件适用于全省各级政府部门政务服务应用（以下简称政务服务应用）与鄂汇办的对接。2 规范性引用文件文件。DB42/T

1728.2-2021

政务服务移动端建设规范

第2部分：旗舰店建设3 术语和定义下列术语和定义适用于本文件。3.1政务服务移动端

mobile

platform由APP、微信小程序、支付宝小程序等移动端应用组成。以下简称“鄂汇办”。3.2鄂汇办

APP

由湖北省人民政府主办，集政务服务、政务公开、便民服务、政民互动为一体的综合服务平台。3.3鄂汇办开放平台

government

open

platform鄂汇办与接入单位对接的接入平台。接入方与鄂汇办接入通过鄂汇办开放平台统一接入。3.4应用资源服务平台 application

resource

platform提供鄂汇办接入的页面应用运行时的基础运行环境的平台。可以实现动态伸缩、扩容、流量控现与其他系统的通信。DB42/T

1728.1—20213.5接入单位 access

organization门。3.6政务服务应用

affairs

service

application由各级政府部门为自然人，法人和其他组织提供各类政务服务的应用。以下简称“应用”。4 鄂汇办接入概述4.1 系统总体接入架构总体接入架构示意图见图1。图1系统总体接入架构示意图Nginx1.12+

Apache2.4+

Java

JDK1.8+Java

Tomcat7.0+

DB42/T

1728.1—20214.2 鄂汇办开放平台功能定位鄂汇办开放平台承担以下功能和服务。a) 接口注册：服务接口统一注册到鄂汇办开放平台，由鄂汇办开放平台统一管理注册信息。b)

url、token、appid、appsecret

等认证信息。c) 接口认证鉴权：通过

、appId、appSecrect

等方式实现接口的认证鉴权。d) 流量控制：通过平台流控功能实现接口访问的流量控制。e) 服务监控：监控接入平台的服务质量，服务异常报警。4.3 应用资源服务平台功能定位应用运行所必须的基础环境，如：JVM虚拟机，服务器，Tomcat容器等。运行基础环境封装在平境见表1。表1 应用资源服务平台支持的运行环境4.4 应用接入方式4.4.1 应用接入内容应用接入内容如下：a) 外提供服务；b) 前端页面应用：由接入单位提供前端页面应用，该页面应用负责展现通过接口调用的数据。4.4.2 应用接入方式应用接入方式如下。a) 后台服务统一通过鄂汇办开放平台接入鄂汇办

APP

APP

用如下方式：1) HTTP

或

HTTPS

方式：通过调用

HTTP

服务，根据规定的参数等发起请求，同步返回结果；2) WebServices

方式：通过调用

服务，遵循标准的

SOAP

协议，采用同步调用的形式返回结果。b) 获取数据，实现页面展现。页面应用统一通过应用资源服务平台完成应用的部署和发布。4.5 总体流程DB42/T

1728.1—2021应用接入到鄂汇办应用接入总体流程示意图见图2。图2 应用接入总体流程示意图4.6 应用接入申请需求分析和调研工作。需求确认后由接入单位通过应用开放平台提交应用接入申请。4.7接口封装和应用开发DB42/T

1728.2-2021描述的设计开发接口页面和交互功能，由鄂汇办统一集中部署、发布。此阶段需完成工作如下：>100099%

>200099%

DB42/T

1728.1—2021a) 发布接口。b) 台。4.8 应用上传、审核与发布服务接入成功，并确保应用后台的稳定可靠。应用经审核后发布。4.9 接口性能要求接入方的服务接口应满足表2的要求。表2 接口接入要求4.10接口可用性要求/（服务可用时间+服务不可用时间），可用性应达到99.9%。5 接口对接5.1接口对接流程接口进行调用。接口对接流程如图3所示。接入方提供的接口服务接入鄂汇办开放平台有如下流程：a) 接口接入申请、审核；b) 接口注册、联调；c) 接口发布、调用。DB42/T

1728.1—2021图3 接口对接流程5.2 接口接入申请、审核册申请表》，其格式应符合附录A.1的规定。5.3 接口注册、联调接入申请审核通过后，接入方在鄂汇办开放平台注册应接入的接口，其接口相关参数应符合附录B的规定，和鄂汇办开放平台一起进行联调测试，测试通过后发布，流程图如图4所示。具体接口请求参数见表B.1B.3B.5，接口调用示例见表。接口注册、联调要求如下：a) 提供接口必要参数，接口地址、接口简介、请求方式、响应数据格式、请求参数；= &b)

= &Number（数字类型），，Array（数组类型），参数位置包含

Parameter

Path（路径），HeadersQuery（路径中以?开头，

对应，

:?Name=张某），Body/Json（请求体中以

格式），Body(请求体中以x-www-form-urlencoded

格式)；DB42/T

1728.1—2021c) 网络连通性校验，鄂汇办开放平台使用以上填写的接口地址、请求方式、响应数据格式、参数名、参数类型、参数位置等信息组装并发起

（网络请求）验证

（应用程序接口）的网络连通性及参数有效性；d) 接口审核：鄂汇办开放平台对接口可用性、业务流程进行审核。图4 接口注册、联调流程5.4 接口发布、调用5.4.1 基本要求接口发布、调用流程基本要求如下。a) 提供必要的

appKey、appSecret

so

双方以安全方式存储接口鉴权密钥。b) 用方。5.4.2接口发布、调用流程如图5所示，接口发布、调用流程如下：a) 接口发布：通过校验、可用性审核的

具有发布资格，反之拦截接口发布请求，发布成功后鄂汇办开放平台会为此接口生成唯一标识；b) 持

HTTP

协议和

https

HTTP

协议地址：cn:8060/，HTTPS

协议地址::40443/汇办开放平台统一地址拼接鄂汇办开放平台生成接口唯一标识

（例：:8060/64bf35d1c4d54a2bb9f3d3a91ce0240e475afdbe2272466d865a9854343a11a1）；c) 请求方式与请求参数：与接口注册时填写的请求方式、参数一致；DB42/T

1728.1—2021d) 按照鄂汇办开放平台规定的签名算法生成签名。鄂汇办开放平台会对每个请求进行签名验证，防止请求重放、数据篡改、身份伪造；e) 承载范围的请求拦截；f) 请求转发：将请求转发至目标接口，获取相应数据；g) 响应转发：将返回内容返回给接口调用方。图5 接口发布、调用流程6 应用开发6.1 应用接入前准备C。6.2 应用接入申请申请填写内容及要求如下。a)

A.2

D.1）填写完整。b)

用场景，预估覆盖的人群数量、使用的频次，过往的业务量等信息。预估使用

社保卡临湖北省人力资源与社会居民输入需要办理临时挂失的社保卡号——点击申可使用本服务进行社保卡100

130

DB42/T

1728.1—20216.3 应用接入审核接入方申请上线的应用至少需满足以下几个条件方能通过审核。a) 接入详细清单》填写完整。b) 服务名称正确对应。c) 结果需包含医院的地址、电话等信息，满足群众知晓医院位置、联系医院等需求。6.4 应用开发DB42/T

1728.2-2021规定的UI接口的调用应满足本文件第5章的规定。6.5用户接入6.5.1 用户访问授权时可忽略本节，需身份信息类应用可依据6.5.3获取用户信息。6.5.2 用户对接流程用户对接流程包括：a) 用户授权：应用通过鄂汇办开放平台申请用户授权；b) 授权验证：鄂汇办开放平台对用户授权请求进行验证；c) 加密用户信息：鄂汇办开放平台对授权用户信息进行加密；d) 分发授权信息：将已加密的授权用户信息分发给请求方；e) 解密用户信息：请求方使用鄂汇办开放平台解密

包对加密用户信息进行解密操作。6.5.3 用户对接方法用户对接时需先引入政务服务应用接入鄂汇办APP标准规范的脚本文件地址。<script

所在网络

token

IdDB42/T

1728.1—20216.5.4获取用户加密数据在使用时应用或事项应获取用户加密数据，得到返回值。获取方法:ehbAppJssdk.user.getUserInfo({success:function(res){}})返回值说明:6.5.5 返回值说明:执行用户登录操作时，应执行以下示例中的函数。ehbAppJssdk.user.login()6.5.6用户注销注销鄂汇办APP已登录用户应按以下示例执行。ehbAppJssdk.user.logout()10DB42/T

1728.1—20217 应用上传审核与发布7.1 应用上传部署接入方上传开发完成的应用部署包至应用汇聚平台，部署包中存放css文件、js文件、html文件的鄂汇办提供的测试工具对应用进行自测。7.2应用审核接入方自测完成后，鄂汇会对应用进行审核，具体要求见第8章。通过审核后允许发布。7.3 应用灰度发布面向部分用户进行灰度发布。灰度发布周期宜为一个月左右。7.4 应用正式上线通过灰度发布后，应用正式上线。应用正式上线运行后，接入方应保障应用的运维工作。7.5应用更新与下线7.5.1 服务稳定性故障监控鄂汇办对上线服务实施2410分钟，3024线处理。7.5.2 服务维护申请服务维护申请如下。a) 影响用户使用。b)由于业务变动等原因申请永久停止服务：若已发布的服务应用因业务变动需要永久停止服务，件或法律依据。7.5.3 维护后恢复上线接入方修复服务问题或维护升级后需申请再次上线，通过审核并完成灰度发布后可重新上线服务。8 应用接入审核标准8.1 应用可用性8.1.1 应用无缺陷<3用缺陷等级划分标准见表3。11

DB42/T

1728.1—2021表3 应用缺陷等级对照表8.1.2业务流程真实性接入方必须提供可供测试的真实账号（尤其是涉及法人的服务），该账号能够走完全部业务流程，必须在测试审核报告中提供完整的可清晰辨认的服务使用截图或者录屏（敏感信息可打马赛克处理）。8.1.3 用户界面规范性DB42/T

1728.2-2021规定的UI部应满足如下规则：a) 单个应用的，应用第一个页面加头部；b) 应用第一页为列表且列表中有多个服务的，每个应用子页面第一页加头部；c) 应用每一页均在底部展示该应用提供主体名称。8.1.4结果信息完整性结果信息完整性要求如下：a) 页面完整性：查询结果页面符合

UI

规范，需包含有结果返回页面、无结果缺省页面、查询异常页面；b) 结果数据完整：包括必要的名称、地址、电话、联系人、规格、时间、服务内容项等信息；c) 例如，不可简单地一律返回“查询结果异常”等对于用户使用服务无帮助的提示信息。8.2 应用易用性输入异常提示、结果提示、输入方式、结果展示等应是清晰易理解的：a)

XX

办理等；b) 如有需用户输入的信息，需校验输入的合法性，例如非空校验、格式校验等；c) 应用中包含有位置信息的业务场景，应根据实际情况使用地图定位、距离排序及导航功能；d) 应用中含有拨打电话的业务场景，应具备点击电话号码直接拨打功能；e)居民养老保险，用户进入城乡居民养老保险缴费服务即可进行缴费，否则不可进行缴费）；f)使用。不允许同一类（项）应用的子项拆分为独立的应用；g) 不限于以上

6

条的其他易用性要求。8.3 应用接入安全性应用接入安全性应满足第9章要求。12DB42/T

1728.1—20218.4 结果数据准确性服务提供的相关结果数据准确，应与实际业务场景匹配，并保持与接入方数据一致。8.5 应用系统稳定性每对应用进行1000次访问调用，服务故障率低于，响应异常次数不超过1次。8.6 应用兼容性应用的用户界面应适配市面主流手机型号及移动操作系统，包括但不限于：a) 主流手机品牌适配：华为、小米、OPPO、VIVO、b) 操作系统适配：HarmonyOS

2.0

及以上、

及以上、iOS

9.0

及以上；c) 分辨率适配：HarmonyOS：、720x1280、，：320x480、、720x1280、1080x1920，：640x960、640x1136、750x1334、1242x2208、1125x2436、、1242x2688；d) 网络制式适配：电信、移动、联通，网络模式（5G、4G、Wi-Fi8.7 应用抗压性应用应满足本文件、中的提出的性能和可用性要求。8.8 文档完整性《湖北政务服务接口注册申请表》（见表A.1）、《湖北政务服务应用接入申请表》（见表《湖北政务服务应用接入清单》（见表D.1）、《湖北政务服务应用接入联调测试审核报告》全部提交并审核通过，其中《湖北政务服务应用接入联调测试审核报告》格式应符合附录的规定。9 应用接入安全9.1身份鉴别应用身份鉴别技术要求包括但不限于：a) 应根据业务需要提供登录控制模块，对用户身份进行鉴别和标识，b) 如失败提示等；c)应确保用户身份标识唯一性，用户可根据业务需要允许其同时在一个或多个终端上登录；d) 不宜内置有默认账户及默认密码；e) 宜具备口令强度和口令时效性检查机制，根据业务安全需要可适时启用此检查机制；f) 休眠状态、锁定状态，并注销或中断连接；g) 用户修改或找回口令时，应用应具备验证机制；h)形验证码宜具备一定的抗机器识别能力，短信验证码应具有防重放攻击机制；i) 应用应按“后台实名、前台自愿”的原则，对注册用户进行真实身份信息认证。9.2 访问控制应用访问控制技术要求包括但不限于：13DB42/T

1728.1—2021a) 户数据时，应先获得用户许可或同意；b) 未经用户许可，应用不应修改终端资源配置，不应修改和删除终端数据；c) 和终端资源（如发送短信、拨打电话、连接网络、拍照、录音、调用其他应用等）；d) 不应拦截或存留用户敏感或隐私信息，如用户支付密码等；e) 问题的权限分配方式或结果；f)被用户赋予或修改权限后，宜不需重启系统，应用相应的权限即可生效；g) 息或警告误导或欺骗用户；h)不应模拟系统信息或安全警告误导用户。9.3 审计日志应用审计日志技术要求包括但不限于：a)

6

录相应日志；b) 应以合适的方式向用户展示相关日志信息；c)服务器端日志中不宜记录用户敏感信息数据，如需要记录敏感信息数据，应进行模糊化处理。9.4 数据安全应用数据安全技术要求包括但不限于：a) 未经用户授权，应用不应从终端设备上的加密存储区域中解密出加密数据的真实内容；b) 未经明示用户且获得授权的情况下，应用不应收集或修改终端数据；c) 不应在数据存储、处理、传输过程中非法截留或窃取数据；d) 或网络传输敏感数据；e) 对个人信息、企业信息等关键信息的展示，强制要求脱敏处理；f) 应用如有数据删除功能，在删除数据前应明确提示用户，并由用户确认删除操作；g) 应采用安全机制保护账号、密码和支付信息等敏感数据的输入与显示，除非用户主动允许外，为数据的输入接口；h) 技术进行传输，账号、密码传输要防止重放攻击和中间人攻击；i) 未经用户授权时，不应获取定位、录音、拍照、摄像等相关数据；j) 息、上网记录和日程表数据等用户敏感数据；k) 用户同意。9.5代码安全应用代码安全技术要求包括但不限于：a) 宜采取反编译防护、反盗版防护等措施防止被破解、篡改或二次打包，保护源代码安全；14DB42/T

1728.1—2021b) 全漏洞及时更新；c) 代码中不应存在已公布的高危风险漏洞；d) 应禁止内部组件被外部程序调用，如需供外部调用，应检查调用者是否符合访问控制机制。9.6 通信安全性应用通信安全性要求包括但不限于：a) 求，并在处理完毕后可正常恢复，继续原来的功能；b) 应用应能处理网络连接中断，并提示用户连接中断的情况；c) 网络异常(如通讯切换或中断)时，应用应能及时将异常情况通报给用户；d) 网络通信超时，应用应发送超时提示信息给用户；e) 当不再需要使用网络连接时，应用应及时关闭或断开连接，减少对网络资源的占用；f) 当用户在公共免费网络环境中(如商场、咖啡馆等)

使用应用，宜提醒用户注意数据安全。9.7 恶意行为防范9.7.1 信息窃取息。9.7.2 恶意扣费致用户经济损失。应用涉及的付费项目应有明确的文字说明付费用途，且付费前应得到用户确认。9.7.3 远程控制未经用户授权，应用不应接受远程控制指令或进行相关操作，不得尝试获取终端远程访问权限。9.7.4恶意传播应用防范恶意传播包括但不限于：a) 为；b)不应强制推荐用户下载或安装其他相关或无关的软件；c) d) 不应强行弹广告窗口、浮窗广告，以及推送广告等，用户许可的情况除外。9.7.5 诱骗欺诈达到不正当目的。9.7.6 功能调用15DB42/T

1728.1—2021应调用智能移动终端的任何功能资源，包括但不限于摄像、录音、播放、拨打电话等。9.7.7 未授权的恶意行为应用未经授权，不应具有包括但不限于以下的恶意行为：a) 长期驻留在系统内存中；b)擅自添加、删除、修改收藏夹和快捷方式等；c) 弹出无法关闭的广告窗口；d) 用户无法正常退出、卸载、删除软件；e) 私自启动、后台运行、结束应用进程或系统服务（如：蓝牙、摄像、位置定位等）；f) 在用户不知情情况下，连接到恶意

地址或僵尸网络，跳转无关的服务器等。16IP

IPbody,headers,query,pathDB42/T

1728.1—2021AA附

录 A（规范性）接入申请表A.1 湖北政务服务接口注册申请表湖北政务服务接口注册申请表见表。表A.1 湖北政务服务接口注册申请表A.2 湖北政务服务应用接入申请表17

IP

PC

PCAPP

PCAPP

PCAPP

DB42/T

1728.1—2021湖北政务服务应用接入申请见表A.2。表A.2 湖北政务服务应用接入申请表18_cityCode否，仅当机构业务需String420000420100421122_sign否，仅当需要通过签String_signType否，仅当需要通过签String生成签名字符串所使SM2HMAC-SHA256_charset否，不传则用机构当String编码字符集，默认为utf-8utf-8gb2312gbkgb18030_timestap否，仅当对高安全级别接口需要控制请求String2015-04-2615:23:12rtnCodeString000000400000103000rtnMessageStringdataStringsignString返回内容签名值，仅当高安全级别接口需要DB42/T

1728.1—2021BB附

录 B（规范性）鄂汇办开放平台接口说明B.1 鄂汇办开放平台接口说明表B.1提供了通用接口参数定义，接入方根据实际需要选择实现。表B.1 通用接口请求参数B.2 通用接口返回参数表B.2提供了通用返回参数定义，需接入方实现。表B.2通用接口返回参数表B.3 区划代码表19420000420100420200420300420500420600420700420800420900421000421100421200421300422800429004429005429006429021420102420103420104420105420106420107420111420112420113420114420115420116420117420118420150420202420203420204420205DB42/T

1728.1—2021区划代码见表。表B.3 区划代码表20420222420281420302420303420304420322420323420324420325420350420351420381420502420503420504420505420506420525420526420527420528420529420550420581420582420583420602420606420607420624420625420626420650420682420683420684420702420703420704DB42/T

1728.1—2021表

表

B.3 区划代码表（续）420750420802420804420822420850420851420881420882420902420921420922420923420950420951420952420981420982420984421002421003421022421023421024421050421081421083421087421102421121421122421123421124421125421126421127421171421172421173421181DB42/T

1728.1—2021表

表

B.3区划代码表（续）4211824212024212214212224212234212244212504212814213034213214213504213514213814228014228024228224228234228254228264228274228281001001Continue1011001Switching

2001001OK2011001Created2021001Accepted2031001Non-Authoritative

2041001No

2051001Reset

2041001No

2051001Reset

2061001Partial

DB42/T

1728.1—2021表

B.3 表

B.3 区划代码表（续）返回状态码见表B.4。表B.4 返回状态代码表233001001Multiple

3011001Moved

3021001Found3031001See

3041001Not

3051001Use

3061001Unused3071001Temporary

4001001Bad

4011001Unauthorized4021001Payment

4031001Forbidden4041001Not

4051001Method

4061001Not

4071001Proxy

Required4081001Request

4091001Conflict4101001Gone4111001Length

Required

Content-Length

4121001Precondition

Failed4131001Request

4141001Request-URI

4151001Unsupported

4161001Requested

4171001Expectation

5001001Internal

Server

5