小程序数据签名场景

1. 场景简介

客户拥有自行维护的微信小程序,需要使用小程序插件集成的模式,类似于协同证书体系下的SDK模式,客户要完成在小程序内完成数据签名的应用场景。

2. 集成准备

使用申请:在微信插件商店,对“云签名组件”进行申请,申请后联系移动技术部张玉山审核通过。申请插件通过后,可以在微信公众平台看到《云签名微信小程序插件使用手册》,请仔细阅读。

云端测试服务环境,无需申请服务开通,测试接入地址:https: //api-sit.isignet.cn:8082/ https: //api-sit.isignet.cn:8082/ids/v1/outer/

移动端配置测试服务地址:https: //api-sit.isignet.cn:8443/

服务端API接入配置参数:

appId=”67f6c99b74484c2b8bcb35473850cdd7”

deviceId=”DEV_B90213F1BAD64B7AA139724161E3B339”

服务端API接入配置参数:secret=”MBxCw0HP7kEVhvC5QL4Da74gzDL7chfU”

移动端SDK和业务系统均要配置appid=67f6c99b74484c2b8bcb35473850cdd7,且要保持一致

3. 开始集成工作

集成说明:下面章节中流程中描述的移动端接口指的是小程序插件接口,服务端接口指的是api服务接口,接入方式为restful接口,无集成语言限制

3.1 手机证书下载集成

流程说明:

业务端将用户信息(姓名、身份证号、手机号)注册到信步云,返回用户邀请码

用户在业务应用小程序中输入激活码,引导用户输入短信验证码、设置证书pin码生成证书,完成手机证书下载。

img

集成接口

接口1:服务端接口3.3.1添加信任用户接口addTrustedUser

接口2:移动端接口 证书下载组件

3.2 小程序内部数据签名

用户已完成了移动证书下载,需要做小程序内部的数据签名

流程说明:

用户在移动端发起数据签名请求,请求到信步云平台,返回签名任务id

业务系统收到返回的签名任务id,返回给小程序

小程序中直接弹出密码键盘,用户输入pin口令,完成协同签名,移动端获取到签名结果后,推送给服务端,服务端拿到后做签名验证,验证通过后存入数据库

img

集成接口

接口1:服务端接口3.2.9.添加数据签名任务/signjob/v1/addSignJob

接口2:移动端接口签名组件

接口3:服务端接口3.2.10.获取签名结果/signjob/v1/querySignJob

接口4:服务端接口3.2.8.数据签名验签/verify/v1/verifySign

4. 集成工作验证

通过服务端注册用户,返回激活码

小程序,找到激活码激活入口,输入激活码,收到短信,设置证书口令,完成下证(下证验证通过)

APP端发起数据前民请求操作,微信小程序弹出密码键盘,用户输入正确证书口令,提示签名成功,并显示登录后页面;输入错误证书口令,提示登录失败(扫码登录认证验证成功)。