0
点赞
收藏
分享

微信扫一扫

微信公众号(微信H5)网页对接腾讯云慧眼人脸核验

sullay 2023-11-30 阅读 50

微信原生 H5 浮层模式和小程序是基于微信原生的体验,客户体验好,但有明确的主体行业限制。但是腾讯云慧眼因为都是腾讯的,所以可以接入更为友好的效果,只是最优的那个模式行业要求非常严格,所以放弃了这个选项,退一步,选择普通模式

微信公众号(微信H5)网页对接腾讯云慧眼人脸核验_json

 

 

 上图就是最优方案的资质要求

普通模式则不用这些资质了。

在微信原生 H5 浮层模式之外,慧眼为无法使用浮层模式的客户提供了备选方案,普通模式没有行业限制。

人脸核身提供身份证 OCR、活体检测、人脸比对三个功能组合使用:

  1. 身份证 OCR :该功能为非必选项,若不需要,可以选择:手动输入或调用时传入身份信息。
  2. 活体检测:
  • 浮层模式:支持数字活体检测、光线活体检测、光线+数字活体检测,三选一。
  • 普通模式:支持读数活体检测、动作活体检测、静默活体检测,三选一。
  1. 人脸比对,支持两种方式:
    (1)跟公安权威库比对。
    (2)跟上传照片比对。
  2. 确认使用模式和功能后,需要创建业务流程,获取 RuleId 用于调用。
    创建入口: 人脸核身控制台-自助接入 。
    流程审核通过后,系统会配置对应流程并分配一个 RuleId,客户可以使用 RuleId 调用 DetectAuth 接口,使用人脸核身服务。

其实,腾讯云慧眼集成的相当的友好的,只要控制后台开通了服务,申请一个流程就行了,这个流程可自由组合搭配的,比较灵活

有了RuleId,还要去控制台生成一个密钥对,SecretId和SecretKey,下面直接开始对接吧!

首先要去GitHub下载最新的sdk包,我是使用PHP对接的,因此去找到PHP的库包,不过官方已经暂停提供直接下载库包了,要通过composer下载,不过我下载好了一个,放网盘了,可以直接拿去用,全量的

链接: http://caiyun.feixin.10086.cn/dl/055CgRlGP1jKt  提取码:p6zu  复制内容打开和彩云手机APP,操作更方便哦

下载好类库放到项目的文件夹中,位置一般都有个库包文件夹,大家各自喜好

步骤:

根据官网的教程,先使用实名核身鉴权接口调起业务流程,然后根据流程结束后回调返回的BizToken去获取本次认证的信息,比较简单

官方的说法:

  1. 接入准备:
  • 登录 人脸核身控制台 ,申请 ruleid 参数,在自助接入中申请创建微信 H5(通用模式)或微信原生 H5(浮层模式)业务流程,ruleid 的申请,请参考 微信 HTML5 接入准备。
  • 登录官网控制台 创建 API 密钥(SecretId 和 SecretKey)
  1. 接入方前端显示核身入口,调用接入方服务端接口。
  2. 接入方服务端调用实名核身鉴权 DetectAuth 接口,传入核身所需信息与业务回跳地址 RedirectUrl,获取到核身流程标识(BizToken)及核身入口 URL 。在线调试。
  3. 接入方前端通过地址跳转方式重定向至步骤3中获取的核身入口 URL,进入核身流程。
  4. 用户完成人脸核身后,页面会跳转到 RedirectUrl 上,地址中会带上此次验证流程使用的 BizToken,接入方服务端即可凭借 BizToken 参数调用获取实名核身结果信息 GetDetectInfo 接口去获取本次核身的详细信息

微信公众号(微信H5)网页对接腾讯云慧眼人脸核验_H5_02

 

 

 其实这个图片我看着感觉比较复杂,我简单描述一下,准备好参数,传参过去腾讯服务器,服务器返回数据,我们再拿数据去查数据,就是这样子

关于接口的调用方式大家各有所好,我是把调用封装在一个类中,供全局调用

第一步:创建一个类文件

QcloudFaceAuth.PHP

<?php
/**
 * 腾讯云慧眼
 */
require_once dirname(__FILE__).'/../../library/tencentcloud-sdk-php/autoload.php';
use TencentCloud\Common\Credential;
use TencentCloud\Common\Profile\ClientProfile;
use TencentCloud\Common\Profile\HttpProfile;
use TencentCloud\Common\Exception\TencentCloudSDKException;
use TencentCloud\Faceid\V20180301\FaceidClient;
use TencentCloud\Faceid\V20180301\Models\DetectAuthRequest;
use TencentCloud\Faceid\V20180301\Models\GetDetectInfoEnhancedRequest;
class QcloudFaceAuth{
    public $secretId;
    public $secretKey;
 
