推送业务数据至签名场景

1. 场景简介

客户没有自己的APP,使用BJCA的信手书APP,服务端采用了HTTP服务restfulAPI接入模式,业务系统将数据推送到信手书APP中,在APP中完成签名。场景如:互联网医院电子处方签名

2. 集成准备

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

服务端API接入配置参数:deviceId=”DEV_B90213F1BAD64B7AA139724161E3B339”

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

服务端API接入配置参数:appid=”67f6c99b74484c2b8bcb35473850cdd7”

接入环境的信手书APP(dev版)在演示平台下载:http: //demo.isignet.cn:8080/demo/

3. 开始集成工作

集成说明:移动端使用信手书APP,无需任何集成工作,服务端接口云服务接口,接入方式为restful接口,无开发语言限制

支持的推送数据类型:1、数据原文 2、hash 3、PDF(1M以下)4、网页签章数据

3.1 信手书APP手机证书下载(无集成)

流程说明:

打开信手书APP,进入登录页,输入手机号,短信验证后登录,在用户类型页,点击“个人入口”,进入个人证书首页

点击“下载证书”,进入身份验证页,输入正确的用户姓名、身份证号,点击“确定”,进入激活页,输入短信验证码,设置证书口令,完成证书下载

注意:若使用新手机号注册,申请证书时候需要先进行身份核验,人脸识别,核验通过后才能下载证书

3.2 用户注册

流程说明:

业务系统将经过身份核验的用户信息(姓名、身份证号、手机号)注册到信步云,返回用户邀请码,表示注册成功,该用户即可使用证书办理该业务系统的签名业务

集成接口

接口1:服务端接口3.1添加个人用户接口addTrustedUserser

3.3 推送业务数据至信手书APP,在APP中完成签名

用户已完成了手机证书下载,业务系统将待签业务数据推送至信手书AOO,在信手书APP中完成签名

流程说明:

用户在PC端发起数据推送请求,接口中指定了接收数据的用户

用户打开信手书APP,在待签标签下,拉取列表,会看到对应的待签数据(数据、hash、pdf文档)

点击“签署”,输入证书口令,完成签署

业务系统发起签署请求后,轮询获取签名结果,获取到签名结果后,存储到数据中

img

集成接口

接口1:服务端接口4.1添加签名任务addSignJob(传入用户id)

接口2:服务端接口4.2获取签名结果getSignResult

4. 集成工作验证

通过服务端注册用户

应用市场下载安装信手书APP,手机号登录,回填短信验证码,设置证书口令,完成下证(下证验证通过)

PC端发起推送数据请求操作,信手书APP待签列表拉取到待签数据或者文档,选择“签署”,弹出密码键盘,输入正确证书口令,提示签名成功,可以在已签列表中查看签署后的数据;输入错误证书口令,提示签名失败(数据推送签署验证成功)。

5. 常见问题及解决办法

服务端接口报错4011(报文中签名值计算不对,参考在线工具进行签名值验证:https: //demo-system.isignet.cn/signHelper/sign.html)

测试环境无需提服务开通申请

服务端集成,可以使用信手书APP(dev版)配合服务端功能验证,下载地址:http: //demo.isignet.cn:8080/demo/

生产环境可以直接在各应用市场搜索“信手书”完成APP下载安装