For the complete documentation index, see llms.txt. This page is also available as Markdown.

Face Capture with IAD

Differences from standard Face Capture

The Selphi IAD Component is functionally equivalent to the Selphi Component standard, incorporating additional security controls aimed at detecting video injection attacks and untrusted capture environments.

The integration, configuration, and usage flow of the component are the same. The main functional difference is the inclusion of the field iad in the result (SelphiResult), which contains the antifraud analysis information prepared for server-side verification.

A new License is required for its use, and the dependency on the standard component must be replaced with:

implementation "com.facephi.androidsdk:selphi_iad_component:$version"

This component has two important restrictions:

  • Devices with at least 3 GB of RAM.

  • Front camera with preview of 1920x1080 or higher.

Introduction

Face Capture with video injection attack detection is performed through the Selphi IAD Component.

This component is responsible for capturing a user's selfie and extracting the most relevant facial features, incorporating a set of preventive security controls aimed at detecting untrusted environments. During the process, the following steps are performed, among others:

  • Internal camera and permission management.

  • Detection of spoofing attempts using videos or manipulated camera sources.

  • Guided assistance during Face Capture.

  • Generation of biometric templates and user images.


Dependency

The specific dependency for the component is:


Available controllers

This component includes several controllers, each oriented toward a specific functionality.

Controller
Description

FSelphiController

Main Facial Recognition controller


Error handling

Errors will be returned as a 'SelphiError' object.

Face Capture error list with IAD:
  • SPI_ACTIVITY_RESULT_ERROR: The activity result is incorrect.

  • SPI_ACTIVITY_RESULT_MSG_ERROR: The activity result received in the msg is incorrect.

  • SPI_APPLICATION_CONTEXT_ERROR: The required application context is null.

  • SPI_BAD_EXTRACTOR_CONFIGURATION_ERROR: Widget: Incorrect extractor configuration.

  • SPI_CAMERA_PERMISSION_DENIED: The user has denied permissions.

  • SPI_CANCEL_BY_USER: The user has canceled the process.

  • SPI_CANCEL_LAUNCH: A general cancellation of the SDK has been made.

  • SPI_COMPONENT_LICENSE_ERROR: The component license is not valid.

  • SPI_CONTROL_NOT_INITIALIZATED_ERROR: Widget: Initialization error.

  • SPI_EMPTY_LICENSE: The license String is empty.

  • SPI_EXTRACTION_LICENSE_ERROR: Widget: License error.

  • SPI_FETCH_DATA_ERROR: Error while fetching the result.

  • SPI_FLOW_ERROR: Error in the flow process.

  • SPI_HARDWARE_ERROR: Widget: Hardware error.

  • SPI_INITIALIZATION_ERROR: Initialization error.

  • SPI_MANAGER_NOT_INITIALIZED: The managers are null.

  • SPI_NO_DATA_ERROR: Input data are null.

  • SPI_OPERATION_NOT_CREATED: There is no operation in progress.

  • SPI_RESOURCES_NOT_FOUND: The resources zip was not found.

  • SPI_SETTINGS_PERMISSION_ERROR: Widget: Permission error.

  • SPI_TEMPLATE_ERROR:

  • SPI_TIMEOUT: Timeout in the process.

  • SPI_UNEXPECTED_CAPTURE_ERROR: Widget: Capture error.

  • SPI_UNKNOWN_ERROR: Unknown error.

  • SPI_WIDGET_RESULT_DATA_ERROR: Error in the widget's output data.

Last updated