oasis

Biometric Identity Assurance Services (BIAS) Soap Profile Version 2.0

Committee Specification 01

11 July 2017

Specification URIs

This version:

http://docs.oasis-open.org/bioserv/BIAS/v2.0/cs01/BIAS-v2.0-cs01.pdf (Authoritative)

http://docs.oasis-open.org/bioserv/BIAS/v2.0/cs01/BIAS-v2.0-cs01.html

http://docs.oasis-open.org/bioserv/BIAS/v2.0/cs01/BIAS-v2.0-cs01.docx

Previous version:

http://docs.oasis-open.org/bioserv/BIAS/v2.0/csprd01/BIAS-v2.0-csprd01.pdf (Authoritative)

http://docs.oasis-open.org/bioserv/BIAS/v2.0/csprd01/BIAS-v2.0-csprd01.html

http://docs.oasis-open.org/bioserv/BIAS/v2.0/csprd01/BIAS-v2.0-csprd01.docx

Latest version:

http://docs.oasis-open.org/bioserv/BIAS/v2.0/BIAS-v2.0.pdf (Authoritative)

http://docs.oasis-open.org/bioserv/BIAS/v2.0/BIAS-v2.0.html

http://docs.oasis-open.org/bioserv/BIAS/v2.0/BIAS-v2.0.docx

Technical Committee:

OASIS Biometric Services (BIOSERV) TC

Chair:

Kevin Mangold (kevin.mangold@nist.gov), NIST

Editors:

Kevin Mangold (kevin.mangold@nist.gov), NIST

Karen Marshall (karen.marshall@nist.gov), NIST

Additional artifacts:

This prose specification is one component of a Work Product that also includes:

·         XML schemas: http://docs.oasis-open.org/bioserv/BIAS/v2.0/cs01/schemas/

Related work:

This specification replaces or supersedes:

·         Biometric Identity Assurance Services (BIAS) SOAP Profile Version 1.0 Plus Errata 02. Edited by Kevin Mangold, Matthew Swayze, and Cathy Tilton. 06 May 2014. OASIS Standard incorporating Approved Errata 02. http://docs.oasis-open.org/bias/soap-profile/v1.0/errata02/os/biasprofile-v1.0-errata02-os-complete.html.

This specification is related to:

·         ISO/IEC 30108-1:2015, Biometric Identity Assurance Services (BIAS). http://www.iso.org/iso/catalogue_detail.htm?csnumber=53228

Declared XML namespace:

·         http://docs.oasis-open.org/bioserv/ns/bias-2.0

Abstract:

BIAS defines biometric services used for identity assurance that are invoked over a services-based framework. It is intended to provide a generic set of biometric and identity-related functions and associated data definitions to allow remote access to biometric services.

Status:

This document was last revised or approved by the OASIS Biometric Services (BIOSERV) TC on the above date. The level of approval is also listed above. Check the “Latest version” location noted above for possible later revisions of this document. Any other numbered Versions and other technical work produced by the Technical Committee (TC) are listed at https://www.oasis-open.org/committees/tc_home.php?wg_abbrev=bioserv#technical.

TC members should send comments on this specification to the TC’s email list. Others should send comments to the TC’s public comment list, after subscribing to it by following the instructions at the “Send A Comment” button on the TC’s web page at https://www.oasis-open.org/committees/bioserv/.

