跳转信手书小程序签名场景

1. 场景简介

客户没有自行维护的微信小程序,需要使用BJCA提供的信手书小程序,客户要完成在企业微信或者微信公众号内完成数据签名的应用场景。

在企业微信或者微信公众号的业务界面生成葵花码后,用户长按葵花码,直接唤起信手书小程序,输入证书PIN码,完成数据签名。

2. 集成准备

使用申请:在微信中搜索“信手书”小程序,使用手机号完成登录

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

服务端API接入配置参数:

appId=”67f6c99b74484c2b8bcb35473850cdd7”

deviceId=”DEV_B90213F1BAD64B7AA139724161E3B339”

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

3. 开始集成工作

集成说明:移动端无需集成,服务端接口指的是api服务接口,接入方式为restful接口,无集成语言限制

3.1 手机证书下载集成

流程说明:

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

2、用户在信手书小程序中找回证书,小程序引导用户输入短信验证码、设置证书pin码生成证书,完成手机证书下载。

集成接口

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

3.2 小程序数据签名

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

流程说明:

1、用户在公众号内部发起数据签名请求,请求到信步云平台,返回葵花码

2、业务系统收到葵花码后,在公众号页面展示

3、用户长按葵花码,直接跳转到信手书小程序,小程序中直接弹出密码键盘,用户输入pin口令,完成协同签名,关掉小程序,服务端轮询获取签名结果,公众号内部展示签名结果

img

集成接口

  1. 接口1:服务端接口3.2添加签名任务

  2. 接口4:服务端接口3.3获取签名结果

4. 集成工作验证

1、 通过服务端注册用户

2、 信手书小程序下载证书,收到短信后,回填短信验证码,设置证书口令,完成下证(下证验证通过)

3、 公众号内部发起数据签名请求,返回葵花码,长按葵花码,唤起小程序,弹出证书口令输入框,输入正确的证书口令,完成签名,提示签名成功,展示签名结果。

5. 常见问题及解决办法

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