The @caf.io/react-native-face-liveness library is a powerful tool for integrating facial liveness detection functionality into React Native applications. It allows developers to easily incorporate live facial verification, adding an extra layer of security.
Minimum Requirements
Android
Settings
Minimum version
minSdkVersion
21
compileSdkVersion
34
Java version
8
iOS
Settings
Minimum version
Target
12
Xcode
13.4.1
Getting Started
yarn add @caf.io/react-native-face-liveness
# or
npm install @caf.io/react-native-face-liveness
Signed response from the CAF server confirming that the captured selfie has a real face. This parameter is used to get an extra layer of security, checking that the signature of the response is not broken, or caused by request interception. If it is broken, there is a strong indication of request interception.
signedResponse params
Name
Type
Description
requestId
string
Request identifier.
isAlive
boolean
Validation of a living person, identifies whether the user passed successfully or not.
token
string
Request token.
userId
string
User identifier provided for the request.
imageUrl
string
Temporary link to the image, generated by our API.
Change the expiration time of the face liveness url
enableScreenshots
boolean
Toggle user screenshots
loadingScreen
boolean
Toggle face liveness loading screen
Enums
Stage
Enum
Description
BETA
Beta environment
PROD
Production environment
DEV
Development environment
Filter
Enum
Description
LINE_DRAWING
Alternative mask for face liveness
NATURAL
Normal mask for face liveness
Time
Enum
Description
THREE_HOURS
Image url expiration time expires in three hours
THIRTY_DAYS
Image url expiration time expires in thirty days
THIRTY_MIN
Image url expiration time expires in thirty minutes
Error
Enum
Description
ServerReason
A server-side error/token invalidation occurred. The associated string (if available) will contain further information about the error.
NetworkReason
An error occurred with the video streaming process. The associated string (if available) will contain further information about the error.
UnknownReason
An unknown error has occurred. The associated string will contain further information about the error. These errors should be reported to iProov for further investigation.
UnexpectedReason
An unxpected error has occurred
CameraPermission
The user disallowed access to the camera when prompted. You should direct the user to re-try.