drawing

T5-Liveness Detection Service (LDS)

Version 1.1
This document is intended for technical developer who are integrating the T5-LDS for performing liveness detection. It describes the API along with interface and packet structure to be used by the clients communicating with the Tech5 T5-LDS.

Disclaimers

The information contained in this document is the proprietary and exclusive property of Tech5 except as otherwise indicated. No part of this document, in whole or in part, may be reproduced, stored, transmitted, or used for design purposes without the prior written permission from Tech5.

The information contained in this document is subject to change without notice. The information in this document is provided for informational purposes only. Tech5 specifically disclaims all warranties, express or limited, including, but not limited, to the implied warranty of merchant-ability and fitness for a particular purpose, except as provided for in a separate software license agreement.

Privacy Information

This document may contain information of a sensitive nature. This information should not be given to individuals other than those who are involved in the T5-LDS development or integration.

Contact : support@tech5-sa.com

Overview

Tech5 liveness detection service (LDS) is designed to serve customers who have limitations on using Tech5 Liveness iOS and Android SDK products.

Introduction

LDS is a REST API based service which takes a photo OR video clip + predefined challenge code as input. The service processes the request to confirm on of the two LD checks defined below.

In the context of the intended uses cases the LDS will serve the following purpose:

  1. Passive Liveness Detection (PLD): Given a single shot/photo the LDS will check for common anti spoofing attacks. This approach is less accurate but is fast and requires low payload. If successful the LDS will return the template which can be used for matching.
  2. Active Liveness Detection (ALD) : The basic principle is based on a challenge response concept. A video with a person performing predetermined challenge (like look left) is passed to LDS. The LDS will confirm if the person did complete the challenge. The algorithm will also check for common anti spoofing attacks. This approach is more accurate but slow and higher payload. The technology behind the service uses a highly accurate Tech5 trained Neural Network and algorithm. If the subject successfully completed the challenge, LDS will also returns one template from the clip which can be used for verifying if the same person is in the various challenges.

REST API

=== REQUEST ===
POST /v1/lsd?challenge=ll HTTP/1.1
Host: tech5.lsd.com
Content-Type: multipart/form-data; boundary=Asrf456BGe4h
Content-Length: 123123123
–Asrf456BGe4h
Content-Disposition: form-data; name=“video”
[VIDEO RAW DATA]

=== RESPONSE ===
HTTP 200 OK
Content-Type: application/json
Content-Length: 123123123
{
“status”: “PASSED” (or FAILED)
“failReason”: “FACE_NOT_FOUND” | “TOO_MANY_FACES” | “TOO_FAST” | “TOO_LONG” | “WRONG_DIRECTION”
“failFrame”: 10
“bestFrame”: 12
“croppedFace”: “BASE64 IMAGE”
}

Challenge Codes

//Challenge codes
LL - Look Left
LR - Look Right
LU - Look Up
LD - Look Down
RL - Roll Left
RR - Roll Right

Video Specification

Requirements for the video:
Min number of frames - 5
Max length - 3.5 s
Min resolution: 720 x 576
Supported codecs and containers - ffmpeg lib supported (H.264, H.265, etc.; avi, mpeg4, etc.)

Sample ALD scenario using LDS

DeviceCustomer ServerTech5LDSMBAPInitiateSend Challenge CodeShow instructions, record video, crop & compress. Send clip orstream video to Customer ServerSend video clipResize and compress if requiredSend video clip + challenge codeProcess clipPass/Fail & cropped imageloop[ Every challenge ]Cropped faces from challenges and final photoConfirm same person in all clips and final photoFinal photoor template and ID for authenticationAuthentication passed or failedDeviceCustomer ServerTech5LDSMBAP

Note: The templates returned in each challenge can be used to make sure the perosn in each challenge is the same you would like to authenticate or enroll