    function __construct($secretId, $secretKey) {
        $this->secretId = $secretId;
        $this->secretKey = $secretKey;
    }<br>//调用鉴权认证流程方法
    public function getDetectAuth($region,$params){
        try {
            $cred = new Credential($this->secretId, $this->secretKey);
            $httpProfile = new HttpProfile();
            $httpProfile->setEndpoint("faceid.tencentcloudapi.com");
 
            $clientProfile = new ClientProfile();
            $clientProfile->setHttpProfile($httpProfile);
            $client = new FaceidClient($cred, $region, $clientProfile);
 
            $req = new DetectAuthRequest();
 
            $req->fromJsonString(json_encode($params));
 
            $resp = $client->DetectAuth($req);
 
            return ['code'=>1,'msg'=>'success','data'=>$resp->toJsonString()];
        }catch (TencentCloudSDKException $e){
            return ['code'=>0,'msg'=>$e->getMessage(),'data'=>''];
        }
 
    }<br>//获取认证信息方法
    public function getDetectInfoEnhanced($region,$params){
        try {
 
            $cred = new Credential($this->secretId, $this->secretKey);
            $httpProfile = new HttpProfile();
            $httpProfile->setEndpoint("faceid.tencentcloudapi.com");
 
            $clientProfile = new ClientProfile();
            $clientProfile->setHttpProfile($httpProfile);
            $client = new FaceidClient($cred, $region, $clientProfile);
 
            $req = new GetDetectInfoEnhancedRequest();
 
            $req->fromJsonString(json_encode($params));
 
            $resp = $client->GetDetectInfoEnhanced($req);
 
            return ['code'=>1,'msg'=>'success','data'=>$resp->toJsonString()];
        }
        catch(TencentCloudSDKException $e) {
            return ['code'=>0,'msg'=>$e->getMessage(),'data'=>''];
        }
    }
 
}

可以看到就两个方法,一个是调起流程(getDetectAuth),一个是获取信息(getDetectInfoEnhanced)

然后在你想使用的地方引入或者包含这个类文件就可以new一个对象调用方法了

include_once dirname(__FILE__).'/inc/common/QcloudFaceAuth.php';

调用位置:

$params=[
       "RuleId" => "申请的业务流程id",
       "IdCard" => '身份证号',
       "Name" => '姓名',
       "RedirectUrl"=>'回调地址,也就是认证流程完成之后跳转的地址',
   ];
 
   $SecretId='你的秘钥id';
   $SecretKey='你的秘钥';
   $faceAuth=new QcloudFaceAuth($SecretId,$SecretKey);
   $region='地区';//ap-chengdu西南地区(成都),ap-guangzhou华南地区(广州)
   $resp=$faceAuth->getDetectAuth($region,$params);
   $resp=json_decode($resp['data'],true);
   if ($resp){
       $this->resultJson(['code'=>200,'msg'=>'success','data'=>$resp]);
   }else{
       $this->resultJson(['code'=>0,'msg'=>$resp,'data'=>[]]);
   }

这里返回的数据中,我们需要取到的是一个流程URL,也就是$resp['Url'],然后你可以让程序调整访问这个URL就可以进入认证流程了;

等流程结束后,会跳转到刚才传过去的 RedirectUrl地址上,然后你可以在这个地址获取返回的BizToken,然后去请求获取认证结果接口

$params = array(
            "InfoType" => "0",
            "BizToken" => $BizToken,
            "RuleId" => "1"
        );
        $SecretId='你的秘钥id';
        $SecretKey='你的秘钥';
        $faceAuth=new QcloudFaceAuth($SecretId,$SecretKey);
        $region='ap-chengdu';//同上接口解释
 
        $resp=$faceAuth->getDetectInfoEnhanced($region,$params);//获取认证信息接口调用<br>//往下就是自己的业务代码
        load()->func('file');
        $resp=json_decode($resp['data'],true);
        if ($resp['Text']['ErrCode']===0){
            $base64_image_content=$resp['BestFrame']['BestFrame'];
            $path = '/images/shot';
            $new_file = $path."/".date('Ymd',time())."/";
            if(!file_exists(MODULE_ROOT.$new_file)){
                //检查是否有该文件夹,如果没有就创建,并给予最高权限
                mkdirs(MODULE_ROOT.$new_file);
            }
            $new_file = $new_file.time().".jpg";
            if (file_put_contents(MODULE_ROOT.$new_file, base64_decode($base64_image_content))){
                $data = array(
                    'uniacid'    => $uniacid,
                    'uid'        => $uid,
                    'lessonid'   => $id,
                    'sectionid'  => $sectionid,
                    'path'       => $new_file,
                    'addtime'    => time()
                );
                $r = pdo_insert($this->table_member_shot, $data);
                if($r){
                    //$this->resultJson(['code'=>200,'msg'=>'success','data'=>$r]);
                }else{
                    message('认证数据写入失败', $this->createMobileUrl('lesson', array('id'=>$id,'sectionid'=>$sectionid,'uid'=>$uid)), "warning");
                }
            }else{
                message('认证取样失败', $this->createMobileUrl('lesson', array('id'=>$id,'sectionid'=>$sectionid,'uid'=>$uid)), "warning");
            }
        }else{
            message('认证失败,请重新认证', $this->createMobileUrl('lesson', array('id'=>$id,'sectionid'=>$sectionid,'uid'=>$uid)), "warning");
        }

 只要拿到了BizToken,通过接口获取认证信息,然后做自己想要的业务判断了,我这里获取了视频认证中返回的最佳帧图片,存到本地来,他们接口返回的图片是base64格式的,所以要转换一下

其实接口不难,就是调试时候很多小毛病,需要细心注意

微信公众号(微信H5)网页对接腾讯云慧眼人脸核验_H5_03

 

举报

相关推荐

0 条评论