版本撰写人日期 1.0 陈步青李其刚李伟罗潜锋夏新

Size: px

Start display at page:

Download "版本撰写人日期 1.0 陈步青李其刚李伟罗潜锋夏新"

畅孙
5 years ago
Views:

1 金融壹账通智能认证接入指南 1

2 版本撰写人日期 1.0 陈步青李其刚李伟罗潜锋夏新

3 目录 1 概述术语功能介绍智能认证介绍使用的技术 Android 接入指南... 6 详见 Android 接入文档... 错误! 未定义书签 4 ios 接入指南... 6 详见 ios 接入文档... 错误! 未定义书签 5 OPEN-API 接入指南接入流程介绍 API 调用规则获取 access_token 说明调用入口加密算法签名算法加密签名 demo 公共输入输出参数说明调用示例 URL: POST 请求数据 : 正确返回示例 : 错误返回示例接口文档通讯层面错误 code 码

4 4

5 1 概述本文档是智能认证接入指南与参考文件, 介绍智能认证的基础功能应用场景和 SDK 和 OPEN-API 的接入流程与方法 1.1 术语金科空间站 : 金融壹账通开放平台, 网站 : 2 功能介绍 2.1 智能认证介绍智能认证是基于人脸检测人脸比对活体识别 OCR 身份验证人证核身声纹识别声纹比对双录服务回访服务质检服务等智能技术组合起来在金融行业进行实人核身场景应用产品 2.2 使用的技术人脸检测 : 基于人的脸部特征信息进行身份识别的一种生物识别技术用摄像机或摄像头采集含有人脸的图像或视频流, 并自动在图像中检测和跟踪人脸, 进而对检测到的人脸进行脸部的一系列相关技术, 通常也叫做人像识别面部识别活体识别 : 在人脸识别过程中, 通过检测眨眼张嘴摇头点头等组合动作, 确保操作的为真实活体人脸人脸比对 : 基于人脸识别技术采集的脸部信息进行实人核查的技术人证核身 : 利用人脸识别技术和公安授权的第三方身份核查平台联网进行人证核身, 将身份信息和人的脸部特征信息进行双重核实的技术声纹识别 : 基于人的声纹特征信息进行身份识别的一种生物识别技术声纹比对 : 通过对比两组声纹信息, 判断出是否为同一人 OCR: 通过手机摄像头拍摄身份证和银行卡原件, 从而自动完成识别身份证号码和银行卡卡号等信息语音识别 : 应用业界最先进的深度学习算法, 具备出色的语音转文字关键词检索静音检测语速检测情绪识别能力双录服务 : 通过人脸识别人脸比对话术提醒人脸出框提醒等技术, 规范录音录像过程 5

6 提高录音录像质量 3 Android 接入指南请参考文档 : 活体检测 SDK 接入文档 Android.pdf 4 ios 接入指南请参考文档 : 活体检测 sdk 接入文档 ios.pdf 5 OPEN-API 接入指南金科空间站上开放调用智能认证的接口, 以 HTTP 的形式对外提供服务, 支持多平台常用的开发语言方便使用智能认证服务 5.1 接入流程介绍向开放平台申请接入参数 : 向智能识别开放平台接口人申请客户端 ID:client_id 密码:Secret 渠道号: channel_id rsa 公钥验签盐值获取 access_token: 通过已申请的客户端 ID(client_id) 与密码 (secret) 发起 get 请求获取访问 Token 例 ( 测试环境 ): 客户端 ID&grant_type=client_credentials&client_secret= 密码请求 OPEN API 6

7 A 根据接口文档约定组装入参 B 增加公共参数 : 参考章节公共参数 method 说明接口方法名, 如 :OCR signmethod 报文签名名称, 如 :sha256 encodekey 对 aes 密钥进行 rsa 加密 timestamp 当前时间戳, 如 : version 版本号 :1.0 requestid 请求编号 ( 每一次请求的唯一标识 ), 如 :uuid format json requestdata 对接口参数进行 AES/CBC/NoPadding 加密 sign 对以上整体报文进行哈希 256 签名 C 设置请求头参数 : 参考 5.3 章节 Header 解密响应报文使用 AES 解密响应报文参考 Demo 注意 : 请使用申请的 clientid secret rsa 公钥等参数替换代码中的参数 ***** Test 类 :com.pa.openapidemo.core.airecognitioncontrollertest 请参考 openapidemo.rar 5.2 API 调用规则 7

8 获取 access_token 说明调用环境测试环境生产环境服务地址 (HTTP) 请求参数 : 字段名称类型必须说明 client_id String 是金科开发平台申请的客户端 ID grant_type String 是授权方式, 固定值 :client_credentials client_secret String 是应用密码, 申请客户端 ID 时获得注 : 测试环境与生产环境获取的密码不同调用入口调用环境测试环境生产专线环境生产公网环境服务地址 (HTTP) 说明 : 服务名称 service 的取值, 参考 API 接口说明 Access token 调用示例 : d=p_jkopen_xxxx&grant_type=client_credentials&client_secret=xxxxxxx 服务调用示例 : recognition?access_token=fff f&requestid= 加密算法 1. AES key 随机产生 16 位长度字符串 ; 2. 对接口的业务参数 json 格式数据使用 AES 加密, 生成 requestdata 的值 8

