人脸核身(支付宝)MP2.0 _学谷人脸核身

1. 简要描述

• 目标小程序跳转到人脸小程序，完成人脸识别；
• 通过人脸识别，完成个人身份的校验；
• 比对的照片库为公安一所的校验库；

2. 使用前须知

• 此插件服务由学谷智能提供，须在官网注册获取商户号才能使用；https://plugin.shargoodata.com

3. 获取 Token 的接口

功能：提供服务端和前端两种获取token方式，建议服务端获取更安全；

服务端获取方法：

简要描述：

• api获取请求token

请求URL:

 接口地址：https://gauss.shargoodata.com/gauss/authorization/token.json
 请求方式：POST
 数据类型：x-www-form-urlencoded

请求参数:

响应结果:

附：小程序前端调用方法（供参考）：

wx.request({
  url: 'https://gauss.shargoodata.com/gauss/authorization/token.json',
  data: {
    platformNo: '*****', // 此为[学谷智能]商户号，请到注册邮箱查看; (商户号注册：https://plugin.shargoodata.com/)
    secretKey: '*****'
  },
  dataType: 'JSON',
  method: 'POST',
  header: {
    'content-type': 'application/x-www-form-urlencoded'
  },
  success: function(res) {
    console.log(res)
  }
})

接口返回结果实例：

{
    data: "" // 返回的token
    outside_no: null
    success: true
}

4. 支付宝跳转api

const uuid; // 作为唯一key，16位 (仅用于加密，可以使用在线生成uuid工具，也可以后端生成)

// api文档可参考：https://developers.weixin.qq.com/miniprogram/dev/api/navigate/wx.navigateToMiniProgram.html
my.navigateToMiniProgram({
    appId: '2021003157626188',   // 跳转到另外一个小程序的appId（复制即可）
    path: 'pages/source/index?id=' + uuid,   // 跳转到小程序的页面（复制即可）
    extraData: {
        params: aseEncryptParams(JSON.stringify(data), uuid)
    },  // data需要携带的信息，具体请见详情
    success(res) {  // success }  // 跳转成功
})

data输入信息

extraInfo

返回信息

加密库

// 这里使用CryptoJS
import CryptoJS from 'crypto-js';
/**
 * ASE加密
 * @description 使用加密秘钥，对 需要加密的参数 进行加密
 * @param {string} word - 需要加密的参数，这里最好用JSON.stringify序列化
 * @param {string} key - 加密密钥（长度必须是 16 的整数倍，这里我们可以用uuid）
 */
export function aseEncryptParams(word: json, key: string) {
  // 加密的参数 - 从 UTF-8编码 解析出原始字符串
  const wordUTF8 = CryptoJS.enc.Utf8.parse(word);
  // 密钥 - 从 UTF-8编码 解析出原始字符串
  const keyUTF8 = CryptoJS.enc.Utf8.parse(key);

  const encrypted = CryptoJS.AES.encrypt(wordUTF8, keyUTF8, {
    mode: CryptoJS.mode.ECB,
    padding: CryptoJS.pad.Pkcs7,
  });

  return encrypted.toString();
}

/**
 * ASE解密
 * @description 使用加密秘钥，对 需要解密的参数 进行解密
 * @param {string} encryptedWord - 需要解密的参数
 * @param {string} key - 加密密钥（长度必须是 16 的整数倍）
 */
export function aesDecryptParams(encryptedWord: string, key: string) {
  // 密钥 - 从 UTF-8编码 解析出原始字符串
  const keyUTF8 = CryptoJS.enc.Utf8.parse(key);

  const bytes = CryptoJS.AES.decrypt(encryptedWord, keyUTF8, {
    mode: CryptoJS.mode.ECB,
    padding: CryptoJS.pad.Pkcs7,
  });

  return JSON.parse(bytes.toString(CryptoJS.enc.Utf8))
}

Demo

import CryptoJS from 'crypto-js';

Page({
  data: {
    token: ""
  },
  onLoad() {
    this.init() // 初始化获取token
  },
  init() {
    const that = this
    my.request({
      url: 'https://gauss.shargoodata.com/gauss/authorization/token.json',
      data: {
        platformNo: "xxx", // 商户号
        secretKey: "xxx" // 密钥
      },
      dataType: 'JSON',
      method: 'POST',
      header: {
        'content-type': 'application/x-www-form-urlencoded'
      },
      success: function(res) {
        that.setData({
          token: JSON.parse(res.data).data
        })
      }
    })
  },
  /**
  * 点击事件
  */
  handleToProgram() {
    const uuid = "xxx" // 作为唯一key，16位 (仅用于加密，可以使用在线生成uuid工具，也可以后端生成)
    const data = {
      token: this.data.token,
      platformNo: "xxx",  // 商户号
      orderNo: "xxx",  // 订单号
      type: "identity",  // 产品类型
      extraInfo: {
        idName: "原则", // 仅限demo使用，调试环境请替换成真实数据
        idNumber: "327462199901122356" // 仅限demo使用，调试环境请替换成真实数据
      },
      extendData: {
        a: 1,
        b: 2
      }
    }
    my.navigateToMiniProgram({
      appId: '2021003157626188', // 跳转到另外一个小程序的appId（复制即可）
      path: 'pages/source/index?id=' + uuid,  // 跳转到小程序的页面（复制即可）
      extraData: {
        params: this.aseEncryptParams(JSON.stringify(data), uuid)
      },
      success(res) {
        console.log(res)
      }
    })
  },
  /**
  * 加密函数
  */
  aseEncryptParams(word, key) {
    // 加密的参数 - 从 UTF-8编码 解析出原始字符串
    const wordUTF8 = CryptoJS.enc.Utf8.parse(word);
    // 密钥 - 从 UTF-8编码 解析出原始字符串
    const keyUTF8 = CryptoJS.enc.Utf8.parse(key);

    const encrypted = CryptoJS.AES.encrypt(wordUTF8, keyUTF8, {
      mode: CryptoJS.mode.ECB,
      padding: CryptoJS.pad.Pkcs7,
    });

    return encrypted.toString();
  }
})

5. 查询接口：“人脸核身”处理结果的后端查询

功能：给需要安全性要求高的，希望通过服务端查询人脸核身结果的商户使用；

请求URL:

接口地址：https://gauss.shargoodata.com/gauss/mp/ocr/query
请求方式：POST
数据类型：x-www-form-urlencoded

表头：

表体：

返回信息

success为true时,code取值说明

success为false时,error_code报错码枚举:

6. 联系客服：

• 手机号：15068737550

• 邮箱： enjoycai@shargoodata.com

• 微信: