Integration

Estimated reading: 22 minutes 113 views

Description

The AwareID Document Capture SDK is the client side library that is used with the Face Liveness and Document Authentication Server products. It is used to capture face and document images then package them according to the Face Liveness and Document Authentication Server specifications. These packages are controlled by the application allowing the developer to control the timing and delivery methods for each transaction. It is up to the application developer to implement any server communication and security.

On the back-end, the Face Liveness service will determine whether the subject is live or not. The Document Authentication server will take the captured document to determine the validity of the document then perform a match with the live face and the facial image from the document to authenicate the user.

Design Features

  • Easy to integrate API
  • Customizable user experience
  • Handles operation of device hardware
  • Optimized data collection for back-end analysis
  • Applications have full control over when and how they interact with the back-end services.

Platforms

  • Android 8.0 and higher

Integration Requirements

The Face Capture SDK requires Camera permissions.

The Regula Document Reader SDK requires Internet, Camera, and NFC Tag Reading permissions. Please see Regula’s documentation for additional details : https://docs.regulaforensics.com/develop/doc-reader-sdk/mobile/android/

https://docs.regulaforensics.com/develop/doc-reader-sdk/mobile/ios/

Add Capabilities and Permissions

Android

Place Aware Face Capture AAR bundles in the application at the following location:

/app/libs/Aware-FaceCaptureAwareId.aar /app/libs/Aware-FaceCaptureAwareId-DeviceControl.aar

Permissions for camera access and internet access should be requested in the manifest at the following location:

/android/app/src/main/AndroidManifest.xml

Setup permissions

   <manifest xmlns:android="http://schemas.android.com/apk/res/android"
   //...

   <uses-permission android:name="android.permission.CAMERA" />
   <uses-permission android:name="android.permission.INTERNET" />

   </manifest>

Setup dependencies

     // Regula
   implementation 'com.regula.btdevice:api:1.0+@aar'
   implementation 'com.regula.documentreader.core:fullrfid:6.8.+@aar' // use fullauthrfid core for 7310
   implementation('com.regula.documentreader:api:6.8.+@aar') {
       transitive = true
   }

Capture Face

Overview

Face Capture SDK is used to capture the subject’s face. This chapter details the steps required to set up a facial capture, obtain data from the capture session, and get the package contents for the Face Liveness back-end.

Face Capture Integration

Create a Face Capture Object

The Face Capture library object manages all other Face Capture API classes, and methods. This object is used to set up a capture session and allow control of the face capturing process. A JSON package can be retrieved using this object following the completion of the face capture.

Android

Create a Face Capture Object

   FaceCaptureJNI mFaceCapture = new FaceCaptureJNI();

Create a Workflow Object

The workflow object allows the developer to customize a capture session. The core workflow parameters are selected by specifying the workflow name. A workflow object combined with a camera are provided to the Face Capture library to control the capture session. The wokflow object may be configured with several options shown in the Face Capture documentation.

Android

Create a Workflow Object

   mWorkFlow = mFaceCapture.workflowCreate(FaceCaptureJNI.FOXTROT);

Select a Camera

Get the list of cameras on the front or back of the phone and select one to use. Cameras can be set up as either portrait or landscape.

Android

Select a camera

   IFaceCapture.ICamera[] mCameraList = null;

   mCameraList = mFaceCapture.getCameraList(CameraPosition.FRONT); //Get camera IDs on front of device.
   mCameraList[0].setOrientation(CameraOrientation.PORTRAIT);      //Set the orientation on camera 0.

Begin a Capture Session

In order to receive facial images and feedback, the capture session must be started. The capture session is initiated by calling startCaptureSession with the selected workflow and camera. Not all camera and workflow combinations are valid. Details are available in the Face Capture documentation.

Android

Begin a Capture Session

   mFaceCapture.startCaptureSession(mWorkFlow, mCameraList[0]);

Get the Capture Region

While a capture session is on-going, a capture region based on the capture session’s settings becomes available. This region is where the face needs to be positioned in order to successfully capture. This should be used to create a display for the user to align themselves with.

Android

Get capture region

   Rectangle mCurrentCaptureRegion;

   mCurrentCaptureRegion = mFaceCapture.captureSessionGetCaptureRegion();

Enable Autocapture

Disabling and enabling this setting allows customizing when a capture can occur easily. The capture session will not successfully complete while this setting is disabled even if the subject meets all capture requirements.

Android

Enable Autocapture

   mFaceCapture.captureSessionEnableAutocapture(true);

Get the current Capture Session State

While a capture session is in progress, the application retrieves the capture session state object using the getCaptureSessionState() function. The getCaptureSessionState() function waits for new data to be available and then returns. This is a blocking function, therefore, it needs to be in a separate thread to avoid deadlocking other application functionality such as the UI thread.

Android

Capture Session State

   mCurrentCaptureState = mFaceCapture.getCaptureSessionState();

Get the Capture State’s Status

The status indicates what the capture session is currently doing or if it has ended. The main use of the capture status is to know when to determine what content to display on screen and when to move to the next screen.

Android

Capture State’s Status

   mCurrentCaptureSessionFrame = mCurrentCaptureState.getStatus();

Get the Capture State’s Image

While the capture status is capturing, images from the camera are available to display on screen. When a capture session has ended, the final capture state object will indicate that the frame is unavailable. It is important to either check the capture status to avoid querying for an unavailable frame or handle unavailable frames appropriately.

Android

Capture State’s Images

   mCurrentCaptureSessionFrame = mCurrentCaptureState.getFrame();

Get the Capture State’s Feedback

When the capture session’s state is capturing, the SDK will provide feedback to the application. The feedback relates to the subject’s position of the face relative to the ideal location and lighting.

Android

Capture State’s Feedback

   mCurrentCaptureSessionFrame = mCurrentCaptureState.getFeedback();

