人脸核身 启动意愿核身移动 H5

一、前置条件

摄像头授权操作示例：


二、前置条件

请合作方确保 NONCE ticket 已经正常获取，获取方式见 获取 NONCE ticket 。合作方根据本次意愿核身的如下参数生成签名,需要签名的参数信息如下：

注意：说明：

注意：参与签名的数据需要和使用该签名的接口中的请求参数保持一致。

三、基本步骤

1. 生成一个32位的随机字符串（字母和数字）nonce（接口请求时也要用到）。

2. 将 appId、userId、orderNo、version、faceId 连同 ticket、nonce 共7个参数的值进行字典序排序。

3. 将排序后的所有参数字符串拼接成一个字符串。

4. 将排序后的字符串进行 SHA1 编码，编码后的40位字符串作为签名（sign）。签名算法可参考 签名算法说明。

四、参考示例

·请求参数：

·字典排序后的参数为：

[1.0.0, aabc1457895464, appId001, bwiwe1457895464, kHoSxvLZGxSoFsjxlbzEoUzh5PAnTU7T, userID19959248596551, zxc9Qfxlti9iTVgHAjwvJdAZKN3nMuUhrsPdPlPVKlcyS50N6tlLnfuFBPIucaMS]

·拼接后的字符串为：

1.0.0aabc1457895464appId001bwiwe1457895464kHoSxvLZGxSoFsjxlbzEoUzh5PAnTU7TuserID19959248596551zxc9Qfxlti9iTVgHAjwvJdAZKN3nMuUhrsPdPlPVKlcyS50N6tlLnfuFBPIucaMS

·计算 SHA1 得到签名：

4E9DFABF938BF37BDB7A7DC25CCA1233D12D986B

该字串就是最终生成的签名（40位），不区分大小写。

五、启动 H5 意愿核身

合作方上送 faceId 以及 sign，后台校验 sign 通过之后重定向到 H5 意愿核身。

注意：1. optimalDomain 使用合作方后台上送身份信息 接口返回的 optimalDomain 域名，如果 optimalDomain 字段返回为空或者取不到，默认使用域名 kyc1.qcloud.com。

注意：2. 该跳转 url 不能直接暴露在前端 html 页面的<a>标签中。某些浏览器会预加载<a>标签中的 url，导致用户点击访问该 url 时，因 url 已经被预加载访问过，于是签名失效，页面报错“签名不合法”。

注意：3. 合作方如果使用 iframe 框架，需要给 iframe 开启相机权限 allow="camera;"，并且内外层都需要使用 https 协议，方可正常使用实时检测人脸核身功能。

注意：示例：<iframe allow="camera *; microphone *; autoplay *;"></iframe>

·请求 URL：

https://{optimalDomain}/s/web/h5

·请求方法：GET

·请求参数：

·请求示例：

https://kyc1.qcloud.com/s/web/h5?appId=appId001&version=1.0.0&nonce=4bu6a5nv9t678m2t9je5819q46y9hf93&orderNo=161709188560917432576916585&faceId=wb04f10695c3651ce155fea7070b74c9&userId=23333333333333&sign=5DD4184F4FB26B7B9F6DC3D7D2AB3319E5F7415F&mode=will