【GA公共安全标准】 居民身份网络认证认证服务第3部分:信息获取控件接口要求

ICS 35.240.15
中华人民共和国公共安全行业标准GA/T1723.3—2020
居民身份网络认证
认证服务
第3部分：信息获取控件接口要求CTID online authentication-Authentication services-Part 3:Interface requirements for information acquirement control2020-06-03发布
中华人民共和国公安部
2020-10-01实施
规范性引用件
术和定义
5接口数据内容
数括结构
接几方法
结果码表
附录A（资料性附录）
数据结构
接口方法
Windows版信息获取控件
附录B（资料性附录）Androidl版信息获取控件13.1
数据结构
接口方法
附录C（资料性附录）IOS版信息获取控件c.
数据结构
接口方法·
参考文献
居民身份网络认证系统整体技术框架身份验证数据结构
结果数据结构
接口方法
衣4结果码表定义
IdCardData结构定义
获取控件版本号接口说明
获取身份验证数热接口说明
获取网证口令数据接口说明·
IrlCardlData结构定义
Resuli(T>结构定义
GA/T 1723.3—2020
GA/T 1723.3—2020
获取控件版本号接口说明
获取身份验证数据接口说明…
获取网证口令数据接口说明.
IdCardData结构定义
Result(NSDictionary)结构定义获取控件版本号接口说明
获取身份验证数据接口说明
获取网证口令数据接口说明
...+.....
GA/T1723《居氏身份网络认：
认证服务》分为5个部分：
第1部分：认证分级：
第2部分：服务接口要求；
一第3部分：信息获取控件接口要求：一一第1部分：人脸图像采集控件技术要求；第5部分：人脸比对引擎接口要求本部分为GA/T1723的第3部分。
本部分按照GB/T1.1—2009给山的规则起草GA/T 1723.3—2020
请注意本文件的某些内容可能沙及专利，本文件的发布机构不承扭识别这些专利的贡任。本部分由公安部社会公共安全应用基础标准化技术委员会提出并归口，本部分起草单位：公安部第一研究所、北京中居安信科技发展有限公司、北京中盾安全技术开发公司、兴唐通信科技有限公司、浙江蚂蚁小微金融服务集团有限公司、新大陆（福建)公共服务有限公司、广州大白联网科技有限公司、深圳市腾讯计算机系统有限公司、公安部安全与警用电子产品质量检测中心、北京信信息科技有限公司，本部分要起草人：颜挺、管毅、于晓敏、吴国英、蔡了凡、工俊峰、谷晨、林乐然、滕杰、杨晓光、张翔、赵明宁。
GA/T1723.3—2020
居氏身份网络认证是国家实施网络可信身份战略实施的重要环节之一：出丁五联网的虚拟性特点传统的身份认证方式已儿法适应网络用户应用的需求，而网络身份认证存在着认证方式多种多样、身份信息直假难辨等弊端，并引发了数据泄露、身份冒用，隐私传播等新的要全问题，甚至威胁到了国家安全，为此，驱需从标准化角度开展研究，构理安全、使捷、统·的居民身份网络认证技未框架：为在网络空间标识居民身份和认证提供安全保障，为提高我国网络身份管理水平、实现网络社会治理现代化提供技术支持。
为了提高居民身份网络认证过程中个人信息采集的规范性和安全性，需要制定统一的信息来集控件要求并对信息采集控件的数据结构、接口方法等逊行规范，特制定本部分。1范围
居民身份网络认证
认证服务
第3部分：信息获取控件接口要求GA/T1723.3—2020
GA/T1723的本部分规定了居民身份网络认证系统的信息获取控件的数据结构、接口方法及结果码表。
本部分适用于居民身份网络认证系统信息获取控件接口的设计开发2
规范性引用文件
下列文件对丁本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用丁本文件。凡是不注日期的引用文件，其最新版本(包括所有的修收单)适用丁本文件：GA/T1721居民身份网络认证道用术请2居民身份网络认证整体技术框架GA/T 1722
GA/T1723.2店民身份网络认证认证服务术语和定义
GA/11721界定的术语和定义适用于本文件。4总则
4.1概述
第2部分：服务接口要求
在GA/T1722给出的居民身份网络认证系统整体技术框架巾，本部分规范的对象处于图1所示的“标准6”位置。
GA/T 1723.3—2020
网证开通
网证管理客户端
皮用程疗
网证缩
余巢医荐
网证应用客户端
成用程序
人验图像
获取控件
标准6
标准1
标准2
标准3
标准4
标准5
标准6
标准7
标准8
标准9
标准10
标准11
标准12
4.2作用
网证解滚
网证注销
网证口令量置
网证应用系统
研酮碳
网证应用服务增
应用程序服务器
数据存储
签名验签
居民身份网络认证
居民身份网络认证
居民身份网络认证
居民身份网络认证
居民身份网络认证
居民身份网络认证
居民身份网络认证
居民身份网络认证
居民身份网络认证
居民身份网络认证
居民身份网络认证
居民身份网络认证
调螺擦
通用术语
整体技术框架
签名验签
网络可信凭证和网络标识格式要求第1部分：认证分级
认证服务
认证服务
认证服务
认证服务
认证服务
第2部分：服务接口要求
居民身份网络认证服务系统
业务服务
网证管理
标识管理
网距验证
生物特征验证
人险验证
身份信息核验
身份信息验证
第3部分：信息获取控件接口要求第4部分：人脸图像采集控件技术要求第5部分：人脸比对引擎接口要求信息采集设备第1部分：居民身份证开通网证读卡器信息采集设备
信息采集设备
信息采集设备
第2部分：自助开通网证设备
第3部分：批量开通网证设备
第4部分：移动终端安全技术要求图1
居民身份网络认证系统整体技术框架数据存鳍
高保馨
网证成用客心端在网证下载认证等业务中需要采集认证信息并对数概进行加密等处.信息获取控件提供了认证信息采集和加密功能，网证应用客户端过调用信息获取控件的接口获取店民身份网络认证信息数据，并构造居民身份网络认证数据包，发送到网证应用服务端进行签名等处理。5接口数据内容
接口数掂内容包括数势结构、接口方法和结果码表。5.2
数据结构
身份验证数据结构
身份验证数据结构是获取身份验证数据接口的人参结构体，数据项见表1，数据结构示例参见表A,1、表[3.1和表（.1
中文名称
业务类型
网证编码数据
机构编号
应川编号
标识衍
WZBMST
结果数据结构
表示格式
身份验证数据结构免费标准下载网bzxz
约束条件
标识不同的业务
网证数据的Base4编码
GA/T 1723.3—2020
居民身份网络认证服务系统为网证应用系统的机构派发的唯编号
居民身份网络认证服务系统为网证应川系统的应川派发的唯一编号
结果数据结构是获取结果数据接口的人参结构体，数据项见表2，数据结构示例参见表13.2和表.2.
表2结果数据结构
中文名称
钻果码
钻果码描述
结果数据
接口方法
标识符
表示格式
约束条件
接口返回结果码
接口返回结果码描述
接返回结果数据
信息获取控件接口方法包插获取控件版本号、获取身份验证数据、获取网证口令数据等，见表3。接口方法示例参见A.2、B.2和C.2。表3接口方法
接名称
获取控件版本号
获取身份验证数据
获最网证令数据
结果码表
用丁获取控件版本号
接1说明
用于获取身份验证数据，作为网证应用服务接1中身份认证和网证下载接的输入参数用于获取网证！令数据.作为网证应用服务接中身份认证和网证下载接的输入参数结果码表定义见表4。
表4结果码表定义
结果码
接Ⅱ调用成功，返结果数据
接止调用火败
GA/T 1723.3—2020
数据结构
附录A
（资料性附录）
Windows版信息获取控件
身份验证数据结构（IdCardData结构）定义见衣A.1表A.1IdCardData结构定义
数据项
业务奖型
网证综码数据
网证综码数据长度
机构编号
机构编号长度
应用综号
应用综专长度
厂商综号
产品综号
标识衍
WZHMSJ
WZRMSJCI)
JGBHCD
YYBHCI)
字段名
organizeld
数据类型
unsigned ehar
unsigned char1
unsigned shart
unsigned char
orgenizeIdLenunsigned short
appldl
applden
注：数据结构递循（语言定义规范：A.2
接口方法
获取控件版本号
获取控件版本号接口说明见表A.2，unsigned cher
umsigned shart
unsignerd shart
unsignerd short
长度/字节
药束条件
无卡认证：
读下认证；
读卡下载网证；
无卡下载网证
网证数据的1Basc64编码
网证编码数据长度
居民身份网络认证服务
系统为网证应用系统的
机构派发的唯一编号
机构编号长度
居民身份网络认证服务
系统为网证应用系统的
应用派发的唯一综号
应用编号长度
USI设备厂商编号
US设备产品编号
接描述
输出参数
返回值
获取控件版本号接口说明
void getAuthIDCardDataVer (unsigned char × ver)获取信息.获取控件版本号
werrOuT：控件版本号
注：接口选循（言定义规范。
获取身份验证数据
获取身份验证数据接口说听见表A3表A.3
获取身份验证数据接口说明
unsigned char get Auth ID) Card Datn (unsignedchar randonVumher,unsigned short randomNun berLen.接口定义
接口描述
输人参数
输出参数
返回值
struct IdCerlData * ldCard
unsigned char#IdiData
unsigned :hort IdDatalen)
获取身份验证数据.川于封装身份认证信息数据包ranckumNumber：身份认证中请响应中的随机数数据randomVumberLen：随机数数据长度Idard：ldcardData结构体，参见A.1数据结格IdI)ata：身份验证数据
IedDataLe：身份验证数据长度
0为成功,1为错误
注：接口遵循C许音定义规范，
获取网证口令数据
获取网证口令数据接口说明见表A.4.表A,4获取网证口令数据接口说明unsigned char getAuthCodeData (unsigned char * randomVumber.接定义
接口描述
输人参数
unsigued short randomNumberLen,unsigned char #AuthCode.
unsigned shnrt * AuthCodel.en)恭取网证口令数据·用于过装身份认证信息数据包randomVumber：身份认证中请响应中的随机数数据randomVumberl.cn：随机数数据长度GA/T 1723.3—2020
GA/T 1723.3—2020
输出参数
返回值
AuthCode：网证口令数据
AuthCodeLen：网证II令数据长度0为成功,1为错误
注：接口莲循C讲言定义规范。
表A.4（续）
小提示：此标准内容仅展示完整标准里的部分截取内容，若需要完整标准请到上方自行免费下载完整标准文档。