INTERNATIONAL ISO/IEC STANDARD 19784-1 Second edition 2018-04 Information technology - Biometric application programming interface - Part 1: BioAPI specification Technologies de I'information - Interface de programmation d'applications biométriques Partie 1: Spécifications BioAPl Reference number IEC ISO/IEC 19784-1:2018(E) os1 @IS0/IEC 2018 IS0/IEC 19784-1:2018(E) COPYRIGHTPROTECTEDDOCUMENT IS0/IEC 2018 All rights reserved. Unless otherwise specified, or required in the context of its implementation, no part of this publication may be reproduced or utilized otherwise in any form or by any means, electronic or mechanical, including photocopying, or posting on the internet or an intranet, without prior written permission. Permission can be requested from either IsO at the address below or Iso's member body in the country of the requester. ISO copyright office CP 401 : Ch. de Blandonnet 8 CH-1214 Vernier, Geneva Phone: +4122 749 0111 Fax: +41 22 749 09 47 Email: [email protected] Website: www.iso.org Published in Switzerland ii @ IS0/IEC 2018 - All rights reserved IS0/IEC 19784-1:2018(E) Contents Page Foreword ..vili Introduction. ..ix 1 Scope. 2 Normative references .... 3 Terms and definitions 4 Symbols and abbreviated terms 5 Conformance. 6 The BioAPI architecture ..9 6.1 The full BioAPI API/SPI Architectural Model .9 6.2 The framework-free BioAPI Architectural Model ..10 6.3 The BioAPI BSP Architectural Model. .10 6.4 The component registry... ..12 6.5 BSP and BFP Installation and De-installation .13 6.6 BSP Load and BioAPI Unit Attachment. ..14 6.7 Controlling BioAPI Units. ..15 6.8 BIR Structure and Handling. .15 6.8.1 BIR Structure .. 15 6.8.2 BIR Data Handling ..16 BioAPI types and macros .17 7.1 BioAPI ..17 7.2 BioAPI_ACBio_PARAMETERS (BioAPI 2.2) ..17 7.3 BioAPI_ASN1_BIR(BioAPI2.2) .17 7.4 BioAPI_ASN1_ENCODED (BioAPI 2.2) .18 7.5 BioAPI_BFP_LIST_ELEMENT .18 7.6 BioAPI_BFP_SCHEMA ..18 7.7 BioAPI_BIR ..19 7.8 BioAPI_BIR_ARRAY_POPULATION .19 7.9 BioAPI_BIR_BIOMETRIC_DATA_FORMAT 20 7.10 BioAPI_BIR_BIOMETRIC_PRODUCT_ID .20 7.11 BioAPI_BIR_BIOMETRIC_TYPE (BioAPI 2.0) 20 7.12 BioAPI_BIR_BIOMETRIC_TYPE (BioAPI 2.1) .21 7.13 BioAPI_BIR_DATA_TYPE. 22 7.14 BioAPI_BIR_HANDLE 23 7.15 BioAPI_BIR_HEADER 23 7.16 BioAPI_BIR_PURPOSE 24 7.17 BioAPI_BIR_SECURITY_BLOCK_FORMAT 25 7.18 BioAPI_BIR_SUBTYPE (BioAPI 2.0) 25 7.19 BioAPI_BIR_SUBTYPE (BioAPI 2.1) 26 7.20 BioAPI_BIR_SUBTYPE_MASK (BioAPI 2.1) 27 7.21 BioAPI_BOOL .28 7.22 BioAPI_BSP_SCHEMA (BioAPI 2.0) 28 7.23 BioAPI_BSP_SCHEMA (BioAPI 2.1) 30 7.24 BioAPI_CANDIDATE 32 7.25 BioAPI_CATEGORY 32 7.26 BioAPI_DATA 32 7.27 BioAPI_DATE 32 7.28 BioAPI_DB_ACCESS_TYPE 33 7.29 BioAPI_DB_MARKER_HANDLE 33 7.30 BioAPI_DB_HANDLE. .33 7.31 BioAPI_DBBIR_ID. .33 7.32 BioAPI_DTG .34 7.33 BioAPI_ENCRYPTION_ALG (BioAPI 2.2) .34 @ IS0/IEC 2018 - All rights reserved ii IS0/IEC 19784-1:2018(E) 7.34 BioAPI_ENCRYPTION_INFO (BioAPI 2.2), .34 7.35 BioAPI_ERROR_INFO (BioAPI 2.1) .34 7.36 BioAPI_EVENT 35 7.37 BioAPI_EVENT_MASK. 35 7.38 BioAPI_EventHandler. 35 7.39 BioAPIFMR. 36 7.40 BioAPI_FRAMEWORK_SCHEMA 36 7.41 BioAPI_GUI_BITMAP (BioAPI 2.0) .37 7.42 BioAPI_GUI_BITMAP (BioAPI 2.1) 37 7.43 BioAPI_GUI_BITMAP_ARRAY (BioAPI 2.1) .38 7.44 BioAPI_GUI_ENROLL_TYPE (BioAPI 2.1) 38 7.45 BioAPI_GUI_EVENT_SUBSCRIPTION (BioAPI 2.1) 39 7.46 BioAPI_GUI_MESSAGE (BioAPI 2.0) .39 7.47 BioAPI_GUI_MOMENT (BioAPI 2.1) 40 7.48 BioAPIGUIOPERATION(BioAPI2.1 41 7.49 BioAPI_GUI_PROGRESS (BioAPI 2.0) 41 7.50 BioAPI_GUI_PROGRESS (BioAPI 2.1) 42 7.51 BioAPI_GUI_RESPONSE (BioAPI 2.0) 42 7.52 BioAPI_GUI_RESPONSE (BioAPI 2.1) 42 7.53 BioAPI_GUI_STATE (BioAPI 2.0). 44 7.54 BioAPI_GUI_STATE_CALLBACK (BioAPI 2.0) 44 7.55 BioAPI_GUI_STREAMING_CALLBACK (BioAPI 2.0) 45 7.56 BioAPI_GUI_SUBOPERATION (BioAPI 2.1) 46 7.57 BioAPI_HANDLE. 47 7.58 BioAPI_HASH_ALG (BioAPI 2.2) 47 7.59 BioAPI_IDENTIFY_POPULATION 47 7.60 BioAPI_IDENTIFY_POPULATION_TYPE .47 7.61 BioAPI_INDICATOR_STATUS 48 7.62 BioAPI_INPUT_BIR 48 7.63 BioAPI_INPUT_BIR_FORM 48 7.64 BioAPI_INS