浙江政务服务网(含单点登录、mgop、zwlog埋点)对接流程

embedded/2025/1/16 3:38:36/

首先由业主单位在IRS平台上注册申请应用,等审批通过后,会给开发商提供开发商账号,使用开发商账号登录IRS平台,就可以进行应用的接口申请和部署了。

一、API接口注册

在IRS平台API管理界面中,新建API,设置生产环境、测试环境的服务地址,GET/POST类型,以及入参和出参。(我司没有定义入参和出参,仅通过在header中增加特定参数,然后通过网关转发api请求。)

注册成功之后,可以进行在线调试,按接口参数定义规则,传入相应参数,调试获取结果。调试成功后,需要上线接口,这样才可以在页面中调用该接口。

备注:经钉钉技术答疑群中相关人员确认,应用可不使用在IRS平台上定义的接口,并自行实现接口并调用后端服务,没有强制规定一定要在IRS上定义API并调用。

二、mgop使用

技术对接文档中已经给出了mgop的基本使用方法,我们要做的就是对mgop进行二次封装,方便使用。

import { mgop } from '@aligov/jssdk-mgop';
const request = function (config) {return new Promise((resolve, reject) => {mgop({api: 'mgop.xxxx.xxxx.xxxxApi', //IRS平台定义的api接口host: 'https://mapi.zjzwfw.gov.cn/', // 固定地址dataType: 'JSON',type: config.mgopApi == 'image' ? 'GET' : 'POST',appKey: 'xxxxxx', // 在IRS平台可获取到header: {'xxxx': 'xxxx', //后端服务所需的请求头参数,可以有多个isTestUrl: '1' //测试环境必填,否则请求的是生产环境地址;},data: config.params ? config.params : '', //请求体参数onSuccess: (data) => {console.log('data', data);resolve(data.data);},onFail: (err) => {console.log(err, 'err');}});});
};
export default request;

使用mgop无法进行本地调试,会出现跨域错误,只能将代码上传到IRS平台上,然后会得到测试地址,通过测试地址查看接口返回值。 

备注:如果请求头中没有添加isTestUrl参数,则将连接生产环境后端地址。

三、政务网header和footer的引入

按照官方技术文档,在index.html中引入头部js尾部js,页面中将自动显示政务网的头部和底部,包含无障碍、长辈版等硬性上线要求,无需额外功能开发。

备注:本地环境下头部城市切换、无障碍功能不可用,涉及到相关请求接口跨域,发布IRS平台后,即可正常使用。

 1. 长辈版样式修改

切换长辈版的原理是,点击长辈版按钮时,会在在index.html的body标签上增加一个类名,类名可以使用政务网的类名zjzwOLD,也可以自定义类名,内部页面的长辈版样式,可以写在.zjzwOLD下。

长辈版切换触发类名修改的方法(技术文档中已提供):

        <script>function zoomin1() {// 在此处添加进入老年版方法localStorage.setItem('mode', '2');_setCookiemode('2');// 添加类名,切换按钮$('body').addClass('elder'); // 自定义类名$('body').addClass('zjzwOLD'); //政务网类名$('.zoomin').css('display', 'none');$('.zoomout').css('display', 'block');// 自定义的操作}function zoomout1() {// 在此处添加进入标准版方法localStorage.removeItem('mode', '');_setCookiemode('');// 删除类名,切换按钮$('body').removeClass('elder'); // 自定义类名$('body').removeClass('zjzwOLD'); //政务网类名$('.zoomout').css('display', 'none');$('.zoomin').css('display', 'block');// 自定义的操作}$('.zoomin').click(function () {zoomin1();});$('.zoomout').click(function () {zoomout1();});// 页面初始化调用方法getCookieMode(function (res) {if (res.data.mode == '2') {zoomin1();} else {zoomout1();}});</script>

 2.页面标签设置

<meta name="SiteName" content="浙江省人民政府 浙江政务服务网 IRS上的平台名称" /><meta name="SiteDomain" content="zwfw.zj.gov.cn,zjzwfw.gov.cn,mapi.zjzwfw.gov.cn" /><meta name="SiteIDCode" content="3300000069" />

SiteName的值,最后一个要写IRS上你的应用的名字,写其它的会被驳回。

四、单点登录

1.首先由业主单位在IRS上申请单点登录组件。

2.在前端页面中定义好单点登录回调路由地址,用于获取政务网登录成功后返回的回调信息。

3.将前端代码上传到IRS平台后,需要提交审核,提交审核后,会拿到生产环境的前端页面访问地址,将此地址下的完整回调页面地址发给业主,由业主将回调地址提交申请,用于政务网登录成功后携带参数跳转到此回调地址。申请通过后,会得到一个appId,用于前端页面跳转到政务网登录页。

4.单点登录跳转示例:

公共登录地址是:

https://portal.zjzwfw.gov.cn/uc/sso/login?appId=xxxxxxx&sp=/xxxxxxxx&userType=xxxxxxx

其中appId是业主将回调地址提交申请审核通过后,得到的appId,不是IRS平台上的appId,切记。

sp参数可传可不传,该参数会在政务网登录成功后,做为返回参数放在回调地址上。我们一般用来做为应用内单点登录成功后的页面跳转地址。

userType参数的值有两个:person和legal(个人和法人)

用户在政务网登录成功后,会自动跳转到回调地址页面,并在url地址上携带ticketId和sp参数。后端同学需要使用这个ticketId获取政务网上登录人信息,完成应用内的单点登录。

回调地址示例:

http://www.baidu.com/call/back?sp=xxxxxxx&ticketId=xxxxxxx

 上面的http://www.baidu.com/call/back就是我们上一步我们提供给业主的完整回调地址。redirectUrl是我们跳转政务网登录页时传入的sp参数,ticketId是政务网登录成功后返回的值。

注意:跳转到政务网登录地址的时候,我们如果传入了sp参数,在登录成功返回到回调地址的时候,该参数的键值变成了redirectUrl。取值时不要取错

五、埋点

1.首先需要在index.html中引入zwlog.js链接地址

2.由于埋点要求每个页面都要上报埋点信息,所以将埋点功能的调用放在了App.vue中,监听路由变化,当路由变化时发送埋点信息。

3.经与技术人员核实,可以仅在登录情况下发送埋点数据,未登录情况下可不发送。

4.使用方式(核心代码):

let _this = this;
this.zwlog = new ZwLog({_user_id: userId, //登录用户id(政务网返回)_user_nick: userNick //登录用户昵称(政务网返回)});this.$nextTick(() => {this.zwlog.onReady(function () {let params = {miniapp_start: '$$miniapp_start',//固定值page_start: '$$page_start', //固定值t2: Time2, //页面启动到加载完成的时间t0: Time0, //页面启动到页面响应完成的时间userType: 'legal', //或personminiAppId:'xxxxx', //IRS上appIdminiAppName: 'xxxxxx', //IRS上应用名称pageId: 'xxxx', //页面id,可以取当前路由pathpageName: 'xxxx',//页面名称,可以取当前路由名称_user_id: 'xxxxx', //当前登录人idminiapp_first_user: 'first_user' //如果用户是首次使用该应用,则传入,否则不传}_this.zwlog.sendPV(params);
})
})

关于t2和t0的计算方法: 

在mounted中获取当前时间,做为页面开始加载时间time1,在watch路由变化时获取当前时间time2,将time2-time1的值做为页面启动到加载完成的时间。但是,该算法仅在页面整体首次加载时有效,因为vue页面除首次加载,之后在切换路由时,页面加载时间可视为0.因此,t2的值在非首次加载时,直接设置为0即可。

t0的算法,在上面nextTick中获取当前时间time3,当页面是首次加载时,t0=time3-time1,当页面是非首次加载时,t0=time3-time2

最终单位要转换成秒

六、其它审核相关内容

1.跳转到政务服务网之外的第三方链接,在跳转之前要有弹窗提醒。技术群中有相关人员答复,原则上不允许跳转到站外地址。但没有明确禁止。

2.长辈版模式下,字体不得小于18px。

3.审核流程

业主单位要先进行内部审核,内部审核通过之后才会提交到浙里办。


http://www.ppmy.cn/embedded/14580.html

相关文章

Java23种设计模式-创建型模式之建造者模式

建造者模式&#xff08;Builder Pattern&#xff09;&#xff0c;也被称为生成器模式&#xff0c;是一种创建型设计模式&#xff0c;主要用于解决复杂对象的构建问题。建造者模式的主要特点是&#xff1a; 1.分离构建与表示&#xff1a;将一个复杂对象的构建与它的表示分离&…

论基于架构的软件设计方法及应用

框架 一、 摘要 2020年12月,我参加了某省政协委员履职系统的开发。该系统为政协机关人员管理委员信息以及委员完成各项履职提供了全方位的软件支撑。我在该项目重担任系统架构师一职,负责履职系统的架构设计。本文结合作者的实践,以委员履职系统为例,论述基于架构的软件开…

Elasticsearch 索引数据多了,调优,部署方案

1&#xff1a;动态索引层面 基于 模板时间rollover api 滚动 创建索引&#xff0c;举例&#xff1a;设计阶段定义&#xff1a;blog 索引的模板格式为&#xff1a;blog_index_时间戳的形式&#xff0c;每天递增数据。这样做的好处&#xff1a;不至于数据量激增导致单个索引数据量…

ETL工具-nifi干货系列 第十七讲 nifi Input PortOut Port 实战教程

1、端口&#xff08;Port&#xff09;&#xff0c;包含输入端口&#xff08;Input Port&#xff09;和输出端口&#xff08;Out Port &#xff09; 使用一个或多个处理组构建的数据流需要一种方式将处理组连接到其他数据流组件。 处理组和处理组之间可以通过使用端口来进行连…

绿色便携方式安装apache+mysql+tomcat+php集成环境并提供控制面板

绿色便携方式安装带控制面板的ApacheMariaDBTomcatPHP集成环境 目录 绿色便携方式安装带控制面板的ApacheMariaDBTomcatPHP集成环境[TOC](目录) 前言一、XAMPP二、安装和使用1.安装2.使用 三、可能的错误1、检查端口占用2、修改端口 前言 安装集成环境往往配置复杂&#xff0c…

如何查看连接的Linux服务器是ubuntu还是centos

测试环境 Ubuntu 22.04.4CentOS Linux release 7.9.2009 (Core) centos使用以下命令 cat /etc/centos-release结果 CentOS Linux release 7.9.2009 (Core)或者 cat /etc/issue结果 \S Kernel \r on an \mubuntu使用以下命令 cat /etc/issue结果 Ubuntu 22.04.4 LTS \n …

【Python-编程模式】

Python-编程模式 ■ 单例模式■ 工厂模式■■ ■ 单例模式 新建文件 str_tools.py 如下代码。 class StrTools:passstr_tool StrTools()在其他文件使用时导入该变量。 from str_tools_py import str_tool s1 str_tool s2 str_tool print(id(s1)) print(id(s2))■ 工厂模式…

Android IPC | Android多进程模式

前 言 关于Android的进程间通信&#xff08;即IPC&#xff09;有很多种方式&#xff0c;比如我们常用的AIDL、Socket等&#xff0c;而其中最重要而且最需要掌握的就是AIDL的使用和原理&#xff0c;简单来说它是通过Binder实现的。 关于Binder的知识点非常多&#xff0c;当我们…