全部产品
云市场

实人认证

更新时间:2020-03-24 20:28:08

通过实人姓名和身份证进行核实,调用ios/安卓sdk下载地址及文档待补充。

1实人认证整体架构

1

2实人认证处理流程

2

3实人认证SDK适用范围

Android Min SdkVersion: API 19: Android 4.4 (KitKat)
适用架构:armeabi,armeabi-v7a, arm64-v8a

4实人认证SDK使用步骤

1.app 中正确添加aar
2. 初始化
iPManager = new IPManager();
//初始化
//public int init(Context context)
//input: context
//成功返回0, 失败返回其他值
ipManager.init(this);
3.空发
//获取本地是否存在id2
//public int id2ClientGetProvStat()
//已存在, 返回1, 其他返回0
int state = iPManager.id2ClientGetProvStat();

//生成空发认证码
//public byte[] id2ClientGetOtpAuthCode(byte[] token)
//input: 临时token, base64 编码,从服务端接收到的tmp_token直接传入
//success 返回authcode,需base64编码后上传服务端, failed 返回null
byte[] authcode = iPManager.id2ClientGetOtpAuthCode(tmp_token);

//解析并存储id2
//public int id2ClientLoadOtpData(byte[] otp_data)
//input: otp_data, 从服务端接收到的otp_data需base64 解码后传入
//success 返回0,failed 返回其他值
iPManager.id2ClientLoadOtpData(otp_data)//空发id2
4.获取image
//设置listerner 监听getImage 的结果
iPManager.setListener(new IPListener() {

  1. @Override<br /> public void onResult(IPErrorCode errcode, IPResult result) {<br />//errcode 为IP_SUCCESS 时, result 中为image正确值<br /> }<br />});<br /> <br />//public void getImage(Context context, final String timestamp)<br />//input: unix timestamp 单位ms

iPManager.getImage(this, timestamp);

返回结果参数说明
类IPResult

字段 含义
id Id2 id
authcode 验证码
token 加密后的token
image 人脸数据


类IPErrorCode

字段 含义
IP_SUCCESS 认证成功
IP_FAIL 认证失败
IP_NOT 认证中断
IP_EXCEPTION 认证异常


4.5 调用结束
//调用结束, 与init 配对使用
//public int cleanup()
ret = iPManager.cleanup();

注:使用实人认证sdk时,如果返回错误结果,可使用adb logcat命令过滤标签IDENTIFY_PERSON,TEE,ID2,LS_LOG查看实人认证sdk 相关日志。

5实人认证临时token获取接口

为实人认证接口获取临时token,用户实人认证接口调用时做验证

接口 版本 描述
/home/paas/person/verify/token/get 1.0.0

请求参数

字段名 类型 必填 备注
apiVersion String api版本号,当前取值1.0.0

返回结果

参数名 参数描述 数据类型
data 临时token,可重复获取,有效期:10min~20min。

base64格式编码
| String |

6实人认证请求空发ID2

为实人认证接口获取临时token,用户实人认证接口调用时做验证

接口 版本 描述
/home/paas/person/verify/id/get 1.0.0

请求参数

字段名 类型 必填 备注
apiVersion String api版本号,当前取值1.1.2
deviceAuthCode String 基于空发token生成的设备端认证码,服务端通过其验证设备空发的合法性,调用ios/安卓sdk获取该字段

返回结果

参数名 参数描述 数据类型
data 加密下发的ID2及密钥信息
String

7实人认证验证接口

为实人认证接口获取临时token,用户实人认证接口调用时做验证

接口 版本 描述
/home/paas/person/verify 1.0.0

请求参数

字段名 类型 必填 备注
apiVersion String api版本号,当前取值1.0.0
id2 String ID²标识,客户端采集人员照片时获得
authCode String 客户端生成的认证码,服务端通过检查其有效性验证客户端的合法性,客户端采集人员照片时生成,调用ios/安卓sdk获取该字段
name String 待认证人员的名称
idNumber String 待认证人员的身份证号
image String 待认证人员的照片,从客户端采集
token String 照片的签名信息,客户端采集照片时生成,调用ios/安卓sdk获取该字段
businessCode String 组织机构代码(统一社会信用代码)

返回结果

参数名 参数描述 数据类型
name 人员名称 String
idNumber 被认证人员的身份证号 String
score 比对分数 Integer
result 实人认证结果 Integer
resultText 结果的文本描述 String