全部产品

实人认证服务

更新时间:2020-10-13 11:39

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

以下接口不需要cloudtoken

1.1 实人认证整体架构

1.2 实人认证处理流程

1.3 实人认证SDK适用范围

Android Min Sdk Version: API 19: Android 4.4 (KitKat)

适用架构:armeabi, armeabi-v7a, arm64-v8a

1.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() {

@Override

public void onResult(IPErrorCode errcode, IPResult result) {

//errcode 为IP_SUCCESS 时, result 中为image正确值

}

});

//public void getImage(Context context, final String timestamp)

//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 相关日志。

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

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

接口

版本

描述

/home/paas/person/verify/token/get

1.0.0

请求参数

字段名

类型

必填

备注

apiVersion

String

api版本号,当前取值1.0.0

返回结果

参数名

参数描述

数据类型

data

临时token,可重复获取,有效期:10min~20min。 base64格式编码

String

1.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

1.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