GB∕T 30267.1-2013 信息技术 生物特征识别应用程序接口 第1部分：BioAPI规范 GB∕T30267.1-2013 标准压缩包解压密码：www.bzxz.net

ICS 35.040
中华人民共和国国家标准
CB/T 30267.12013/ISO/1EC 19784-1:2006信息技术
生物特征识别应用程序接口
第1部分：BioAPI规范
Information technology-Biometric application programming interface-Part 1: BioAPl specification(IS0/IEC 19784-1:2006,IDT)
2013-12-31发布
中华人民共和国国家质量监督检验检疫总局中国国家标准化管理委员会
2014-07-15实施
符合性
规范性引卅文件
术落和定义
符号和缩咯语
完整BioAPTAPI/SPI架构模型
架白的BicAPI架构模型
iOAPIBSP架钩模型..
红件注册表…
BSI和BFP安装和御载
6.BSP灿载和 iAPI Ur：的链接
6,7BiAPI单管理
6.8BIR结构和处理
7BioAPI类型和宏
GB/T 30267.1--2013/1S0/IEC 19784-1:2006次
7.1bis13i0APL_ACBi0_PARAMETERS (BioAPI 2.2)7.lter
BinAPT ASN1 BIR (ioAPI 2.2)
7.Iqualer
BioAPI ASN1 ENCODED (BiAPI 2.2)7.2HiAPI_BFP_LIST_ELEMENT
BiOAPI_RFP_SCHEMA
BidAPI BIR
7.5BioAPI_BIR_ARRAY_POPUIATION7.6BinAPL_IR_RIOMETRIC_DATA FORMAT7,7
BioAPI_BIR_BIOMETRIC_PRODLCT_HD -*-.BioAPI BIR_BIOMETRIC_TYPE(BioAPI 2.0)Bi:API BIR DATA TYFE
BiAP1 IR HANLE
BiGAPI_IR_IFADER
BicAPI EIR PURPOSE
BiAPI_BR_SECURITY_BLOCK_FORMAT7,14
Bi0AH1 IR SI'3'YPFi0API 2,):BioAPI BOOL
BioAPI_BSP_SCHEMA(BioAPI 2.0)14
GB/T 302G7.1--2013/IS0/IEC 19784-1:20067.1713i0API_CANDIDATE
BAPI_ATEGORY...
BioAPI_DATA
BioAFIDATE
13iOAF1_D3 ACCESS TYPF
BiOAHJ__MARKER_HANDLE
BioAPI DB_HANDI.E
BioAPI_DBBIRID..
BiOAPI_DIG
BioAPI_ENCRYPTION_ALG (BioAPI2.2)....7.25bis
BioAPL_ENCRYPTION_INFO (BiOAPI 2.2)BioAPI_EVENT ..
BioAPI_EVENT MASK
RioAPl_EvenHandler
BioAPI_FMR
BiOAPI.FRAMEWORK_SCIIEMA...
HioAPI_GUI BITMAP(1ioAPI 2.0).
BioAPI_GUI_MESSAGE (BioAPI 2.0)+++
BiOAPL_GULPR(GRESS (BiOAPI 2.0) .-RioAPI_GUI_RESPONSE(BioAPI2.0)..BioAPI_GUJI_STATE (BioAPI_2.0)+++..+.
BioAPI.GUT STATE_CALLBACK (BioAPI_2.0)++tI++++
++++.+++.
............
BioAPI_GUI_STREAMING_CALI.BACK (BioAPI_2.0) ..........BioAPI_HANLE ....*..
13i0API_IHASH_AIG (3i0API 2.2) ..*--.BiOAPT_IDENTIFY_POPULATION
++++.+.++
BiOAPI_IDENTIFY_POPULATION_IYPE......BiOAPI_INDICATOR_STATIS
........+.
BioAPI INPUT_BIR -*-.
BioAPI_INPUT_BIR_FORM
BOAPI_INSTAEI_ACTION
BioAPI INSTALI_FRROR ..
BioAPI_KEY_INFO (Bic:AP1 2.2)+I+I+Ir
BioAPI_KEY_TRANSPROT (BioAPI 2.2)BioAPI_MAC_ALG (Bi0API 2,2) **7.45quater
7.4.3uinquicsI3ioAPI_MAC_INF() (BioAPI 2.2)7.46
BiOAPI_OPERATIONS_MASK
BiGAPI_OPTIONS MASK
BioAPI_P()WER_MODE
BioAPL QUALITY
iAPI_RETURN
BiAPL_SECURITY_(PTIONS_MASK (BiAPI2.2)BioAPI SECURITY_PROFIIE(BicAPI2.2)dht
GB/T 30267.1—2013/IS0/IEC 19784-1:20067,5OUualer BiOAPI_DTCITAI_SIGNATURE_AIG (ioAPI 2.2)7.51 B:0API_STRING
7.52 BioAPI_TIMF ....
7.53 BioAP1_LNIT_ID
7.E4 API_LNIT_LIST_ELEMENT
7.USBiAPI_UNIT_SGHIEMA
7.55bis BioAPI_UNIT_SCHEMA (3ioAPI 2,2) -.-7.56BiuAPI_UUID .**
ioAPI_VERSHON
7.58BioAPI_BIR_BIOMETRIC_TYPE(BioAPI 2.1) -7.59
BioAPI BIR. SUBTYPE(BioAPI 2.1 ---BioAPI_BSP_SCHIEMA(BioAPI 2.1)BioAPI_GL:1_1ITMAP(3i0API 2.1)BioAPI CLI_ENROLL_ TYPE(3icAPI 2.1)BioAPI_GLI_BITMAP ARRAY(BioAPI 2.I)BioAPI_13IR_SUBT YPE_MASK(BioAPI 2.1)BioAPLGUI_FVENT_SUBSCRIPTION(BiuAPI 2.1)BioAPI_GUI MOMENT(BioA PI 2.1)BinAPI_GUI_PROGRESS(BioAPI 2.1)RiOAPI_(GUI_(PERATION(BiOAPI 2.1)BioAPL_GUI_RESPONSE(Ii0AFI 2.1)BioAPL GU_SLBOPFRATHON(BioAPI 2.1)GUI 事件
BioAPI_ERROR_INFO(BioAPI2.J)BioAPI功能
组建管理函数
数据处埋操作
回调与事件操作·
生物特征操作·
数据库操作
BioAPI Lnit 操作
效用雨函数
BicAPI服务供方接L
生物特征识别服务供方的类型定义生物特征识别服务供方操作bzxz.net
组件注册表接[1·.
BioAPI登记模式
10.2结件注明表隔数
1lBioAPI错误处理
11.1错误值和错误代码格式
11.2错误代码和辑误值枚举·
GR/130267.1—2013/1S0/IEC19784-1.2006附是A（范性附录）符合性
......
++++t++++
阴录B（规范性除录）（\BEFI资助人格式规范：lioAPI资助人格武附求（（资料性附泵）
附录I）（资料性附录）
附录E（规范性附录）
参号文献
规范概述
调用序列范例示例及代码
ASV.1BioAPI_BIR现范
++++..+...
.. 210
CB/T 30267.1—2013/IS0/1EC19784-1.2006前
GB/T30267≤信息技术生物特征识别成用程序接［I》分为两个部分：---第1部分·BioAII规范
二-第2部分：牛物特征识别存格功能供方理序接「。本部分为（B/T3C267的第1部分。本部分按G3/T1.12009给出的舰则起单本部分使[川翊译法等同采用1S0/1EC9784-1:2G06信息技术物等识别应用程序接11第1部分：BioAPI规范、IS0/1EC197841：2005/Amd.1:2007信息技术生物特征识别应用程序接『第1部分：bioAFI规范修止案：BiaGUJI 规范》，IS0/IEC 19781-1:2006/An:l.2：2009信恩技术生物特征识别应程序接I第！部分：3ioAP规范修正案2：框渠日山的13icAPI》ISO/IEC19784-1：2006/And.3：2010《信息技术生物特征识别应用程序接1第：部分：BisAP1规范修正案3：支持证行和安全性认定交换及其他安食方而》。三个修正案的内容-在本部分相应条款的外侧员达空自位置用算直双线（)标示。
请注意本文件的某益内容可能涉及专利。本文件的发布机构不承担识别这峰专利的资任。本部分巾全国信息技术标准化技术委员会（SACTC28)提山并J。本部分起草单位北京天盛业科技有限公司、中电子技术标准化研究院，本部分主要起草人：袁理、杨寿林，彭程、律红文、手佳平、冯、企倩。GB/1 30267.1-2013/1S0/IEC19784-1:2006引言
G13.T30267的本部分提供了一种高层次的、泛化的认证模型，适用于多种形式的生物特征识别技本尚时也对多模态生物特征和安全评估提供支持。本部分描述了，·个体系赖整，该模型使得生物特征识别系统的组件可以由不同的供方提供，并且可以通过完整定义的应用程序接口(API)相主作用。本部分间样适用丁山具有符合性的13SP组件（无13ioAPI框架模块）建立许使用平台特定系统整会机制的系统（觅第6章），
本体系构的关链特征是BioAPI证架，本框架使用BioAPI规范·从而支持一个或者多个应用组l件（山不同的供力提供：详可能同时运行）的调用。BiuPI据渠通过调用（通过个服务供方接L，SPI)个或者多个生物持征识别服务供方（13SF)组件（由不同的供方提供.并可能同时运行）来提供这样的支特待，这些组件能被动态加裁或者在待要时用应用组件谢用。当应H程序和BSP在同一个系统时.本部分规定了13ioAPI框架的行为。其他互通标准（见4.29)规定了行为的改变，以便使[3SP和图形用户接几都可以远离包含应用程序的系统。注：BiaAPiInterwurkiugPratoccl（ISIF）i通标准的个范例：参见参考文献L3j)。在最低层次水平上，有执行生物持征功能（例妇.来集、匹配或存档）的硬件或者软件。体系结构的这些部分称为BioAPI单元，它们可以被集成到BSI中，或者作为单独BioAPI功能供（BFP)纠件的部分
在不间供方提供的数据给构的13SP之间可能会发生交互（经虫1BioAPI框架）.这些数据结构用米记录其访间的BioAPI单元信，这些单心遵循其他标准，特别是ISO/IEC1979的各部分。ioAPI休系结构的最后·个组件足识别，即BSP能提供生物等征识别服务：&）过使用集成到BSP（即，接用SP管理)的IBioAPI单儿：或者b）通过BioAPI动能供方接（FIPI)调用一个或者多个BFP组件（由不同的供方提供）来管理案成到BFP的13ioAPI单元。
注：sioAP1单元可以只包含较件、戴希热软硬件结合例如，含物特征传感器、存相或样算法）。对每种出BSP(或BFP）支指的BioAP1单元类型.可以将-个或多个本类型的BioAP1单儿动态摘人到系统中.以及从系统中除。插人和移除司以产生通知（通过BSP和BiaAPI框架)给应用程序的件，
BiAP规范涵盖基本的生物特征注册、验证和识张功能（参见附（）并且包含数书库接口，允许应J程序通过由ISP或BFP管理的存档BioAPI单儿来理生物许征记录的存储。这可为存档和生物特征搜索过程提供最佳性能（例如，在个很大的数量中执行生物特征识别功能）。应用程序接\提供原语：允许它通过叫对应的BioAPI单儿来管理生物特征传感器的生物特征样本采集，以及使用这华生物特征样本进行注时（这些样本存储在“个应用程序控制的BIR或BSP控制的3R数据准中），以及接下来对这些存储记录送行验证或者识别。此外，本部分详述了生物特征组件注册表内穿（关于作物特征组件在生物特征识别系统中的安装信意）也为注册的符理和监视提供了一个维件注期接口。本部分使川C讲（见GB/T15272)编写BicAPI接几的数据结构函数调用。第章描述了I3ioAPI体系模型及其组件，以及这此组件之间的指定接了第子楚义了RinAP1使衔的数结。第8章定义了由流用程序初始化，月巾合性HioAPI框架支待的函数调用，该框架内B:oAPI(:B/T 30267.1—2013/IS0/1EC 19784-1.2006架逆行内部处理（例如，已安装BioAPI组件的枚举），或者映射到13SP提供的函数。第9章定义了由符合性13SP支持的函数溯用（同谢被1BiAP1框架调用，该框架响应来白一个生物特征应门程序的请用）。
第10竞规定了生物特征组件注册表以及组件注则表接山的形式。第11单定义了事件和错误返可的处理。附录A是规范性附录，详述了13ioAPI生物特征成用程序、框架或BSP组件供方用来标识须被支持的函数和生物征记录格式的符合性要求和形式的细节，注：考文献[4中强调厂BioAPI现范的符合性测试。附录B是规范性附录，详述了和1S()/IEC19785-！-致的BaAPI生物特征信总记录（1BIR）.并采用CBEFF支持格式。本信息提供了对生物特征记录的描述，同时，为了存储和传输方使，规定此记录为形武表达
附录（是资料性附录，为13i0API规范的很多方面供了一个通用指南。附录D是资料性附录，为闻明代码调用序列和实施向导提供样例代码。附录E足规范性蔚录，
GB/T 30267.1—2013/IS0/IEC 197B4-1:2006信息技术生物特征识别应用程序接口第1部分：BioAPI规范
（:B/T30267的本部分为生物特征认别系统内的标准接口定义了应洲程序接11（API）和服务提供方接II（SPI）。生物特征识别系统支持米门总个供力的组件，并通过遵子本部分和其他润家标准，提供了组件之间的交，
在使H一个不包含I3ioAPI椎渠的系统（称为相渠白小的13inAPI系统)时，其适用的接只有SPI应用程序直接以特淀平台的方式与之连接。注：本部分的许多条款不适用于框渠门出的30A所系统的实域，这些己在该条款并始部分说哦本部分透川丁各种生物特征技术类型。它也适川丁各种各样的采川牛物特征的应用，例划·从个人设备·到网络安全，到大型复杂以别系统。本部分中，一个BioAPI框架支持多个同时存在的牛物特征应用程序（出不同供方提供），它使用多个动态安斐和加载（或卸载）生物特往只别服务供方（IBSP)的纽件和3iAPI单儿（由其他供方提供），也可能使用一组可选的BiOAPI功能供方（IFP)的组件（山其他供力提供）或目BioAPI单点接管埋。注1：丸心AP单元止不间供方提供时，均满要个标准化的BiAPI功能供方接［FPI），这超出本部分的范司似后续部分将详述不向种类的FI注2：当BiAPT格架不能属用于系统时.支持多个成川理序和多个FSP的能方依顿于平台，H依顿于所便H的系统集成技术的类型。
如果个完整的生物特征识别系统将从单一供力采购，特别是当牛物特征硬件、服务成者应用程序的添加或交换并不是该生物特征认别系统（有时称这炎系统为\散人式系统\）的特征时，那么本部分将不适所（H适常不应被引用）。此类系统的标准不在本部分范用之内，参见IS()/1FC:19784-3。定义生物特征应用和生物特征认别服务供方的安全性要求不在本部分范用之内，注：参考文献列提供止物特征识别系统安全方百的指南。生物特征识别系统的性能（特别是在人规赖生物特征识别系统提供生物特征识别的能力)不在术部分范制之内，上操作性和性能之间的权衡相不在个部分范间之内。本部分内容给了版本号为2.0的iA舰范，时也给山了版本号为2.1的增强图形川产接的说明·还有版本号为2.2的支持融个安全策略的特征说明。其中，有些条款仅适用于其中的一个版本，而有些条款则适用2～3个版本，这一点将在各条款的非头给出出朗，注1：期oAH规范许不是除标准。注2；征梁门的操作规范2.心版不考2.1版不之间的差别议与生物特征识别类型数值和端码有关2符合性
2.1附录A规定了符合本部分的BioAFI组件的符台性要求：2.2本部分使用（语前（见（B/T 152721991)来详述其定义的接口。BiuAP1组件可通过供方或使用者使用的讲方来进行说明，但此类接！的件应能使用符合本部分给出的详细的C说言规范（见7.1)的接门。
GB/T30267.1—2013/ISO/IEC19784-1:20063规范性引用文件
下列文件对了本文件的点用是必不可少的，凡是注1期的引用文性，仅法期的版本适用于本义件。是不注Ⅱ期的引用文件，其最新版本(包括所有的修改单)适而于本文件。GH130002010信息技术通用多八位编码字符集（CCS)（TS0/IEC10646：2003.I1DT）GB/T152721994程序设计语言（(IS0/IEC9899：1999,IDT）GB/T17969.82C10信息技术开放系统互连（)SI登记机构操作规程第8部分：逆用唯一标识符（LID))的生成租登记及其用作ASN.1客体标识符部件（IS()/IEC9834-8:2005，IDT)IS0/Er：19794<所有部分）信息技术生物特征识需数据交换格式(In:rmationtc:chnrology一Biometric te:ta :xehsnge: formelts)IS)/IEL1?85-1危息技术公用生物特征交换格式架第1部分：数据元素观范Infornuation iechuology -Common biometrie exchangc formats framework-Part l:Dal: clementspecification)
1S0)/1EC19785-2信总技术公用生物特征交换格式框渠第2部分：生物特征识别注册机构操作规 程（Irferialiar techno.ogy--Common biometrie: xchange Formats framework-Parl2:Procecures fur the: operation o: the bionetric registration auhority)IS0/1EL:19°85-4:201C信息技术公用生物持征交换格式框渠第4部分：安全块格式规款(Inlormation technelogy--Common biorretric exehange forrmus framcwork--Per 4:Security bluckformatspecifications)
IS)/IEc:24751信息技术安全技术生物特征识别的授权背款（InfermationtechnologySecurity techniques.-Authtntiatinn rontext for biometrics)IFTFRFC398国际化资源识别符（IRIs）「lniernatinalizedsrrcriclentificrs(IRIs）4术语和定义
\下列术诺和定义适用于本文件注1：这单未定义两数名和数据素名是在本交件的证文中给山京义注2：许多条款租定义与自出报架Ei0AJT系统下的IS0/IEC19784帮分应用相美4.0
ACBio实例报告ACBininstance
符合【S/1EC2476I要求的生物特征识别处理单（BPU)生成的报告，该报告显示广在一个BPL执行的个或多个子逊程产生结果的有效性。4.1
自适应araptation
模板自适应templateadlaptation使用新采集并经过验证的生物特征样本所创建的B1尺，以日动变新成翻新参考模板。注；本过辈用」减小模板的老化效府，4.2
链接会话attachsession
在应刊程序中，一个单一的BSP以及其直接或间接管理的组BiaAPI单元之间的临时链接。4.3
BioAPI组件 BjoAPI compunent
已定义接的B:oAPI体系结构的组件，它可以由单独的供方提供并遵循符合性测试。2
GB/T 30267.1—2013/1S0/IEC 19784-1:2006注：ioAPI经件包活ioAPI应用程序iaAP然、BSP和BFP4.3his
生物特征识别认证背景资料authentication context Tor liomelrics;ACBia规定ACIin实例的形式和编码的国际标准。[IS0/IEC2475]-
BioAPI功能供方BioAPIfunclionprovider;BFP管理个或多个特定范畴的BiuAPl单儿的纽件。注1：术部分的后续章节刘3ioAFI功能试方接厂进行了标游化。注2：据HFP管范的BiaAP单元范时对H分类（见6.3.1)。4.5
BinAPI单元BiuAPI ani
由 BSP或 BFP直接管理的软件或硬件资源单,心注：对13iAP）单元进行广分奖（见6.3.2）.它包含传感器单元，在单元四配法单示处理额算法单元。4.5.1
个人非生物特征数据iugruphiedala（BiuAPI2.2：有可能影响·个牛物待征识别探作的与个人相关的非生物特:(non-biometric)数挪4.5.2
个人非生物特征BIR bingraphice BER （BinaPl 2.2）有能影响-个生物特征别操作的与个人相关的非生物特社(no-iamc:tric)IIR，4.6
生物特征识别（的）biamctric
与生物特征识别领墩行美的，
生物特征数据块bimetricdata bleck；BDB其有巴定义格式的数据块包括一个或多个生物特衍样本或生物特征模板。注1：本部分不支持非8位数偿的比B注2：不要求出格式的我设量界限。注3：1S/11971的每个部分标准化广个或多个BI3格式：出可以指定和识别供方转有格式.注4：作[oAP内部,113对应川程序是个适明哟,因此，有时路其为不透明的生物李征效据块，4.8
生物特征信息记录biometricinfarinationrceurd;BiR包含一个戒多个生物特征数据块，标识生物特径数据块格式的信息和听能的其他信息（如生物特征数据块是否加密等)的数据结构
注：本部分使川术语3TR,道常指出 Bi心API(卫阴录 B]定义的特定IBIR格式·而不是任意的 13IR格式4.8.1
参考 BIR reference BIR
其BI3包含个或多个生物特征模板的BIR。4.B.2
样本 BIR sample BIR
其BDH只包含非模板的生物特征的BIR3
(B/T 30267.1—2013/1S0/IEC 19784-1:20064.9
生物特征样本bionetric sumple点接从传感幕获得或经过进一步处理的生物特征信息，注：见原娠生物特证样木、中间生物件征推本和已处理生物特征样本4.9.1
生物特征模板
bivmetric temptate
适于存储的生物特征样本或者生物特征样本的集合，具以作为后续比较的参考4.9.2
中间生物特征样本intermediatehiometricsample处理原始生物特征样本过程中得到的生物特征样木，其叮以用于后续处理。4.9.3
processed biometric sample
已处理生物特征样本
适于比对的性物特征样本。
原始生物特征样本Tuwbiometriesample点接案白工性物特征传愿器的牛物特征样本。注：原悠生物特征择本格式通常不是标准的，并H农赖」生物持征设备的特征和设备供方。可能以保会得这些格式作为特是生物识别特征硬性标准化的一部分他之标准化4.9.5
参考模板reterelce tenplate
已存储的生物特征模板。
生物特征传感器biometric sensor用来从个体获取原始生物特征样本的生物特征识别硬件，注：术谱\牛物转征识别设音“和本术语可巧换。4.10bis
生物特征识别处理单元bionetric processing unit;BPU在同一安全水平下进行一个或多个生物特征验证于进程的处理单元。注：,例划传感端、智能下和此对设衔。4.11
生物特征识别服务供方biometricservicepruvider；BSP通过已途义接为谋个成用提供生物特征识别服务的组件，式为通过直按管埋一个或多个BioAPI 单,或通过 BioAPI功能供方接4.12
生物特征识别biometrics
填1个体的行为守征和生物学特征，对该个体进行的白动识别，注：“个\限指人。
回调cailback
使用API组件来调用API组件内部两数的机制.丽数的地址诈为API阐数谢用的轮入参数，注：在不训个AP1弱数的法况下可以便州这种桃制·个13cAPI红件与引个BioAI红件通信，这通带是对·个事件或中用的响应。
小提示：此标准内容仅展示完整标准里的部分截取内容，若需要完整标准请到上方自行免费下载完整标准文档。