Get the Server Package

Once a capture has successfully completed, the workflow used to start the capture session can be used to get an encrypted or non-encrypted package. A package type is necessary to tell the server how to analyze the package. There are several package types that can be used based on usability and security requirements.

An encryption type and corresponding public key is necessary to create the encrypted package. The public key is retrieved from the AwareID server.

Unencrypted

Android

Get the Server Package

   mCurrentCaptureServerPackage = mFaceCapture.getServerPackage(mWorkFlow, mPackageType);

Encrypted

Android

Get the Encrypted Server Package

   mCurrentCaptureServerPackage = mFaceCapture.getEncryptedServerPackage(mEncryptionType, mPublicKey, mWorkFlow, mPackageType);

Stop a Capture Session

A stop capture session function is available for when the application needs to end a capture session early. The capture session should be stopped when the application is put into the background to avoid conflicts with other applications that may be running.

Android

Stop a Capture Session

   mFaceCapture.stopCaptureSession();

Capture Document

Overview

Document Reader is used to scan documents such as passports for subject data and facial images.

Document Capture Integration

There are two types of document captures, OCR and NFC. Each capture type consists of setup, running and processing. A “DocumentReader” must first be initialized, and a database file downloaded. This database consists of document templates to assist in document recognition. Each capture has a list of available setup options to help with the capture process. Once the capture process is started the user will be prompted by UI and text instructions on how to position the document for capture. When a capture is finished the collected data can be sent to the AwareID server for analysis.

Document Capture Initialization

Document capture initialization consists of checking for a valid license and downloading the document database.

Prepare The Database

The database file will be downloaded from the network only one time and stored on the user device. The current database size is (~60MB), the size can be controlled by replacing the string “Full” with other options found in the documentation: https://docs.regulaforensics.com/develop/doc-reader-sdk/mobile/android/database/ 

Android

