检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
本章节以证件版（二要素）API为例，介绍如何使用IVS Python SDK在本地进行开发。 该接口使用姓名、身份证号码二要素进行身份审核，并将识别结果以JSON格式返回给用户。人证核身成功时，会返回校验通过信息；人证核身失败时，会返回校验失败的具体原因。 前提条件 注册华为账号并开通
账号名”以及待使用区域的“项目ID”。调用服务时会用到这些信息，请提前保存。 本样例以“华北-北京四”区域为例，获取对应的项目ID（project_id）。 图2 我的凭证 安装SDK 在Linux系统上安装SDK 获取依赖包 所需的这些第三方软件包在大部分系统的包管理工具中都有提供，例如基于
业规范的呼声越来越强。使用华为云人证核身服务可对贴吧、博客博主和视频主播的真实身份进行审核备案，大幅减少违规违法内容，规避风险。 游戏防沉迷 使用华为云人证核身服务可对游戏玩家进行真实有效的身份认证，继而对接防沉迷系统，规范青少年玩家游戏行为（如对18岁以下和未经实名认证的玩家限制游戏时间）。
生僻字识别不成功说明 由于历史原因，公安部门在办理身份证登记身份信息时，使用了微软或其他输入法，将生僻字以PUA编码形式记录在了公安数据库中。随着信息化发展，这些生僻字以新的编码被国家标准GB18030收录。如今，在手机及通用计算机上都是使用新的编码输入和显示这些生僻字，但由于实名认证时公安系统是根
他们拥有IVS的使用权限，但是不希望他们拥有删除IVS等高危操作的权限，那么您可以使用IAM为开发人员创建用户，通过授予仅能使用IVS，但是不允许删除的权限，控制对资源的使用范围。 IAM是华为云提供权限管理的基础服务，无需付费即可使用，您只需要为您账号中的资源进行付费。关于IAM的详细介绍，请参见IAM产品介绍。
数据传入方式 使用IVS API或SDK时，支持输入以下数据实现人证核身校验。 标准版（三要素）API： 方式一：使用身份证图片、人像图片进行校验。 方式二：使用身份证姓名、身份证号码文本，人像图片进行校验。 证件版（二要素）API： 方式一：使用身份证图片进行校验。 方式二：使用身份证姓名、身份证号码文本进行校验。
Implemented 服务器不支持请求的功能，无法完成请求。 502 Bad Gateway 充当网关或代理的服务器，从远端服务器接收到了一个无效的请求。 503 Service Unavailable 被请求的服务无效。 建议直接修改该请求，不要重试该请求。 504 Gateway Timeout
常状态。 已开通人证核身服务。 操作步骤 登录API Explorer。 登录后，“X-Auth-Token”和“project_id”参数会自动填充，无需填写。 填写待验证的身份证信息。 输入数据可选使用身份证图片校验，或使用身份证文本校验，本示例使用身份证姓名、身份证号码文本进行校验。
根据自身的业务需求使用IVS提供的入门实践。 表1 常用最佳实践 实践 描述 活体人证核身 该实践基于于华为云人证核身服务IVS和人脸识别服务FRS构建，通过动作活体检测判断操作用户是否为真人，并将检测结果与用户身份证信息关联起来，使用人证核身技术，实现对用户身份真实性的核验。
申请服务 正式使用服务之前，必须先申请开通服务，下面是相关服务申请的步骤。 首次使用服务时，需要先申请开通该服务。服务只需要开通一次即可，后面使用时无需再次申请。如未开通服务，调用服务时会提示IVS.0015报错，请在调用服务前先进入控制台开通服务，并注意开通服务区域与调用服务的区域保持一致。
调用SDK实现人证核身证件版（二要素） 人证核身服务软件开发工具包（IVS SDK）是对人证核身服务提供的REST API进行的封装，以简化用户的开发工作。 人证核身证件版（二要素）API为例，介绍如何使用IVS Python SDK。 使用IVS SDK的详细步骤如下所示： 步骤1：开通服务 步骤2：安装SDK
关闭服务 IVS服务开通后，如不使用，可登录控制台进行关闭。 如果您是主账户，也可以控制子用户的服务开通、关闭状态。 图1 关闭服务 图2 控制子用户的开通、关闭
在欧洲地区有业务的用户，可以选择“欧洲-巴黎”区域。 云服务之间的关系 如果多个云服务一起搭配使用，需要注意： 不同区域的弹性云服务器、关系型数据库、对象存储服务内网不互通。 不同区域的弹性云服务器不支持跨区域部署在同一负载均衡器下。 资源的价格 不同区域的资源价格可能有差异，请参见华为云服务价格详情。
约束与限制 只支持“华北-北京四”区域。 只支持中国大陆身份证的识别。 支持港澳台居住证核验，证件信息需文本输入 只支持JPG格式，图片中人像需无遮挡。 图像数据，base64编码，要求base64编码后大小不超过4MB。 图像各边的像素大小在300到8000px之间。 图像中身份证区域
与其他云服务的关系 统一身份认证服务 统一身份认证（Identity and Access Management，简称IAM）服务，IAM为人证核身提供了用户认证和鉴权功能。
API概览 人证核身服务根据不同场景提供多种API。 表1 接口说明 API 说明 标准版（三要素） 使用姓名、身份证号码、人脸图片三要素进行身份审核。 证件版（二要素） 使用姓名、身份证号码二要素进行身份审核。
是否能退订服务，退订套餐包 服务开通后，不支持退订，不使用则不计费。 如果购买了套餐包，已购买套餐包不支持退订，购买前请确认。 父主题： 产品咨询类
是否是活体。 actions Array of ActionsList objects 动作列表。 picture String 检测出最大人脸的图片base64。 表3 ActionsList 参数 参数类型 描述 confidence Double 置信度，取值范围0～1。 action
Access Key)：与访问密钥ID结合使用的密钥，对请求进行加密签名，可标识发送方，并防止请求被修改。 使用AK/SK认证时，您可以基于签名算法使用AK/SK对请求进行签名，也可以使用专门的签名SDK对请求进行签名。详细的签名方法和SDK使用方法请参见API签名指南。 如果之前没
华为云账号若已升级为华为账号，将不支持获取账号Token。建议您创建一个IAM账户，使用IAM账户获取Token。 步骤1：创建IAM账户 登录华为云控制台，在右上角用户名处选择“统一身份认证”。 图1 统一身份认证 单击“创建用户”，并设置IAM账户的用户名、密码，创建IAM用户。 图2 创建用户 图3 设置用户名、密码
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
