这里咱们使用腾讯云的人脸核身来给你们作一个基础的介绍和使用java
1、基本介绍
1.概述
人脸核身：通常是对一组对用户身份信息真实性进行验证审核的服务套件提供各种认证功能模块，包含证件 OCR 识别、活体检测、人脸1 : 1对比等能力，以解决行业内大量对用户身份信息核实的需求。web
2.功能特色
OCR 识别
支持识别身份证正反面，一次扫描便可返回身份证号、姓名、有效时间等全部字段，数字识别准确率达到 99.9% 以*上，在多个字段上处于领先水平。处理倾斜、暗光、曝光、阴影等异常状况稳定性好，自适应判别纠正技术大大提升识别准确率。算法
活体检测
活体检测， 主要针对高安全性要求的人脸核身验证而研发的一种技术， 防止照片、视频、静态3D建模等各类不一样类型的攻击； 目前支持唇语读数、动做、静默等多种活体模式，适用于多类验证场景。spring
1：1人脸比对
人脸比对，根据面部特征，计算两张人脸的类似度，自动进行身份鉴别。立足于腾讯社交数据大平台收集的海量人脸训练集，结合高维 LBP、PCA、LDA 联合贝叶斯、度量学习、迁移学习、深度神经网络， LFW 测评准确度为 99.80%。并支持多场景下的识别验证，对年龄、姿态及光强均有较好的支持度。api
3.使用场景
综合政务服务、公安微警务、工商企业注册、养老金领取生存验证等
银行开户、保险验证
各大运营提供的在线申请号码、购买手机卡、预装宽带等 网吧上网实名登记、酒店住宿实名登记等
机场安检登机、铁路安检购票、长途客运购票、边检口岸通关等
2、术语概述
咱们主要是使用其中的两个接口，DetectAuth(实名核身鉴权)、GetDetectInfo(获取实名核身结果信息)。这两个功能基本能够实现咱们的的人脸核身这个功能需求。安全
基础参数说明
参数名称
类型
必选
描述
Action
String
是
操做的接口名称。取值参考接口文档中输入参数公共参数 Action 的说明。例如云服务器的查询实例列表接口，取值为 DescribeInstances。
ruleid
String
是
用于调用配置的业务流程，可在 人脸核身控制台-自助接入 建立业务流程，流程审核经过后，系统会自动建立流程并分配业务 ID(ruleid)，建立 ruleid 的过程当中，须要肯定如下问题：
Region
String
是
地域参数，用来标识但愿操做哪一个地域的数据。接口接受的地域取值参考接口文档中输入参数公共参数 Region 的说明。注意：某些接口不须要传递该参数，接口文档中会对此特别说明，此时即便传递该参数也不会生效。
Timestamp
Integer
是
当前 UNIX 时间戳，可记录发起 API 请求的时间。例如1529223702，若是与当前时间相差过大，会引发签名过时错误。
Nonce
Integer
是
随机正整数，与 Timestamp 联合起来，用于防止重放攻击。
SecretId
String
是
在云API密钥上申请的标识身份的 SecretId，一个 SecretId 对应惟一的 SecretKey ，而 SecretKey 会用来生成请求签名 Signature。
Signature
String
是
请求签名，用来验证这次请求的合法性，须要用户根据实际的输入参数计算得出。具体计算方法参见接口鉴权文档。
Version
String
是
操做的 API 的版本。取值参考接口文档中入参公共参数 Version 的说明。例如云服务器的版本 -03-12。
SignatureMethod
String
否
签名方式，目前支持 HmacSHA256 和 HmacSHA1。只有指定此参数为 HmacSHA256 时，才使用 HmacSHA256 算法验证签名，其余状况均使用 HmacSHA1 验证签名。
Token
String
否
临时证书所用的 Token ，须要结合临时密钥一块儿使用。临时密钥和 Token 须要到访问管理服务调用接口获取。长期密钥不须要 Token 。
DetectAuth(实名核身鉴权)
在使用人脸核身以前须要:先调用本接口获取BizToken，用来串联核身流程，在验证完成后，用于获取验证结果信息。服务器
GetDetectInfo(获取实名核身结果信息)
为了获取用户的验证信息，是否经过。若是经过能够指定拉取的结果信息，取值(0：所有；1：文本类；2：身份证正反面；3：视频最佳截图照片；4：视频)微信
3、基本接口说明使用
DetectAuth(实名核身鉴权)
输入参数网络
这里咱们就只要一些基础信息就能够完成集成，若是有其它需求请根据参数再传递便可。app
这里咱们就只用一些它的必传参数，还有一个回调地址便可。
参数名称
必选
类型
描述
Action
是
String
公共参数，本接口取值：DetectAuth。
Version
是
String
公共参数，本接口取值：-03-01。
Region
是
String
公共参数，详见产品支持的 地域列表。
RuleId
是
String
用于细分客户使用场景，申请开通服务后，能够在腾讯云慧眼人脸核身控制台(https://console./faceid) 自助接入里面建立，审核经过后便可调用。若有疑问，请加慧眼小助手微信(faceid001)进行咨询。
TerminalType
否
String
本接口不须要传递此参数。
IdCard
否
String
身份标识(未使用OCR服务时，必须传入)。 规则：a-zA-Z0-9组合。最长长度32位。
Name
否
String
姓名。(未使用OCR服务时，必须传入)最长长度32位。中文请使用UTF-8编码。
RedirectUrl
否
String
认证结束后重定向的回调连接地址。最长长度1024位。
Extra
否
String
透传字段，在获取验证结果时返回。
ImageBase64
否
String
用于人脸比对的照片，图片的BASE64值； BASE64编码后的图片数据大小不超过3M，仅支持jpg、png格式。
输出参数
参数名称
类型
描述
Url
String
用于发起核身流程的URL，仅微信H5场景使用。
BizToken
String
一次核身流程的标识，有效时间为7,200秒； 完成核身后，可用该标识获取验证结果信息。
RequestId
String
惟一请求 ID，每次请求都会返回。定位问题时须要提供该次请求的 RequestId。
GetDetectInfo(获取实名核身结果信息)
输入参数
如下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。
参数名称
必选
类型
描述
Action
是
String
公共参数，本接口取值：GetDetectInfo。
Version
是
String
公共参数，本接口取值：-03-01。
Region
是
String
公共参数，详见产品支持的 地域列表。
BizToken
是
String
人脸核身流程的标识，调用DetectAuth接口时生成。
RuleId
是
String
用于细分客户使用场景，申请开通服务后，能够在腾讯云慧眼人脸核身控制台(https://console./faceid) 自助接入里面建立，审核经过后便可调用。若有疑问，请加慧眼小助手微信(faceid001)进行咨询。
InfoType
否
String
指定拉取的结果信息，取值(0：所有；1：文本类；2：身份证正反面；3：视频最佳截图照片；4：视频)。 如 134表示拉取文本类、视频最佳截图照片、视频。 默认值：0
输出参数
参数名称
类型
描述
DetectInfo
String
JSON字符串。 { // 文本类信息 “Text”: { “ErrCode”: null, // 本次核身最终结果。0为成功 “ErrMsg”: null, // 本次核身最终结果信息描述。 “IdCard”: “”, // 本次核身最终得到的身份证号。 “Name”: “”, // 本次核身最终得到的姓名。 “OcrNation”: null, // ocr阶段获取的民族 “OcrAddress”: null, // ocr阶段获取的地址 “OcrBirth”: null, // ocr阶段获取的出生信息 “OcrAuthority”: null, // ocr阶段获取的证件签发机关 “OcrValidDate”: null, // ocr阶段获取的证件有效期 “OcrName”: null, // ocr阶段获取的姓名 “OcrIdCard”: null, // ocr阶段获取的身份证号 “OcrGender”: null, // ocr阶段获取的性别 “LiveStatus”: null, // 活体检测阶段的错误码。0为成功 “LiveMsg”: null, // 活体检测阶段的错误信息 “Comparestatus”: null,// 一比一阶段的错误码。0为成功 “Comparemsg”: null, // 一比一阶段的错误信息 “Location”: null, // 地理位置信息 “Extra”: “”, // DetectAuth结果传进来的Extra信息 “Detail”: { // 活体一比一信息详情 “LivenessData”: [] } }, // 身份证正反面照片Base64 “IdCardData”: { “OcrFront”: null, “OcrBack”: null }, // 视频最佳帧截图Base64 “BestFrame”: { “BestFrame”: null }, // 活体视频Base64 “VideoData”: { “LivenessVideo”: null } }
RequestId
String
惟一请求 ID，每次请求都会返回。定位问题时须要提供该次请求的 RequestId。
4、开发工具类
maven导包
com.tencentcloudapi
tencentcloud-sdk-java
3.0.112
常量管理
/**
* 人脸核身相关参数
*/
public static final String FACEKERNEL_SECRETID = "标识身份的 SecretId |";
public static final String FACEKERNEL_SECRETKEY = "标识身份的SecretKey ，SecretKey 会用来生成请求签名 Signature。 ";
public static final Object FACEKERNEL_RULEID = "用于调用配置的业务流程";
代码
import mon.collect.MapUtils;
import mon.mapper.JsonMapper;
import mon.constant.TencentFaceConstant;
import mon.Credential;
import mon.exception.TencentCloudSDKException;
import mon.profile.ClientProfile;
import mon.profile.HttpProfile;
import com.tencentcloudapi.faceid.v0301.FaceidClient;
import com.tencentcloudapi.faceid.v0301.models.DetectAuthRequest;
import com.tencentcloudapi.faceid.v0301.models.DetectAuthResponse;
import com.tencentcloudapi.faceid.v0301.models.GetDetectInfoRequest;
import com.tencentcloudapi.faceid.v0301.models.GetDetectInfoResponse;
import java.util.Map;
/**
* 人脸识别工具类
*/
public class RealNameAuthUtils {
/**
* 获取实名核身鉴权结果
* @param redirectUrl 认证结束后重定向的回调连接地址。最长长度1024位
* @return
*/
public static String getDetectAuthResult(String redirectUrl){
String result = "";
try{
//用户验证 id和对应密钥
Credential cred = new Credential(TencentFaceConstant.FACEKERNEL_SECRETID, TencentFaceConstant.FACEKERNEL_SECRETKEY);
HttpProfile httpProfile = new HttpProfile();
httpProfile.setEndpoint("faceid.ap-");
ClientProfile clientProfile = new ClientProfile();
clientProfile.setHttpProfile(httpProfile);
//设置前置信息，如用户验证信息，地域信息(越近越快)，请求域名地址
FaceidClient client = new FaceidClient(cred, "ap-chengdu", clientProfile);
Map paramMap = MapUtils.newHashMap();
//paramMap.put("RedirectUrl",Constant.FACEKERNEL_REDIRECTURL);
//设置了一个回调地址连接
paramMap.put("RedirectUrl",redirectUrl);
paramMap.put("RuleId", TencentFaceConstant.FACEKERNEL_RULEID);
String params = JsonMapper.toJson(paramMap);
DetectAuthRequest req = DetectAuthRequest.fromJsonString(params, DetectAuthRequest.class);
DetectAuthResponse resp = client.DetectAuth(req);
result = DetectAuthRequest.toJsonString(resp);
System.out.println(result);
} catch (TencentCloudSDKException e) {
System.out.println(e.toString());
result = "error";
}
return result;
}
/**
* 获取实名核身结果信息
* @param bizToken
* @return
*/
public static String getDetectInfo(String bizToken){
String result = "";
try{
Credential cred = new Credential(TencentFaceConstant.FACEKERNEL_SECRETID, TencentFaceConstant.FACEKERNEL_SECRETKEY);
HttpProfile httpProfile = new HttpProfile();
httpProfile.setEndpoint("faceid.ap-");
ClientProfile clientProfile = new ClientProfile();
clientProfile.setHttpProfile(httpProfile);
FaceidClient client = new FaceidClient(cred, "ap-chengdu", clientProfile);
Map paramMap = MapUtils.newHashMap();
paramMap.put("BizToken",bizToken);
paramMap.put("RuleId", TencentFaceConstant.FACEKERNEL_RULEID);
String params =JsonMapper.toJson(paramMap);
GetDetectInfoRequest req = GetDetectInfoRequest.fromJsonString(params, GetDetectInfoRequest.class);
GetDetectInfoResponse resp = client.GetDetectInfo(req);
result = GetDetectInfoRequest.toJsonString(resp);
System.out.println(result);
} catch (TencentCloudSDKException e) {
System.out.println(e.toString());
result = "error";
}
return result;
}
}