9 3. AES key 采用 RSA 公钥加密, 生成 encodekey 的值 4. AES 加密明文示例 :{"productid":"xxx","productcode":"xxxx"}; 5. RSA 公钥由金融壹账通颁发签名算法签名使用所有通用入参及业务入参按顺序排序后使用 sha256 进行加签, 网关使用相同的方式对签名进行校验, 其中加签使用到的掩码 secret, 由网关为每个 client_id 进行分配注 : 这里使用的的 secret 为所分配的盐值, 与 client_secret 不同 Map<String, String> signdatas = new TreeMap<String, String>(); signdatas.put("encodekey", "xxxxxx"); signdatas.put("format", "json"); signdatas.put("method", "asset.getincomehistory"); signdatas.put("client_id", "123"); signdatas.put("requestdata", " 业务请求参数密文 "); signdatas.put("version", "1.0"); signdatas.put("requestid", SeqUtils.getSeqNo(4));//uuid signdatas.put("signmethod", "sha256"); signdatas.put("timestamp", " :55:22.123"); signdatas.put("secret", "xxxxxx"); String sha256sign = DigestUtils.sha256Hex(signDatas.toString()); 加密签名 demo 代码清单 : AESCBCUtils.java Base64Utils.java RSAUtils.java Test.java commons-codec jar, commons-logging jar 请参考附件 :RSA&AES.zip 9

10 5.3 公共输入输出参数说明 Header 参数 : 字段名称类型必须说明 Accept String 是 application/json Content-Type String 是 application/json get 请求参数 : 字段名称类型必须说明 access_token String 是参考获取 token 接口 request_id String 是长度最长为 64 位, 数字和字符串的组合, 客户端请求唯一标识 ( 建议用 UUID), 客户端生成, 每次接口请求的 requestid 都是不同的 post 请求参数 : 字段名称类型必须说明 method String 是接口名称, 详细参考 API 接口说明 client_id String 是金科开发平台申请的客户端 ID requestid String 是长度最长为 64 位, 数字和字符串的组合, 客户端请求唯一标识 ( 建议用 UUID), 客户端生成, 每次接口请求的 requestid 都是不同的 encodekey String 是 AES 密钥 (RSA 公钥加过密 ) sign String 是签名 ( 对所有字段除 sign 外非 Null 字段, 以 key 值进行字母排序进行加签 ) signmethod String 否签名的摘要算法, 默认值为 :sha256 timestamp String 是 yyyy-mm-dd HH:mm:ss, 时区 GMT+8,linux 时间戳, 精确到毫秒 (System.currentTime) format String 否响应格式, 默认为 json version String 是接口版本号, 默认值 1.0 requestdata String 是 json 格式业务数据密文, 详细参考 API 接口说明返回参数 : 字段名称类型必须说明 ret String 是通讯层面 - 响应码 msg String 是通讯层面 - 响应码说明 data Json 是 responsecode String 是业务层面 - 响应码 responsemessage String 是业务层面 - 响应码说明 responsedata json 是业务层面 -json 格式业务数据密文详细参考 API 接口说明 10

11 5.4 调用示例 URL: access_token=d8kg3fs032l2s200sk2023k3&request_id= POST 请求数据 : { "encodekey": "Zq4S167kl6nmjwLvGU0iQcPq6AWCcBRv6F3MHCc95fYgDmiALnGax3NkHo5f+AdrGTCTW9 NagwiWRg6/jKMrJpmM2jQYRW/XJnw245ygxL0ICovgNCmm5dh2pZLMyQz7RgLc2fNnm7IzH IFSXuBuQNr5GlBi8CASgLrnfCt4jBc=", "format": "json", "method": "register", "client_id": "P_JKOPEN_DMZ_TEST", "requestdata": "/Ln280NAA95uImZ0BJdps+MI+GexMFvBJ9MVrBRO3RY=", "sign": "53d60301a1d1c352d1d81ccbe2f88ae521619a91f14d7c48cbbacad ", "signmethod": "sha256", "timestamp": " ", "version": "1.0" } 正确返回示例 : Content-type: application/json;charset=utf-8 { "ret":"0", "msg":"", "data":{ "responsecode ":"000000", "responsemessage":" 成功 ", "responsedata ":"/Ln280NAA95uImZ0BJdps+MI+GexMFvBJ9MVrBRO3RY=" } } data 值默认为 String 字符串格式, 若需要返回的 data 值为 JSON 字符串格式, 则请求头的 Accept 属性值只能为 :application/json; 或者 application/json;charset=utf-8, responsedata 为 json 格式业务数据密文错误返回示例 11

12 Content-type: application/json;charset=utf-8 { "ret":"13005", "msg":"access_token 为空 ", "data":"" } 5.5 接口文档请参考接口文档 : 保险一帐通 - 智能识别接口文档 _v1.4.xlsx 5.6 通讯层面错误 code 码错误码错误码描述解决方案未知错误请求权限资源失败非法的 access_token 请求 openapi 资源失败您的应用没有可调用的 open api 资源 access_token 为空 url 地址受限 access_token 对应的环境不匹配请求 open api 遭遇未知错误无法与 open api 服务建立连接 open api 调用发生异常 open api 服务发生异常已失效的 access_token 连接池资源繁忙未知主机,open api 服务网络链路不通连接拒绝,open api 服务不可达 open api 服务响应超时 SSL 证书错误 open api 服务连接超时校验 access_token 失败 12

13 13

获取 Access Token access_token 是接口的全局唯一票据, 接入方调用各接口时都需使用 access_token 开发者需要进行妥善保存 access_token 的存储至少要保留 512 个字符空间 access_token 的有效期目前为 2 个小时, 需定时刷新, 重复

获取 Access Token access_token 是接口的全局唯一票据, 接入方调用各接口时都需使用 access_token 开发者需要进行妥善保存 access_token 的存储至少要保留 512 个字符空间 access_token 的有效期目前为 2 个小时, 需定时刷新, 重复获取将导致上次获取的 access_token 失效接入方可以使用 AppID 和 AppSecret

版本撰写人日期 1.0 陈步青 李其刚 李伟 罗潜锋 夏新

版本撰写人日期 1.0 陈步青李其刚李伟罗潜锋夏新