PC端扫码网页签章场景

1. 场景简介

客户自有app,移动端集成信步云sdk,服务端采用了HTTP服务restfulAPI接入模式,实现PC端扫码网页签章的功能,常见场景如:PC端OA流程扫码审批等应用等场景

2. 集成准备

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

移动端SDK配置测试服务地址:http: //dev.isignet.cn:8080/MSSPServer/

服务端API接入配置参数:

appid=67f6c99b74484c2b8bcb35473850cdd7

deviceId=”DEV_B90213F1BAD64B7AA139724161E3B339”

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

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

移动端SDK通过在OA流程上提出库流程从质控获取

3. 开始集成工作

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

3.1 手机证书下载集成

流程说明:

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

用户在业务应用app中输入激活码,进入SDK页面,引导用户输入短信验证码、设置证书pin码生成证书(或者由业务系统将激活码反给app,app通过调用sdk接口传入激活码),SDK内部完成证书下载。

img

集成接口

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

接口2:移动端接口 3.1.1邀请码注册

3.2 PC端扫码网页签章

用户已完成了移动证书下载,需要做PC端的网页签章,通过手机app扫码签实现

流程说明:

用户在PC端浏览流程或者表单数据,发起网页签章请求,业务系统将待签表单数据请求推到信步云,信步云返回签名任务ID和对应的二维码信息

业务系统收到返回的二维码信息,在浏览器中展示,同时发起轮询签章结果的请求

用户使用app扫码,扫码后弹出密码键盘,用户输入pin口令,完成网页签章

完成签名后业务系统轮询到签章结果,同时PC端关闭二维码,存入数据库中

PC端展示签章页面签,业务系统对签章数据进行验签,验签通过,正常显示签章表单,验签失败,显示错误签章图片,提示用户签章数据被篡改

img

集成接口

接口1:服务端接口3.2.1网页签章添加任务addSignWebPage

接口2:移动端接口3.3.1数据签名功能

接口3:服务端接口3.2.2网页签章获取结果getSignSealData4ESS

接口4:服务端接口3.2.3网页签章验签verifySignEss

4. 集成工作验证

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

移动端打开app,找到激活码激活入口,输入激活码,收到短信,设置证书口令,完成下证(下证验证通过)

PC端发起网页签章请求操作,页面弹出二维码,业务app扫码,弹出密码键盘,用户输入正确证书口令,提示签名成功,并显示正确签章图片;输入错误证书口令,提示签名失败,不显示签章页面(网页签章验证成功)。