检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
最新动态 本文介绍了人证核身服务IVS各特性版本的功能发布和对应的文档动态,新特性将在各个区域(Region)陆续发布,欢迎体验。 2021年08月 序号 功能名称 功能描述 阶段 相关文档 1 上线人证核身服务 通过用户的身份证信息、人脸图片,与权威数据库进行比对,进而实现身份验证
API概览 人证核身服务根据不同场景提供多种API。 表1 接口说明 API 说明 标准版(三要素) 使用姓名、身份证号码、人脸图片三要素进行身份审核。 证件版(二要素) 使用姓名、身份证号码二要素进行身份审核。
表1 常用最佳实践 实践 描述 活体人证核身 该实践基于于华为云人证核身服务IVS和人脸识别服务FRS构建,通过动作活体检测判断操作用户是否为真人,并将检测结果与用户身份证信息关联起来,使用人证核身技术,实现对用户身份真实性的核验。
建议客户本地将jackson 版本升级到和华为云 java sdk一致,jackson版本要求请见pom.xml。 引用华为云java sdk的bundle包来解决 jackson 版本冲突的问题。
约束与限制 只支持“华北-北京四”区域。 只支持中国大陆身份证的识别。 支持港澳台居住证核验,证件信息需文本输入 只支持JPG格式,图片中人像需无遮挡。 图像数据,base64编码,要求base64编码后大小不超过4MB。 图像各边的像素大小在300到8000px之间。 图像中身份证区域有效占比超过
什么是人证核身 人证核身服务(Identity Verification Solution,简称IVS),是指通过用户的身份证信息、人脸图片,与权威数据库进行比对,进而实现身份验证。 当前,人证核身提供以下子功能: 标准版(三要素) 使用姓名、身份证号码、人脸图像三要素进行匹配核验
准备数据 数据要求 受技术与成本多种因素制约,IVS服务存在一些约束限制。 API只支持“华北-北京四”区域。 只支持中国大陆身份证的识别。 只支持JPG格式,图片中人像需无遮挡。 图像数据,base64编码,要求base64编码后大小不超过4MB。 图像各边的像素大小在300到8000px
华为云通过AK识别用户的身份,通过SK对请求数据进行签名验证,用于确保请求的机密性、完整性和请求者身份的正确性。AK、SK获取方法请参见准备工作。
使用华为云人证核身服务可对贴吧、博客博主和视频主播的真实身份进行审核备案,大幅减少违规违法内容,规避风险。 游戏防沉迷 使用华为云人证核身服务可对游戏玩家进行真实有效的身份认证,继而对接防沉迷系统,规范青少年玩家游戏行为(如对18岁以下和未经实名认证的玩家限制游戏时间)。
SDK简介 人证核身服务端SDK是对人证核身提供的REST API进行的封装,您可以直接继承服务端从而实现对人证核身服务的快速操作。 接口与API对应关系 表1 接口与API对应关系 接口 API 人证核身标准版(三要素) POST https://{endpoint}/v2.0/
图2 我的凭证 安装SDK 使用SDK前需要安装华为云Go SDK 库。
状态码 HTTP 状态码为三位数,分成五个类别:1xx:相关信息;2xx:操作成功;3xx:重定向;4xx:客户端错误;5xx:服务器错误。 状态码如下所示。 状态码 编码 状态说明 100 Continue 继续请求。 这个临时响应用来通知客户端,它的部分请求已经被服务器接收,且仍未被拒绝
请联系华为云支持人员。 当您调用API时,如果遇到“APIGW”,“APIG”开头的错误码,请参见API网关错误码进行处理。 父主题: 附录
调用说明 人证核身提供了REST(Representational State Transfer)风格API,支持您通过HTTPS请求调用,调用方法请参见如何调用API。 父主题: 使用前必读
概述 人证核身服务(Identity Verification Solution,简称IVS)是结合人脸识别、文字识别等技术,对用户身份进行真实性核验。 人证核身服务以开放API的方式提供给用户,您可以根据本文档提供的API来使用服务。 在调用人证核身服务API之前,请确保已经充分了解人证核身服务相关概念
统计API使用量 IVS服务控制台支持查看API的总调用量、调用成功量、调用失败量。 如果您购买了套餐包,可在“套餐包管理”页面,查看已有的套餐包及使用详情。套餐包费用扣减规则请参见“产品介绍 > 计费说明”。
构造请求 本节介绍REST API请求的组成,并以调用人证核身(三要素)接口为例说明如何调用API,该API获取用户的Token,Token可以用于调用其他API时鉴权。 您还可以通过这个视频教程了解如何构造请求调用API:https://bbs.huaweicloud.com/videos
如果您的华为云账号已升级为华为账号,将不支持获取账号Token。建议为您自己创建一个IAM用户,获取IAM用户的Token。详细说明请参见账密报错。 Token在计算机系统中代表令牌(临时)的意思,拥有Token就代表拥有某种权限。
返回结果 状态码 请求发送以后,您会收到响应,包含状态码、响应消息头和消息体。 状态码是一组数字代码,状态码表示了请求响应的状态,如果调用后返回状态码为2xx,则表示调用成功。完整的状态码列表请参见状态码。 响应消息头 对应请求消息头,响应同样也有消息头,如“Content-type
获取账号ID 在调用接口的时候,部分URL中需要填入账号ID(domain-id),所以需要先在管理控制台上获取到账号ID。账号ID获取步骤如下: 登录管理控制台。 单击用户名,在下拉列表中单击“我的凭证”。 在“我的凭证”页面的项目列表中查看账号ID。 图1 查看账号ID 父主题