This Committee Specification is provided under the RAND Mode of the OASIS IPR Policy, the mode chosen when the Technical Committee was established. For information on whether any patents have been disclosed that may be essential to implementing this specification, and any offers of patent licensing terms, please refer to the Intellectual Property Rights section of the TC’s web page (https://www.oasis-open.org/committees/bioserv/ipr.php).

Note that any machine-readable content (Computer Language Definitions) declared Normative for this Work Product is provided in separate plain text files. In the event of a discrepancy between any such plain text file and display content in the Work Product's prose narrative document(s), the content in the separate plain text file prevails.

Citation format:

When referencing this specification the following citation format should be used:

[BIAS-Profile-v2.0]

Biometric Identity Assurance Services (BIAS) Soap Profile Version 2.0. Edited by Kevin Mangold and Karen Marshall. 11 July 2017. OASIS Committee Specification 01. http://docs.oasis-open.org/bioserv/BIAS/v2.0/cs01/BIAS-v2.0-cs01.html. Latest version: http://docs.oasis-open.org/bioserv/BIAS/v2.0/BIAS-v2.0.html.

Notices

Copyright © OASIS Open 2017. All Rights Reserved.

All capitalized terms in the following text have the meanings assigned to them in the OASIS Intellectual Property Rights Policy (the "OASIS IPR Policy"). The full Policy may be found at the OASIS website.

This document and translations of it may be copied and furnished to others, and derivative works that comment on or otherwise explain it or assist in its implementation may be prepared, copied, published, and distributed, in whole or in part, without restriction of any kind, provided that the above copyright notice and this section are included on all such copies and derivative works. However, this document itself may not be modified in any way, including by removing the copyright notice or references to OASIS, except as needed for the purpose of developing any document or deliverable produced by an OASIS Technical Committee (in which case the rules applicable to copyrights, as set forth in the OASIS IPR Policy, must be followed) or as required to translate it into languages other than English.

The limited permissions granted above are perpetual and will not be revoked by OASIS or its successors or assigns.

This document and the information contained herein is provided on an "AS IS" basis and OASIS DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY OWNERSHIP RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.

OASIS requests that any OASIS Party or any other party that believes it has patent claims that would necessarily be infringed by implementations of this OASIS Committee Specification or OASIS Standard, to notify OASIS TC Administrator and provide an indication of its willingness to grant patent licenses to such patent claims in a manner consistent with the IPR Mode of the OASIS Technical Committee that produced this specification.

OASIS invites any party to contact the OASIS TC Administrator if it is aware of a claim of ownership of any patent claims that would necessarily be infringed by implementations of this specification by a patent holder that is not willing to provide a license to such patent claims in a manner consistent with the IPR Mode of the OASIS Technical Committee that produced this specification. OASIS may include such claims on its website, but disclaims any obligation to do so.

OASIS takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation or use of the technology described in this document or the extent to which any license under such rights might or might not be available; neither does it represent that it has made any effort to identify any such rights. Information on OASIS' procedures with respect to rights in any document or deliverable produced by an OASIS Technical Committee can be found on the OASIS website. Copies of claims of rights made available for publication and any assurances of licenses to be made available, or the result of an attempt made to obtain a general license or permission for the use of such proprietary rights by implementers or users of this OASIS Committee Specification or OASIS Standard, can be obtained from the OASIS TC Administrator. OASIS makes no representation that any information or list of intellectual property rights will at any time be complete, or that any claims in such list are, in fact, Essential Claims.

The name "OASIS" is a trademark of OASIS, the owner and developer of this specification, and should be used only to refer to the organization and its official outputs. OASIS welcomes reference to, and implementation and use of, specifications, while reserving the right to enforce its marks against misleading uses. Please see https://www.oasis-open.org/policies-guidelines/trademark for above guidance.

Table of Contents

1        Introduction. 8

1.0 IPR Policy. 8

1.1 Purpose/Scope. 8

1.2 Overview. 8

1.3 Background. 8

1.4 Relationship to Other Standards. 9

1.5 Terminology. 9

1.6 References. 10

1.6.1 Normative References. 10

1.6.2 Non-Normative References. 11

2        Design Concepts and Architecture (non-normative) 13

2.1 Philosophy. 13

2.2 Context 13

2.3 Architecture. 13

3        Data Dictionary. 16

3.1 Documentation Conventions. 16

3.2 Common Elements. 17

3.2.1 ApplicationIdentifier 17

3.2.2 ApplicationUserIdentifier 17

3.2.3 BaseBIRType. 17

3.2.4 BIASBiometricDataType. 17

3.2.5 BIASFaultCode. 18

3.2.6 BIASFaultDetail 19

3.2.7 BIASIdentity. 19

3.2.8 BIASIDType. 20

3.2.9 BinaryBIR. 20

3.2.10 BiographicDataItemType. 20

3.2.11 BiographicDataItemListType. 20

3.2.12 BiographicDataListType. 20

3.2.13 BiographicDataSetType. 20

3.2.14 BiographicDataType. 21

3.2.15 BiometricDataType. 22

3.2.16 BiometricDataListType. 22

3.2.17 CandidateListResultType. 23

3.2.18 CandidateListType. 23

3.2.19 CandidateType. 23

3.2.20 CapabilityListType. 23

3.2.21 CapabilityName. 24

3.2.22 CapabilityType. 29

3.2.23 CBEFF_BIR_ListType. 29

3.2.24 CBEFF_BIR_Type. 29

3.2.25 Classification. 30

3.2.26 ClassificationAlgorithmType. 30

3.2.27 ClassificationData. 31

3.2.28 DocumentDataType. 31

3.2.29 DocumentDataListType. 32

3.2.30 EncounterCategoryType. 33

3.2.31 EncounterListType. 33

3.2.32 FusionDecision. 33

3.2.33 FusionIdentityListType. 33

3.2.34 FusionInformationListType. 34

3.2.35 FusionInformationType. 34

3.2.36 FusionResult 34

3.2.37 FusionScore. 34

3.2.38 GenericRequestParameters. 35

3.2.39 IdentifySubjectResultType. 35

3.2.40 InformationType. 35

3.2.41 ListFilterType. 35

3.2.42 MatchType. 36

3.2.43 OptionType. 36

3.2.44 ProcessingOptionsType. 36

3.2.45 ProductID.. 36

3.2.46 QualityData. 36

3.2.47 ResponseStatus. 37

3.2.48 ReturnCode. 37

3.2.49 ScoreType. 37

3.2.50 TokenResultType. 38

3.2.51 TokenType. 38

3.2.52 URI_BIR. 38

3.2.53 VendorIdentifier 38

3.2.54 Version. 38

3.2.55 VersionType. 39

3.2.56 XML_BIR. 39

4        BIAS Messages. 40

4.1 Primitive Operations. 40

4.1.1 AddSubjectToGallery. 40

4.1.2 CheckQuality. 41

4.1.3 ClassifyBiometricData. 44

4.1.4 CreateEncounter 46

4.1.5 CreateSubject 47

4.1.6 DeleteBiographicData. 48

4.1.7 DeleteBiometricData. 50

4.1.8 DeleteDocumentData. 51

4.1.9 DeleteEncounter 53

4.1.10 DeleteSubject 54

4.1.11 DeleteSubjectFromGallery. 55

4.1.12 GetIdentifySubjectResults. 57

4.1.13 IdentifySubject 59

4.1.14 ListBiographicData. 61

4.1.15 ListBiometricData. 64

4.1.16 ListDocumentData. 69

4.1.17 PerformFusion. 71

4.1.18 QueryCapabilities. 73

4.1.19 RetrieveBiographicData. 75

4.1.20 RetrieveBiometricData. 77

4.1.21 RetrieveDocumentData. 79

4.1.22 SetBiographicData. 81

4.1.23 SetBiometricData. 83

4.1.24 SetDocumentData. 85

4.1.25 TransformBiometricData. 86

4.1.26 UpdateBiographicData. 88

4.1.27 UpdateBiometricData. 90

4.1.28 UpdateDocumentData. 92

4.1.29 VerifySubject 93

4.2 Aggregate Operations. 95

4.2.1 Delete. 95

4.2.2 Enrol 97

4.2.3 GetDeletionResults. 99

4.2.4 GetEnrolResults. 101

4.2.5 GetIdentifyResults. 102

4.2.6 GetUpdateResults. 104

4.2.7 GetVerifyResults. 105

4.2.8 Identify. 107

4.2.9 RetrieveData. 109

4.2.10 Update. 111

4.2.11 Verify. 113

5        Message structure and rules. 117

5.1 Purpose and constraints. 117

5.2 Message requirements. 118

5.3 Handling binary data. 119

5.3.1 Base64 encoding. 120

5.3.2 Use of XOP. 120

5.4 Discovery. 120

5.5 Identifying operations. 120

5.5.1 Operation name element 120

5.5.2 WS-Addressing Action. 121

5.6 Security. 122

5.6.1 Use of SSL 3.0 or TLS 1.0. 122

5.6.2 Data Origin Authentication. 122

5.6.3 Message Integrity. 122

5.6.4 Message Confidentiality. 123

5.6.5 CBEFF BIR security features. 123

5.6.6 Security Considerations. 123

5.6.7 Security of Stored Data. 123

5.6.8 Key Management 123

5.7 Use with other WS* standards. 124

5.8 Tailoring. 124

6        Error handling. 125

6.1 BIAS operation return codes. 125

6.2 SOAP fault codes. 125

7        Conformance. 126

Appendix A. XML Schema. 129

Appendix B. Use Cases (non-normative) 254

B.1 Verification Use Case. 254

B.2 Asynchronous Verification Use Case. 255

B.3 Primitive Verification Use Case. 256

B.4 Identification Use Case. 257

B.5 Biometric Enrolment Use Case. 258

B.6 Primitive Enrolment Use Case. 259

Appendix C. Samples (non-normative) 260

C.1 Create Subject Request/Response Example. 260

C.2 Set Biographic Data Request/Response Example. 262

C.3 Set Biometric Data Request/Response Example. 263

Appendix D. Acknowledgements. 265

Appendix E. Revision History. 266

 

 


1            Introduction

1.0 IPR Policy

This Committee Specification is provided under the RAND Mode of the OASIS IPR Policy, the mode chosen when the Technical Committee was established.

For information on whether any patents have been disclosed that may be essential to implementing this specification, and any offers of patent licensing terms, please refer to the Intellectual Property Rights section of the TC’s web page (https://www.oasis-open.org/committees/bioserv/ipr.php).

1.1 Purpose/Scope

This Organization for the Advancement of Structured Information Standards (OASIS) Biometric Identity Assurance Services (BIAS) profile specifies how to use the eXtensible Markup Language (XML) [XML10] defined in ISO/IEC 30108-1:2015, Information technology — Biometric Identity Assurance Services [ISO/IEC-BIAS] to invoke Simple Object Access Protocol (SOAP) -based services that implement BIAS operations.  These SOAP-based services enable an application to invoke biometric identity assurance operations remotely in a Services Oriented Architecture (SOA) infrastructure.

Not included in the scope of BIAS is the incorporation of biometric authentication as an integral component of an authentication or security protocol.  (However, BIAS services may be leveraged to implement biometric authentication in the future.)

1.2 Overview

In addition to this introduction, this standard includes the following:

·         Clause 2 presents the design concepts and architecture for invoking SOAP-based services that implement BIAS operations.

·         Clause 3 presents the namespaces necessary to implement this profile, ISO/IEC BIAS data elements, and identifies relationships to external data definitions.

·         Clause 4 specifies the content of the BIAS messages.

·         Clause 5 presents the BIAS message structure, as well as rules and considerations for its application.

·         Clause 6 presents information on error handling.

·         Clause 7 specifies conformance requirements.

·         Annexes include the OASIS BIAS XML schema/sample Web Service Definition Language (WSDL), use cases, sample code, acknowledgements, and the revision history of this profile.

1.3 Background

In late 2005/early 2006, a gap was identified in the existing biometric standards portfolio with respect to biometric services.  The Biometric Identity Assurance Services standard proposal was for a collaborative effort between government and private industry to provide a services-based framework for delivering identity assurance capabilities, allowing for platform and application independence.  This standard proposal required the attention of two major technical disciplines: biometrics and service architectures.  The expertise of both disciplines was required to ensure the standard was technically sound, market relevant, and achieved widespread adoption.  The International Standards Organization and the International Electrotechnical Commission (ISO/IEC) provided the standards leadership relevant to biometrics, defining the “taxonomy” of biometric operations and data elements.  OASIS provided the standards leadership relevant to service architectures with an initial focus on web services, defining the schema and SOAP messaging.

                                                                 

The driving requirements of the BIAS standard proposal were to provide the ability to remotely invoke biometric operations across an SOA infrastructure; to provide business level operations without constraining the application/business logic that implements those operations; to be as generic as possible – technology, framework, & application domain independent; and to provide basic capabilities that can be used to construct higher level, aggregate/composite operations.

1.4 Relationship to Other Standards

This OASIS BIAS profile comprises a companion standard to ISO/IEC 30108-1:2015, Information technology — Biometric Identity Assurance Services, which defines the BIAS requirements and taxonomy, specifying the identity assurance operations and the associated data elements. This OASIS BIAS profile specifies the design concepts and architecture, data model and data dictionary, message structure and rules, and error handling necessary to invoke SOAP-based services that implement BIAS operations.

Together, the BIAS standard and the BIAS profile provide an open framework for deploying and remotely invoking biometric-based identity assurance capabilities that can be readily accessed across an SOA infrastructure.

This relationship allows the leveraging of the biometrics and web services expertise of the two standards development organizations. Existing standards are available in both domains and many of these standards will provide the foundation and underlying capabilities upon which the biometric services depend.

1.5 Terminology

The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in [RFC2119].

The following additional terms and definitions are used:

Note:  The terms and definitions specified in ISO/IEC 30801-1 [ISO/IEC-BIAS] also apply to this Standard.

 

BIAS operation and data element names are not defined here, but in their respective sections.

 

BIAS

Biometric Identity Assurance Services

BIR

Biometric Information Record

ESB

Enterprise Service Bus

HTTP

HyperText Transfer Protocol

HTTPS

HyperText Transfer Protocol over SSL or HTTP Secure

IRI

Internationalized Resource Identifier

SOA

Service-Oriented Architecture

SOAP

Simple Object Access Protocol

SSL

Secure Sockets Layer

TLS

Transport Layer Security

UDDI

Universal Description, Discovery, and Integration

URI

Uniform Resource Identifier

VPN

Virtual Private Network

WSDL

Web Services Description Language

WSS

Web Services Security

XML

eXtensible Markup Language

CBEFF

Common Biometric Exchange Formats Framework - data elements and BIR formats specified in ISO/IEC 19785-1

BIAS implementation

software entity that is capable of creating, processing, sending, and receiving BIAS messages

BIAS endpoint

runtime entity, identified by an endpoint URI/IRI, capable of sending and receiving BIAS messages, and containing a running BIAS implementation

BIAS message

message that can be sent from a BIAS endpoint to another BIAS endpoint through a BIAS link channel

BIAS request message

BIAS message conveying a request for an action to be performed by the receiving BIAS endpoint

BIAS response message

BIAS message conveying a response to a prior BIAS requestmessage

1.6 References

1.6.1 Normative References

[RFC2119]   S. Bradner, Key words for use in RFCs to Indicate Requirement Levels, IETF RFC 2119, March 1997
http://www.ietf.org/rfc/rfc2119.txt

 

[CBEFF]  ISO/IEC19785-1:2006, Information technology – Common Biometric Exchange Formats Framework – Part 1: Data element specification, with Amendment 1:2010
http://www.iso.org

 

[CBEFF-3]   ISO/IEC19785-3:2015, Information technology – Common Biometric Exchange Formats Framework – Part 3: Patron format specifications
http://www.iso.org

 

[DATE-TIME]  ISO 8601:2004, Data elements and interchange formats — Information interchange — Representation of dates and times
http://www.iso.org

 

[INCITS-BIAS]  ANSI INCITS 442-2010, Biometric Identity Assurance Services (BIAS), July 2010
http://www.incits.org

 

[IRI]      M. Duerst, et al, Internationalized Resouce Identifiers, RFC3987, January 2005
http://www.ietf.org/rfc/rfc3987.txt

 

[ISO/IEC-BIAS]         ISO/IEC 30108-1:2015, Information technology — Biometric Identity Assurance Services — Part 1: BIAS Services
http://www.iso.org

[SOAP11]   Simple Object Access Protocol (SOAP) 1.1, 8 May 2000
http://www.w3.org/TR/2000/NOTE-SOAP-20000508/

[URI]     T. Berners-Lee, R. Fielding, L. Masinter, Uniform Resource Identifiers (URI): Generic Syntax, RFC 3986, MIT/LCS, U.C. Irvine, Xerox Corporation, January 2005.
http://ietf.org/rfc/rfc3986

[UTF-8]   ISO/IEC 10646:2003, Information technology — Universal Multiple-Octet Coded Character Set (UCS)
http://www.iso.org

[WS-Addr]  W3C Recommendation,Web Services Addressing 1.0 - Core,  and Web Services Addressing 1.0 - SOAP Binding, 9 May 2006
http://www.w3.org/2002/ws/addr/

[WS-I-Basic]  Basic Profile Version 1.1, 10 April 2006
http://www.ws-i.org/Profiles/BasicProfile-1.1-2006-04-10.html

[WS-I-Bind]  Web Services-Interoperability Organization (WS-I) Simple SOAP Binding Profile Version 1.0, 24 August 2004
http://www.ws-i.org/Profiles/SimpleSoapBindingProfile-1.0-2004-08-24.html

[WSDL11]   Web Services Description Language (WSDL) 1.1, 15 March 2001
http://www.w3.org/TR/2001/NOTE-wsdl-20010315

[XML 10]  Extensible Markup Language (XML) 1.0, 16 August 2006
http://www.w3.org/TR/2006/REC-xml-20060816/

[XOP]   XML-binary Optimized Packaging, W3C Recommendation, 25 January 2005
http://www.w3.org/TR/2005/REC-xop10-20050125/

1.6.2 Non-Normative References

[BioAPI]     ISO/IEC 19784-1:2006, Information technology – Biometric Application Programming Interface – Part 1: BioAPI Specification
http://www.iso.org

[BIO SEC]  ISO 19092 Financial services -- Biometrics -- Security framework
http://www.iso.org

[EBTS-DOD]   Department of DefenseElectronic Biometric TransmissionSpecification, Version 2.0, 27 March 2009
http://www.biometrics.dod.mil/CurrentInitiatives/Standards/dodebts.aspx

[EBTS-FBI] IAFIS-DOC-01078-8.1,  “Electronic Biometric Transmission Specification (EBTS)”, Version 8.1, November 19, 2008, Federal Bureau of Investigation, Criminal Justice Information Services Division
https://www.fbibiospecs.org

[EFTS]  IAFIS-DOC-01078-7,  “Electronic Fingerprint Transmission Specification (EFTS)”, Version 7.1, May 2, 2005, Federal Bureau of Investigation, Criminal Justice Information Services Division
https://www.fbibiospecs.org

[HR-XML]    HR-XML Consortium Library, 2007 April 15
http://www.hr-xml.org

[INT-I]   Interpol Implementation of ANSI/NIST ITL1-2000, Ver 4.22b, October 28, 2005, The Interpol AFIS Expert Group
http://www.interpol.int

[NIEM]  National Information Exchange Model (NIEM), Ver 2.0, June 2007, US DOJ/DHS
BIAS-v2.0-csprd01.docx

[RFC2246]   T. Dierks & C. Allen,The TLS Protocol, Version 1.0, January 1999
http://www.ietf.org/rfc/rfc2246.txt

[RFC2617]   J. Franks, et al, HTTP Authentication: Basic and Digest Access Authentication, June 1999
http://www.ietf.org/rfc/rfc2617.txt

[RFC3280]   R. Housley, et al, Internet X.509 Public Key Infrastructure Certificate and Certificate Revocation List (CRL) Profile, April 2002
http://www.ietf.org/rfc/rfc3280.txt

[SAML] Security Assertion Markup Language (SAML), Oasis Standard, March 2005
http://docs.oasis-open.org/security/saml/v2.0/saml-core-2.0-os.pdf

[SAML SEC]           Security and Privacy Considerations for the OASIS Security Assertion Markup Language (SAML) V2.0, Oasis Standard, 15 March 2005
http://docs.oasis-open.org/security/saml/v2.0/saml-sec-consider-2.0-os.pdf

[SSL3]  SSL 3.0 Specification
http://www.freesoft.org/CIE/Topics/ssl-draft/3-SPEC.HTM

[WSS]   Web Services Security: SOAP Message Security 1.1, (WS-Security 2004), OASIS Standard Specification, 1 February 2006
http://www.oasis-open.org/committees/download.php/16790/wss-v1.1-spec-os-SOAPMessageSecurity.pdf

[X509]   X.509: Information technology - Open Systems Interconnection - The Directory: Public-key and attribute certificate frameworks, ITU-T, August 2005
http://www.itu.int/rec/T-REC-X.509-200508-I

[xNAL]  Customer Information Quality Specifications Version 3.0: Name (xNL), Address (xAL), Name and Address (xNAL) and Party (xPIL), Committee Specification 02, 20 September 2008  
http://www.oasis-open.org/committees/tc_home.php?wg_abbrev=ciq

2            Design Concepts and Architecture (non-normative)

2.1 Philosophy

Rather than define a totally new and unique messaging protocol for biometric services, this specification instead defines a method for using existing biometric and Web services standards to exchange biometric data and perform biometric operations. 

2.2 Context

Today, biometric systems are being developed which collect, process, store and match biometric data for a variety of purposes.  In many cases, data and/or capabilities need to be shared between systems or systems serve a number of different client stakeholders.  As architectures move towards services-based frameworks, access to these biometric databases and services is via a Web services front-end.  However, lack of standardization in this area has led implementers to develop customized services for each system/application.

BIAS is intended to provide a common, yet flexible, Web services interface that can be used within both closed and open SOA systems.  Figure 1, below, depicts the context in which the BIAS messages will be implemented.

 

 

 

Figure 1.  BIAS Context

 

The clients (requesters) may use standard discovery mechanisms (i.e., UDDI directories) to discover the BIAS service provider (implementation) or, particularly in closed systems, the URI/IRI and WSDL for the service provider may be known a priori by the client BIAS application developer.

2.3 Architecture

BIAS Web services are intended to be used within systems employing a services framework, such as a services-oriented architecture (SOA) (although implementations are not limited to this environment).  As such, it is recognized that the clients may interact directly with the BIAS service provider or layers may exist between the client and the service provider, for example as an ESB or other application layer.

The BIAS Architecture as shown in Figure 2, in which:

·                     A Client request to the BIAS Web services may be triggered by a human interaction OR any proxy system such as an ESB.

·                     Client sends and receives SOAP messages that conform to the BIAS schemas

·                     Calls to the BIAS Implementation use OASIS Service Interfaces and Bindings (via WSDL)

·                     The BIAS implementation maps the service call to the appropriate internal API or set of APIs and returns data according to the service interface.

Note that services are represented as circles.

 

 

Figure 2. Representative BIAS Architecture

 

NOTE:  It is possible that BIAS may also be used between the service provider and the managed resource (e.g., a biometric matcher).

 

At the heart of the BIAS SOAP Profile are the concepts of BIAS messages and endpoints.

 

BIAS implementation

A BIAS implementation is a software entity that is capable of creating, processing, sending, and receiving BIAS messages.  This standard does not define requirements for the BIAS implementation other than defining the messages and protocols used by the endpoints.

BIAS messages

A BIAS message is a one that can be sent from a BIAS endpoint to another BIAS endpoint over a TCP/IP link.

BIAS endpoints

A BIAS endpoint is a runtime entity, uniquely identified and accessed by an endpoint URI/IRI [URI] [IRI], capable of sending and receiving BIAS messages.

NOTE:  When not publicly and directly exposed, the endpoints for purposes of this specification are the BIAS service provider exposing BIAS services and the component that directly interacts with that service provider, e.g., the business application or ESB, rather than the ultimate end client requester.

3            Data Dictionary

This section describes the BIAS data elements used within BIAS messages (as defined in Clause 4). Common data elements are defined for use in one or more operations. These include common data types or return codes. BIAS data elements are defined in ISO/IEC 30108-1. The elements, complex types and simple types described for the BIAS messages belong to the following namespace: http://docs.oasis-open.org/bias/ns/bias-2.0/.  See Annex A for the XML schema.

NOTE:  Biographic and biometric data included in a native XML format MAY contain elements referencing external namespaces (e.g., ansi-nist).

3.1 Documentation Conventions

Each common element has a section describing its content.  Likewise, each operation has a section describing the request and response messages and the associated input and output parameters. The input and output of each message and the comment elements are detailed in a table as described in the figure below. Each field that forms part of the message request/response is detailed in the table.

 

Header Name

Description

Values

Value Meaning

Field

The name of the field.

 

 

Type

The XML schema type of the field.

 

 

#

The cardinality of the field

1

One occurrence

0..1

Zero or one occurrence

0..*

Zero or more occurrences

1..*

One or more occurrences

?

Defines if the field must be present.

Y

Yes – is always required

N

No – is not always required, an optional field.

C

Conditional – requirement is dependent on system or message conditions.

Meaning

Gives a short description of the field’s use

 

 

Figure 3. BIAS Message Input/Output Dictionary Table Headings

Fields Hierarchy Explained:

To denote the field hierarchy the symbol  is used to denote the child-of relationship.

All string types/elements MUST consist of ISO/IEC 10646 (Unicode) characters encoded in UTF-8 [UTF-8] (see ISO/IEC 10646:2003, Annex D).

 

3.2 Common Elements

3.2.1 ApplicationIdentifier

Type:

string

Description:

Identifies an application.

Min Length:

1

Max Length:

255

3.2.2 ApplicationUserIdentifier

Type:

string

Description:

Identifies an application user or instance.

Min Length:

1

Max Length:

255

3.2.3 BaseBIRType

Type:

Schema complexType

Description:

Base type for all BIR subtypes; see BinaryBIR, URI_BIR, and XML_BIR for currently available types.

3.2.4 BIASBiometricDataType

Field

Type

#

?

Meaning

BIASBiometricDataType

 

 

Y

Wraps the various BIAS biometric types.

The operations that use this type specify which elements are required.

            BIRList

CBEFF_BIR_ListType

0..1

N

A list of CBEFF-BIR elements.

            BIR

CBEFF_BIR_Type

0..1

N

Contains biometric information in either a non-XML or an XML representation.

            InputBIR

CBEFF_BIR_Type

0..1

N

Maps to specific ISO/IEC BIAS elements as required by that specification.

            ReferenceBIR

CBEFF_BIR_Type

0..1

N

Maps to specific ISO/IEC BIAS elements as required by that specification.

            BiometricDataList

BiometricDataListType

0..1

N

A list of biometric data elements.

3.2.5 BIASFaultCode

Type:

String

Description:

Error code referenced in a SOAP fault.

BIASFaultCode Enumeration Values

Value

Description

UNKNOWN_ERROR

The service failed for an unknown reason.

UNSUPPORTED_CAPABILITY

A requested capability is not supported by the service implementation.

INVALID_INPUT

The data in a service input parameter is invalid.

BIR_QUALITY_ERROR

Biometric sample quality is too poor for the service to succeed.

INVALID_BIR

The input BIR is empty or in an invalid or unrecognized format.

BIR_SIGNATURE_FAILURE

The service could not validate the signature, if used, on the input BIR.

BIR_DECRYPTION_FAILURE

The service could not decrypt an encrypted input BIR.

INVALID_ENCOUNTER_ID

The input encounter ID is empty or in an invalid format.

INVALID_SUBJECT_ID

The input subject ID is empty or in an invalid format.

UNKNOWN_SUBJECT

The subject referenced by the input subject ID does not exist.

UNKNOWN_GALLERY

The gallery referenced by the input gallery ID does not exist.

UNKNOWN_ENCOUNTER

The encounter referenced by the input encounter ID does not exist.

UNKNOWN_BIOGRAPHIC_FORMAT

The biographic data format is not known or not supported.

UNKNOWN_IDENTITY_CLAIM

The identity referenced by the input identity claim does not exist.

INVALID_IDENTITY_CLAIM

The identity claim requested is already in use.

NONEXISTANT_DATA

The data requested for deletion does not exist.

UNKNOWN_DOCUMENT_CATEGORY

The data requested does not exist.

INVALID_TOKEN

The data requested does not exist.

TOKEN_EXPIRED

The data requested does not exist.

DUPLICATE_ENCOUNTER

The input encounter ID for a new encounter already exists for that subject.

IDENTIFICATION_RESULT_NOT_YET_AVAILABLE

The result of an asynchronous identification process is not yet available.

3.2.6 BIASFaultDetail

Field

Type

#

?

Meaning

BIASFaultDetail

 

 

Y

Defines the error information associated with a SOAP fault.

            BIASFaultType

BIASFaultCode

1

Y

References an error code.

            BIASFaultMessage

string

1

Y

Provides a brief explanation of the fault.

            BIASFaultDescription

string

0..1

N

Provides detailed information about a BIAS fault, such as trace details.

3.2.7 BIASIdentity

Field

Type

#

?

Meaning

BIASIdentity

 

 

Y

Defines a single element for encapsulating the data associated with an Identity. Includes the Identity’s reference identifiers, biographic data, and biometric data.

The operations that use this type specify which elements are required.

            SubjectID

BIASIDType

0..1

C

A system unique identifier for a subject.

Required as input to many operations.

            IdentityClaim

BIASIDType

0..1

N

An identifier by which a subject is known to a particular gallery or population group.

            EncounterID

BIASIDType

0..1

C

The identifier of an encounter associated with the subject.

Required for encounter-centric models.

            EncounterList

EncounterListType

0..1

N

A list of encounters associated with a subject.

            BiographicData

BiographicDataType

0..1

N

An Identity’s biographic data.

            BiometricData

BIASBiometricDataType

0..1

N

An Identity’s biometric data.

3.2.8 BIASIDType

Type:

string

Description:

A BIAS Identifier.

3.2.9 BinaryBIR

Field

Type

#

?

Meaning

BinaryBIR

BaseBIRType

 

Y

Defines a BIR type of Binary

            Binary

base64Binary

1

Y

BIR information in base64 binary format

3.2.10 BiographicDataItemType

Field

Type

#

?

Meaning

BiographicDataItemType

 

 

Y

Defines a single biographic data element.

            Name

string

1

Y

The name of the biographic data item.

            Type

string

1

Y

The data type for the biographic data item.

            Value

string

0..1

N

The value assigned to the biographic data item.

NOTE:  This element can be used to transmit scanned identity documents or document information (e.g., passports, driver’s license, birth certificates, utility bills, etc. required to establish an identity).

3.2.11 BiographicDataItemListType

Field

Type

#

?

Meaning

BiographicDataItemListType

 

 

Y

Defines a list of biographic data elements.

            BiographicDataItem

BiographicDataItemType

1..*

Y

Data structure containing information about a biographic record.

3.2.12 BiographicDataListType

Field

Type

#

?

Meaning

BiographicDataListType

 

 

Y

Defines a list of biographic data.

            BiographicData

BiographicDataType

0..*

N

Data structure containing information about a biographic record.

3.2.13 BiographicDataSetType

Field

Type

#

?

Meaning

BiographicDataSetType

 

 

Y

Defines a set of biographic data that is formatted according to the specified format.

            name

string

1

Y

The name of the biographic data format. Use these names for common formats: FBI-EFTS [EFTS], FBI-EBTS [EBTS-FBI], DOD-EBTS [EBTS-DOD], INT-I [INT-I], NIEM [NIEM], xNAL [xNAL], HR-XML [HR-XML].

            version

string

0..1

N

The version of the biographic data format (e.g., “7.1” for FBI-EFTS or “2.0” for NIEM).

            source

string

1

Y

Reference to a URI/IRI describing the biographic data format. For example: (FBI-EFTS and FBI-EBTS) www.fbibiospecs.org, (DOD-EBTS) www.biometrics.dod.mil, (INT-I) www.interpol.int, (NIEM) www.niem.gov, (xNAL) www.oasis-open.org, (HR-XML) www.hr-xml.org.

            type

string

1

Y

The biographic data format type. Use these types for common formats: ASCII (e.g., for non-XML versions of FBI-EFTS, FBI-EBTS, DOD-EBTS, or INT-I), XML (e.g., for NIEM, xNAL, and HR-XML or future versions of FBI-EBTS).

            unspecified

any

0..*

N

Biographic data formatted according to a specific format.

NOTE:  Biographic data formats are not limited to those listed.  The string value is not enumerated.  If one of the common types are used, it MUST be indicated by the specified name values; however, the service provider MAY offer other formats.  See ISO/IEC 30108 for further information.

3.2.14 BiographicDataType

Field

Type

#

?

Meaning

BiographicDataType

 

 

Y

Defines a set of biographic data elements, utilizing either the BiographicDataItemListType to represent a list of elements or the BiographicDataSetType to represent a complete, formatted set of biographic information.

One of the following elements must be present.

            LastName

string

0..1

N

The last name of a subject.

            FirstName

string

0..1

N

The first name of a subject.

            BiographicDataItemList

BiographicDataItemListType

0..1

N

A list of biographic data elements.

                        BiographicDataItem

BiographicDataItemType

1..*

Y

A single biographic data element.

            BiographicDataSet

BiographicDataSetType

0..1

N

A set of biographic data information.

NOTE:  The implementer is given three choices for encoding biographic data:

·         Encode only first and last name using the defined fields within BiographicDataType

·         Define a list of biographic data elements using the BiographicDataItemListType

·         Use a pre-defined set of biographic data (e.g., as specified in another standard) using the BiographicDataSetType.

See also ISO/IEC 30108-1, section 8.1 for further information.

3.2.15 BiometricDataType

Field

Type

#

?

Meaning

BiometricDataType

 

 

Y

Provides descriptive information about biometric data, such as the biometric type, subtype, and format, contained in the BDB of the CBEFF-BIR.

            BiometricType

oasis_cbeff:MultipleTypesType

1

Y

The type of biological or behavioral data stored in the biometric record, as defined by CBEFF.

            BiometricTypeCount

positiveInteger

0..1

N

The number of biometric records having the biometric type recorded in the biometric type field.

            BiometricSubType

oasis_cbeff:SubtypeType

0..1

N

More specifically defines the type of biometric data stored in the biometric record, as defined by CBEFF.

            BDBFormatOwner

positiveInteger

1

Y

Identifies the standards body, working group, industry consortium, or other CBEFF biometric organization that has defined the format for the biometric data.

            BDBFormatType

positiveInteger

1

Y

Identifies the specific biometric data format specified by the CBEFF biometric organization recorded in the BDB Format Owner field.

3.2.16 BiometricDataListType

Field

Type

#

?

Meaning

BiometricDataListType

 

 

Y

A list of biometric data elements.

            BiometricDataRecord

BiometricDataType

0..*

N

Data structure containing information about a biometric record.

3.2.17 CandidateListResultType

Field

Type

#

?

Meaning

CandidateListResultType

 

 

Y

Defines a set of candidates, utilizing the CandidateType to represent each element in the set.

            CandidateList

CandidateListType

1

Y

The candidate list.

3.2.18 CandidateListType

Field

Type

#

?

Meaning

CandidateListType

 

 

Y

Defines a set of candidates, utilizing the CandidateType to represent each element in the set.

            Candidate

CandidateType

0..*

N

A single candidate.

3.2.19 CandidateType

Field

Type

#

?

Meaning

CandidateType

 

 

Y

Defines a single candidate as a possible match in response to a biometric identification request.

            ScoreList

 

0..1

N

A list of comparison(s) scores and optionally the type and subtype of the relating biometric

                        Score

ScoreType

1

Y

The match score.

            Rank

integer

1

Y

The rank of the candidate in relation to other candidates for the same biometric identification operation.

            Identity

 

 

 

 

                        SubjectID

BIASIDType

0..1

Y

The identifier of the subject.

                        BiographicData

BiographicDataType

0..1

N

Biographic data associated with the candidate match.

                        BIRList

CBEFF_BIR_ListType

1

Y

Biometric data associated with the candidate match.

3.2.20 CapabilityListType

Field

Type

#

?

Meaning

CapabilityListType

 

 

Y

Defines a set of capabilities.

            Capability

CapabilityType

0..*

N

A single capability.

3.2.21 CapabilityName

Type:

string

Description:

A list of capability items.

CapabilityName Enumeration Values

Value

Description

AggregateInputDataOptional

A data element accepted as optional input by the implementing system for the aggregate services.

 

The Capability Value should be set to the name of the data element that will be accepted by the aggregate services.

 

The Capability Supporting Value that indicates the which services support the data element, using one or more of the following values, each separated by a comma:

 

“Delete”

“Enrol”

“Identify”

“Verify”

“All”

AggregateInputDataRequired

A data element required as input by the implementing system for the aggregate services.

 

The Capability Value should be set to the name of the data element that will be accepted by the aggregate services.

 

The Capability Supporting Value that indicates the which services support the data element, using one or more of the following values, each separated by a comma:

 

“Delete”

“Enrol”

“Identify”

“Verify”

“All”

AggregateProcessingOption

A processing option supported by the implementing system for the aggregate services.

 

The Capability Value should be set to the option identifier, or “key” field, for the Processing Option parameter in the aggregate services.

 

The Capability Supporting Value that indicates the option value, or “value” field, for the Processing Option parameter in the aggregate services, if applicable.

 

The Capability Additional Info should indicate which aggreagate services support the processing option, using one or more of the following values, each separated by a comma:

 

“Delete”

“Enrol”

“Identify”

“Verify”

“Retrieve”

“All”

AggregateReturnData

A data element returned by the implementing system for the aggregate services.

 

The Capability Value should be set to the name of the data element that will be returned by the aggregate services.

 

The Capability Supporting Value that indicates which services support the data element, using one or more of the following values, each separated by a comma:

 

“Delete”

“Enrol”

“Identify”

“Verify”

“Retrieve”

“All”

AggregateServiceDescription

Describes the processing logic of an aggregate service supported by the implementing system.

 

The Capability Value should be set to the name of the data element that describes the aggregate services.

 

The Capability Supporting Value that indicates the which services support the data element, using one or more of the following values, each separated by a comma:

 

“Delete”

“Enrol”

“Identify”

“Verify”

“Retrieve”

BiographicDataSet

Identifies a biographic data set supported by the implementing system.

 

The Capability Value should contain the name of the biographic data format supported by the implementing system (e.g. “EBTS” or “NIEM”).

 

The Capability Supporting Value should contain the version of the biographic data format supported by the implementing system.

 

The Capability Additional Info should contain the biographic data format type supported by the implementing system (e.g. ASCII or XML).

CBEFFPatronFormat

A patron format supported by the implementing system.

 

The Capability Value should contain the format owner.

 

The Capability Supporting Value should contain the format type.

ClassificationAlgorithmType

A classification algorithm type supported by the implementing system.

 

The Capability Value should contain the name of classification alogorithm type supported by the implementing system.

ConformanceClass

Identifies the conformance class of the BIAS implementation.

 

The Capability Value should be set to one of the following:

 

1 – (Class 1 conformance)

2 – (Class 2 conformance)

3 – (Class 3 conformance)

4 – (Class 4 conformance)

5 – (Class 5 conformance)

6 – (Class 6 conformance)

7 – (Class 7 conformance)

Gallery

A gallery or population group supported by the implementing system.

 

The Capability Value should be the same as the value used for the Gallery ID parameter in the Add Subject to Gallery, Delete Biographic Data, Delete Biometric Data, Delete Subject From Gallery, Identify Subject, Retrieve Biographic Data Retrieve Biometric Data, Retrieve Document Data, Set Biographic Data, Set Biometric Data, Set Document Data, and Verify Subject Services.

IdentityModel

Identifies whether the implementing system is person-centric or encounter-centric based.

 

The Capability Value shall be set to one of the following:

 

“person”

“encounter”

MatchAlgorithm

A match algorithm vendor and algorithm vendor product ID supported by the implementing system.

 

The Capability Value shall contain the algorighm vendor.

 

The Capability Supporting Value shall contain the algorithm vendor product ID.

 

The Capability Additional Info shall be set to the biometric type (defined by the XML Patron Format in ISO/IEC 19785-3) that corresponds to the match algorithm.

 

The Capability Description shall contain the software version of the match algorithm.

MatchScore

Identifies the use of match scores returned by the implementing system.

 

The Capability Value shall be set to the end-of-score-range that signifies a match.

 

The Capability Supporting Value shall be set to the end-of-score-range that signifies a no-match.

 

The Capability Additional Info shall be set to the biometric type (defined by the XML Patron Format in ISO/IEC 19785-3) that corresponds to the match score range.

QualityAlgorithm

A quality algorithm vendor and algorithm vendor product ID supported by the implementing system.

 

The Capability Value shall contain the algorighm vendor.

 

The Capability Supporting Value shall contain the algorithm vendor product ID.

 

The Capability Additional Info shall be set to the biometric type (defined by the XML Patron Format in ISO/IEC 19785-3) that corresponds to the quality algorithm.

 

The Capability Description shall contain the software version of the quality algorithm.

SupportedBiometric

A biometric type supported by the implementing system.

 

The Capability Value shall be set to the biometric type, as defined by the ZML Patron Format in ISO/IEC 19785-3 (for example, the biometric type for face is represented a “face”).

 

The Capability Supporting Value shall indicate if the implementing system supports matching for the biometric type, using one of he following values:

 

“1” (identification)

“2” (verification)

“3” (identification and verification)

“4” (no comparison supported)

TransformOperation

A transform operation type supported by the implementing system.

 

The Capability Value shall be equal to the value for the Transform Operation parameter in the Transform Biometric Data service.

 

The Capability Supporting Value shall specify the value of the Transform Control parameter in the Transform Biometric Data service. The value returned may be either a single value or a range of values. If a range of values is returned, the Capability Description shall specify additional information for the value of the Transform Control parameter. If the Transform Operation does not support a Transform Control, the Capability Supporting value shall be set to “NotApplicable”.

3.2.22 CapabilityType

Field

Type

#

?

Meaning

CapabilityType

 

 

Y

Defines a single capability supported by an implementing system.

            CapabilityName

CapabilityName

1

Y

The name of the capability.

            CapabilityID

string

0..1

N

An identifier assigned to the capability by the implementing system.

            CapabilityDescription

string

0..1

N

A description of the capability.

            CapabilityValue

string

0..1

N

A value assigned to the capability.

            CapabilitySupportingValue

string

0..1

N

A secondary value supporting the capability.

            CapabilityAdditionalInfo

string

0..1

N

Contains additional information for the supported capability.

3.2.23 CBEFF_BIR_ListType

Field

Type

#

?

Meaning

CBEFF_BIR_ListType

 

 

Y

A list of CBEFF-BIR elements.

            BIR

CBEFF_BIR_Type

0..*

N

CBEFF structure containing information about a biometric sample.

3.2.24 CBEFF_BIR_Type

Field

Type

#

?

Meaning

CBEFF_BIR_Type

 

 

Y

Represents biometric information, with either a non-XML or XML representation.

            FormatOwner

positiveInteger

1

Y

Identifies the Patron format owner.

            FormatType

positiveInteger

1

Y

Identifies the Patron format type.

            BIR_Information

 

0..1

N

Describes what is contained in a BIR.

                        BIR_Info

oasis_cbeff:BIRInfoType

0..1

N

Contains information about the CBEFF-BIR.

                        BDB_Info

oasis_cbeff:BDBInfoType

0..1

N

Contains information about the BDB in a simple CBEFF-BIR.

                        SB_Info

oasis_cbeff:SBInfoType

0..1

N

Contains information about the security block, if used, in a simple CBEFF-BIR.

            BIR

BaseBIRType

1

Y

One of the following sub-elements must be present: BinaryBIR, URI_BIR, or XML_BIR.

NOTE:  The implementer is given three choices for encoding a BIR:

The latter two alternatives can use any CBEFF Patron Format.  The optional BIR_Information provides a mechanism for exposing metadata associated with a BIR format that is not easily decoded (i.e., a non-XML BIR).  See section 5.3 for more information on handling of binary data within BIAS and ISO/IEC 30108, Clause 8.2, for more information on representing biometric data.

NOTE: 

(1)   XML BIRs MUST conform to the XML patron format in Annex B; however, non-XML (binary) and URI BIRs MAY implement any CBEFF patron format.

(2)   It is RECOMMENDED that only registered CBEFF patron formats be used; however, in closed systems, this may not be required.

3.2.25 Classification

Type:

string

Description:

The result of a classification.

3.2.26 ClassificationAlgorithmType

Type:

string

Description:

Type of classification algorithm that was used to perform the classification.

3.2.27 ClassificationData

Field

Type

#

?

Meaning

ClassificationData

 

 

Y

Contains information on classification results and the algorithm used to determine the classification.

            Classification

Classification

1

Y

The result of the classification.

            ClassificationAlgorithmType

ClassificationAlgorithmType

1

Y

Identifies the type of classification algorithm that was used to perform the classification.

3.2.28 DocumentDataType

Field

Type

#

?

Meaning

DocumentDataType

 

 

Y

Defines a set of document data elements providing information about the presented identity document.

            DocumentCategory

string

1

Y

The type of identity document presented (e.g. passport).

            DocumentIDNumber

string

0..1

N

The number associated with the identity document (e.g. passport number)

            DocumentIssuanceCountryCode

iso_3166_1:CountryAlpha2CodeType

0..1

N

The ISO 2-character code for the country which issued the document or from within which it was issued.

            DocumentIssuingOrganization

string

0..1

N

The entity which issued the identity document.

            DocumentIssuanceDate

datetime

0..1

N

The date upon which the identity document was issued.

            DocumentExpirationDate

datetime

0..1

N

The date upon which the identity document is no longer valid (expires).

            DocumentLastName

string

0..1

N

The family name of the person to whom the identity document was issued, as contained within the document itself.

            DocumentFirstName

string

0..1

N

The first given name of the person to whom the identity document was issued, as contained within the document itself.

            DocumentMiddleName

string

0..1

N

The second given name of the person to whom the identity document was issued, as contained within the document itself.

            DocumentValidity

boolean

0..1

N

The assessed validity of the identity document (e.g. as the result of local or online validity checks).

            DocumentValidityText

string

0..1

N

Details or remarks associated with the assessed validity (e.g. description of validity issue).

            DocumentImage

xsd:base64binary

0..1

N

A scanned image of the subject document (e.g. passport picture page).

3.2.29 DocumentDataListType

Field

Type

#

?

Meaning

DocumentDataListType

 

 

Y

Provides a list of documents.

            DocumentData

DocumentDataType

0..*

Y

Data structure containing information about a document and optionally an image of that document.

3.2.30 EncounterCategoryType

Type:

String

Description:

Identifies the type of encounter (interaction) during which the identity (biographic, biometric, and/or document) data was collected from the subject as determined by the requester.

EncounterCategoryType Enumeration Values

Value

Description

Enrolment

The encounter is created during an enrolment interaction.

Recognition

The encounter is created during a recognition interaction.

Unspecified

The type of encounter is unknown.

3.2.31 EncounterListType

Field

Type

#

?

Meaning

EncounterListType

 

 

Y

Defines a set of encounters.

            EncounterID

BIASIDType

0..*

N

The identifier of an encounter.

3.2.32 FusionDecision

Type:

string

Description:

The match decision assigned by the matching algorithm

3.2.33 FusionIdentityListType

Field

Type

#

?

Meaning

FusionIdentityListType

 

 

Y

Contains fusion input elements for one or more identities, utilizing the FusionInformationListType to represent a single set of fusion information for each identity.

            FusionIdentity

FusionInformationListType

0..*

Y

A set of fusion information for a single identity.

3.2.34 FusionInformationListType

Field

Type

#

?

Meaning

FusionInformationListType

 

 

Y

Contains at a minimum two sets of fusion input elements, as input to the PerformFusion operation.

            FusionElement

FusionInformationType

2..*

Y

A set of fusion information.

3.2.35 FusionInformationType

Field

Type

#

?

Meaning

FusionInformationType

 

 

Y

Represents the information necessary to perform a fusion operation.

            BiometricType

oasis_cbeff:MultipleTypesType

1

Y

The type of biological or behavioral data stored in the biometric record, as defined by CBEFF.

            BiometricSubType

oasis_cbeff: SubtypeType

0..1

N

More specifically defines the type of biometric data stored in the biometric record.

            AlgorithmOwner

string

1

Y

The owner or vendor of the algorithm used to determine the score or decision.

            AlgorithmType

string

1

Y

The Algorithm Owner’s identifier for the specific algorithm product and version used to determine the score or decision.

            FusionResult

FusionResult

0..1

C

Either FusionScore or a FusionDecision element MUST be used.

3.2.36 FusionResult

Type:

complexType

Description:

The base type for any resulting types which indicate the status of a Fusion operation

3.2.37 FusionScore

Type:

ScoreType

Description:

The similarity score assigned by the matching algorithm.

3.2.38 GenericRequestParameters

Field

Type

#

?

Meaning

GenericRequestParameters

 

 

Y

Common request parameters that can be used to identify the requester.

            Application

ApplicationIdentifier

0..1

N

Identifies the requesting application.

            ApplicationUser

ApplicationUserIdentifier

0..1

N

Identifies the user or instance of the requesting application.

            BIASOperationName

string

0..1

N

Identifies the BIAS operation that is being requested.

NOTE:  See section 5.4 for alternatives for identifying the requested BIAS operation in a BIAS SOAP message.

3.2.39 IdentifySubjectResultType

Description:

A base type for all types that could be returned from the IdentifySubject operation

3.2.40 InformationType

Field

Type

#

?

Meaning

InformationType

 

 

Y

Allows for an unlimited number of data element types, and it does not specify nor require any particular data element.

            unspecified

any

0..*

N

 

3.2.41 ListFilterType

Field

Type

#

?

Meaning

ListFilterType

 

 

Y

Provides a method to filter the amount of information returned in a search of biometric data.

            BiometricTypeFilters

 

1

Y

 

                        BiometricTypeFilter

oasis_cbeff:MultipleTypesType

1..*

Y

Limits the returned information to a specific type of biometric, as defined by CBEFF.

            IncludeBiometricSubType

boolean

1

Y

A Boolean flag indicating if biometric subtype information should be returned.

3.2.42 MatchType

Type:

boolean

Description:

The result of a fusion method.

3.2.43 OptionType

Field

Type

#

?

Meaning

OptionType

 

 

Y

BIAS aggregate operations support the ability to include various processing options which direct and possibly control the business logic for that operation. Together with the ProcessingOptionsType, The OptionType provides a method to represent those options. Processing options SHOULD be defined by the implementing system.

            Key

string

1

Y

The identifier of an option supported by the implementing system.

            Value

string

0..1

N

The value for an option supported by the implementing system.

3.2.44 ProcessingOptionsType

Field

Type

#

?

Meaning

ProcessingOptionsType

 

 

Y

BIAS aggregate operations support the ability to include various processing options which direct and possibly control the business logic for that operation. The ProcessingOptionsType provides a method to represent those options. Processing options SHOULD be defined by the implementing system.

            Option

OptionType

0..*

N

An option supported by the implementing system.

3.2.45 ProductID

Type:

string

Description:

The vendor’s ID for a particular product.

3.2.46 QualityData

Field

Type

#

?

Meaning

QualityData

 

 

Y

Contains information about a biometric sample’s quality and the algorithm used to compute the quality.

            QualityScore

oasis_cbeff:QualityType

0..1

N

The quality of a biometric sample.

            AlgorithmVendor

VendorIdentifier

1

Y

The vendor of the quality algorithm used to determine the quality score.

            AlgorithmVendorProductID

ProductID

1

Y

The vendor’s ID for the algorithm used to determine the quality.

            AlgorithmVersion

VersionType

0..1

N

The version of the algorithm used to determine the quality.

 

3.2.47 ResponseStatus

Field

Type

#

?

Meaning

ResponseStatus

 

 

Y

 

            Return

ReturnCode

1

Y

The return code indicates the return status of the operation.

            Message

string

0..1

N

A short message corresponding to the return code.

3.2.48 ReturnCode

Type:

unsignedLong

Description:

Return value specifying success or other condition.

ReturnCode Enumeration Values

Value

Description

0

Success

3.2.49 ScoreType

Field

Type

#

?

Meaning

ScoreType

 

 

Y

 

            Value

float

1

Y

Defines a match result or quality score.

            BiometricType

oasis_cbeff:MultipleTypesType

0..1

N

The type of biological or behavioral data stored in the biometric record, as defined by CBEFF.

             BiometricSubType

oasis_cbeff:SubTypesType

0..1

N

More specifically defines the type of biometric data stored in the biometric record.

NOTE:  Matching scores MAY be in a standardized or proprietary form in terms of value range and interpretation.  Quality scores, however, follow the definition found in Annex

3.2.50 TokenResultType

Field

Type

#

?

Meaning

TokenResultType

 

 

Y

Defines a token that is returned for asynchronous processing.

            TokenType

TokenType

1

Y

Defines a token that is returned for asynchronous processing.

3.2.51 TokenType

Field

Type

#

?

Meaning

TokenType

 

 

Y

Defines a token that is returned for asynchronous processing.

            TokenValue

string

1

Y

A value returned by the implementing system that is used to retrieve the results to an operation at a later time.

            Expiration

date

1

Y

A date and time at which point the token expires and the operation results are no longer guaranteed to be available.

NOTE:  Date/time format is defined in ISO/IEC 30108 and is consistent with the date format specified in Annex B and ISO 8601[DATE-TIME].See also Annex A for schema definition.

3.2.52 URI_BIR

Field

Type

#

?

Meaning

URI_BIR

BaseBIRType

 

Y

Defines a BIR type of Binary

            URI

anyURI

1

Y

The URI of the BIR

3.2.53 VendorIdentifier

Type:

string

Description:

Identifies a vendor.

NOTE:  Vendor identifiers are registered with IBIA as the CBEFF registration authority (see ISO/IEC 19785-2).  Registered biometric organizations are listed at: http://www.ibia.org/cbeff/_biometric_org.php.

3.2.54 Version

Field

Type

#

?

Meaning

Version

 

 

Y

For a description or definition of each data element, see the referenced CBEFF standards in the CBEFF_BIR_TYPE schema.

            major

nonNegativeInteger

1

Y

            minor

nonNegativeInteger

1

Y

3.2.55 VersionType

Type:

string

Description:

The version of a component.

3.2.56 XML_BIR

Field

Type

#

?

Meaning

XML_BIR

BaseBIRType

 

Y

Defines a BIR type of Binary

            XML

Oasis_cbeff:BIRType

1

Y

BIR information in XML format

 

4            BIAS Messages

This section describes the BIAS messages implementing BIAS operations as defined in ISO/IEC 30108-1:2015.  The operations are listed alphabetically, with each operation containing a request and a response message.  The tables follow the conventions described in section 3.1.

4.1 Primitive Operations

4.1.1 AddSubjectToGallery

AddSubjectToGalleryRequest

AddSubjectToGalleryResponse

The AddSubjectToGallery operation registers a subject to a given gallery or population group. As an OPTIONAL parameter, the value of the claim to identity by which the subject is known to the gallery MAY be specified. This claim to identity MUST be unique across the gallery. If no claim to identity is specified, the subject ID (assigned with the CreateSubject operation) will be used as the claim to identity. In the encounter-centric model, the encounter ID associated with the subject’s biometrics that will be added to the gallery MUST be specified. Additionally, the service provider implementation is responsible for the creation and management of galleries. For this purpose, services are not exposed to the requester.

Request Message

Field

Type

#

?

Meaning

AddSubjectToGallery

 

 

Y

Register a subject to a given gallery or population group.

AddSubjectToGalleryRequest

 

1

Y

 

            GenericRequestParameters

GenericRequestParameters

0..1

N

Common request parameters that can be used to identify the requester.

                        Application

ApplicationIdentifier

0..1

N

Identifies the requesting application.

                        ApplicationUser

ApplicationUserIdentifier

0..1

N

Identifies the user or instance of the requesting application.

                        BIASOperationName

string

0..1

N

Identifies the BIAS operation that is being requested: “AddSubjectToGallery”.

            GalleryID

BIASIDType

1

Y

The identifier of the gallery or population group to which the subject will be added.

            Identity

BIASIdentity

1

Y

The identity to add to the gallery.

                        SubjectID

BIASIDType

1

Y

A system unique identifier for a subject.

                        IdentityClaim

BIASIDType

0..1

N

An identifier by which a subject is known to a particular gallery or population group. (This could be a username or account number, for example.)

                        EncounterID

BIASIDType

0..1

C

The identifier of an encounter associated with the subject.

Required for encounter-centric models.

Response Message

Field

Type

#

?

Meaning

AddSubjectToGalleryResponse

 

 

Y

The response to an AddSubjectToGallery operation.

AddSubjectToGalleryResponsePackage

 

1

Y

 

            ResponseStatus

ResponseStatus

1

Y

Returned status for the operation.

                        Return

ReturnCode

1

Y

The return code indicates the return status of the operation.

                        Message

string

0..1

N

A short message corresponding to the return code.

4.1.2 CheckQuality

CheckQualityRequest

CheckQualityResponse

The CheckQuality operation returns a quality score for a given biometric or a specified subject. Either a biometric sample or a subject ID MUST be provided. The biometric input is provided in a CBEFF basic structure or CBEFF record, which in this specification is called a CBEFF-BIR. The algorithm vendor and algorithm vendor product ID MAY be optionally provided in order to request a particular algorithm’s use in calculating the biometric quality. If an algorithm vendor is provided, then the algorithm vendor product ID is REQUIRED. If no algorithm vendor is provided, the implementing system will provide the algorithm vendor and algorithm vendor product ID that were used to calculate the biometric quality as output parameters.

Algorithm Vendors are registered with the ISO Biometric Registration Authority. They are assigned unique identifiers as outlined in ISO/IEC 19785-2. Algorithm Product IDs are assigned by the registered algorithm vendor.

Request Message

Field

Type

#

?

Meaning

CheckQuality

 

 

Y

Calculate a quality score for a given biometric.

CheckQualityRequest

 

1

Y

 

            GenericRequestParameters

GenericRequestParameters

0..1

N

Common request parameters that can be used to identify the requester.

                        Application

ApplicationIdentifier

0..1

N

Identifies the requesting application.

                        ApplicationUser

ApplicationUserIdentifier

0..1

N

Identifies the user or instance of the requesting application.

                        BIASOperationName

string

0..1

N

Identifies the BIAS operation that is being requested: “CheckQuality”.

            BiometricData

BIASBiometricDataType

0..1

C

Data structure containing a single biometric sample for which a quality score is to be determined; required if no Subject ID is provided.

                        BIR

CBEFF_BIR_Type

1

Y

The biometric sample.

            Identity

BIASIdentity

0..1

C

Required if no BIR is provided.

                        SubjectID

BIASIDType

1

Y

Identifies the subject; required if no BIR is provided.

            Qualityinfo

QualityData

0..1

N

Specifies a particular algorithm vendor and vender product ID.

                        AlgorithmVendor

VendorIdentifier

1

Y

The vendor of the quality algorithm used to determine the quality score.

                        AlgorithmVendorProductID

ProductID

1

C

The vendor assigned ID for the algorithm used to determine the quality; required as input if algorithm vendor is provided

Response Message

Field

Type

#

?

Meaning

CheckQualityResponse

 

 

Y

The response to a CheckQuality operation.

CheckQualityResponsePackage

 

1

Y

 

            ResponseStatus

ResponseStatus

1

Y

Returned status for the operation.

                        Return

ReturnCode

1

Y

The return code indicates the return status of the operation.

                        Message

string

0..1

N

A short message corresponding to the return code.

            QualityInfo

QualityData

1

Y

Contains the quality information for the submitted biometric sample.

                        QualityScore

oasis_cbeff:QualityType

0..1

N

The quality of a biometric sample.

                        AlgorithmVendor

VendorIdentifier

1

Y

The vendor of the quality algorithm used to determine the quality score.

                        AlgorithmVendorProductID

ProductID

1

Y

The vendor’s ID for the algorithm used to determine the quality.

                        AlgorithmVersion

VersionType

1

Y

The version of the algorithm used to determine the quality.

4.1.3 ClassifyBiometricData

ClassifyBiometricDataRequest

ClassifyBiometricDataResponse

The ClassifyBiometricData operation attempts to classify a biometric sample. For example, a fingerprint biometric sample may be classified as a whorl, loop, or arch (or other classification classes and sub-classes). If no classification algorithm is input, then the BIAS service provider will make the selection.

To obtain the types of classification algorithms and classes, see the QueryCapabilities operation.

Request Message

Field

Type

#

?

Meaning

ClassifyBiometricData

 

 

Y

Classifies a biometric sample.

*       ClassifyBiometricDataRequest

 

1

Y

 

            GenericRequestParameters

GenericRequestParameters

0..1

N

Common request parameters that can be used to identify the requester.

                        Application

ApplicationIdentifier

0..1

N

Identifies the requesting application.

                        ApplicationUser

ApplicationUserIdentifier

0..1

N

Identifies the user or instance of the requesting application.

                        BIASOperationName

string

0..1

N

Identifies the BIAS operation that is being requested: “ClassifyBiometricData”.

            BiometricData

BIASBiometricDataType

1

Y

Data structure containing a single biometric sample for which the classification is to be determined.

                        BIR

CBEFF_BIR_Type

1

Y

The biometric sample.

            ClassificationData

 

0..1

N

Contains the algorithm to be used to determine the classification.

                        ClassificationAlgorithmType

 

ClassificationAlgorithmType

1

Y

Identifies the type of classification algorithm to be used to perform the classification.

Response Message

Field

Type

#

?

Meaning

ClassifyBiometricDataResponse

 

 

Y

The response to a ClassifyBiometricData operation, containing the classification of a biometric sample.

ClassifyBiometricDataResponsePackage

 

1

Y

 

            ResponseStatus

ResponseStatus

1

Y

Returned status for the operation.

                        Return

ReturnCode

1

Y

The return code indicates the return status of the operation.

                        Message

string

0..1

N

A short message corresponding to the return code.

            ClassificationData

ClassificationData

1

Y

Information on the results and type of classification performed.

                        Classification

Classification

1

Y

The result of the classification.

                        ClassificationAlgorithmType

ClassificationAlgorithmType

1

Y

Identifies the type of classification algorithm that was used to perform the classification.

4.1.4 CreateEncounter

CreateEncounterRequest

CreateEncounterResponse

The CreateEncounter operation creates a new encounter record for a subject and associates an encounter ID to that record. If an encounter ID is not supplied by the requester, the service generates an encounter ID that uniquely identifies the encounter within the subject record. The CreateEncounter operation is performed prior to a SetBiographicData, SetBiometricData, or SetDocumentData operation.

In encounter mode, for match operations, the BIAS service provider will create the encounter and will set the encounter type to “recognition”. Normally the BIAS implementation will assign the encounter ID. However, if a requester assigns the encounter ID, it should be used unless it duplicates an existing encounter ID. If that happens an error should be returned.

Request Message

Field

Type

#

?

Meaning

CreateEncounter

 

 

Y

Create a new encounter record for the specified subject and associate an encounter ID to that record.

*       CreateEncounterRequest

 

1

Y

 

            GenericRequestParameters

GenericRequestParameters

0..1

N

Common request parameters that can be used to identify the requester.

                        Application

ApplicationIdentifier

0..1

N

Identifies the requesting application.

                        ApplicationUser

ApplicationUserIdentifier

0..1

N

Identifies the user or instance of the requesting application.

                        BIASOperationName

string

0..1

N

Identifies the BIAS operation that is being requested: “CreateEncounter”.

            Identity

BIASIdentity

1

Y

 

                        SubjectID

BIASIDType

1

Y

A system unique identifier for a subject

                        EncounterID

BIASIDType

0..1

N

The identifier of an encounter associated with the subject.

Required for encounter-centric models.

            EncounterType

EncounterCategoryType

1

Y

Identifies the type of encounter during which data was collected from the subject, as determined by the requester.

Response Message

Field

Type

#

?

Meaning

CreateEncounterResponse

 

 

Y

The response to a CreateEncounter operation, containing the new encounterID associated with the specified subject.

CreateEncounterResponsePackage

 

1

Y

 

            ResponseStatus

ResponseStatus

1

Y

Returned status for the operation.

                        Return

ReturnCode

1

Y

The return code indicates the return status of the operation.

                        Message

string

0..1

N

A short message corresponding to the return code.

            Identity

BIASIdentity

1

Y

 

                        EncounterID

BIASIDType

1

Y

The identifier of an encounter associated with the subject.

Required for encounter-centric models.

4.1.5 CreateSubject

CreateSubjectRequest

CreateSubjectResponse

The CreateSubject operation creates a new subject record and associates a subject ID to that record. As an optional parameter, the subject ID MAY be specified by the caller. If no subject ID is specified, the CreateSubject operation will generate one. UUIDs should be used for Subject IDs when universal uniqueness is required.

Request Message

Field

Type

#

?

Meaning

CreateSubject

 

 

Y

 

CreateSubjectRequest

 

1

Y

 

            GenericRequestParameters

GenericRequestParameters

0..1

N

Common request parameters that can be used to identify the requester.

                        Application

ApplicationIdentifier

0..1

N

Identifies the requesting application.

                        ApplicationUser

ApplicationUserIdentifier

0..1

N

Identifies the user or instance of the requesting application.

                        BIASOperationName

string

0..1

N

Identifies the BIAS operation that is being requested: “CreateSubject”.

Response Message

Field

Type

#

?

Meaning

CreateSubjectResponse

 

 

Y

The response to a CreateSubject operation, containing the subject ID of the new subject record.

CreateSubjectResponsePackage

 

1

Y

 

            ResponseStatus

ResponseStatus

1

Y

Returned status for the operation.

                        Return

ReturnCode

1

Y

The return code indicates the return status of the operation.

                        Message

string

0..1

N

A short message corresponding to the return code.

            Identity

BIASIdentity

1

Y

 

                        SubjectID

BIASIDType

1

Y

A system unique identifier for a subject.

4.1.6 DeleteBiographicData

DeleteBiographicDataRequest

DeleteBiographicDataResponse

The DeleteBiographicData operation erases all of the biographic data associated with a given subject record. In the encounter-centric model the operation erases all of the biographic data associated with a given encounter, and therefore the encounter ID MUST be specified. If no encounter ID is specified, or it is null, biographic data will be removed from all encounters. If a gallery is specified, biographic data will be deleted from that gallery only.

When deleting data, BIAS implementations MAY completely erase the information in order to prevent the ability to reconstruct a record in whole or in part, or they MAY track and record the deleted information for auditing and/or quality control purposes.

Request Message

Field

Type

#

?

Meaning

DeleteBiographicData

 

 

Y

Erase all of the biographic data associated with a given subject record or, in the encounter-centric model, with a given encounter.

DeleteBiographicDataRequest

 

1

Y

 

            GenericRequestParameters

GenericRequestParameters

0..1

N

Common request parameters that can be used to identify the requester.

                        Application

ApplicationIdentifier

0..1

N

Identifies the requesting application.

                        ApplicationUser

ApplicationUserIdentifier

0..1

N

Identifies the user or instance of the requesting application.

                        BIASOperationName

string

0..1

N

Identifies the BIAS operation that is being requested: “DeleteBiographicData”.

            Identity

BIASIdentity

1

Y

 

                        SubjectID

BIASIDType

1

Y

A system unique identifier for a subject.

                        EncounterID

BIASIDType

0..1

C

The identifier of an encounter associated with the subject.

Required for encounter-centric models.

            GalleryID

BIASIDType

0..1

N

The identifier of the gallery or population group from which the biographic information will be deleted.

Response Message

Field

Type

#

?

Meaning

DeleteBiographicDataResponse

 

 

Y

The response to a DeleteBiographicData operation.

*       DeleteBiographicDataResponsePackage

 

1

Y

 

            ResponseStatus

ResponseStatus

1

Y

Returned status for the operation.

                        Return

ReturnCode

1

Y

The return code indicates the return status of the operation.

                        Message

string

0..1

N

A short message corresponding to the return code.

4.1.7 DeleteBiometricData

DeleteBiometricDataRequest

DeleteBiometricDataResponse

The DeleteBiometricData operation erases all of the biometric data associated with a given subject record. In the encounter-centric model the operation erases all of the biometric data associated with a given encounter, and therefore the encounter ID MUST be specified. If no encounter ID is specified, or it is null, biometric data will be removed from all encounters. If a gallery is specified, biometric data will be deleted from that gallery only. If a biometric type(s) is specified, then only biometric data of that type will be deleted.

When deleting data, BIAS implementations MAY completely erase the information in order to prevent the ability to reconstruct a record in whole or in part, or they MAY track and record the deleted information for auditing and/or quality control purposes.

Request Message

Field

Type

#

?

Meaning

DeleteBiometricData

 

 

Y

Erase all of the biometric data associated with a given subject record or, in the encounter-centric model, with a given encounter.

*       DeleteBiometricDataRequest

 

1

Y

 

            GenericRequestParameters

GenericRequestParameters

0..1

N

Common request parameters that can be used to identify the requester.

                        Application

ApplicationIdentifier

0..1

N

Identifies the requesting application.

                        ApplicationUser

ApplicationUserIdentifier

0..1

N

Identifies the user or instance of the requesting application.

                        BIASOperationName

string

0..1

N

Identifies the BIAS operation that is being requested: “DeleteBiometricData”.

            Identity

BIASIdentity

1

Y

 

                        SubjectID

BIASIDType

1

Y

A system unique identifier for a subject.

                        EncounterID

BIASIDType

0..1

C

The identifier of an encounter associated with the subject.

Required for encounter-centric models.

            BiometricType

oasis_cbeff:MultipleTypesType

0..1

N

The type of biological or behavioral data to delete, as defined by CBEFF.

            GalleryID

BIASIDType

0..1

N

The identifier of the gallery or population group from which the biometric information will be deleted.

Response Message

Field

Type

#

?

Meaning

DeleteBiometricDataResponse

 

 

Y

The response to a DeleteBiometricData operation.

DeleteBiometricDataResponsePackage

 

1

Y

 

            ResponseStatus

ResponseStatus

1

Y

Returned status for the operation.

                        Return

ReturnCode

1

Y

The return code indicates the return status of the operation.

                        Message

string

0..1

N

A short message corresponding to the return code.

4.1.8 DeleteDocumentData

DeleteDocumentDataRequest

DeleteDocumentDataResponse

The DeleteDocumentData operation erases all of the document data of the specified category(ies) associated with a given subject record. In the encounter-centric model the service erases all of the document data associated with a given encounter, and therefore the encounter ID MUST be specified. If no encounter ID is specified, or it is null, document data will be removed from all encounters. If no categories are specified, then all categories (for the specified encounters) will be deleted.

When deleting data, BIAS implementations MAY completely erase the information in order to prevent the ability to reconstruct a record in whole or in part, or they may track and record the deleted information for auditing and/or quality control purposes.

Request Message

Field

Type

#

?

Meaning

DeleteDocumentData

 

 

Y

Erase all of the document data associated with a given subject record or, in the encounter-centric model, with a given encounter.

*       DeleteDocumentDataRequest

 

1

Y

 

            GenericRequestParameters

GenericRequestParameters

0..1

N

Common request parameters that can be used to identify the requester.

                        Application

ApplicationIdentifier

0..1

N

Identifies the requesting application.

                        ApplicationUser

ApplicationUserIdentifier

0..1

N

Identifies the user or instance of the requesting application.

                        BIASOperationName

string

0..1

N

Identifies the BIAS operation that is being requested: “DeleteDocumentData”.

            Identity

BIASIdentity

1

Y

 

                        SubjectID

BIASIDType

1

Y

A system unique identifier for a subject

                        EncounterID

BIASIDType

0..1

C

The identifier of an encounter associated with the subject.

Required for encounter-centric models.

            DocumentData

DocumentDataType

0..1

N

Defines a set of document data elements providing information about the presented identity document.

                        DocumentCategory

string

1

Y

The category(ies) of the identity documents to be deleted.

Response Message

Field

Type

#

?

Meaning

DeleteDocumentDataResponse

 

 

Y

The response to a DeleteDocumentData operation.

 DeleteDocumentDataResponsePackage

 

1

Y

 

            ResponseStatus

ResponseStatus

1

Y

Returned status for the operation.

                        Return

ReturnCode

1

Y

The return code indicates the return status of the operation.

                        Message

string

0..1

N

A short message corresponding to the return code.

4.1.9 DeleteEncounter

DeleteEncounterRequest

DeleteEncounterResponse

The DeleteEncounter operation deletes an existing encounter record from the system. When deleting an encounter, BIAS implementations MAY completely erase the information in order to prevent the ability to reconstruct a record in whole or in part, or they MAY track and record the deleted information for auditing and/or quality control purposes.

Request Message

Field

Type

#

?

Meaning

DeleteEncounter

 

 

Y

Delete an existing encounter record and, any associated encounter information.

*       DeleteEncounterRequest

 

1

Y

 

            GenericRequestParameters

GenericRequestParameters

0..1

N

Common request parameters that can be used to identify the requester.

                        Application

ApplicationIdentifier

0..1

N

Identifies the requesting application.

                        ApplicationUser

ApplicationUserIdentifier

0..1

N

Identifies the user or instance of the requesting application.

                        BIASOperationName

string

0..1

N

Identifies the BIAS operation that is being requested: “DeleteEncounter”.

            Identity

BIASIdentity

1

Y

 

                        SubjectID

BIASIDType

1

Y

A system unique identifier for a subject

                        EncounterID

BIASIDType

1

Y

The identifier of an encounter associated with the subject.

Response Message

Field

Type

#

?

Meaning

DeleteEncounterResponse

 

 

Y

The response to a DeleteEncounter operation.

DeleteEncounterResponsePackage

 

1

Y

 

            ResponseStatus

ResponseStatus

1

Y

Returned status for the operation.

                        Return

ReturnCode

1

Y

The return code indicates the return status of the operation.

                        Message

string

0..1

N

A short message corresponding to the return code.

4.1.10 DeleteSubject

DeleteSubjectRequest

DeleteSubjectResponse

The DeleteSubject operation deletes an existing subject record and, in an encounter-centric model, any associated encounter information from the system. This operation also removes the subject from any registered galleries.

When deleting a subject, BIAS implementations MAY completely erase the subject information in order to prevent the ability to reconstruct a record or records in whole or in part, or they MAY track and record the deleted information for auditing and/or quality control purposes.

Request Message

Field

Type

#

?

Meaning

DeleteSubject

 

 

Y

Delete an existing subject record and, in an encounter-centric model, any associated encounter information.

*       DeleteSubjectRequest

 

1

Y

 

            GenericRequestParameters

GenericRequestParameters

0..1

N

Common request parameters that can be used to identify the requester.

                        Application

ApplicationIdentifier

0..1

N

Identifies the requesting application.

                        ApplicationUser

ApplicationUserIdentifier

0..1

N

Identifies the user or instance of the requesting application.

                        BIASOperationName

string

0..1

N

Identifies the BIAS operation that is being requested: “DeleteSubject”.

            Identity

BIASIdentity

1

Y

The identity of the subject to delete.

                        SubjectID

BIASIDType

1

Y

A system unique identifier for a subject.

Response Message

Field

Type

#

?

Meaning

DeleteSubjectResponse

 

 

Y

The response to a DeleteSubject operation.

DeleteSubjectResponsePackage

 

1

Y

 

            ResponseStatus

ResponseStatus

1

Y

Returned status for the operation.

                        Return

ReturnCode

1

Y

The return code indicates the return status of the operation.

                        Message

string

0..1

N

A short message corresponding to the return code.

4.1.11 DeleteSubjectFromGallery

DeleteSubjectFromGalleryRequest

DeleteSubjectFromGalleryResponse

The DeleteSubjectFromGallery operation removes the registration of a subject from a gallery or population group. The subject is identified by either the subject ID or the claim to identity that was specified in the AddSubjectToGallery operation.

Request Message

Field

Type

#

?

Meaning

DeleteSubjectFromGallery

 

 

Y

Remove the registration of a subject from a gallery or population group.

DeleteSubjectFromGalleryRequest

 

1

Y

 

            GenericRequestParameters

GenericRequestParameters

0..1

N

Common request parameters that can be used to identify the requester.

                        Application

ApplicationIdentifier

0..1

N

Identifies the requesting application.

                        ApplicationUser

ApplicationUserIdentifier

0..1

N

Identifies the user or instance of the requesting application.

                        BIASOperationName

string

0..1

N

Identifies the BIAS operation that is being requested: “DeleteSubjectFromGallery”.

            GalleryID

BIASIDType

1

Y

The identifier of the gallery or population group from which the subject will be deleted.

            Identity

BIASIdentity

1

Y

The identity to remove from the gallery.

                        SubjectID

BIASIDType

0..1

C

A system unique identifier for a subject.

Required if an Identity Claim is not provided.

                        IdentityClaim

BIASIDType

0..1

C

An identifier by which a subject is known to a particular gallery or population group.

Required if a Subject ID is not provided.

Response Message

Field

Type

#

?

Meaning

DeleteSubjectFromGalleryResponse

 

 

Y

The response to a DeleteSubjectFromGallery operation.

DeleteSubjectFromGalleryResponsePackage

 

 

 

 

            ResponseStatus

ResponseStatus

1

Y

Returned status for the operation.

                        Return

ReturnCode

1

Y

The return code indicates the return status of the operation.

                        Message

string

0..1

N

A short message corresponding to the return code.

4.1.12 GetIdentifySubjectResults

GetIdentifySubjectResultsRequest

GetIdentifySubjectResultsResponse

The GetIdentifySubjectResults operation retrieves the identification results for the specified token. This opereation is used in conjunction with the IdentifySubject operation. If the IdentifySubject operation is implemented as an asynchronous service, the implementing system returns a token and the GetIdentifySubjectResults operation is used to poll for the results of the original IdentifySubject request.

Request Message

Field

Type

#

?

Meaning

GetIdentifySubjectResults

 

 

Y

Retrieve the identification results for a specified token, which was returned by the IdentifySubject operation.

*       GetIdentifySubjectResultsRequest

 

1

Y

 

            GenericRequestParameters

GenericRequestParameters

0..1

N

Common request parameters that can be used to identify the requester.

                        Application

ApplicationIdentifier

0..1

N

Identifies the requesting application.

                        ApplicationUser

ApplicationUserIdentifier

0..1

N

Identifies the user or instance of the requesting application.

                        BIASOperationName

string

0..1

N

Identifies the BIAS operation that is being requested: “GetIdentifySubjectResults”.

            Token

TokenType

1

Y

A value used to retrieve the results of an IdentifySubject request.

                        TokenValue

string

1

Y

A value returned by the implementing system that is used to retrieve the results to an operation at a later time.

                        Expiration

date

1

Y

A date and time at which point the token expires and the operation results are no longer guaranteed to be available.

Response Message

Field

Type

#

?

Meaning

GetIdentifySubjectResultsResponse

 

 

Y

The response to a GetIdentifySubjectResults operation, which includes a candidate list.

GetIdentifySubjectResultsResponsePackage

 

1

Y

 

            ResponseStatus

ResponseStatus

1

Y

Returned status for the operation.

                        Return

ReturnCode

1

Y

The return code indicates the return status of the operation.

                        Message

string

0..1

N

A short message corresponding to the return code.

            CandidateList

CandidateListType

1

Y

A rank-ordered list of candidates that have a likelihood of matching the input biometric sample.

                        Candidate

CandidateType

0..*

N

A single candidate.

                                    Score

ScoreType

0..1

N

The match score.

                                    BiographicData

BiographicDataType

0..1

N

Biographic data associated with the candidate match.

                                    BIRList

CBEFF_BIR_ListType

1

Y

Biometric data associated with the candidate match.

                                                BIR

CBEFF_BIR_Type

0..*

N

CBEFF structure containing information about a biometric sample.

4.1.13 IdentifySubject

IdentifySubjectRequest

IdentifySubjectResponse

The IdentifySubject operation performs an identification search against a given gallery for a given biometric, returning a rank-ordered candidate list of a given maximum size. Note that multiple scores/candidates is already incorporated as a score comes with a CandidateType which is a member of CandidateList.

If the IdentifySubject operation is implemented as a synchronous service, the implementing system immediately processes the request and returns the results in the candidate list. If the IdentifySubject operation is implemented as an asynchronous service, the implementing system returns a token, which is an indication that the request is being handled asynchronously. In this case, the GetIdentifySubjectResults operation is used to poll for the results of the IdentifySubject request.

Gallery ID must not be used in conjunction with Gallery parameter. Gallery must not be used in conjunction with Gallery ID parameter. However, Gallery ID or Gallery MUST be present.

Request Message

Field

Type

#

?

Meaning

IdentifySubject

 

 

Y

Perform an identification search against a given gallery for a given biometric.

IdentifySubjectRequest

 

1

Y

 

            GenericRequestParameters

GenericRequestParameters

0..1

N

Common request parameters that can be used to identify the requester.

                        Application

ApplicationIdentifier

0..1

N

Identifies the requesting application.

                        ApplicationUser

ApplicationUserIdentifier

0..1

N

Identifies the user or instance of the requesting application.

                        BIASOperationName

string

0..1

N

Identifies the BIAS operation that is being requested: “IdentifySubject”.

            GalleryID

BIASIDType

0..1

C

The identifier of the gallery or population group which will be searched. Must not be used in conjunction with Gallery parameter.

            Gallery

CandidateListType

0..1

C

A list of BIRs that must be used instead of a stored gallery. Must not be used in conjunction with GalleryID parameter.

            Identity

BIASIdentity

1

Y

Contains the BIR, a data structure containing the biometric sample for the search.

                        BiometricData

BIASBiometricDataType

1

Y

An Identity’s biometric data.

                                    BIR

CBEFF_BIR_Type

1

Y

Contains biometric information in either a non-XML or an XML representation.

            MaxListSize

positiveInteger

1

Y

The maximum size of the candidate list that should be returned.

Response Message

Field

Type

#

?

Meaning

 

IdentifySubjectResponse

 

 

Y

The response to an IdentifySubject operation, returning a rank-ordered candidate list.

 

IdentifySubjectResponsePackage

 

1

Y

 

 

            ResponseStatus

ResponseStatus

1

Y

Returned status for the operation.

 

                        Return

ReturnCode

1

Y

The return code indicates the return status of the operation.

 

                        Message

string

0..1

N

A short message corresponding to the return code.

 

            CandidateList

CandidateListResultType

(see IdentifySubjectResultType)

0..1

C

A rank-ordered list of candidates that have a likelihood of matching the input biometric sample (i.e., exceed the system threshold).

Rank ordering is from highest to lowest match score.

Returned with successful synchronous request processing.

 

                        Candidate

CandidateType

0..*

N

A single candidate.

                                    Score

ScoreType

0..1

N

The match score.

                                    BiographicData

BiographicDataType

0..1

N

Biographic data associated with the candidate match.

                                    BIRList

CBEFF_BIR_ListType

1

Y

Biometric data associated with the candidate match.

                                                BIR

CBEFF_BIR_Type

0..*

N

CBEFF structure containing information about a biometric sample.

            Token

TokenResultType

(see IdentifySubjectResultType)

0..1

C

A token used to retrieve the results of the IdentifySubject operation.

Returned with asynchronous request processing.

 

                        TokenValue

string

1

Y

A value returned by the implementing system that is used to retrieve the results to an operation at a later time.

 

                        Expiration

date

1

Y

A date and time at which point the token expires and the operation results are no longer guaranteed to be available.

 

NOTES: 

(1)   In the event that the number of candidates exceeding the threshold exceeds the MaxListSize, the system will determine which candidate is included in the last position of the rank ordered candidate list (i.e., in the event of a tie).

(2)   Requesters MAY NOT change the system thresholds.

4.1.14 ListBiographicData

ListBiographicDataRequest

ListBiographicDataResponse

The ListBiographicData operation lists the biographic data elements stored for a subject using the Biographic Data Elements output parameter. Note that no actual biographic data is returned by this operation (see the RetrieveBiographicData operation to obtain the biographic data). In the encounter-centric model, an encounter ID MAY be specified to indicate that only the biographic data elements stored for that encounter should be returned. If an encounter ID is not specified and encounter data exists for the subject, the operation returns the list of encounter IDs which contain biographic data using the Encounter List output parameter, and the Biographic Data Element List output parameter is empty.

Request Message

Field

Type

#

?

Meaning

ListBiographicData

 

 

Y

Lists the biographic data elements stored for a subject.

ListBiographicDataRequest

 

1

Y

 

            GenericRequestParameters

GenericRequestParameters

0..1

N

Common request parameters that can be used to identify the requester.

                        Application

ApplicationIdentifier

0..1

N

Identifies the requesting application.

                        ApplicationUser

ApplicationUserIdentifier

0..1

N

Identifies the user or instance of the requesting application.

                        BIASOperationName

string

0..1

N

Identifies the BIAS operation that is being requested: “ListBiographicData”.

            Identity

BIASIdentity

1

Y

Identifies the subject or, in the encounter-centric model, a subject and an encounter.

                        SubjectID

BIASIDType

1

Y

A system unique identifier for a subject.

                        EncounterID

BIASIDType

0..1

N

The identifier of an encounter associated with the subject.

            EncounterType

EncounterCategoryType

0..1

C

Identifies the category of encounter. If an encounter ID is not specified and encounter data exists for the subject, the operation returns the list of encounter IDs of a specific type which contain biographic data using the Encounter List output parameter, and the Biographic Data Elements output parameter is empty.

Should not be used in conjunction with EncounterID.

Response Message

Field

Type

#

?

Meaning

ListBiographicDataResponse

 

 

Y

The response to a ListBiographicData request, containing a list of biographic data elements stored for a subject. In the encounter-centric model, the biographic data elements for a specific encounter are returned. If an encounter ID is not specified and encounter data exists for the subject, the list of encounter IDs which contain biographic data is returned.

ListBiographicDataResponsePackage

 

1

Y

 

            ResponseStatus

ResponseStatus

1

Y

Returned status for the operation.

                        Return

ReturnCode

1

Y

The return code indicates the return status of the operation.

                        Message

string

0..1

N

A short message corresponding to the return code.

            Identity

BIASIdentity

1

Y

Contains a list of biographic data elements associated with a subject or encounter; non-empty if the service was successful, biographic data exists, and either (a) the person-centric model is being used or (b) the encounter-centric model is being used and an encounter identifier was specified.

                        BiographicData

BiographicDataType

0..1

C

An Identity’s biographic data elements that are stored in the implementing system.

                                    BiographicDataItemList

BiographicDataItemListType

0..1

N

A list of biographic data elements.

                                                BiographicDataItem

BiographicDataItemType

1..*

Y

A single biographic data element.

                                                            Name

string

1

Y

The name of the biographic data item.

                                                            Type

string

1

Y

The data type for the biographic data item.

            Value

string

0..1

N

The value assigned to the biographic data item.

                        EncounterList

EncounterListType

0..1

C

A list of encounter ID’s associated with a subject and which contain biographic data; non-empty if the service was successful, biographic data exists, the encounter-centric model is being used, and an encounter identifier was not specified.

                                    EncounterID

BIASIDType

0..*

N

The identifier of an encounter.

4.1.15 ListBiometricData

ListBiometricDataRequest

ListBiometricDataResponse

The ListBiometricData operation lists the biometric data elements stored for a subject using the Biometric Data List output parameter. Note that no actual biometric data is returned by this operation (see the RetrieveBiometricData operation to obtain the biometric data). In the encounter-centric model, an encounter ID MAY be specified to indicate that only the biometric data elements stored for that encounter should be returned. If an encounter ID is not specified and encounter data exists for the subject, the operation returns the list of encounter IDs which contain biometric data using the Encounter List output parameter, and the Biometric Data List output parameter is empty.

An optional parameter MAY be used to indicate a filter on the list of returned data. Such a filter may indicate that only biometric types should be listed (e.g., face, finger, iris, etc.) or that only biometric subtypes for a particular biometric type should be listed (e.g., all fingerprints: left slap, right index, etc.). If a filter is not specified, all biometric type and biometric subtype information must both be listed (e.g., left index finger, right iris, face frontal, etc.).

Request Message

Field

Type

#

?

Meaning

ListBiometricData

 

 

Y

Lists the biometric data elements stored for a subject.

ListBiometricDataRequest

 

1

Y

 

            GenericRequestParameters

GenericRequestParameters

0..1

N

Common request parameters that can be used to identify the requester.

                        Application

ApplicationIdentifier

0..1

N

Identifies the requesting application.

                        ApplicationUser

ApplicationUserIdentifier

0..1

N

Identifies the user or instance of the requesting application.

                        BIASOperationName

string

0..1

N

Identifies the BIAS operation that is being requested: “ListBiometricData”.

 

            Identity

BIASIdentity

1

Y

Identifies the subject or, in the encounter-centric model, a subject and an encounter.

                        SubjectID

BIASIDType

1

Y

A system unique identifier for a subject.

                        EncounterID

BIASIDType

0..1

N

The identifier of an encounter associated with the subject.

            EncounterType

EncounterCategoryType

0..1

C

Identifies the category of encounter. If an encounter ID is not specified and encounter data exists for the subject, the operation may return the list of encounter IDs of a specific type which contain biometric data using the Encounter List output parameter, and the Biometric Data List output parameter is empty.

Should not be used in conjunction with EncounterID.

            ListFilterType

ListFilterType

0..1

N

Indicates what biometric information should be returned.

                        BiometricTypeFilter

oasis_cbeff:MultipleTypesType

1..*

Y

Limits the returned information to a specific type of biometric, as defined by CBEFF.

                        IncludeBiometricSubType

boolean

1

Y

A Boolean flag indicating if biometric subtype information should be returned.

Response Message

Field

Type

#

?

Meaning

ListBiometricDataResponse

 

 

Y

The response to a ListBiometricData operation, containing a list of biometric data elements stored for a subject. In the encounter-centric model, the biometric data elements for a specific encounter are returned. If an encounter ID is not specified and encounter data exists for the subject, the list of encounter IDs which contain biometric data is returned.

ListBiometricDataResponsePackage

 

1

Y

 

            ResponseStatus

ResponseStatus

1

Y

Returned status for the operation.

                        Return

ReturnCode

1

Y

The return code indicates the return status of the operation.

                        Message

string

0..1

N

A short message corresponding to the return code.

            Identity

BIASIdentity

0..1

N

Includes a list of biometric data elements associated with a subject or encounter or a list of encounter ID’s associated with a subject and which contain biometric data.

                        BiometricData

BIASBiometricDataType

0..1

C

An Identity’s biometric data.

                                    BiometricDataList

BiometricDataListType

0..1

N

A list of biometric data elements.

                                                BiometricDataRecord

BiometricDataType

1..*

Y

Data structure containing information about a biometric record.

                                                            BiometricType

oasis_cbeff:MultipleTypesType

1

Y

The type of biological or behavioral data stored in the biometric record, as defined by CBEFF.

                                                            BiometricTypeCount

positiveInteger

0..1

N

The number of biometric records having the biometric type recorded in the biometric type field.

                                                            BiometricSubType

oasis_cbeff:SubtypeType

0..1

N

More specifically defines the type of biometric data stored in the biometric record, as defined by CBEFF.

                                                            BDBFormatOwner

positiveInteger

1

Y

Identifies the standards body, working group, industry consortium, or other CBEFF biometric organization that has defined the format for the biometric data.

                                                            BDBFormatType

positiveInteger

1

Y

Identifies the specific biometric data format specified by the CBEFF biometric organization recorded in the BDB Format Owner field.

                        EncounterList

EncounterListType

0..1

C

A list of encounter ID’s associated with a subject and which contain biometric data; non-empty if the service was successful, biometric data exists, the encounter-centric model is being used, and an encounter identifier was not specified.

                                    EncounterID

BIASIDType

1..*

Y

The identifier of an encounter.

4.1.16 ListDocumentData

ListDocumentDataRequest

ListDocumentDataResponse

The ListDocumentData operation lists the document categories stored for a subject using the Document Data List output parameter. Note that no other document data is returned by this operation (see the RetrieveDocumentData operation to obtain document data by category.) In the encounter-centric model, an encounter ID may be specified to indicate that only the document data elements stored for that encounter should be returned. If an encounter ID is not specified and encounter data exists for the subject, the operation mustl return the list of encounter IDs which contain document data using the Encounter List Output parameter, and the Document Data List output parameter must be empty.

Request Message

Field

Type

#

?

Meaning

ListDocumentData

 

 

Y

 

*       ListDocumentDataRequest

 

1

Y

 

            GenericRequestParameters

GenericRequestParameters

0..1

N

Common request parameters that can be used to identify the requester.

                        Application

ApplicationIdentifier

0..1

N

Identifies the requesting application.

                        ApplicationUser

ApplicationUserIdentifier

0..1

N

Identifies the user or instance of the requesting application.

                        BIASOperationName

string

0..1

N

Identifies the BIAS operation that is being requested: “ListDocumentData”.

            Identity

BIASIdentity

1

Y

Identifies the subject or, in the encounter-centric model, a subject and an encounter.

                        SubjectID

BIASIDType

1

Y

A system unique identifier for a subject

                        EncounterID

BIASIDType

0..1

C

The identifier of an encounter associated with the subject.

EncounterType

EncounterCategoryType

0..1

C

Identifies the category of encounter. If an encounter ID is not specified and encounter data exists for the subject, the operation must return the list of encounter IDs which contain document data using the Encounter List Output parameter, and the Document Data List output parameter must be empty.

Should not be used in conjunction with EncounterID.

Response Message

Field

Type

#

?

Meaning

ListDocumentDataResponse

 

 

Y

The response to a ListDocumentData operation.

 ListDocumentDataResponsePackage

 

1

Y

 

            ResponseStatus

ResponseStatus

1

Y

Returned status for the operation.

                        Return

ReturnCode

1

Y

The return code indicates the return status of the operation.

                        Message

string

0..1

N

A short message corresponding to the return code.

            DocumentDataList

DocumentDataListType

0..1

C

A list of document categories associated with a subject or encounter; non-empty if the service was successful, document data exists, and either the person-centric model is being used or the encounter-centric model is being used and an encounter identifier was specified.

                        DocumentData

DocumentDataType

1..*

Y

Defines a set of document data elements providing information about the presented identity document

                                    DocumentCategory

string

1

Y

The type of identity document presented (e.g. passport).

            Identity

BIASIdentity

0..1

C

 

EncounterList

EncounterListType

1

Y

A list of encounter IDs associated with a subject and which contain document data; non-empty if the service was successful, document data exists, the encounter-centric model is being used, and an encounter identifier was not specified.

EncounterID

BIASIDType

1..*

Y

The identifier of an encounter.

4.1.17 PerformFusion

PerformFusionRequest

PerformFusionResponse

The PerformFusion operation accepts either match score or match decision information and creates a fused match result. The FusionInformationListType, through the FusionInformationType, provides specific elements for match score input and match decision input for a single identity, while the FusionIdentityListType provides the ability to submit multiple identities to the Perform Fusion operation. The fusion method and processes are left to the implementing system.

Request Message

Field

Type

#

?

Meaning

PerformFusion

 

 

Y

Accepts either match score or match decision information and creates a fused match result.

PerformFusionRequest

 

1

Y

 

            GenericRequestParameters

GenericRequestParameters

0..1

N

Common request parameters that can be used to identify the requester.

                        Application

ApplicationIdentifier

0..1

N

Identifies the requesting application.

                        ApplicationUser

ApplicationUserIdentifier

0..1

N

Identifies the user or instance of the requesting application.

                        BIASOperationName

string

0..1

N

Identifies the BIAS operation that is being requested: “PerformFusion”.

            FusionInput

FusionIdentityListType

1

Y

 

                        FusionIdentity

FusionInformationListType

1

Y

Score or decision input information to the fusion method for each identity.

                                    FusionElement

FusionInformationType

2..*

Y

A set of fusion information.

                                                BiometricType

oasis_cbeff:MultipleTypesType

1

Y

The type of biological or behavioral data stored in the biometric record, as defined by CBEFF.

                                                BiometricSubType

oasis_cbeff:SubtypeType

0..1

N

More specifically defines the type of biometric data stored in the biometric record.

                                                AlgorithmOwner

string

1

Y

The owner or vendor of the algorithm used to determine the score or decision.

                                    AlgorithmType

string

1

Y

The Algorithm Owner’s identifier for the specific algorithm product and version used to determine the score or decision.

                                    FusionResult

FusionResult

0..1

C

Either FusionScore  or a FusionDecision element MUST be used.

Response Message

Field

Type

#

?

Meaning

PerformFusionResponse

 

 

Y

The response to the PerformFusion operation.

PerformFusionResponsePackage

 

1

Y

 

            ResponseStatus

ResponseStatus

1

Y

Returned status for the operation.

                        Return

ReturnCode

1

Y

The return code indicates the return status of the operation.

                        Message

string

0..1

N

A short message corresponding to the return code.

            Match

MatchType

1

Y

Indicates the result of the fusion method.

4.1.18 QueryCapabilities

QueryCapabilitiesRequest

QueryCapabilitiesResponse

The QueryCapabilities operation returns a list of the capabilities, options, galleries, etc. that are supported by the BIAS implementation. Refer to Annex A in the ISO/IEC BIAS [ISO/IEC-BIAS] standard for conformance requirements regarding which capability names an implementation must use in the QueryCapabilities operation. If the implementing system does not support a capability item, the Capability Value can be set to null in the response.

Proprietary and additional information may be returned by returning capabilities that are not part of those capabilities enumerated in the Capability Name section 3.2.21. When returning capabilities not enumerated in section 3.2.21, the Capability Description should describe the capability. For each capability enumerated in section 3.2.21, the Capability Name should be set to the name in the value column.

Request Message

Field

Type

#

?

Meaning

QueryCapabilities

 

 

Y

Returns a list of the capabilities, options, galleries, etc. that are supported by the BIAS implementation.

QueryCapabilitiesRequest

 

1

Y

 

            GenericRequestParameters

GenericRequestParameters

0..1

N

Common request parameters that can be used to identify the requester.

                        Application

ApplicationIdentifier

0..1

N

Identifies the requesting application.

                        ApplicationUser

ApplicationUserIdentifier

0..1

N

Identifies the user or instance of the requesting application.

                        BIASOperationName

string

0..1

N

Identifies the BIAS operation that is being requested: “QueryCapabilities”.

Response Message

Field

Type

#

?

Meaning

QueryCapabilitiesResponse

 

 

Y

The response to a QueryCapabilities operation.

*       QueryCapabilitiesResponsePackage

 

1

Y

 

            ResponseStatus

ResponseStatus

1

Y

Returned status for the operation.

                        Return

ReturnCode

1

Y

The return code indicates the return status of the operation.

                        Message

string

0..1

N

A short message corresponding to the return code.

            CapabilityList

CapabilityListType

1

Y

A list of capabilities supported by the BIAS implementation.

                        Capability

CapabilityType

0..*

N

A single capability.

                                    CapabilityName

CapabilityName

1

Y

The name of the capability.

                                    CapabilityID

string

0..1

N

An identifier assigned to the capability by the implementing system.

                                    CapabilityDescription

string

0..1

N

A description of the capability.

                                    CapabilityValue

string

0..1

N

A value assigned to the capability.

                                    CapabilitySupportingValue

string

0..1

N

A secondary value supporting the capability.

                                    CapabilityAdditionalInfo

string

0..1

N

Contains additional information for the supported capability.

4.1.19 RetrieveBiographicData

RetrieveBiographicDataRequest

RetrieveBiographicDataResponse

The RetrieveBiographicData operation retrieves the biographic data associated with a subject ID. In the encounter-centric model, the encounter ID MAY be specified and the operation will return the set of biographic data associated with that encounter (the list contains a single set). If the encounter ID is not specified in the encounter-centric model, the operation returns the list of biographic information associated with the most recent encounter. If no gallery ID is specified, a list of biographic information from all galleries will be returned.

Request Message

Field

Type

#

?

Meaning

RetrieveBiographicData

 

 

Y

Retrieves the biographic data associated with a subject ID.

*       RetrieveBiographicDataRequest

 

1

Y

 

            GenericRequestParameters

GenericRequestParameters

0..1

N

Common request parameters that can be used to identify the requester.

                        Application

ApplicationIdentifier

0..1

N

Identifies the requesting application.

                        ApplicationUser

ApplicationUserIdentifier

0..1

N

Identifies the user or instance of the requesting application.

                        BIASOperationName

string

0..1

N

Identifies the BIAS operation that is being requested: “RetrieveBiographicData”.

            Identity

BIASIdentity

1

Y

Identifies the subject or, in the encounter-centric model, a subject and an encounter.

                        SubjectID

BIASIDType

1

Y

A system unique identifier for a subject.

                        EncounterID

BIASIDType

0..1

N

The identifier of an encounter associated with the subject.

            EncounterType

EncounterCategoryType

0..1

N

Identifies the type of encounter during which data was collected from the subject, as determined by the requester.

            GalleryID

BIASIDType

0..1

N

The identifier of the gallery or population group from which the biographic information will be retrieved.

Response Message

Field

Type

#

?

Meaning