Prepare The Database

   DocumentReader.Instance().prepareDatabase(getApplicationContext(),
       "Full",  // if you use 7310, replace to FullAuth
       new IDocumentReaderPrepareCompletion() {
           @Override
           public void onPrepareProgressChanged(int progress) {
               // Database download progress.
           }

           @Override
           public void onPrepareCompleted(boolean status, DocumentReaderException error) {
               if (status) {
                   initializeReader();
               }
       });

InitializeReader

After downloading the database, the developer can initialize the reader. Read the license file from appsrcmainresrawdocument.license into a buffer. The SDK will automatically check for license updates if the update license option is set to true. Initializing the reader will result in a completion callback, and then the scan can be started.

Android

Initialize the Reader

   DocReaderConfig config = new DocReaderConfig(license);
   config.setLicenseUpdate(true);  //The SDK will check for license updates online.

   //Initializing the reader
   DocumentReader.Instance().initializeReader(getApplicationContext(), config, initCompletion);

Setup Initialization Completion Callback

A completion handler callback is required to be set to the IDocumentReaderInitCompletion. It will be called after the initialization process is complete, either successfully or with errors. The initCompletion callback takes two parameters. The first one is a result boolean. The second one is a DocumentReaderException type object which contains an error message if applicable.

Android

Setup Init Completion Callback

   protected final IDocumentReaderInitCompletion initCompletion = (result, error) -> {
       //Setup OCR scanning.
   };

Document Scanning Process For OCR

Setup Document Scanning

Set the selected scenario and any required options. The SDK supports many scenarios and options, one such option is the ability to check for holograms on a document, another option is the ability to scan multiple pages of a document. More information on scenarios and options can be found in the documentation.

Android

Setup Document Scanning

   // Set the selected scenario to DocumentReader params.
   DocumentReader.Instance().processParams().scenario = Scenario.SCENARIO_FULL_PROCESS;

   DocumentReader.Instance().startNewSession();

   // Set selected options.
   DocumentReader.Instance().processParams().checkHologram = false;
   DocumentReader.Instance().processParams().multipageProcessing = true;
   DocumentReader.Instance().functionality().edit().setOrientation(DocReaderOrientation.PORTRAIT).apply();

Start Document Scanning

Starting the scanner requires passing in a completion callback where results can be processed.

Android

Start Document Scanning

   // Start the scanner, passing a callback function.
   DocumentReader.Instance().showScanner(getApplicationContext(), ocrCompletion);

Process Data

Once scanning is complete save the encrypted data by calling results.getEncryptedContainers().

Android

Process Data

   //Setup a completion callback.
   private final IDocumentReaderCompletion ocrCompletion = new IDocumentReaderCompletion() {
       @Override
       public void onCompleted(int action, DocumentReaderResults results, DocumentReaderException error) {
           // Processing is finished, all results are ready.

           if ((action == DocReaderAction.COMPLETE) {

               // Check if the document has a chip.
               mChipUsable = results.chipPage;

               // Save the encrypted data.
               mEncryptedPackageOcr = results.getEncryptedContainers();
           }
       }
   };

Document Scanning Process for NFC (Optional)

Setup Document Scanning

This process is optional depending on if the server is set to capture RFID data and the document is equipped with an RFID chip. For active authentication, which is supported by some passports, a server URL must be supplied to handle a server challenge.

Android

Setup Document Scanning

   // Set selected options.
   DocumentReader.Instance().functionality().edit().setOrientation(DocReaderOrientation.PORTRAIT).apply();

   // Setup for Active Authentication.
   DocumentReader.Instance().processParams().shouldReturnPackageForReprocess = true;

   ReprocParams reprocParams = new ReprocParams("https://awareid-dev.aware-apis.com/regula-docreader");
   reprocParams.setFailIfNoService(true);

   // Please see the Enrollment Process chapter for access_token and apikey.
   Map<String, String> headers = new HashMap<>();
   headers.put("Authorization", "Bearer " + access_token);
   headers.put("apikey", mApiKey);
   reprocParams.setHttpHeaders(headers);
   DocumentReader.Instance().rfidScenario().setReprocessParams(reprocParams);

Start Document Scanning

Starting the scanner requires passing in a completion callback where results can be processed.

Android

Start Document Scanning

   // Start the scanner, passing a callback function.
   DocumentReader.Instance().startRFIDReader(getApplicationContext(), nfcReaderCompletion);

Process Data

Once scanning is complete save the encrypted data by calling results.getEncryptedContainers().

Android

Process Data

   //Setup a completion callback.
   private final IDocumentReaderCompletion nfcReaderCompletion = new IDocumentReaderCompletion() {
       @Override
       public void onCompleted(int rfidAction, DocumentReaderResults results, DocumentReaderException error) {

           if (rfidAction == DocReaderAction.COMPLETE) {

               // Save the encrypted data.
               mEncryptedPackageOcr = results.getEncryptedContainers();
           }
       }
   };

Notes

Processing the callback data should be done in the OnResume() of the applications activity. This will make sure that the application owns the data and that the activity used by the Regula SDK if finished.

Enrollment Process

This section provides details regarding the enrollment process when initiated from a client or QR code. An instance of the services is hosted by Aware at www.awareid.aware-apis.com.

Enrollment with AwareID requires both a face capture and a document capture. The face from the document is matched against the face capture from the application to ensure that the user is owner of the document.

Enrollment can be done in one of two ways.

Client Based

Get Access Token

Retrieve an “access_token”, this token allows communication between the client application and the AwareID servers. For this enrollment method the user is required to enter some configuration information:

Configuration Variables

   mUserName - A name used to identify the enrollment.
   mEmail - An email used to identify the enrollment.
   mPhoneNumber - A phone number used to identify the enrollment.
   mCustomerName - The customer’s name to access the AwareID server.
   mHostname - The URL of the AwareID server ex. https://awareid.aware-apis.com/mCustomerName
   mApiKey - Used to access the AwareID server.
   mClientSecret - Used to access the AwareID server.

Get Access Token

   POST /auth/realms/{{customer_name}}-consumers/protocol/openid-connect/token
   Content-Type: 'application/x-www-form-urlencoded',

   "client_id": client_id
   "client_secret": client_secret
   "scope": openid
   "grant_type" : client_credentials

Urlencoded

   This is the only call whose content type of this call is “application/x-www-form-urlencoded”

Response - Retrieve Access Token

The “access_token” is saved and used as the “JWT” in future calls to the AwareID server.

Response - openid-connect

   STATUS CODE 200
   {
       "access_token": "eyJhbGciOiJSUzI1NiIsI...",
       "expires_in": 300,
       "refresh_expires_in": 0,
       "token_type": "Bearer",
       "id_token": "eyJhbGciOiJSUzI1NiI...",
       "not-before-policy": 0,
       "scope": "openid"
   }

QR Code Based

Generate QR Code

Web Portal

To start an enrollment using the QR code method a QR code must first be generated to be consumed by the client application (in our example we use a web app). This web application uses a UI to allow an end-user to register using a username and email address. Then uses these pieces of information in the API Call for /triggerEnroll.

Trigger Enroll

Enrollment is initiated by calling the /triggerEnroll endpoint with the received access token.

  • username - required
  • email - required
  • notifyOptions - optional

Trigger Enroll

   POST baseUrl + /b2c/proxy/triggerEnroll
   Content-Type: 'application/json; charset=UTF-8',

   { "username": "[email protected]",
       "email": "[email protected]",
       "notifyOptions": {
           "notifyByEmail": false
       }
   }

Response - Trigger Enroll

   STATUS CODE 200
   {
       status : "SUCCESS"
       sessionCallbackURL : "https://awareid-dev.aware-apis.com/onboarding?data=jgTW40dmoG6Hp_d6Rg7YaZ97vfGSlV5BcBJvLvqXVmhoQ2Hg2DcC2Kvr9AkTZ38ZkyIfiSj80QFxOWs1YeckYsp3D0D9vS46wppl1Zdt-tpiAdzlvBKA2DBfcj7rf0VePWUn1vKdIPgEoWAulqRxZ_mNakFB7FijLg0QJ8kYsB6w0Nk1A4m9QtLGIdHcuGn9XJnxooQHyr2yhtUsgfOo2FrRXYmFIF7ZNwxYd56miFCs-yuD6eZZcvZ1M01Wje7ji0NYUWVpdes-DA_P0cKgsLPX5sV7SyPSlf9kmoCQz7Ag20kAKkOf-LFFKQmgnJ3362nXIEovxS8vp4BCClu7vIfEVCE2s1zS7zNwrDuRfFdViVAQMMxDMe77LnbKbfvLqUhiv--wPFyV9Iier1EDSL9y5kikOw_PGSyuRzvbQKuoNdGj-IqVZYZ_5QivOFqq_OEt8jaX1zZxAiQ8uXRt3g"
       qrcodeImage : "iVBORw0KGgoAAAA..."
       sessionToken : "aa73e547-0f1b-4235-a7b0-dd52fa4ab774"
       errorSummary : null
   }

Our response for trigger enroll includes five pieces of information with the most relevant piece being the base64 encoded string of the QR that is used to be displayed to the user to continue the enrollment on their device.

Decrypt The QR Code

The QR Code will return a URL with an encrypted data parameter named “data”.

This data must be decrypted using the available public key. Once decoded three pieces of information are provided separated by “&”.

  1. Host URL
  1. This URL is where all subsequent api calls will be made through.
  1. The API Key
  1. This API Key is used in the header of api calls.
  2. The key value pair in the header is as follows:

“apikey”:API_Key

  1. Session Token
  1. The session token is used to validate the session.

Decode The base64 URL Encoded Data

Android

Decode The base64 URL Encoded Data

   byte[] base64DecodedData = Base64.decode(encryptedData, Base64.DEFAULT | Base64.URL_SAFE | Base64.NO_PADDING);
   Log.i(TAG, "Base64 decoded");

Extract Signature and Encrypted Data

Android

Extract Signature And Encrypted Data

  byte[] signatureExtracted = new byte[256];
  byte[] encryptedDataExtracted = new byte[base64DecodedData.length - 256];
  System.arraycopy(base64DecodedData, 0, signatureExtracted, 0, signatureExtracted.length); // Get signature from data.
  Log.i(TAG, "Signature extracted");
  System.arraycopy(base64DecodedData, 256, encryptedDataExtracted, 0, base64DecodedData.length - 256);
  Log.i(TAG, "Encrypted Data extracted");

Verify Signature

Verify the signature using the public key.

Server Key

 String serverPublicKeyEncoded = "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAj1v8H6ehFSCfm23Z12W5tWr9UQM8+kWJsZqplgE7QcuhbM97G1bs874ouKjojdWmFHuLSkEuUNi9oIU3USJhSaCUmseD7CI0Tui4ODy8Y/3++BNqYGXAG2XQhNuGx4/6JVCg33zL46yl7zAj5fdl5+tJ5DrITDqf12dcwdPNTOM18ddBkKRL0oD4eIx2IGc4oCEBPghJlQCmDAuuXsuaNQc12sOo2BC9Uf+TQgIe5OjptAEaZLIEYTKle66yrWlZ+o0T028DtK971UUMmBQ0Uk+JKKfvTMkgCam4lZ8UMmBeaogYF5UPcMsoQlfkqjo3RILEyCaeW97ZAw3oq70DjwIDAQAB";

Android

Verify Signature

  byte[] decodedPublicKey = Base64.decode(serverPublicKeyEncoded, Base64.DEFAULT);
  Log.i(TAG, "Public key decoded");
  X509EncodedKeySpec spec = new X509EncodedKeySpec(decodedPublicKey);
  KeyFactory kf = null;

  kf = KeyFactory.getInstance("RSA");
  PublicKey publicKey = null;
  publicKey = kf.generatePublic(spec);
  boolean verifyResult = CryptoUtils.verifyUsingPublicKey("SHA256WithRSA", publicKey, encryptedDataExtracted, signatureExtracted);

Rebuild Key Using SecretKeySpec

Android

Rebuild Key Using SecretKeySpec

  byte[] decodedKey = Base64.decode(serverKey, Base64.DEFAULT);
  Log.i(TAG, "Secret key decoded");
  SecretKey serverSecret = new SecretKeySpec(decodedKey, 0, decodedKey.length, "AES");
  Log.i(TAG, serverSecret.toString());
  String decryptedData = null;
  decryptedData = CryptoUtils.dataDecrypt(encryptedDataExtracted, serverSecret);

  String[] valueElements = decryptedData.split("&");
  prefsEdit.putString(AppConstants.BIMAAS_URL_KEY, "https://" + valueElements[0]).apply();
  prefsEdit.putString(AppConstants.API_KEY_KEY, valueElements[1]).apply();
  prefsEdit.putString(AppConstants.SESSION_TOKEN, valueElements[2]).apply();

The following steps are the same for both client based and QR code based enrollment

Initiate An Enrollment

With this method type we start onboarding with accessToken, sessionToken and apikey.

Initiate An Enrollment

   POST /onboarding/enrollment/enroll
   Authorization: 'Bearer AccessToken'
   apikey: 'apikey'

   {
      "sessionToken": "sessiontoken"
   }

Response - Initiate an Enrollment

Response - Initiate An Enrollment

   STATUS CODE 200
   {
       "enrollmentToken": "be00a983-e60a-44de-8685-70da3b1b98be",
       "userExistsAlready": false,
       "requiredChecks": [
           "addDevice",
           "addFace",
           "addDocument"
       ]
   }

Get Device ID

Android

Get Device Id

   deviceId = Settings.Secure.getString(getContentResolver(), Settings.Secure.ANDROID_ID);

Add Device

The device ID is checked when performing an authentication to confirm the device enrolled is the same as the device attempting.

Add device

   POST /onboarding/enrollment/adddevice
   Authorization: 'Bearer AccessToken'
   apikey: 'apikey'

   {
       "enrollmentToken": "enrollmentToken",
       "deviceId": "deviceID"
   }

Response - Add Device

Response - Add Device

   {
       "enrollmentStatus": 1,
       "registrationCode": ""
   }

From here the response will include a registration code and enrollment status.

There are 3 enrollment statuses:

Enrollment Statuses

   0 = Enrollment Failed
   1 = Enrollment Pending
   2 = Enrollment Complete

Add Face Sample

Send a facial image to the back end to verify liveness. If the subject is live, the facial image will be kept for verification. The addFace API call requires the JSON package generated by the Face Capture SDK.

Add Face Sample

   POST /onboarding/enrollment/addFace
   Authorization: 'Bearer AccessToken'
   apikey: 'apikey'

   {
       "enrollmentToken": "enrollmentToken",
       "faceLivenessData":
          {
            "video": {
            "workflow_data": {
               "workflow": "hotel2",
               "rotation": 0,
               "frames": [
                   "data":"face package data generated by face sdk",
                   "data":"face package data generated by face sdk",
                   "data":"face package data generated by face sdk"
               ]
           },
           "meta_data": {
               "client_device_brand": "Unknown",
               "username": "username",
               "client_version": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/87.0.4280.88 Safari/537.36 Edg/87.0.664.66"
           },
           "client_version": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/87.0.4280.88 Safari/537.36 Edg/87.0.664.66"
       }
     }
   }

Response - Add Face Sample

The response from the enrollment call returns:

  • Liveness Result
    • This is a boolean value.
    • returns true if the sample is assessed to be a live sample
    • returns false is the sample is assessed too not be live
  • Enrollment Status
    • 0 = failed
    • 1 = pending
    • 2 = success
  • Registration Code
    • This code is used in the re-enrollment process
  • Liveness Result
    • Broken down into several fields giving feedback on the liveness score.

Liveness Result

   STATUS CODE 200
   {
       "livenessResult": true,
       "enrollmentStatus": 1,
       "registrationCode": "LLXL2N",
       "faceLivenessResults": {
           "video": {
               "liveness_result": {
                   "decision": "LIVE",
                   "feedback": [],
                   "score_frr": 1.1757098732441127
               }
           }
       }
   }

Add Document OCR

This method takes the data captured from the document capture SDK.

Add Document OCR

  POST /onboarding/enrollment/addDcoumentOCR
  Authorization: 'Bearer AccessToken'
  apikey: 'apikey'

   {
       "documentsInfo": {
           "documentPayload": {
               "request": {
                   "data": {
                       "ContainerList": {
                           "List": [{
                               "License": "AAEAAHQU5U8HN..."
                               "buf_length": 1724,
                               "light": 0,
                               "list_idx": 0,
                               "page_idx": 0,
                               "result_type": 50
                           }, {
                               "EncryptedRCL": "MDAwMXjaJJdlUyv..."
                               "buf_length": 1063742,
                               "light": 0,
                               "list_idx": 0,
                               "page_idx": 0,
                               "result_type": 49
                           }]
                       },
                       "TransactionInfo": {
                           "ComputerName": "localhost",
                           "DateTime": "2023-06-29T12:03:04.472Z",
                           "SystemInfo": "Linux, localhost, 5.10.81-android12-9-24339823-abS901U1UEU2AVF7, #1 SMP PREEMPT Tue Jun 21 00:33:42 UTC 2022, aarch64",
                           "TransactionID": "903639b3-dad8-4cdb-9c14-cc25ab624019",
                           "UserName": "u0_a952",
                           "Version": "6.8.9145"
                       }
                   },
                   "vendor": "REGULA"
               }
           },
           "processParam": {
               "alreadyCropped": true
           }
       },
       "enrollmentToken": "64e401db-a6f0-4484-9930-c948abeaaf09"
   }

Response - Add Document OCR

Response - Add Document OCR

  STATUS CODE 200
  {
       "enrollmentStatus": 0,
       "registrationCode": "",
       "matchResult": true,
       "matchScore": 5.8946095,
       "ocrResults": {
               "mrzPresence": false,
               "documentType": "United States - ePassport (2005) Page 3",
               "year": "2005",
               "documentTypeId": "-705504038",
               "fidType": "Passport Page",
               "overallResult": "FAILED",
               "rfidValidationResults": null,
               "authenticityResult": {
                       "authenticityImagePatternCheck": {
                               "securityElements": [],
                               "overallResult": "UNDEFINED"
                       },
                       "overallResult": "UNDEFINED"
               },
               "overallResultScore": 0,
               "icaoCode": "USA",
               "fidTypeId": "240",
               "signatureImage": "/9j/4AAQS..."

       "overallResultInfo": {
                       "fieldErrorCodes": ["MRZ_NONE", "VISUAL_NONE", "BARCODE_NONE", "DOCUMENT EXPIRED"],
                       "numberOfImages": 2,
                       "imagePairValid": false,
                       "analysisEngineErrorCodes": ["AUTHENTICITY_NULL"]
               },
               "countryName": "United States",
               "portraitImage": "/9j/4AAQSkZJRgAB..."
                       "rfidPresence": 1,
               "fieldType": [{
                       "name": "Document Class Code",
                       "fieldResult": {
                               "isMrzStatusValid": "NOT_VALIDATED",
                               "isBarcodeStatusValid": "NOT_VALIDATED",
                               "mrz": "",
                               "mrzVisualCompareValid": "NOT_COMPARED",
                               "isVisualStatusValid": "NOT_VALIDATED",
                               "visual": "",
                               "barcode": "",
                               "mrzBarcodeCompareValid": "NOT_COMPARED",
                               "visualBarcodeCompareValid": "NOT_COMPARED"
                       },
                       "typeId": 0,
                       "overallResult": "UNDEFINED"
               }, {
                       "name": "Issuing State Code",
                       "fieldResult": {
                               "isMrzStatusValid": "NOT_VALIDATED",
                               "isBarcodeStatusValid": "NOT_VALIDATED",
                               "mrz": "",
                               "mrzVisualCompareValid": "NOT_COMPARED",
                               "isVisualStatusValid": "NOT_VALIDATED",
                               "visual": "",
                               "barcode": "",
                               "mrzBarcodeCompareValid": "NOT_COMPARED",
                               "visualBarcodeCompareValid": "NOT_COMPARED"
                       },
                       "typeId": 1,
                       "overallResult": "UNDEFINED"
               }, {
                       "name": "Document #",
                       "fieldResult": {
                               "isMrzStatusValid": "NOT_VALIDATED",
                               "isBarcodeStatusValid": "NOT_VALIDATED",
                               "mrz": "",
                               "mrzVisualCompareValid": "NOT_COMPARED",
                               "isVisualStatusValid": "NOT_VALIDATED",
                               "visual": "",
                               "barcode": "",
                               "mrzBarcodeCompareValid": "NOT_COMPARED",
                               "visualBarcodeCompareValid": "NOT_COMPARED"
                       },
                       "typeId": 2,
                       "overallResult": "UNDEFINED"
               }, {
                       "name": "Date of expiry",
                       "fieldResult": {
                               "isMrzStatusValid": "NOT_VALIDATED",
                               "isBarcodeStatusValid": "NOT_VALIDATED",
                               "mrz": "",
                               "mrzVisualCompareValid": "NOT_COMPARED",
                               "isVisualStatusValid": "NOT_VALIDATED",
                               "visual": "",
                               "barcode": "",
                               "mrzBarcodeCompareValid": "NOT_COMPARED",
                               "visualBarcodeCompareValid": "NOT_COMPARED"
                       },
                       "typeId": 3,
                       "overallResult": "UNDEFINED"
               }, {
                       "name": "Date of issue",
                       "fieldResult": {
                               "isMrzStatusValid": "NOT_VALIDATED",
                               "isBarcodeStatusValid": "NOT_VALIDATED",
                               "mrz": "",
                               "mrzVisualCompareValid": "NOT_COMPARED",
                               "isVisualStatusValid": "NOT_VALIDATED",
                               "visual": "",
                               "barcode": "",
                               "mrzBarcodeCompareValid": "NOT_COMPARED",
                               "visualBarcodeCompareValid": "NOT_COMPARED"
                       },
                       "typeId": 4,
                       "overallResult": "UNDEFINED"
               }, {
                       "name": "Date of birth",
                       "fieldResult": {
                               "isMrzStatusValid": "NOT_VALIDATED",
                               "isBarcodeStatusValid": "NOT_VALIDATED",
                               "mrz": "",
                               "mrzVisualCompareValid": "NOT_COMPARED",
                               "isVisualStatusValid": "NOT_VALIDATED",
                               "visual": "",
                               "barcode": "",
                               "mrzBarcodeCompareValid": "NOT_COMPARED",
                               "visualBarcodeCompareValid": "NOT_COMPARED"
                       },
                       "typeId": 5,
                       "overallResult": "UNDEFINED"
               }, {
                       "name": "Place of Birth",
                       "fieldResult": {
                               "isMrzStatusValid": "NOT_VALIDATED",
                               "isBarcodeStatusValid": "NOT_VALIDATED",
                               "mrz": "",
                               "mrzVisualCompareValid": "NOT_COMPARED",
                               "isVisualStatusValid": "NOT_VALIDATED",
                               "visual": "",
                               "barcode": "",
                               "mrzBarcodeCompareValid": "NOT_COMPARED",
                               "visualBarcodeCompareValid": "NOT_COMPARED"
                       },
                       "typeId": 6,
                       "overallResult": "UNDEFINED"
               }, {
                       "name": "Surname",
                       "fieldResult": {
                               "isMrzStatusValid": "NOT_VALIDATED",
                               "isBarcodeStatusValid": "NOT_VALIDATED",
                               "mrz": "",
                               "mrzVisualCompareValid": "NOT_COMPARED",
                               "isVisualStatusValid": "NOT_VALIDATED",
                               "visual": "",
                               "barcode": "",
                               "mrzBarcodeCompareValid": "NOT_COMPARED",
                               "visualBarcodeCompareValid": "NOT_COMPARED"
                       },
                       "typeId": 8,
                       "overallResult": "UNDEFINED"
               }, {
                       "name": "Given names",
                       "fieldResult": {
                               "isMrzStatusValid": "NOT_VALIDATED",
                               "isBarcodeStatusValid": "NOT_VALIDATED",
                               "mrz": "",
                               "mrzVisualCompareValid": "NOT_COMPARED",
                               "isVisualStatusValid": "NOT_VALIDATED",
                               "visual": "",
                               "barcode": "",
                               "mrzBarcodeCompareValid": "NOT_COMPARED",
                               "visualBarcodeCompareValid": "NOT_COMPARED"
                       },
                       "typeId": 9,
                       "overallResult": "UNDEFINED"
               }, {
                       "name": "Nationality",
                       "fieldResult": {
                               "isMrzStatusValid": "NOT_VALIDATED",
                               "isBarcodeStatusValid": "NOT_VALIDATED",
                               "mrz": "",
                               "mrzVisualCompareValid": "NOT_COMPARED",
                               "isVisualStatusValid": "NOT_VALIDATED",
                               "visual": "",
                               "barcode": "",
                               "mrzBarcodeCompareValid": "NOT_COMPARED",
                               "visualBarcodeCompareValid": "NOT_COMPARED"
                       },
                       "typeId": 11,
                       "overallResult": "UNDEFINED"
               }, {
                       "name": "Sex",
                       "fieldResult": {
                               "isMrzStatusValid": "NOT_VALIDATED",
                               "isBarcodeStatusValid": "NOT_VALIDATED",
                               "mrz": "",
                               "mrzVisualCompareValid": "NOT_COMPARED",
                               "isVisualStatusValid": "NOT_VALIDATED",
                               "visual": "",
                               "barcode": "",
                               "mrzBarcodeCompareValid": "NOT_COMPARED",
                               "visualBarcodeCompareValid": "NOT_COMPARED"
                       },
                       "typeId": 12,
                       "overallResult": "UNDEFINED"
               }, {
                       "name": "Issuing Authority",
                       "fieldResult": {
                               "isMrzStatusValid": "NOT_VALIDATED",
                               "isBarcodeStatusValid": "NOT_VALIDATED",
                               "mrz": "",
                               "mrzVisualCompareValid": "NOT_COMPARED",
                               "isVisualStatusValid": "NOT_VALIDATED",
                               "visual": "",
                               "barcode": "",
                               "mrzBarcodeCompareValid": "NOT_COMPARED",
                               "visualBarcodeCompareValid": "NOT_COMPARED"
                       },
                       "typeId": 24,
                       "overallResult": "UNDEFINED"
               }, {
                       "name": "Surname And Given Names",
                       "fieldResult": {
                               "isMrzStatusValid": "NOT_VALIDATED",
                               "isBarcodeStatusValid": "NOT_VALIDATED",
                               "mrz": "",
                               "mrzVisualCompareValid": "NOT_COMPARED",
                               "isVisualStatusValid": "NOT_VALIDATED",
                               "visual": "",
                               "barcode": "",
                               "mrzBarcodeCompareValid": "NOT_COMPARED",
                               "visualBarcodeCompareValid": "NOT_COMPARED"
                       },
                       "typeId": 25,
                       "overallResult": "UNDEFINED"
               }, {
                       "name": "Nationality Code",
                       "fieldResult": {
                               "isMrzStatusValid": "NOT_VALIDATED",
                               "isBarcodeStatusValid": "NOT_VALIDATED",
                               "mrz": "",
                               "mrzVisualCompareValid": "NOT_COMPARED",
                               "isVisualStatusValid": "NOT_VALIDATED",
                               "visual": "",
                               "barcode": "",
                               "mrzBarcodeCompareValid": "NOT_COMPARED",
                               "visualBarcodeCompareValid": "NOT_COMPARED"
                       },
                       "typeId": 26,
                       "overallResult": "UNDEFINED"
               }, {
                       "name": "MRZ Type",
                       "fieldResult": {
                               "isMrzStatusValid": "NOT_VALIDATED",
                               "isBarcodeStatusValid": "NOT_VALIDATED",
                               "mrz": "",
                               "mrzVisualCompareValid": "NOT_COMPARED",
                               "isVisualStatusValid": "NOT_VALIDATED",
                               "visual": "",
                               "barcode": "",
                               "mrzBarcodeCompareValid": "NOT_COMPARED",
                               "visualBarcodeCompareValid": "NOT_COMPARED"
                       },
                       "typeId": 35,
                       "overallResult": "UNDEFINED"
               }, {
                       "name": "Optional data",
                       "fieldResult": {
                               "isMrzStatusValid": "NOT_VALIDATED",
                               "isBarcodeStatusValid": "NOT_VALIDATED",
                               "mrz": "",
                               "mrzVisualCompareValid": "NOT_COMPARED",
                               "isVisualStatusValid": "NOT_VALIDATED",
                               "visual": "",
                               "barcode": "",
                               "mrzBarcodeCompareValid": "NOT_COMPARED",
                               "visualBarcodeCompareValid": "NOT_COMPARED"
                       },
                       "typeId": 36,
                       "overallResult": "UNDEFINED"
               }, {
                       "name": "Issuing State",
                       "fieldResult": {
                               "isMrzStatusValid": "NOT_VALIDATED",
                               "isBarcodeStatusValid": "NOT_VALIDATED",
                               "mrz": "",
                               "mrzVisualCompareValid": "NOT_COMPARED",
                               "isVisualStatusValid": "NOT_VALIDATED",
                               "visual": "",
                               "barcode": "",
                               "mrzBarcodeCompareValid": "NOT_COMPARED",
                               "visualBarcodeCompareValid": "NOT_COMPARED"
                       },
                       "typeId": 38,
                       "overallResult": "UNDEFINED"
               }, {
                       "name": "MRZ Lines",
                       "fieldResult": {
                               "isMrzStatusValid": "NOT_VALIDATED",
                               "isBarcodeStatusValid": "NOT_VALIDATED",
                               "mrz": "",
                               "mrzVisualCompareValid": "NOT_COMPARED",
                               "isVisualStatusValid": "NOT_VALIDATED",
                               "visual": "",
                               "barcode": "",
                               "mrzBarcodeCompareValid": "NOT_COMPARED",
                               "visualBarcodeCompareValid": "NOT_COMPARED"
                       },
                       "typeId": 51,
                       "overallResult": "UNDEFINED"
               }, {
                       "name": "Check digit of document number",
                       "fieldResult": {
                               "isMrzStatusValid": "NOT_VALIDATED",
                               "isBarcodeStatusValid": "NOT_VALIDATED",
                               "mrz": "",
                               "mrzVisualCompareValid": "NOT_COMPARED",
                               "isVisualStatusValid": "NOT_VALIDATED",
                               "visual": "",
                               "barcode": "",
                               "mrzBarcodeCompareValid": "NOT_COMPARED",
                               "visualBarcodeCompareValid": "NOT_COMPARED"
                       },
                       "typeId": 80,
                       "overallResult": "UNDEFINED"
               }, {
                       "name": "Check digit of birth date ",
                       "fieldResult": {
                               "isMrzStatusValid": "NOT_VALIDATED",
                               "isBarcodeStatusValid": "NOT_VALIDATED",
                               "mrz": "",
                               "mrzVisualCompareValid": "NOT_COMPARED",
                               "isVisualStatusValid": "NOT_VALIDATED",
                               "visual": "",
                               "barcode": "",
                               "mrzBarcodeCompareValid": "NOT_COMPARED",
                               "visualBarcodeCompareValid": "NOT_COMPARED"
                       },
                       "typeId": 81,
                       "overallResult": "UNDEFINED"
               }, {
                       "name": "Check digit of expiry date",
                       "fieldResult": {
                               "isMrzStatusValid": "NOT_VALIDATED",
                               "isBarcodeStatusValid": "NOT_VALIDATED",
                               "mrz": "",
                               "mrzVisualCompareValid": "NOT_COMPARED",
                               "isVisualStatusValid": "NOT_VALIDATED",
                               "visual": "",
                               "barcode": "",
                               "mrzBarcodeCompareValid": "NOT_COMPARED",
                               "visualBarcodeCompareValid": "NOT_COMPARED"
                       },
                       "typeId": 82,
                       "overallResult": "UNDEFINED"
               }, {
                       "name": "Final check digit",
                       "fieldResult": {
                               "isMrzStatusValid": "NOT_VALIDATED",
                               "isBarcodeStatusValid": "NOT_VALIDATED",
                               "mrz": "",
                               "mrzVisualCompareValid": "NOT_COMPARED",
                               "isVisualStatusValid": "NOT_VALIDATED",
                               "visual": "",
                               "barcode": "",
                               "mrzBarcodeCompareValid": "NOT_COMPARED",
                               "visualBarcodeCompareValid": "NOT_COMPARED"
                       },
                       "typeId": 84,
                       "overallResult": "UNDEFINED"
               }, {
                       "name": "Age",
                       "fieldResult": {
                               "isMrzStatusValid": "NOT_VALIDATED",
                               "isBarcodeStatusValid": "NOT_VALIDATED",
                               "mrz": "",
                               "mrzVisualCompareValid": "NOT_COMPARED",
                               "isVisualStatusValid": "NOT_VALIDATED",
                               "visual": "",
                               "barcode": "",
                               "mrzBarcodeCompareValid": "NOT_COMPARED",
                               "visualBarcodeCompareValid": "NOT_COMPARED"
                       },
                       "typeId": 185,
                       "overallResult": "UNDEFINED"
               }, {
                       "name": "Check digit of 'Optional data'",
                       "fieldResult": {
                               "isMrzStatusValid": "NOT_VALIDATED",
                               "isBarcodeStatusValid": "NOT_VALIDATED",
                               "mrz": "",
                               "mrzVisualCompareValid": "NOT_COMPARED",
                               "isVisualStatusValid": "NOT_VALIDATED",
                               "visual": "",
                               "barcode": "",
                               "mrzBarcodeCompareValid": "NOT_COMPARED",
                               "visualBarcodeCompareValid": "NOT_COMPARED"
                       },
                       "typeId": 195,
                       "overallResult": "UNDEFINED"
               }, {
                       "name": "Other valid IDs",
                       "fieldResult": {
                               "isMrzStatusValid": "NOT_VALIDATED",
                               "isBarcodeStatusValid": "NOT_VALIDATED",
                               "mrz": "",
                               "mrzVisualCompareValid": "NOT_COMPARED",
                               "isVisualStatusValid": "NOT_VALIDATED",
                               "visual": "",
                               "barcode": "",
                               "mrzBarcodeCompareValid": "NOT_COMPARED",
                               "visualBarcodeCompareValid": "NOT_COMPARED"
                       },
                       "typeId": 315,
                       "overallResult": "UNDEFINED"
               }, {
                       "name": "Observations",
                       "fieldResult": {
                               "isMrzStatusValid": "NOT_VALIDATED",
                               "isBarcodeStatusValid": "NOT_VALIDATED",
                               "mrz": "",
                               "mrzVisualCompareValid": "NOT_COMPARED",
                               "isVisualStatusValid": "NOT_VALIDATED",
                               "visual": "",
                               "barcode": "",
                               "mrzBarcodeCompareValid": "NOT_COMPARED",
                               "visualBarcodeCompareValid": "NOT_COMPARED"
                       },
                       "typeId": 318,
                       "overallResult": "UNDEFINED"
               }, {
                       "name": "DS Certificate Issuer",
                       "fieldResult": {
                               "isMrzStatusValid": "NOT_VALIDATED",
                               "isBarcodeStatusValid": "NOT_VALIDATED",
                               "mrz": "",
                               "mrzVisualCompareValid": "NOT_COMPARED",
                               "isVisualStatusValid": "NOT_VALIDATED",
                               "visual": "",
                               "barcode": "",
                               "mrzBarcodeCompareValid": "NOT_COMPARED",
                               "visualBarcodeCompareValid": "NOT_COMPARED"
                       },
                       "typeId": 327,
                       "overallResult": "UNDEFINED"
               }, {
                       "name": "Months to expire",
                       "fieldResult": {
                               "isMrzStatusValid": "NOT_VALIDATED",
                               "isBarcodeStatusValid": "NOT_VALIDATED",
                               "mrz": "",
                               "mrzVisualCompareValid": "NOT_COMPARED",
                               "isVisualStatusValid": "NOT_VALIDATED",
                               "visual": "",
                               "barcode": "",
                               "mrzBarcodeCompareValid": "NOT_COMPARED",
                               "visualBarcodeCompareValid": "NOT_COMPARED"
                       },
                       "typeId": 364,
                       "overallResult": "UNDEFINED"
               }, {
                       "name": "Age at issue",
                       "fieldResult": {
                               "isMrzStatusValid": "NOT_VALIDATED",
                               "isBarcodeStatusValid": "NOT_VALIDATED",
                               "mrz": "",
                               "mrzVisualCompareValid": "NOT_COMPARED",
                               "isVisualStatusValid": "NOT_VALIDATED",
                               "visual": "",
                               "barcode": "",
                               "mrzBarcodeCompareValid": "NOT_COMPARED",
                               "visualBarcodeCompareValid": "NOT_COMPARED"
                       },
                       "typeId": 522,
                       "overallResult": "UNDEFINED"
               }, {
                       "name": "Years since issue",
                       "fieldResult": {
                               "isMrzStatusValid": "NOT_VALIDATED",
                               "isBarcodeStatusValid": "NOT_VALIDATED",
                               "mrz": "",
                               "mrzVisualCompareValid": "NOT_COMPARED",
                               "isVisualStatusValid": "NOT_VALIDATED",
                               "visual": "",
                               "barcode": "",
                               "mrzBarcodeCompareValid": "NOT_COMPARED",
                               "visualBarcodeCompareValid": "NOT_COMPARED"
                       },
                       "typeId": 523,
                       "overallResult": "UNDEFINED"
               }],
               "icaoVerificationResult": false
       },
       "retryDocumentCapture": false,
       "documentVerificationResult": false,
       "icaoVerificationResult": false,
       "icaoChipValidationResults": null
  }

Software Acknowledgments

AwareID Document Capture libraries incorporate third-party software. See the LICENSE file installed with the AwareID Document Capture software for the full license agreement.

CONTENTS