检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
访问秘钥”页面，获取Access Key（AK）和Secret Access Key（SK）。 图1 获取AK、SK 登录“我的凭证”页面，获取“IAM用户名”“、账号名”以及待使用区域的“项目ID”。调用服务时会用到这些信息，请提前保存。 本样例以“华北-北京四”区域为例，获取对应的项目ID（project_id）。
户所属的账号名称，********为用户登录密码，project name为项目名称。username，domainname和project name的获取方法参见获取用户名、用户ID、项目名称、项目ID。 获取Token的终端节点和project name需与IVS服务终端节点
44</version> </dependency> 当出现第三方库冲突的时，如Jackson，okhttp3版本冲突等。可以引入如下bundle包(3.0.40-rc版本后)，该包包含所有支持的服务和重定向了SDK依赖的第三方软件，避免和业务自身依赖的库产生冲突： <dependency> <groupId>com
”，其中“{endpoint}”为IAM的终端节点。接口的认证鉴权请参见认证鉴权。 响应示例如下，例如，人证核身服务部署的区域为“cn-north-4”，响应消息体中查找“name”为“cn-north-4”，其中“projects”下的“id”即为项目ID。 { "projects":
约束与限制 只支持“华北-北京四”区域。 只支持中国大陆身份证的识别。 只支持JPG格式，图片中人像需无遮挡。 图像数据，base64编码，要求base64编码后大小不超过4MB。 图像各边的像素大小在300到8000px之间。 图像中身份证区域有效占比超过15%，保证整张身份证内容及其边缘包含在图像内。
选择需要使用的服务，在操作列单击“开通服务”。本示例中开通人证核身证件版（二要素）API。 图1 开通服务 服务开通成功后，开通状态显示“已开通”。 首次使用服务时，需要先申请开通该服务。服务只需要开通一次即可，后面使用时无需再次申请。如未开通服务，调用服务时会提示IVS.0015报错。
创建企业项目后，在传参时，有以下三类场景。 携带正确的ID，正常使用IVS服务，账单的企业项目会被分类到企业ID对应的企业项目中。 携带格式正确但不存在的ID，正常使用IVS服务，账单的企业项目会显示对应不存在的企业项目ID。 不携带ID或格式错误ID（包含特殊字符等），正常使用IVS服务，账单的企业项目会被分类到"default"中。
根据自身的业务需求使用IVS提供的入门实践。 表1 常用最佳实践 实践 描述 活体人证核身 该实践基于于华为云人证核身服务IVS和人脸识别服务FRS构建，通过动作活体检测判断操作用户是否为真人，并将检测结果与用户身份证信息关联起来，使用人证核身技术，实现对用户身份真实性的核验。
申请服务 正式使用服务之前，必须先申请开通服务，下面是相关服务申请的步骤。 首次使用服务时，需要先申请开通该服务。服务只需要开通一次即可，后面使用时无需再次申请。如未开通服务，调用服务时会提示IVS.0015报错，请在调用服务前先进入控制台开通服务，并注意开通服务区域与调用服务的区域保持一致。
只允许使用字母、数字和下划线 (_)。中文字符必须是UTF-8或Unicode格式。 无默认值，名称可以自定义。例如命名为ivs-api 选择高级选项中，直接单击“下一步：配置确认（可选）” 在配置确认页面中，单击“创建执行计划”。 图4 配置确认 在弹出的创建执行计划框中，自定义填写执行计划名称，单击“确认”。
开通人证核身服务 IVS服务提供的开通方式有以下两种，用户可以任选其一进行开通服务。 按需计费开通服务 登录IVS服务控制台。 选择需要使用的服务，在操作列单击“开通服务”，此时的计费方式采用按需计费。 图1 开通服务 服务开通成功后，开通状态将显示为“已开通”。 IVS服务开通后，
是否能退订服务，退订套餐包 服务开通后，不支持退订，不使用则不计费。 如果购买了套餐包，已购买套餐包不支持退订，购买前请确认。 父主题： 产品咨询类
具体计费价格请参见人证核身套餐包。 套餐包购买后立即生效。 已购买的套餐包不支持退订，购买前请确认。 调用人证核身API需在套餐包生效期内，该次调用才可在套餐包内抵扣。 套餐和具体的区域绑定，购买的套餐只能在套餐包购买的区域使用，不能在非套餐包购买的区域使用。 套餐包有效期为1年，到期不会自动顺延
如果您需要对华为云上购买的IVS资源，为企业中的员工设置不同的访问权限，以达到不同员工之间的权限隔离，您可以使用统一身份认证服务（Identity and Access Management，简称IAM）进行精细的权限管理。该服务提供用户身份认证、权限分配、访问控制等功能，可以帮助您安全的控制华为云资源的访问。
业规范的呼声越来越强。使用华为云人证核身服务可对贴吧、博客博主和视频主播的真实身份进行审核备案，大幅减少违规违法内容，规避风险。 游戏防沉迷 使用华为云人证核身服务可对游戏玩家进行真实有效的身份认证，继而对接防沉迷系统，规范青少年玩家游戏行为（如对18岁以下和未经实名认证的玩家限制游戏时间）。
约束与限制 只支持“华北-北京四”区域。 只支持中国大陆身份证的识别。 支持港澳台居住证核验，证件信息需文本输入 只支持JPG格式，图片中人像需无遮挡。 图像数据，base64编码，要求base64编码后大小不超过4MB。 图像各边的像素大小在300到8000px之间。 图像中身份证区域
共服务。Region分为通用Region和专属Region，通用Region指面向公共租户提供通用云服务的Region；专属Region指只承载同一类业务或只面向特定租户提供业务服务的专用Region。 详情请参见区域和可用区。 可用区（AZ，Availability Zone）
n_id uuid：唯一标识此次请求的ID，用户自定义，不超过64位。例如10eb0091-887f-4839-9929-cbc884f1e20e verification_name：被验证人的姓名 verification_id：被验证人的身份证号码 复制代码示例至PyCharm中。
错误码类 调用API报错IVS.0015怎么处理 改名字导致的校验不通过怎么处理 APIG.0101报错处理方法 APIG.0201报错处理方法 APIG.0301报错处理方法 APIG.0307报错处理方法 账密报错“The username or password is wrong
API概览 人证核身服务根据不同场景提供多种API。 表1 接口说明 API 说明 标准版（三要素） 使用姓名、身份证号码、人脸图片三要素进行身份审核。 证件版（二要素） 使用姓名、身份证号码二要素进行身份审核。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
