1、 INCITS/ISO/IEC 24709-3:2011 2011 ISO/IEC 24709-3:2011 Information technology Conformance testing for the biometric application programming interface (BioAPI) Part 3: Test assertions for BioAPI frameworks INCITS/ISO/IEC 24709-3:2011 2011 PDF disclaimer This PDF file may contain embedded typefaces. I
2、n accordance with Adobes licensing policy, this file may be printed or viewed but shall not be edited unless the typefaces which are embedded are licensed to and installed on the computer performing the editing. In downloading this file, parties accept therein the responsibility of not infringing Ad
3、obes licensing policy. The ISO Central Secretariat accepts no liability in this area. Adobe is a trademark of Adobe Systems Incorporated. Details of the software products used to create this PDF file can be found in the General Info relative to the file; the PDF-creation parameters were optimized fo
4、r printing. Every care has been taken to ensure that the file is suitable for use by ISO member bodies. In the unlikely event that a problem relating to it is found, please inform the Central Secretariat at the address given below. Adopted by INCITS (InterNational Committee for Information Technolog
5、y Standards) as an American National Standard. Date of ANSI Approval: 8/17/2011 Published by American National Standards Institute, 25 West 43rd Street, New York, New York 10036 Copyright 2011 by Information Technology Industry Council (ITI). All rights reserved. These materials are subject to copyr
6、ight claims of International Standardization Organization (ISO), International Electrotechnical Commission (IEC), American National Standards Institute (ANSI), and Information Technology Industry Council (ITI). Not for resale. No part of this publication may be reproduced in any form, including an e
7、lectronic retrieval system, without the prior written permission of ITI. All requests pertaining to this standard should be submitted to ITI, 1250 Eye Street NW, Washington, DC 20005. Printed in the United States of America ii ITIC 2011 All rights reserved ISO/IEC 24709-3:2011(E) ISO/IEC 2011 All ri
8、ghts reserved iiiContents Page Foreword .v Introductionvi 1 Scope1 2 Conformance .1 3 Normative references1 4 Terms and definitions .1 5 Abbreviated terms.2 6 General principles .2 7 Testing the conformance of BioAPI frameworks .3 7.1 General .3 7.2 Configuration of test assertions 3 7.3 Test flow .
9、6 7.4 Initialisation and termination .6 7.5 List of test assertions .7 7.6 BioAPI conformity statement .10 8 Test assertions 11 8.1 Descriptions of Test Tables .11 8.2 Descriptions of XML text 15 8.3 Common activities.16 8.4 Assertion 1.1 BioAPI_Init.28 8.5 Assertion 1.2 BioAPI_Terminate.30 8.6 Asse
10、rtion 1.3 BioAPI_GetFrameworkInfo 33 8.7 Assertion 1.4 BioAPI_EnumBSPs.35 8.8 Assertion 1.5 BioAPI_BSPLoad_And_BioSPI_BSPLoad .40 8.9 Assertion 1.6 BioAPI_BSPUnload_And_BioSPI_BSPUnload44 8.10 Assertion 1.7 BioAPI_BSPAttach_And_BioSPI_BSPAttach47 8.11 Assertion 1.8 BioAPI_BSPDetach_And_BioSPI_BSPDet
11、ach 51 8.12 Assertion 1.9 BioAPI_QueryUnits_And_BioSPI_QueryUnits 53 8.13 Assertion 1.10 BioAPI_EnumBFPs.58 8.14 Assertion 1.11 BioAPI_QueryBFPs_And_BioSPI_QueryBFPs60 8.15 Assertion 1.12 BioAPI_ControlUnit_And_BioSPI_ControlUnit .63 8.16 Assertion 2.1 BioAPI_FreeBIRHandle_And_BioSPI_FreeBIRHandle .
12、67 8.17 Assertion 2.2 BioAPI_GetBIRFromHandle_And_BioSPI_GetBIRFromHandle.69 8.18 Assertion 2.3 BioAPI_GetHeaderFromHandle_And_BioSPI_GetHeaderFromHandle 73 8.19 Assertion 3.1 BioAPI_EnableEvents_And_BioSPI_EnableEvents76 8.20 Assertion 3.2 BioAPI_SetGUICallbacks_And_BioSPI_SetGUICallbacks .79 8.21
13、Assertion 4.1 BioAPI_Capture_And_BioSPI_Capture82 8.22 Assertion 4.2 BioAPI_CreateTemplate_And_BioSPI_CreateTemplate.87 8.23 Assertion 4.3 BioAPI_Process_And_BioSPI_Process .92 8.24 Assertion 4.4 BioAPI_ProcessWithAuxBIR_And_BioSPI_ProcessWithAuxBIR .95 8.25 Assertion 4.5 BioAPI_VerifyMatch_And_BioS
14、PI_VerifyMatch 100 8.26 Assertion 4.6 BioAPI_IdentifyMatch_And_BioSPI_IdentifyMatch.105 8.27 Assertion 4.7 BioAPI_Enroll_And_BioSPI_Enroll.111 8.28 Assertion 4.8 BioAPI_Verify_And_BioSPI_Verify .117 8.29 Assertion 4.9 BioAPI_Identify_And_BioSPI_Identify125 8.30 Assertion 4.10 BioAPI_Import_And_BioSP
15、I_Import.133 8.31 Assertion 4.11 BioAPI_PresetIdentifyPopulation_And_BioSPI_PresetIdentifyPopulation137 8.32 Assertion 5.1 BioAPI_DbOpen_And_BioSPI_DbOpen .140 ISO/IEC 24709-3:2011(E) iv ISO/IEC 2011 All rights reserved8.33 Assertion 5.2 BioAPI_DbClose_And_BioSPI_DbClose . 143 8.34 Assertion 5.3 Bio
16、API_DbCreate_And_BioSPI_DbCreate 146 8.35 Assertion 5.4 BioAPI_DbDelete_And_BioSPI_DbDelete . 150 8.36 Assertion 5.5 BioAPI_DbSetMarker_And_BioSPI_DbSetMarker 153 8.37 Assertion 5.6 BioAPI_DbFreeMarker_And_BioSPI_DbFreeMarker 156 8.38 Assertion 5.7 BioAPI_DbStoreBIR_And_BioSPI_DbStoreBIR 159 8.39 As
17、sertion 5.8 BioAPI_DbGetBIR_And_BioSPI_DbGetBIR 162 8.40 Assertion 5.9 BioAPI_DbGetNextBIR_And_BioSPI_DbGetNextBIR. 166 8.41 Assertion 5.10 BioAPI_DbDeleteBIR_And_BioSPI_DbDeleteBIR. 169 8.42 Assertion 6.1 BioAPI_SetPowerMode_And_BioSPI_SetPowerMode. 172 8.43 Assertion 6.2 BioAPI_SetIndicatorStatus_
18、And_BioSPI_SetIndicatorStatus. 175 8.44 Assertion 6.3 BioAPI_GetIndicatorStatus_And_BioSPI_GetIndicatorStatus 178 8.45 Assertion 6.4 BioAPI_CalibrateSensor_And_BioSPI_CalibrateSensor . 181 8.46 Assertion 7.1 BioAPI_Cancel_And_BioSPI_Cancel. 183 8.47 Assertion 7.2 BioAPI_Free_And_BioSPI_Free . 186 8.
19、48 Assertion 8.1 BioAPI_Util_InstallBSP 188 8.49 Assertion 8.2 BioAPI_Util_InstallBFP 192 Annex A (informative) Test procedures for the multiple-component support 196 A.1 General. 196 A.1.1 Principles. 196 A.2 Test procedures 197 A.2.1 Role of API/SPI routing for the applications and the BSPs 197 Bi
20、bliography. 200 ISO/IEC 24709-3:2011(E) ISO/IEC 2011 All rights reserved vForeword ISO (the International Organization for Standardization) and IEC (the International Electrotechnical Commission) form the specialized system for worldwide standardization. National bodies that are members of ISO or IE
21、C participate in the development of International Standards through technical committees established by the respective organization to deal with particular fields of technical activity. ISO and IEC technical committees collaborate in fields of mutual interest. Other international organizations, gove
22、rnmental and non-governmental, in liaison with ISO and IEC, also take part in the work. In the field of information technology, ISO and IEC have established a joint technical committee, ISO/IEC JTC 1. International Standards are drafted in accordance with the rules given in the ISO/IEC Directives, P
23、art 2. The main task of the joint technical committee is to prepare International Standards. Draft International Standards adopted by the joint technical committee are circulated to national bodies for voting. Publication as an International Standard requires approval by at least 75 % of the nationa
24、l bodies casting a vote. Attention is drawn to the possibility that some of the elements of this document may be the subject of patent rights. ISO and IEC shall not be held responsible for identifying any or all such patent rights. ISO/IEC 24709-3 was prepared by Joint Technical Committee ISO/IEC JT
25、C 1, Information technology, Subcommittee SC 37, Biometrics. ISO/IEC 24709 consists of the following parts, under the general title Information technology Conformance testing for the biometric application programming interface (BioAPI): Part 1: Methods and procedures Part 2: Test assertions for biom
26、etric service providers Part 3: Test assertions for BioAPI frameworks The following part is under preparation: Part 4: Test assertions for BioAPI applications ISO/IEC 24709-3:2011(E) vi ISO/IEC 2011 All rights reservedIntroduction The test assertions specified in this part of ISO/IEC 24709 enable a
27、user of this part of ISO/IEC 24709 (such as a testing laboratory) to test the conformance to ISO/IEC 19784-1 (BioAPI2.0) of any BioAPI framework that claims to be a conforming implementation of that International Standard. The organization of the test assertions in this part of ISO/IEC 24709 reflect
28、s the structure of Annex A of ISO/IEC 19784-1:2006, which specifies conformance to BioAPI for various types of implementations (BSPs, frameworks, and applications) and for BSPs belonging to several conformance subclasses. This part of ISO/IEC 24709 contains test assertions for testing conformance of
29、 BioAPI frameworks to claim compliance to the BioAPI specification defined by ISO/IEC 19784-1:2006. The assertions are further organized according to conformance subclass (if any) and claimed support of optional features. Each test assertion exercises one or more (possibly elementary) features of an
30、 implementation under test. Assertions are placed into packages (one or more assertions per package) as required by the assertion language. Clause 6 specifies general principles. Clause 7 specifies the principles and the testing mechanism for the conformance testing for BioAPI frameworks in addition
31、 to listing up the test assertions to be used in this conformance testing model. Clause 8 specifies the assertions to be used in the conformance testing model for BioAPI frameworks. INTERNATIONAL STANDARD ISO/IEC 24709-3:2011(E) ISO/IEC 2011 All rights reserved 1Information technology Conformance te
32、sting for the biometric application programming interface (BioAPI) Part 3: Test assertions for BioAPI frameworks 1 Scope This part of ISO/IEC 24709 defines a number of test assertions written in the assertion language specified in ISO/IEC 24709-1:2007. This part of ISO/IEC 24709 specifies all the te
33、st assertions that are to be executed for conformance testing of BioAPI frameworks claiming conformance to ISO/IEC 19784-1 (BioAPI 2.0). Test assertions specified in this part of ISO/IEC 24709 are not claimed to be exhaustive (see also ISO/IEC 24709-1:2007, Clause 6). Implementations of BioAPI 2.0 t
34、hat are tested according to the methodology specified in ISO/IEC 24709-1:2007 and with test assertions specified in this part of ISO/IEC 24709 can (only) claim conformance to those aspects of ISO/IEC 19784-1 that are covered by these test assertions. 2 Conformance Implementations (BioAPI conformance
35、 test suites) claiming conformance to this part of ISO/IEC 24709 shall be able to process all the test assertions specified in Clause 8 according to the methodology specified in ISO/IEC 24709-1:2007 and the general principles and provisions specified in Clauses 6 and 7. 3 Normative references The fo
36、llowing referenced documents are indispensable for the application of this document. For dated references, only the edition cited applies. For undated references, the latest edition of the referenced document (including any amendments) applies. ISO/IEC 19784-1:2006, Information technology Biometric
37、application programming interface Part 1: BioAPI specification ISO/IEC 24709-1:2007, Information technology Conformance testing for the biometric application programming interface (BioAPI) Part 1: Methods and procedures 4 Terms and definitions For the purposes of this document, the terms and definit
38、ions given in ISO/IEC 19784-1:2006, ISO/IEC 24709-1:2007 and the following apply. ISO/IEC 24709-3:2011(E) 2 ISO/IEC 2011 All rights reserved4.1 API/SPI routing feature provided by the BioAPI Framework to handle multiple applications and/or multiple biometric service providers (BSPs), with which a Bi
39、oAPI call from an application is correctly given to the BSP specified by the application, and with which a BioSPI return from a BSP is correctly given to the application that specified the BSP 5 Abbreviated terms For the purposes of this document, the following abbreviated terms apply. API applicati
40、on programming interface BIR biometric information record BSP biometric service provider CBEFF common biometric exchange format framework FMR false match rate FPI function provider interface GUI graphic user interface ID identity/identification/identifier SPI service provider interface UUID universa
41、lly unique identifier BCS BioAPI conformity statement CTS BioAPI conformance test suite IUT implementation under test 6 General principles 6.1 The test assertions listed in Clause 7 and specified in Clause 8 are based on the conformance testing methodology specified in ISO/IEC 24709-1:2007, and can
42、only be used in the context of that methodology. The assertions are written in the assertion language specified in ISO/IEC 24709-1:2007, which is part of that methodology. 6.2 An important concept of the conformance testing methodology specified in ISO/IEC 24709-1:2007 is the existence of three conf
43、ormance testing models (see ISO/IEC 24709-1:2007, Clause 6). a) the conformance testing model for BioAPI applications b) the conformance testing model for BioAPI frameworks c) the conformance testing model for BioAPI BSPs 6.3 Each testing model is concerned with testing one of the three standard com
44、ponents of the BioAPI architecture (see ISO/IEC 24709-1:2007, Clause 6). Clause 8 of this part of ISO/IEC 24709 specifies a number of test assertions for the conformance testing model for BioAPI frameworks. This part of ISO/IEC 24709 is not concerned with the conformance testing models for BioAPI ap
45、plications, BSPs and corresponding test assertions. 6.4 In the conformance testing model for BioAPI frameworks, a special testing component (called the “framework-testing application“) shall replace the normal application, and another special testing component( called the “framework-testing BSP“) sh
46、all replace the normal BSP. (See 6.2.5.2 of ISO/IEC 24709-1:2007). ISO/IEC 24709-3:2011(E) ISO/IEC 2011 All rights reserved 37 Testing the conformance of BioAPI frameworks 7.1 General 7.1.1 This subclause describes the principles of the test conditions of the conformance test for BioAPI frameworks a
47、nd the principles to create pass/fail results. 7.1.2 The principles of the test conditions of the BioAPI frameworks under test are as follows: - All the BioAPI functions and all the related BioSPI functions shall be tested. - All the parameters defined in each function shall be tested. - All the val
48、ues that are able to be specified in each of the parameters shall be tested. - All the capabilities in the BSP schema of the testing BSP that are related to the test case shall be tested. 7.1.3 The principles to create pass/fails results of the test cases of the BioAPI frameworks are as follows: - T
49、he return value shall be checked. If ISO/IEC 19784-1:2006 does not specify an error value for a specific BioAPI function, the test shall pass if one of the possible error values has been returned. - As for the output parameters, they shall be checked if ISO/IEC 19784-1:2006 declares that the BioAPI framework sets the values to the output
