检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
Solution,简称IVS),是指通过用户的身份证信息、人脸图片,与权威数据库进行比对,进而实现身份验证。 服务以开放API(Application Programming Interface,应用程序编程接口)的方式提供身份验证能力。用户调用API接口需要具备一定的编程开发基础,识别后返回的结果为JSON格式,用户需要通过编程来处理识别结果。
在线调试 API Explorer在线调试工具提供API的检索、调试、代码示例生成功能。同时,集成开发环境CloudIDE,可完成代码的构建、调试、运行。 本章节以证件版(二要素)API为例,介绍如何使用API Explorer调试API。 前提条件 注册华为账号并开通华为云,并
开通人证核身服务 IVS服务提供的开通方式有以下两种,用户可以任选其一进行开通服务。 按需计费开通服务 登录IVS服务控制台。 选择需要使用的服务,在操作列单击“开通服务”,此时的计费方式采用按需计费。 图1 开通服务 服务开通成功后,开通状态将显示为“已开通”。 IVS服务开通
身份信息核验。API会返回JSON格式的识别结果,用户需要通过编码将识别结果对接到业务系统中。 关于人证核身服务的相关声明请参见人证核身服务免责声明。 人证核身服务等级协议请参见华为云服务等级协议。
IVS自定义策略 如果系统预置的权限,不满足您的授权要求,可以创建自定义策略。自定义策略中可以添加的授权项(Action)请参见权限管理。 目前华为云支持以下两种方式创建自定义策略: 可视化视图创建自定义策略:无需了解策略语法,按可视化视图导航栏选择云服务、操作、资源、条件等策略内容,可自动生成策略。
正式使用服务之前,必须先申请开通服务,下面是相关服务申请的步骤。 首次使用服务时,需要先申请开通该服务。服务只需要开通一次即可,后面使用时无需再次申请。如未开通服务,调用服务时会提示IVS.0015报错,请在调用服务前先进入控制台开通服务,并注意开通服务区域与调用服务的区域保持一致。 登录人证核身服务控制台。
在进行一键卸载之前,需要先删除该方案创建的委托。 删除委托 登录统一身份认证服务(IAM)控制台。 进入“委托”页面,删除委托。 图1 删除委托 一键卸载 登录人证核身解决方案部署页面。 单击方案堆栈后的“删除”。 图2 一键卸载 在弹出的删除堆栈确认框中,输入方案的堆栈名称,单击“确认”,即可卸载解决方案。
创建IAM用户步骤请参见创建IAM用户并授权使用IVS。 创建企业项目 登录控制台,单击界面右上方的“企业 > 项目管理”。 屏幕分辨率低的情况下单击页面右上方的“更多 > 企业 > 项目管理”。 图2 企业项目入口 在企业项目管理页面,单击页面右上方“创建企业项目”。依据界面指引完成企业项目的创建。
套餐和具体的区域绑定,购买的套餐只能在绑定的区域使用,不能在非绑定区域使用。 套餐包重置规则说明:计费时将优先使用套餐包的额度,超出额度部分将以当月累计使用量所在的阶梯价计费。套餐包的额度为购买日起一年内的可用资源数。套餐包的有效时长为一年。 已购买套餐包不支持退订,购买前请确认。 按次计费QPS数量限制:10QPS。
约束与限制 只支持“华北-北京四”区域。 只支持中国大陆身份证的识别。 只支持JPG格式,图片中人像需无遮挡。 图像数据,base64编码,要求base64编码后大小不超过4MB。 图像各边的像素大小在300到8000px之间。 图像中身份证区域有效占比超过15%,保证整张身份证内容及其边缘包含在图像内。
只允许使用字母、数字和下划线 (_)。中文字符必须是UTF-8或Unicode格式。 无默认值,名称可以自定义。例如命名为ivs-api 选择高级选项中,直接单击“下一步:配置确认(可选)” 在配置确认页面中,单击“创建执行计划”。 图4 配置确认 在弹出的创建执行计划框中,自定义填写执行计划名称,单击“确认”。
此单独强调。 表1 URI中的参数说明 参数 说明 URI-scheme 表示用于传输请求的协议,当前所有API均采用HTTPS协议。 endpoint 指定承载REST服务端点的服务器域名或IP,不同服务不同区域的endpoint不同,您可以从地区和终端节点获取。 例如IVS服
关闭服务 IVS服务开通后,如不使用,可登录控制台进行关闭。 如果您是主账户,也可以控制子用户的服务开通、关闭状态。 图1 关闭服务 图2 控制子用户的开通、关闭
以通过reader.result获取到文件的数据URL,也就是一个以data:image/...;base64,开头的字符串。 为了得到纯粹的base64编码,需要将数据URL中的前缀部分去掉,这里用了一个正则表达式来实现。然后将得到的base64编码打印出来。 <html> <head>
Verification Solution,简称IVS)是结合人脸识别、文字识别等技术,对用户身份进行真实性核验。 人证核身服务以开放API的方式提供给用户,您可以根据本文档提供的API来使用服务。 在调用人证核身服务API之前,请确保已经充分了解人证核身服务相关概念,详细信息请参见产品介绍。 父主题:
选中“Headers”配置项,KEY、VALUE按下图进行填写,并复制步骤3中获取的Token值到“X-Auth-Token”的“VALUE”中。 填写接口的Body信息。选中“Body”的配置项,选中“raw”,将下方代码填充至请求体中。 人证核身证件版(二要素)API可用
”,其中“{endpoint}”为IAM的终端节点。接口的认证鉴权请参见认证鉴权。 响应示例如下,例如,人证核身服务部署的区域为“cn-north-4”,响应消息体中查找“name”为“cn-north-4”,其中“projects”下的“id”即为项目ID。 { "projects":
通过python将图片转成base64编码 下方示例代码以Python为例,介绍如何将d:\demo.jpg图片转换成base64编码。您也可以使用在线的图片转base64工具。 import base64 with open("d:\demo.jpg", "rb") as image_file:
受技术与成本多种因素制约,IVS服务存在一些约束限制。 API只支持“华北-北京四”区域。 只支持中国大陆身份证的识别。 只支持JPG格式,图片中人像需无遮挡。 图像数据,base64编码,要求base64编码后大小不超过4MB。 图像各边的像素大小在300到8000px之间。 图像中身份证区域有效占比超过15%,保证整张身份证内容及其边缘包含在图像内。
统计API使用量 IVS服务控制台支持查看API的总调用量、调用成功量、调用失败量。 如果您购买了套餐包,可在“套餐包管理”页面,查看已有的套餐包及使用详情。套餐包费用扣减规则请参见“产品介绍 > 计费说明”。