浙里办接入微应用实战

浙里办接入微应用

需求

最近公司新接了一个需求,需要把已经开发好的H5应用上架到浙里办APP

第一步,用户体系对接

首先需要加入钉钉组织—浙政钉

浙政钉→机关内部最多跑一次→用户认证体系对接申请提交申请

https://cdn.nlark.com/yuque/0/2020/png/653116/1594120733041-ddb09ecf-7e17-4d30-bf37-acf8024773ee.png?x-oss-process=image%2Fresize%2Cw_746

https://cdn.nlark.com/yuque/0/2020/png/653116/1594120920684-86d71dda-2210-4839-aede-6c2684b22b11.png?x-oss-process=image%2Fresize%2Cw_746

申请通过之后,会有对接人给我们接入码

第二步,配置回调地址

准备一个回调地址,我们使用了前端页面地址,比如

https://newstest.yuanbaopu.com/#/dqrcm

将地址提供给对接人,配置在政务服务网个人用户认证管理后台

页面逻辑

我们的回调地址同时也是我们的应用首页,当用户进入之后,首页跳转到浙里办oss单点登录页面

登录地址:https://puser.zjzwfw.gov.cn/sso/mobile.do?action=oauth&scope=1&servicecode=【接入代码】&goto=【附带跳转地址,以sp参数返回】

这里的接入码就是上一步申请的接入码

goto参数可以不填,如果填写,则用户登录完成之后,会以sp参数返回

用户完成登录之后,会跳转到我们配置的这个回调地址,同时会在地址后面带上ticket票据参数,如果填了goto参数,则会返回sp参数

页面代码

1
2
3
4
5
6
beforeCreate() {
console.log('beforeCreate', this.$route)
if (!this.$route.query.ticket) {
document.location.href = "https://puser.zjzwfw.gov.cn/sso/mobile.do?action=oauth&scope=1&servicecode=dqrcm&goto=https%3A%2F%2Fnews.dqbdsh.com%2F%23%2F"
}
}

登录成功之后跳转的回调地址并且带上参数

https://newstest.yuanbaopu.com/#/dqrcm?1=1&ticket=8a11885a74926b8a0174bf4f06055537-ticket&sp=https%3A%2F%2Fnews.dqbdsh.com%2F%23%2F

第三步获取用户信息

获取票据:
(1)首先是使用浙江政务服务网统一登陆地址https://puser.zjzwfw.gov.cn/sso/mobile.do?action=oauth&scope=1&servicecode【接入代码】登陆,登陆的时候个人用户中心会主动将票据以post或者以get方式传到接入系统提供的回调地址上面,收到票据之后使用ticketValidation方法(见附录一:1.票据认证)将票据和其他参数传到接口进行票据认证。
(2)票据认证通过之后接入系统接收token参数和一部分用户数据,然后是调用getUserInfo方法将接收到的票据传到我们接口认证,认证通过之后接收用户详细信息并接收sp参数。
(3)sp地址是指应用系统单点登录成功之后如不想跳转到配置在个人中心的回调地址上面,则可以将最终的跳转地址以goto参数写在登陆地址后面,个人中将会把该地址以sp参数回传给应用系统,应用系统需识别该参数并做跳转

第四步发布汇聚平台

将应用的一些信息发到钉钉群里

例如:

1
2
3
4
5
6
7
8
9
应用发布信息示例
组织:温州市
空间:瑞安市
应用名称:政务服务中心预约服务
域名:https://**********.yyhj.zjzwfw.gov.cn
监控URL:https://**********.yyhj.zjzwfw.gov.cn/首页路径(浙里办扫码测试需要可访问到应用页面的路径)
账号姓名:***
电话:1805879****
邮箱:*****@**.com

之后,群里会有对接人帮忙生成一个汇聚平台的账号和密码

登录汇聚平台,搜索我们开发的应用简称,比如dqrcm(德清人才码),进入应用的运维管理平台

然后,我们本地打包项目,执行

1
npm run build

这里有个坑,就是我们正常打包的目录,文件的权限是不对的,需要设置为可读可写可执行权限

所以还要执行

1
chmod -R +rwx dist

将dist目录权限改为可读可写可执行

进入dist目录,将全部文件打包,然后上传到汇聚平台

然后打开之前配置的监控URL,就能访问到我们的应用了

第五步事项库中认领配置相对应的公共服务事项

这一步主要是对接人申请的,开发不用参与

第六步提交浙里办上架申请

这一步也是最后一步,就是提交应用到浙里办

按照要求准备好对应的所需材料即可

到此全部流程结束,审核大概7-15天

另外

目前我们已经上线的应用有

【德清云博物馆】【德清人才码】

可以在浙里办搜索到


浙里办接入微应用实战
https://thaneyang.github.io/2020/09/浙里办接入微应用实战.html
作者
ThaneYang
发布于
2020年9月25日
许可协议