移动端扫码数据签名场景
1. 场景简介
客户自有app,移动端集成信步云sdk,服务端采用了HTTP服务restfulAPI接入模式,实现移动端数据签名的功能,常见场景如:医护人员查房/移动执法等应用场景
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内部完成证书下载。
集成接口
接口1:服务端接口3.3.1添加信任用户接口addTrustedUser
接口2:移动端接口 3.1.1邀请码注册
3.2 APP端数据签名
用户已完成了移动证书下载,需要做APP端的数据签名
流程说明:
移动端准备好数据,发起数据签名请求,由app端将待数据推给业务系统,业务系统发起数据签名请求到信步云,信步云返回签名任务ID
业务系统收到返回的签名任务ID,返回给APP
app弹出密码键盘,用户输入pin口令,完成数据签名
完成签名后,APP告知服务端已签名完成,业务服务端根据签名任务ID获取签名结果,并保存到数据库中,并将签名结果返回给app
app刷新页面显示签名结果
集成接口
接口1:服务端接口3.2.9.添加数据签名任务/signjob/v1/addSignJob
接口2:移动端接口3.3.1数据签名功能
接口3:服务端接口3.2.10.获取签名结果/signjob/v1/querySignJob
接口4:服务端接口3.2.8.数据签名验签/verify/v1/verifySign
4. 集成工作验证
通过服务端注册用户,返回激活码
移动端打开app,找到激活码激活入口,输入激活码,收到短信,设置证书口令,完成下证(下证验证通过)
移动端业务发起数据签名请求操作,弹出密码键盘,用户输入正确证书口令,提示签名成功,并显示签名结果;输入错误证书口令,提示签名失败,不显示签名结果(数据签名验证成功)。