检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
使用身份证图片、人脸图片验证 功能介绍 使用身份证正反面图片提取姓名和身份证号码，与人脸图片进行三要素身份审核。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI POST
使用身份证图片、人脸视频验证 功能介绍 从身份证正反面图片中提取姓名和身份证号码，并对视频做活体检测后提取人脸图片，以此进行三要素身份审核。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
开始使用 动作活体检测视频采集要求 表1 动作活体检测视频检测要求 活体检测动作 动作示例 视频动作说明 左摇头 √，左摇头幅度正常。 ×，左摇头幅度过大，超出画面。 右摇头 √，右摇头幅度正常。 ×，右摇头幅度过大，超出画面。 点头 √，点头幅度正常 ×，点头幅度过大，超出画面。
IdcardResult 身份证图像文字识别结果结构体。 表1 结构体说明 参数 类型 描述 name String 身份证上识别的名称。 number String 身份证号。 sex String 性别。 birth String 出生日期。 ethnicity String
状态码 HTTP 状态码为三位数，分成五个类别：1xx：相关信息；2xx：操作成功；3xx：重定向；4xx：客户端错误；5xx：服务器错误。 状态码如下所示。 状态码 编码 状态说明 100 Continue 继续请求。 这个临时响应用来通知客户端，它的部分请求已经被服务器接收，且仍未被拒绝。
权限管理 如果您需要对华为云上购买的IVS资源，为企业中的员工设置不同的访问权限，以达到不同员工之间的权限隔离，您可以使用统一身份认证服务（Identity and Access Management，简称IAM）进行精细的权限管理。该服务提供用户身份认证、权限分配、访问控制等功
自动化部署步骤 登录华为云解决方案实施库，选择“一键部署”。 图1 一键部署人证核身解决方案 在选择模板界面中，直接单击“下一步：配置参数”。 图2 选择模板 在配置参数界面中，自定义填写堆栈名称。根据表完成参数配置后，单击“下一步：高级配置”。 图3 配置参数 表1 参数说明 参数名称
API概览 人证核身服务根据不同场景提供多种API。 表1 接口说明 API 说明 标准版（三要素） 使用姓名、身份证号码、人脸图片三要素进行身份审核。 证件版（二要素） 使用姓名、身份证号码二要素进行身份审核。
开通人证核身服务 IVS服务提供的开通方式有以下两种，用户可以任选其一进行开通服务。 按需计费开通服务 登录IVS服务控制台。 选择需要使用的服务，在操作列单击“开通服务”，此时的计费方式采用按需计费。 图1 开通服务 服务开通成功后，开通状态将显示为“已开通”。 IVS服务开通
创建IAM用户并授权使用IVS 如果您需要对您所拥有的IVS进行精细的权限管理，您可以使用统一身份认证服务（Identity and Access Management，简称IAM），通过IAM，您可以： 根据企业的业务组织，在您的华为云账号中，给企业中不同职能部门的员工创建IA
错误码 调用接口出错后，将不会返回结果数据。调用方可根据每个接口对应的错误码来定位错误原因。当调用出错时，HTTPS请求返回一个 4xx 或 5xx 的 HTTPS状态码。返回的消息体中是具体的错误代码及错误信息。在调用方找不到错误原因时，可以联系华为云客服，并提供错误码，以便尽快帮您解决问题。
入门实践 当您完成了调用API、调用SDK基本操作后，可以根据自身的业务需求使用IVS提供的入门实践。 表1 常用最佳实践 实践 描述 活体人证核身 该实践基于于华为云人证核身服务IVS和人脸识别服务FRS构建，通过动作活体检测判断操作用户是否为真人，并将检测结果与用户身份证信息
构造请求 本节介绍REST API请求的组成，并以调用人证核身（三要素）接口为例说明如何调用API，该API获取用户的Token，Token可以用于调用其他API时鉴权。 您还可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud.com/videos/102987
SDK简介 人证核身服务端SDK是对人证核身提供的REST API进行的封装，您可以直接继承服务端从而实现对人证核身服务的快速操作。 接口与API对应关系 表1 接口与API对应关系 接口 API 人证核身标准版（三要素） POST https://{endpoint}/v2.0/ivs-standard
调用API实现人证核身证件版（二要素） 本章节通过Postman调用人证核身证件版（二要素）API为例，帮助您快速体验并熟悉IVS服务的使用方法。 使用IVS服务API的详细步骤如下所示： 步骤1：开通服务 步骤2：配置环境 步骤3：Token认证鉴权 步骤4：调用服务 准备工作
认证鉴权 调用接口有如下两种认证方式，您可以选择其中一种进行认证鉴权。 Token认证：通过Token认证调用请求。 AK/SK认证：通过AK（Access Key ID）/SK（Secret Access Key)加密调用请求。 Token认证 需要使用一个Token鉴权时，可以先缓存起来，避免频繁调用。
通过js将图片转成base64编码 下方示例代码通过js将图片转换成base64编码。功能如下： 在页面加载完成后，给id为imgUpload的文件输入框添加了一个onchange事件监听器，当用户选择了一张图片后，就调用getBase64函数。 getBase64函数接收一个文
校验信息说明 表1 验证信息 检验代码 检验结果 检验信息 说明 1000 valid Successful certification 认证成功。 2001 invalid Inconsistent identity information 认证信息不一致，即姓名与身份证号码不一致。
本地调用 本章节以证件版（二要素）API为例，介绍如何使用IVS Python SDK在本地进行开发。 该接口使用姓名、身份证号码二要素进行身份审核，并将识别结果以JSON格式返回给用户。人证核身成功时，会返回校验通过信息；人证核身失败时，会返回校验失败的具体原因。 前提条件 注
调用SDK实现人证核身证件版（二要素） 人证核身服务软件开发工具包（IVS SDK）是对人证核身服务提供的REST API进行的封装，以简化用户的开发工作。 人证核身证件版（二要素）API为例，介绍如何使用IVS Python SDK。 使用IVS SDK的详细步骤如下所示： 步骤1：开通服务
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
