微信小程序-人脸核身解决方案

名词解释

由于不同公司对于 人脸识别的用词不一致，微信小程序背靠腾讯，因此以下的名词主要采集于腾讯云的解释

1. 人脸识别：

• 主要关注人脸的检测、分析、比对等技术层面，侧重于识别个体身份的技术实现。它利用人脸检测、五官定位、人脸搜索、人脸比对、人脸验证、活体检测等功能，来判断和确认两个人脸图像是否属于同一人。
  
• 应用场景包括但不限于在线相册分类、刷脸门禁、人脸考勤、人脸登录、人脸特效、在线考试等，更多地用于便捷性和安全性提升的场景中。
  

2. 人脸核身（又称人脸身份验证）：

• 是一个更综合的概念，不仅包含了人脸识别的技术，还加入了证件OCR识别、活体检测等技术，以实现对用户身份信息的真实性验证。它是一个完整的身份认证解决方案，目的是为了确认当前用户是否为其所声称的身份。
  
• 人脸核身主要用于需要高度安全性和合规性的场景，比如金融服务、政务平台、共享出行等行业，确保用户身份的合法性，防止身份冒用。
  

解决方案

在微信小程序中，想要实现人脸核身，无非两种解决方案

1. 第三方公司提供的人脸核身
2. 微信小程序自带的人脸核身

第三方公司提供的人脸核身

由于微信小程序的官方限制，并不是所有的微信小程序都可以使用官方提供的人脸核身功能。

现阶段微信人脸核验能力，针对小程序，开放的主体类目范围包含：

总得来说，如果你的微信小程序主体不符合以上资质，那么你只能选择第三方的公司提供的人脸核身方案了。

腾讯云 人脸核身

1. 活体人脸比对
   传入视频和照片，先判断视频中是否为真人，判断为真人后，再判断该视频中的人与上传照片是否属于同一个人。
   
2. 活体人脸核身
   传入视频和身份信息，先判断视频中是否为真人，判断为真人后，再判断该视频中的人与权威库的证件照是否属于同一个人。
   

阿里云 实人认证

链接

第三方公司的人脸核身通用流程

不管是使用任何第三方的人脸核身接口，都脱离不了以下相关流程

客户端-第三方服务接口

客户端-后端-第三方服务接口

此方案对比 客户端-第三方服务接口的主要区别是多了一层中间 后端

此时 后端 的存在主要是解决 自己业务的实际问题。如自己存储人脸相关数据，或者选择服务端接入的方式实现人脸核身。

微信小程序 - 人脸核身

来到此文重点讲解的部分。如你的公司或者组织符合相关资质。那么使用微信小程序-人脸核身方案会更存在优势

1. 接入人脸核身更简单
2. 暂时免费

认证流程

1. 微信认证
2. 补充小程序信息、名称、图表、描述等
3. 补充小程序服务类目-设置主营类目
4. 小程序备案

5. 开通人脸核身
   

编码流程

1. 检测设备是否支持人脸活体检测 wx.checkIsSupportFacialRecognition(OBJECT)
   接口说明和使用
   OBJECT 参数说明：

1. checkAliveType 的值和对应的解释：

1. CALLBACK 返回参数

1. 回调结果说明

1. 回调结果说明仅对Android生效，iOS不返回errcode。
2. 开始人脸活体检测

1. 业务方没有存储用户身份信息
   
2. 业务放有存储用户身份信息
   

无用户身份相关信息

此时调用接口需要传递用户的姓名+身份证相关信息

(一)接口描述 wx.startFacialRecognitionVerify(OBJECT)

(二)参数说明

1、OBJECT参数说明：

2、CALLBACK返回参数

3、回调结果说明

示例代码

async faceAuth() {
    try {
      const res = await wx.startFacialRecognitionVerify({
        name: "xxx",
        idCardNumber: "xxx"
      })
      console.log(res)
    } catch (e) {
      //TODO handle the exception
      console.log(e.message)
    }
  }

有用户身份相关信息

1、业务方上传用户姓名和身份证，获取用户凭证，把凭证给到前端通过 jsapi 调用

1.2 请求URL api.weixin.qq.com/cityservice… cess_token}

1.3 请求方式 POST

2、请求数据格式

Json
{
"name" : “张三”,
"id_card_number" : "452122xxxxxxx43215"
}

请求示例

#!/bin/bash TOKEN='xxxxxxxxxxxx'
 
URL='https://api.weixin.qq.com/cityservice/face/identify/getuseridkey' JSON='{ "name": "张三",id_card_number": "452344xxxxxxxxxxxxx234"}' curl "${URL}?access_token=${TOKEN}" -d "${JSON}"

 "

参数说明

3、返回数据

{
"errcode" : 0, "errmsg" : "ok",
"user_id_key" : "id_key_xxxx", "expires_in": 3600
}

4、后台消息推送 如果业务方传入out_seq_no，核身完成后会通过消息推送回调给业务方的服务器，如果回调业务方失败，会在5s尽力推送，超过5s不再推送。

参数说明

返回示例

{
  "ToUserName": "gh_81fxxxxxxxx",
  "FromUserName": "oRRn15NUibBxxxxxxxxx",
  "CreateTime": 1703657835,
  "MsgType": "event",
  "Event": "face_identify",
  "openid": "oRRn15NUibBxxxxxxxxx",
  "out_seq_no": "test1234",
  "verify_result": "XXIzTtMqCxwOaawoE91-VNGAC3v1j9MP-5fZJxv0fYT4aGezzvYlUb-n6RWQa7XeJpQo0teKj8mGE4ZcRe1JI3GqzADBYORBu613rKjKAFfEXTXw_bu1bs7MnmPOpguS"
}

四、再次获取核验结果api

此接口是前端完成人脸核身后，基于前端返回的凭据，通过后台api再次进行核验结果和身份信息的校验，有助于提高安全性，请务必接入！ 前端获取结果不可信，存在被篡改的风险，为了保障请求结果安全性，请务必对identify_ret、id_card_number_md5、name_utf8_md5字段进行校验！

(一)API说明

1、说明

人脸核身之后，开发者可以根据jsapi返回的verify_result向后台拉取当次认证的结果信息。

2、请求URL

api.weixin.qq.com/cityservice…

3、请求方式

POST

4、请求格式

json

(二)请求数据说明

1、请求

2、数据返回 HTTP 头如下

Date: Mon, 06 Feb 2017 08:12:58 GMT Content-Type: application/json; encoding=utf-8 Content-Length: 85 Connection: close

json示例

{
"errcode" : 0,
"errmsg" : "ok", "identify_ret" : 0,
"identify_time" : 1486350357
"validate_data": "8593"

(三)返回参数说明

1、返回参数

注：errcode和identify_ret同时为0，代表本次认证成功。

2、错误码对应信息

参考链接

1. 微信人脸核身接口能力官方