id-now-auto-ident

Auto ident from IDNow for expo integration.

IDnow AutoIdent offers a fully automated solution to identify a person. The process automatically performs these steps:

• Determines the kind of document used (e.g. passport, ID-card, driver's license)
• Determines the version of the document (e.g. German passport)
• Retrieves the data from the document
• Performs a biometric comparison
• Executes a liveness detection
• Verifies the genuineness of the document used during the process

IDnow mobile SDKs for integration into customer-specific apps to support the AutoIdent process.

Installation

• IDNow auto ident for expo -
• IDNow auto ident for expo configuration plugin -

For bare React Native projects, you must ensure that you have installed and configured the expo package before continuing.

Add the package to your npm dependencies

npm i expo-idnow-auto-ident

Configure for iOS

Run npx pod-install after installing the npm package.

Optionally, add permissions to use camera for ios if you want your custom message. Otherwise the plugin will use the default message.

"expo": {
    "ios": {
      "infoPlist": {
        "NSCameraUsageDescription": "Allow Camera Access for Video Identification",
        "NSPhotoLibraryUsageDescription": "Allow Camera Access for Video Identification"
      }
    }
}

Configure for Android

Install config plugin

npm install expo-idnow-auto-ident-config-plugin --save

or

yarn add expo-idnow-auto-ident-config-plugin  

add installed plugin in app.json plugins section

Package requires to have minSdkVersion: 23 which can be also defined with the same build properties plugin. App.json file needs to look like this:

"expo-build-properties",
    {
    "android": {
      "minSdkVersion": 23,
      "kotlinVersion": "1.8.0"
    },
}

After adding all of these you will need to run

npx expo prebuild --clean 

and verify that repository and minSdk versions are added correctly.

Contributing

In order to maintain this library it will often need to be updated with changes thats comming from Idnow sdks.

Usage and testing on Example App

Import from the package expo-idnow-auto-ident (unlike the example app).

import * as IdNowAutoIdent from "expo-idnow-auto-ident";
import {
  AutoIdentResponseDescriptions,
  IdNowLanguage,
} from "expo-idnow-auto-ident";
import { Platform, StyleSheet, Text, View } from "react-native";
import { useAsyncEffect } from "use-async-effect";

const language = IdNowLanguage.en;

export default function App() {
  useAsyncEffect(async () => {
    if (Platform.OS === "android") {
      const result = await IdNowAutoIdent.autoIdentInitAndroid(language);
      console.log("IdNowAutoIdent initAndroid", result);
    }
    const result = await IdNowAutoIdent.startAutoIdent(
      "TST-BRLYCD-KN",
      language,
    );
    if (!result) return;
    const errorCode = result.errorCode;
    if (errorCode) {
      const errorMessage = AutoIdentResponseDescriptions[errorCode];
      console.log(`IdNowAutoIdent error: ${errorCode} ${errorMessage}`);
    }
    console.log(`IdNowAutoIdent  ended with status: ${result.status}`);
  }, []);

  return (
    <View>
      <Text>Starting...</Text>
    </View>
  );
}