web-fcm-demo

Welcome to the Web FCM Demo. The purpose of this repository is to demo the Face Capture Module npm package integration and use the output image to perform a prediction calling Yoti AI Services.

Setup

This project needs to have a configuration file in order to work. We only need to pass the configuration values as environment variables. We can follow this approach using a .env.local file:

Rename .env.example to .env.local and fill in the configuration values:

PEM_FILE_PATH=
SDK_ID=
ENDPOINT=

• PEM_FILE_PATH: path to the .pem private key needed to request Yoti Services.
• SDK_ID: client SDK ID needed to request Yoti Services.
• ENDPOINT: endpoint for the service to be requested.

Both PEM_FILE_PATH and SDK_ID secrets are obtained from following the instructions in this document. Specifically, under Generate API keys section.

The information required to fill the ENDPOINT variable can be found here. The BASE_URL (base URL for the service to be requested) is set in the .env file (check the value to fill the ENDPOINT field).

Set the clientSdkId in the FaceCapture component with SDK_ID value in the .env.local file.

Run locally

This demo was designed to be run locally. To get started, follow the below steps in the root directory:

1. Install all the dependencies:

   npm install

2. Start the server that will manage the request:

   node server.js

3. Start the client in a different terminal window:

   npm start

Now the client is ready to use. You just need to follow the FCM instructions, take a photo and wait for the response.

Windows

If the client browser does not start automatically or the given address in the terminal does not work, replace 0.0.0.0 by 127.0.0.1.

Face Capture module

The Face Capture module is a npm package that provides a React component which takes pictures using face detection tools. The usage of this module can be found in App.js. You can find more information about how to install the dependency, the API sections, etc here.

Use the secure flag to ensure the image can't be changed once is taken. Have in mind this will make some additional calls to the Yoti servers in order to secure the request.

Secure mode

Secure mode

Yoti NodeJS SDK

The Yoti NodeJS SDK package allows to integrate a NodeJS back-end with Yoti apps. The usage of this package to perform predictions to a Yoti app can be found in server.js file. For more information about this package, check this link.

Level of assurance is an optional parameter of the Yoti antispoofing API used to determine the strictness of the check.