【GA公共安全标准】 居民身份网络认证认证服务第5部分:人脸比对引擎接口要求

ICS35.240.15
中华人民共和国公共安全行业标准GA/T1723.5—2020
居民身份网络认证
认证服务
第5部分：人脸比对引擎接口要求CTID online authentication-Authentication services-Part 5: Interface requirements for face recognition engine2020-06-03发布
中华人民共和国公安部
2020-10-01实施
规范性引用义件
术语、定义和缩咯语
术和定义
缩咯语
接口框架
总体框架
接口清单
使用要求
接口定义
心跳监控
特征提取
特征比对
两幅图像比对
算法版本信息
7引攀服务配置内容
参考文献
尽民身份网络认证系统整体技术框架接口清单
返回值代码
表3心跳监控接口定义
表4心跳监控接口返问值
表5特征提取接口定义
表6特征提取接口请求输人参数及返回值特征比对接口定义
表8特征比对接口请求输人参数及返回值·表9两幅图像比对接口定义
表10两幅图像比对接口请求输人参数及返回值次
GA/T 1723.5—2020
GA/T 1723.5—2020
算法版本信息接口定义
算法版本信总接口返回值
表13引擎服务配置信总
+.+....++..
GA/T1723《居民网络身份认证
：认证服务》分为5个部分：
第1部分：认证分级：
第2部分：服务接口要求；
一第3部分：信息获取控件接口要求：一第1部分：人脸图像采集控件技术要求；第5部分：人脸比对引擎接口要求本部分为GA/T1723的第5部分
本部分按照GB/T1.1—2009给出的规则起草GA/T 1723.5—2020
请注意本文件的某些内容可能涉及专利，本文件的发布机构不承扭识别这些专利的贡任。本部分由公安部社会公共安全应用基础标准化技术委员会提出并归口，本部分起草单位：公安部第一研究所、北京中居安信科技发展有限公司、北京中盾安全技术开发公司、北京市商汤科技开发有限公司、北京广视科技有限公司、重庆中科云从科技有限公司、广州像素数据技术股份有限公司、浙江蚂蚁小徽金融服务集团有限公司，深圳市腾讯计算机系统有限公司，公安部安全与警用电子产品质量检测中心、杭州海康威视数字技术股份有限公司等。本部分要起草人：出强、李志远、夏吉广、谢玉风、吕蒙、李军、姚若光、谷晨、工听、杨晓光、刘军、许路、杜伟、陈色桃。
GA/T1723.5—2020
居氏身份网络认证是国家实施网络可信身份战略实施的重要环节之一：出丁五联网的虚拟性特点传统的身份认证方式已儿法适应网络用户应用的需求，而网络身份认证存在着认证方式多种多样、身份信息直假难辨等弊端，并引发了数据泄露、身份冒用，隐私传播等新的要全问题，甚至威胁到了国家安全，为此，驱需从标准化角度开展研究，构理安全、使捷、统·的居民身份网络认证技未框架：为在网络空间标识居民身份和认证提供安全保障，为提高我国网络身份管理水平、实现网络社会治理现代化提供技术支持。
为解决人脸识别技术在居民身份网络认证服务中的接入、应用、推广和普及等问题，指导技术提供商、开发者和用户行技术对接促迹行业生态健康发展，特制定本部分。1范围
居民身份网络认证认证服务
第5部分：人脸比对引擎接口要求GA/T 1723.5—2020
GA/T1723的本部分舰定了店民身份网络认证中人脸比对引擎的接口框架，接口定义和引整服务配置内容等
本部分适用于后民身份网络认证服务系统中人脸比对引擎的系统设计、开发及应用等。2规范性引用文件
下列文件对丁本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用丁本文件。凡是不注日期的引用文件，其最新版本（包括所有的修政单)适用丁本文件。GA/T893—2010安防牛物特征识别成用术证GA/T1721居民身份网络认证通用术语GA/T1722、居民身份网络认证整体技术框架RF266超文本传输协议HTTP/1.]
3术语、定义和缩略语
3.1术语和定义
GA/T893一2010和GA/T1721界定的以及下列术语和定义适用工本文件。为了使工使用+以上重复列出了GA/T8932010中的一些术语和定义3.1.1
特征feature
从生物样本中提取的用于表征该样本特定属性的数据。3.1.2
featureextraction
特征提取
从生物样本中提取用丁征该样本特定属性的数据的过程。3.1.3
相似度similarity
比刘的输出结果,代表参与比对的两个生物特征的相似程度。相似度的数值也可称为相似分数或比对分数，bzxz.net
LGA/T 893—2010,定义 3.1.18]3.2缩略语
下列缩略适用于本文件，
HTTP：超文木传输协议（HypertextTranslerProtocol）JSON：JavaSeript对象标记(JavaScriptObjcctNotation）1
GA/T 1723.5—2020
URL:统资源定位符(Lniform Resource Locators)4总则
4.1概述
在（A/722给出的居民身份网络认证系统整体技术框架中，本部分规范的对象处于图1所示的“标8\位置。
网证管理客户端
皮用程疗
网证开通
4.2作用
网证涨结
朵巢题释
网证应用客户端
就用程序
大险图像
我最整件
标准1
标准2
标准3
标准4
标准5
标准6
标准7
标准8
标准9
标准10
标准11
标准12
网证解游
两证注销
网证口令量贸
网证应用系统
的旺能
网证应用服务增
应用想序服务器
数损存储
签名验签
居民身份网络认证
通用术语
居民身份网络认证
居民身份网络认证
居民身份网络认证
居民身份网络认证
居民身份网络认证
居民身份网络认证
居民身份网络认证
居民身份网络认证
居民身份网络认证
居民身份网络认证
居民身份网络认证
需螺黎做
整体技术框架
签名验签
网络可信凭证和网络标识格式要求认证服务
认证服务
认证服务
认证服务
第1部分：认证分级
第2部分：服务接口要求
居民身份网络认证服务系统
业务服务
网证管理
标识管理
网证验证
生物特征验证
人险验证
身份信息核验
身份信息验证
第3部分：信息获取控件接口要求第4部分：人脸图像采集控件技术要求第5部分：人脸比对引擎接口要求认证服务
信息采集设备第1部分：居民身份证开通网证读卡器信息采集设备第2部分：自助开通网证设备信息采集设备第3部分：批量开通网证设备第4部分：移动终端安全技术要求信息采集设备
居民身份网络认证系统整体技术框架数据存储
尽民身份网络认证服务系统中人验验证请求通过调用人验比对引擎服务接口驱动人脸比对引擎实现人脸特征提取、比对和人脸身份核验，并将人脸比对结果通过人脸比对引擎接口返叫给居民身份网络认证服务系统。
5接口框架
5.1概述
人脸比对引擎服务通过RFC2616规定的HTTP协议对外提供服务。5.2总体框架
接口协议资源URL地址为：http：//host「port/FR/interface其中：
[host_：人脸比对引肇服务器IP或域名：Lportl：服务端口号：
FR：类型标志，固定宁符\FR”.意义为人脸比对引擎；[intc.rfacc]：服务接口函数名。5.3接口清单
接口资源URL地址、定义及请求方法见表1表1接口清单
接II资源URL地址
hup://[host_:_port]/FR/HecartBee.1http://[host:por1//FR/Featurr:Extracth11p://[ host]:[ por/FR/Fcarure.Matchhttp://Lhostl:Lport_/FR/VerifyWith2Ima.geshttp://_host_:Lport//FR/GetVersionInfo宠义
心跳监控（见6.1)
特征提取（见6.2)
特征比对（见6.3）
两图像比对（见8.4）
算法版本信息（见6.5）
注：“\代表选用该请求方法，“”代表不选用该请求方法。
使用要求
5.4.1请求
请求参数数据结构采用ISON格式迹行封装：并包含请求的LRL中5.4.2返回
GA/T 1723.5—2020
请求方法
调用成功后以JSON格式返回结果，返回值代码见表2：调用失败时返回相应的借误信息。表2
返回值代码
返间值代码
无错误
内存分配失败
特征格式不支持
图像格式不支持
图像质不合格
数据库连接失败
GA/T 1723.5—2020
返回值代码
100-200
6接口定义
心跳监控
人脸检测失败
请求参数错误
建模尖败
比对失败
其他浩误
表2（续）
克法引擎内部门义
心跳监控接口定义见表3，返回估见表1，说朗
表3心跳监控接口定义
接口名称
接口标识
接口描述
接口资源URI.地所
请求方法
翰人参数
输出参数
返回值
返回值
宁符串）
数据项
请求返三时间
错误捕述
比对设备标识
特征提取
心跳监控
public string HeariBcat O
人脸比刘引擎心跳监控,判断人脸比刘引擎足否正常工作http://host:[port]/FR/HeartBeatGET
返回值为JSON字符衍串，返回值数据项定义详见表4表4心跳监控接口返回值
标识符
QQFIST
BDSBBS
表示格式
约束条件
人验比对引擎止常返回请求时问，精确到秒.格武为“YYYYMMDDhhmnss
当服务异常时，为异常描述：当系统无异常时，该数据项可不返回
处理比对请求的引学设备的IP地址或标记特征提取接口定义见表5，请求输人参数及返回值见表64
接口名称
接口标识
接口描述
接ⅡI资源URL地址
请求方认
输人参数
输出参数
返回值
输入参数
字符中)
返回值
宁符串)
数据项
人验图像
附属信息
业务流水号
人验特征
销误代码
错误捕述
比对设备标识
业务流水号
特征比对
特征提胶
特征提取接口定义
public string FentureExtract (string JhonImgData)GA/T1723.5—2020
输人一唱人脸图像信息，进行人脸特征提取，返回人脸特征信息，人脸图像格式应为JPEG.PAG或BMP格式中的在种
http://[host]:Lporul/FR/FcaturcExiraciPOST
JSON字符串，人验图像数据信息尤
JSON字衍串，人险特征信息
标识符
BDSBBS
特征提取接口请求输入参数及返回值表示格式
cl..1024acoc
约束条件
人验图像Base64编码字符串（最大10M)其他附属信息
业务流水号
人脸特征13as(ci4编码，若建模失败或异带，其为null
错误代码，详见表2
当服务异常时，为异常描述：当系统无异常时该数据项可不返回
处理建模请求的引擎设备的IP地址或喔标记
业务流水号
特征比对接口定义见表7，请求输人参数及返回值见表8。表7
接！名称
接门标识
接口描述
接口资源URI.地址
请求方法
输人参数
输山参数
返回值
特征比对
特征比对接口定义
publie string FeatureMateh (string JsonFeatureData)输人两个人监特征.进行待征比对，返回比对结果信息http://Lhost]:Lport//FR/FeatureMatchPOST
JSON宁符中.人脸特征数据信息
JSON字符串，比对结果信息
GA/T 1723.5—2020
输入参数
宁符串）
返回值
学符串)
数据项
第一个人险特征
第二个人险特征
业务流水号
比对分数
错误代码
错误措述
比对设备标识
业务流水号
标识符
BDSBBS
特征比对接口请求输入参数及返回值表示格式
约束条件
待比对的第一个人脸特征Beses1编码待比对的第二个人脸特征Bases4编码业务流水号
特征比对分数，当出现失败或异常时，其值为错误代码,详见表 2
当服务异常时·为异常描述：当系统无异常时，该数据项可不返回
处理比对请求的引擎设备的IP地址或喔一标记业务流水号
注：比对分数为范围在0～1000的单精度浮点数，精确到小数点后2位，其值越大表示为同一人的概率尴高6.4
两幅图像比对
两幅图像比对接口定义见表9.请求输人参数及返回值见表10两幅图像比对接口定义
接口名称
接旧标识
接描述
接I资源URL地址
请求方法
输人参数
输出参数
返回值
输人参数
字符串)
数据项
第一幅人脸图像
两幅图像比刘
publie string VerilyWih2Inagus (gtring JsonlrngDeta)输人两个人股图像及其附属信息·进行两唱图像比对，返回比对结果信息http://LhostJ:LpurtJ/FR/VerifyWith2ImagesPOST
ISON字符，人图像数据信息
JSON字符串,比对结果信息
两幅图像比对接口请求输入参数及返回值标识符
第一幅图像附属信息
第二幅人脸图像
第二幅图像附属信息
业务流水号
表示格式
c1..10240000
el..10240006
约束条件
待比对的第一幅人脸图像 Basc64编码了符中
第一幅人脸图像共他附属信息
待比对的第二幅人验图像Base64 编码字符中
第二幅人验图像其他附属信息
业务流水号
小提示：此标准内容仅展示完整标准里的部分截取内容，若需要完整标准请到上方自行免费下载完整标准文档。