Skip to content

Introduction

The goal of this framework is to read the NFC chip of some documents, guiding the user in a self-contained and accessible system.

This SDK has two different modes, one with User Interface and other without it.

This SDK retrieves the following information and returns it in:

  • VDNfcDataCaptured
    • Some information that is contained in the NFC chip.
    • The face image encoded to Base64.
    • The signature image encoded to Base64.
  • VDNfcValidationDataCaptured
    • The PACE, BAC, AA and EAC success or not.
    • Each DG validation info: read hash, calculated hash and validation status.
  • VDDocumentSigningCertificateCaptured
    • The Document's Signing Certificate (DSC) Also this SDK:
  • Reads the encrypted information from the NFC chip using the PACE and BAC protocol(s).
  • Tries to perform AA and EAC-CA authentications if document supports it.
  • Returns a Data Group validation info encapsulated in a DGHashInfo object with the following structure:
    • DGNumber: (int) Number of the Data Group
    • ReadHash: (byte[]) Hash obtained from SOD File (File containing document's security information)
    • CalculatedHash: (byte[]) Hash calculated from the DG information
    • isValid: (boolean) true if Data Group content validation is correct

Some permissions are required by the framework:

  • NFC.

The SDK is localised in English and Spanish. By default English language is selected and the language is automatically switched to Spanish if the device locale is Spanish.

The SDK can be configured using a Map<String, String>. All possible keys and values can be checked in Configuration.

Description

  • The recognised documents that can be read are:
    • VDNFC_SPAIN_DNI_30: DNI 3.0 (Spain)
    • VDNFC_SPAIN_DNI_40: DNI 4.0 (Spain)
    • VDNFC_SPAIN_RP_2011: Residence Permit 2011 (Spain)
    • VDNFC_SPAIN_RP_2020: Residence Permit 2020 (Spain)
    • VDNFC_PASSPORT: Passport (International)
    • VDNFC_ICAO_LIMITED_SUPPORT: It represents any other document that complies with ICAO 9303, that is not specifically supported by the SDK.

We provide support for all NFC-enabled documents within the standard coverage that meet the ICAO NFC standard.

Specifications

  • Android minimum SDK version: API Level 21 (Android 5) (mobile devices only).
  • SDK compatible with Harmony OS.
  • SDK size: 1.5 MB (approx.).