1、ICS 35.240.15 A 90 GA 中 华 人 民 共 和 国 公 共 安 全 行 业 标 准 GA/T XXXX.5 XXXX 居民身份网络认证 认证服务 第 5 部分： 人脸比对引擎接口要求 CTID online authentication Authentication services Part 5:Interface requirements for face recognition engine （报批稿） XXXX - XX - XX 发布 XXXX - XX - XX 实施 中华人民共和国公安部 发布 GA/T XXXX.5 XXXX I 目 次 前言 . III 引
2、言 . IV 1 范围 . 1 2 规范性引用文件 . 1 3 术语、定义和缩略语 . 1 3.1 术语 和 定义 . 1 3.2 缩略语 . 2 4 总则 . 2 4.1 概述 . 2 4.2 作用 . 2 5 接口框架 . 3 5.1 概述 . 3 5.2 总体框架 . 3 5.3 接口清单 . 3 5.4 使用要求 . 3 6 接口定义 . 4 6.1 心跳监控 . 4 6.2 特征提取 . 4 6.3 特征比对 . 5 6.4 两幅图像比对 . 6 6.5 算法版本信息 . 7 7 引擎服务配置内容 . 8 参考文献 . 9 图 1 居民身份网络认证系统整体技术框架 . 2 表 1 接
3、口清单表 . 3 表 2 服务返回值代码表 . 4 表 3 心跳监控接口表 . 4 表 4 心跳监控接口返回值表 . 4 表 5 特征提取接口表 . 5 表 6 特征提取接口请求输入参数及返回值表 . 5 表 7 特征比对接口表 . 5 表 8 特征比对请求输入参数及返回值表 . 6 GA/T XXXX.5 XXXX II 表 9 两幅图像比对接口表 . 6 表 10 两幅图像 比对接口参数及返回结果表 . 7 表 11 算法版本信息接口表 . 7 表 12 算法版本信息接口返回值表 . 8 表 13 引擎服务配置信息表 . 8 GA/T XXXX.5 XXXX III 前 言 GA/T XX
4、XX居民网络身份认证 认证服务分为五个部分： 第 1部分：认证分级； 第 2部分：服务 接口要求； 第 3部分：信息获取控件接口要求； 第 4部分：人脸图像 采 集控件技术要求； 第 5部分：人脸比对引擎接口要求。 本部分为 GA/T XXXX的第 5部分。 本部分按照 GB/T 1.1-2009给出的规则起草。 请注意本文件的某些内容可能涉及专利。本文 件 的发布机构不承担识别这些专利的责任。 本部分由公安部社会公共安全应用基础标准化技术委员会提出并归口。 本部分起草单位：公安部第一研究所、北京中盾安信科技发展有限公司、北京中盾安全技术开发公 司、北京市商汤科技开发有限公司、北京旷视科技有限
5、公司、重庆中 科云从科技有限公司、广州像素数 据技术股份有限公司、浙江蚂蚁小微金融服务 集 团 有限公司、深圳市腾讯计算机系统有限公司、公安部 安全与警用电子产品质量检测中 心、杭州海康威视数字技术股份有限公司等。 本部分主要起草人：田强、李志远、夏吉广、谢玉凤、吕蒙、李军、姚若光、谷晨、王昕、杨晓光、 刘军、许路、杜伟、陈色桃。 GA/T XXXX.5 XXXX IV 引 言 居民身份网络认证是国家实施网络可信身份战略实施的重要环节之一。由于互联网的虚拟性特点， 传统的身份认证方式已无法适应网络用户应用的需求，而当前的网络身份认证存在着认证方式多种多 样 、身份信息真假难辨等弊端，并引发了数
6、据泄露、身份冒用、隐私传播等新的安全 问 题，甚至威胁到 了国家安全。 为此， 亟需从标准化角度开展研究，构建安全、便捷、统一的居民身份网络认证技术框架， 为在网络空间标识居民身份和认证提供安全保障，为提高我国网络身份管理水平、实现网络社会治理现 代化提供技术支持。 为解决人脸识别技术在居民身份网络认证服务中的接入、应用、推广和普及等，指导技术提供商、 开发者和用户进行技术对接，促进行业生态健康发展，特制定本 部分 。 GA/T XXXX.5 XXXX 1 居民身份网络认证 认证服务 第 5 部分：人脸比对引擎接口要求 1 范围 GA/T XXXX的本部分规定了居民身份网络认证中人脸比对引擎的
7、接口框架 、 接口定义和引擎 服务配 置内容 等 。 本部分适用于居民身份网络认证服务系统中人脸比对引擎的系统设计、开发及应用等。 2 规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅 注日期的版本适用于本文件。 凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。 GA/T 893-2010 安防生物特征识别应用术语 GA/T XXXX 居民身份网络认证 通用术语 GA/T XXXX 居 民身份网络认证 整体技术框架 RFC2616 超文本传 输 协议 HTTP/1.1 3 术语、定义和缩略语 3.1 术语和定义 GA/T 893-2010和 G
8、A/T XXXX居民身份网络认证 通用术语 界定的 以 及下列 术语和定义适用于本 文件。为了便于使用，以下重复列出了 GA/T 893-2010的一些术语和定义。 3.1.1 特征 feature 从生物样本中提取的用于表征该样本特定属性的数据。 GA/T 893-2010，定义 3.3.13 3.1.2 特征提取 feature extraction 从生物 样本中提取用于表征该样本特定属性的数据的过程。 GA/T 893-2010，定义 3.3.14 3.1.3 相似度 similarity 比对的输出结果，代表参与比对的两个生物特征的相似程度。相似度的数值也可称为相似分数或比 对分数。
9、 GA/T 893-2010，定义 3.3.18 GA/T XXXX.5 XXXX 2 3.2 缩略语 下列缩略语适用于本文件。 HTTP： 超文本传输协议（ Hypertext Transfer Protocol） JSON： JavaScript对象标记（ JavaScript Object Notation） URL： 统一资 源定位符（ Uniform Resource Locators） 4 总则 4.1 概 述 在 GA/T XXXX居民身份网络认证 整体技术框架 给出的居民身 份网络认证系统整体技术框架中， 本部分规范的对象处于图 1所示的“标准 8”位置。 标准 1 . 居民身
10、份网络认证 通用术语 标准 2 . 居民身份网络认证 整体技术框架 标准 3 . 居民身份网络认证 网络可信凭证和网络标识格式要求 标准 4 . 居民身份网络认证 认证服务 第 1 部分 ： 认证分级 标准 5 . 居民身份网络认证 认证服务 第 2 部分 ： 服务接口要求 标准 6 . 居民身份网络认证 认证服务 第 3 部分 ： 信息获取控件接口要求 标准 7 . 居民身份网络认证 认证服务 第 4 部分 ： 人脸图像采集控件技术要求 标准 8 . 居民身份网络认证 认证服务 第 5 部分 ： 人脸比对引擎接口要求 标准 9 . 居民身份网络认证 信息采集设备 第 1 部分 ： 居民身份证
11、开通网证读卡器 标准 10 . 居民身份网络认证 信息采集设备 第 2 部分 ： 自助开通网证设备 标准 11 . 居民身份网络认证 信息采集设备 第 3 部分 ： 批量开通网证设备 标准 12 . 居民身份网络认证 信息采集设备 第 4 部分 ： 移动终端安全技术要求 居民身份网络认证 服务系统 网证 应用 服务 接口 网证管理 数据存储 生物特征 验证 网证验证 网证 居民身份 网络标识 应用程序 居民 网证应用客户端 应用程序 人脸图像 采集控件 信息 获取控件 网证 网证应用服务端 签名验签 应用程序服务器 数据存储 居民身份 网络标识 签名验签 身份信息核验 业务服务 身份信息验证
12、标识管理 网证应用系统 居民 身份 证开 通网 证读 卡器 人脸图像 采集控件 网证 管理 服务 接口 网证 开通 网证 冻结 网证 解冻 网证 注销 网证 口令重置 人脸 验证 标准 8 网证管理 客户端 图 1 居民身份网络认证系统整体技术框架 4.2 作用 居民身份网络认证服务系统中人脸验证请求通过调用人脸比对引擎服务接口驱动人脸比对引擎，实 GA/T XXXX.5 XXXX 3 现人脸特征提取、比对和人脸身份核验，并将人脸比对结果通过人脸比对引擎接口返回给居民身份网络 认证服务系统。 5 接口框架 5.1 概述 人脸比对引擎服务通过 RFC2616规定的 HTTP协议对外提供服务。 5
13、.2 总体框架 接口协议资源 URL地址为： http:/host:port/FR/interface 其中： host：人脸比对引擎服务器 IP或域名 port：服务端口号 FR：类型标志，固定字符“ FR”，意义为人脸比对引擎 interface：服务接口函数名 5.3 接口清单 接口资源 URL地址、定义及调用方法 见 表 1。 表 1 接口清单表 接口 URL 地址 定义 请求方法 Get Post http:/ host:port/FR/HeartBeat 心跳监控 （见 6.1） http:/ host:port/FR/FeatureExtract 特征 提取 （见 6.2） ht
14、tp:/ host:port/FR/FeatureMatch 特征 比对 （见 6.3） http:/ host:port/FR/VerifyWith2Images 比对两幅 图像（见 6.4） http:/ host:port/FR/GetVersionInfo 算法版本 信息（见 6.5） 注： “ ”代表选用该请求方式；“ ”代表不选用该请求方式。 5.4 使用要求 5.4.1 请求 请求参数数据结构采用 JSON格式进行封装，并包含在请求的 URL中。 5.4.2 返回 调用成功后以 JSON格式返回结果，返回值代码见表 2；调用失败时返回相应的错误信息。 GA/T XXXX.5 XX
15、XX 4 表 2 服务返回值代码表 返回值 代码 说 明 000 无错误 001 内存分配失败 002 特征格式不支持 003 图像格式不支持 004 图像质量不合格 005 数据库连接失败 006 人脸检测失败 007 请求参数 错误 008 建模失败 009 比对失败 099 其他错误 100200 算法引擎内部自定义 6 接口定义 6.1 心跳监控 心跳监控接口定义见表 3，返回值见表 4。 表 3 心跳监控接口表 接口名称 心跳监控 接口标识 public string HeartBeat () 接口描述 人脸比对引擎心跳监控，判断人脸比对引擎是否正常工作 资源 URL http:/h
16、ost:port/FR/HeartBeat 调用方式 GET 输入参数 无 输出参数 无 返回值 响应值为 JSON 字符串，返 回值数据项定义详见 表 4 表 4 心跳监控接口返回值表 项目 数据项 标识符 表示格式 约束条 件 意义 返回值 （ JSON 字 符串 ） 请求返回时间 QQFHSJ c1.14 必选 人脸比对引擎正常，返回请求时间，精确到秒，格式为“ YYYYMMDDhhmmss” 错误描述 CWMS c1.1000 可选 服务异常时，异常描述；当系统无异常时，该数据项可不返回 比对设备标识 BDSBBS c1.24 必选 处理比对请求的引擎设备的 IP地址 或唯一标记 6.
17、2 特征提取 特征提取接口定义见表 5，请求输入参数及返回值 见表 6。 GA/T XXXX.5 XXXX 5 表 5 特征提取 接口表 接口名称 特征提取 接口标识 public string FeatureExtract (string JsonImgData) 接口描述 输入一幅人脸图像信息，进行人脸特征提取，返回人脸特征信息，人脸图像格式应为 JPEG、PNG 或 BMP 格式中任一种 资源 URL http:/host:port/FR/FeatureExtract 调用方式 POST 输入 参数 JSON 字符串，人脸图像数据信息 输出参数 无 返回值 JSON 字符串，人脸特征信息
18、 表 6 特征提取接口 请求输入参数及返回 值表 项目 数据项 标识符 表示格式 约束条件 意义 输入参数 （ JSON 字符 串） 人脸图像 RLTX c1.10240000 必选 人脸图像 Base64 编码字符串（最大10M） 附属信息 FSXX c1.256 必选 其他附属信息 业务流水号 YWLSH c1.32 必选 业务流水号 返回值 （ JSON 字符 串） 人脸特征 RLTZ c1.4000 必选 人脸特征 Base64 编码，若建模失败或异常，其值为 null 错误代码 CWDM c1.4 必选 错误代码，详见 表 1 错误描述 CWMS c1.1000 可选 服务异常时，异
19、常描述；当系统无异 常时，该数据项可不返回 比对设备标识 BDSBBS c1.24 必选 处理建模请求的引擎设备的 IP地址或唯一标记 业务流水号 YWLSH c1.32 必选 业务流水号 6.3 特征比对 特征比对接口定义见表 7，请求输入参数及返回值见表 8。 表 7 特征比对接口表 接口名称 特征比对 接口标识 public string FeatureMatch (string JsonFeatureData) 接口描述 输入两个人脸特征 ，进行特征比对，返 回比对结果信息 资源 URL http:/host:port/FR/FeatureMatch 调用方式 POST 输入参数 JS
20、ON 字符串，人脸特征数据信息 输出参数 无 返回值 JSON 字符串，比对结果信息 GA/T XXXX.5 XXXX 6 表 8 特征比对请求输入参数及返回值表 项目 数据项 标识符 表示格式 约束条件 意义 输入参 数（ JSON 字符串） 第一个人脸特征 RLTZ1 c1.4000 必选 待比对的第 1 个人脸特征 Base64 编码 第二个人脸特征 RLTZ2 c1.4000 必选 待比对的第 2 个人脸 特征 Base64 编码 业务流水号 YWLSH c1.32 必选 业务流水号 返回值 （ JSON 字符串） 比对分数 BDFS c1.6 必选 特征比对分数，当出现失败或异常时，
21、其值为“ -1” 错误代码 CWDM c1.4 必选 错误代码，详见表 1 错误描述 CWMS c1.1000 可选 服务异常时，异常描述；当系统无异常时，该数据项可不返回 比对设备标识 BDSBBS c1.24 必选 处理比对请求的引擎设备的 IP地址 或唯一标记 业务流水号 YWLSH c1.32 必选 业务 流水号 注： 比对分数范围在 0 1000之间的单精度浮点数，精确到小数点 后 2位，其值越大表示为同一人的概率越高 。 6.4 两幅图像比对 两幅图像比对接口数定义见表 9，请求输入参数及返回值见表 10。 表 9 两幅图像比对接口表 接口名称 两幅图像比对 接口标识 public
22、 string VerifyWith2Images (string JsonImgData) 接口描述 输入两个人脸图像及其附属信息，进行两幅图像比对，返回比对结果信息 资源 URL http:/host:port/FR/ VerifyWith2Images 调用方式 POST 输入参数 JSON 字符串，人 脸图像数据信息 输出参数 无 返回值 JSON 字符串，比对结果信息 GA/T XXXX.5 XXXX 7 表 10 两幅图像比对接口参数及返回结果表 项目 数据项 标识符 表示格式 约束条件 意义 请求参 数 （ JSON 字符 串） 第一幅人脸图像 RLTX1 c1.10240000
23、 必选 待比对的第 1 幅 人脸图像 ， Base64 编码字符串 第一幅图像附属信息 FSXX1 c1.256 可选 第 1 幅人脸图像 其他附属信息 第二幅人脸 图像 RLTX2 c1.10240000 必选 待比对的第 2 幅人脸图像， Base64 编码 第二幅图像附属信息 FSXX2 c1.256 可选 第 2 幅人脸图像 其他附属信息 业务流水号 YWLSH c1.32 必选 业务流水号 返回值 （ JSON 字符 串） 比对分数 BDFS n1.6 必选 特征比对分数，当出现失败或异常时，其值为“ -1” 错误代码 CWDM c3 必选 错误代码，详见表 1 错误描述 CWMS
24、c1.1000 可选 服务异常时，异常描述；当系统无异常时，该数据项可不返 回 比对设备标 识 BDSBBS c6.24 必选 处理比对请求的引擎设备的 IP地址 或 唯一标记 业务流水号 YWLSH c1.32 必选 业务流水号 注： 比对分数范围在 0 1000之间的单精度浮点数，精确到小数点后 2位，其值越大表示为同一人的概率越高 。 6.5 算法版本信息 算法版本信息接口定义见表 11，返回值见表 12。 表 11 算法版本信息接口表 接口名称 算法版本信息 接口标识 public string GetVersion () 接口描述 获得人脸 比对 算法版本 及比对推荐阈值信息接口 资
25、源 URL http:/host:port/FR/GetVersion 调用方式 GET 输 入参数 无 输出参数 无 返回值 JSON 字符串 注： 算法版本命令规则为：“厂商名 _版本号”，厂商名和版本号通过分割符“ _”进行区分 ,厂商名和版本号字符应 用为英文 字母 （含大小写）、数字及“ .”字符组成，厂商名、版本号最大长度均为 16个字符 。 GA/T XXXX.5 XXXX 8 表 12 算法版本信息接口返回值表 项目 数据项 标识符 表示格式 约束条件 意义 返回值 （ JSON 字符 串） 算法版本 SFBB c3.33 必选 人脸比对算法版本 号 阈值 1 YZ1 n1.6
26、 必选 错误接受率在 0.1%时，算法推荐阈值 阈值 2 YZ2 n1.6 必选 错误接受率在 0.01%时，算法推荐阈值 阈值 3 YZ3 n1.6 必选 错误接受率在 0.001%时，算法推荐阈值 阈值 4 YZ4 n1.6 必选 错误接受率在 0.0001%时，算法推荐阈值 错误代码 CWDM c3 必选 错误代码，详见表 1 错误描述 CWMS c1.1000 可选 服务异常时，异常描述；当系统无异常时，该数据项可不返回 注： 比对阈值分数范围在 0 1000之间的单精度浮点数 ，精确到小数点后 2位，其值越大表示为同一人的概率越高 。 7 引擎服务配置内 容 引擎服务配置信息应包括服
27、务超时时间、超时重发机制、重发次数、引擎设备标志等。引擎服务配 置信息文件名应为“ CTID_FR_WS_Config.data”，配置项采用 JSON格式写入该文件，配置项定义及要求 见 表 13。 表 13 引擎服务配置信息表 数据项 字段名 表示格式 约束条件 说明 超时设置 CSSZ n.4 必选 服务超时时间设置，单位毫秒 重发设置 CFSZ n1 必选 超时重发设置，其值为 1 表示重发，其值为 0 表 示不重发 重发次 数 CFCS n1 必选 超时重发次数，当超时重发设置为 0 时，该项值不起 作用 比对 设备标识 BDSBBS c6.24 必选 引擎设备标识，处理比对请求的引擎设备的 IP 地址 GA/T XXXX.5 XXXX 9 参 考 文 献 1 GB/T 7408-2005 数据和交换格式 信息交换 日期和时间表示法 2 GB/T 26238-2010 信息技术 生物特征识别术语 3 GA/T 542-2011 公安数据元编写规则 4 GA/T 1293-2016 应用软件接口标准编写技术要素 _
