FaceLiveness
FaceLiveness for iOS brings cutting-edge live facial verification and fingerprint authentication technology into your iOS applications. By leveraging the iProov Biometrics iOS SDK and FingerprintPro S
Current Version
Name | Version |
---|---|
| 5.0.0 |
Requirements
Deployment Info | Version |
---|---|
iOS Target | 12.0+ |
Xcode | 14.3.1+ |
Swift | 5.5+ |
A valid caf mobileToken.
Cocoapods installed
SDK Dependencies
FaceLiveness utilizes two key external SDKs, managed through CocoaPods for straightforward integration:
SDK | Version |
---|---|
| 11.0.3 |
| 2.2.0 |
iProov Biometrics iOS: Facilitates the integration of live facial verification technology.
FingerprintPro iOS: Adds fingerprint authentication capabilities, enhancing your app's security features.
Runtime permissions
In the info.plist
file, add the permissions below:
Permission | Reason | Required |
---|---|---|
| Capturing the selfie in live facial verification policies | Yes |
Installation
In your Podfile, specify the reference to our framework. Replacing <version>
with the current version:
For versions prior to FaceLiveness 4.0.0
, you must also include these additional sources in the Podfile:
Instantiating the SDK
First, instantiate an object of type FaceLivenessSDK
. This object is for you to configure all your business rules:
FaceLiveness Options
Parameter | Required | Default Value |
---|---|---|
| Yes | You must provide this information. |
Used to redirect the SDK to the desired environment in caf api. It has the following options: | No |
|
Set the camera filter applied to the camera preview. It has the following options: | No |
|
This boolean parameter determines whether the loading screen will be implemented via a delegate or if you will use the default screen. If set to 'true,' the loading screen will be a standard SDK screen. In the case of 'false,' you should use the 'LoadingScreen' session and implement the delegates. | No | false |
Use to change the default image URL expiration time to retrieve the scan capture. It has the following options: | No | 30 min |
Getting the Results
You must implement the FaceLivenessDelegate
class to get the SDK results. To do that, you should provide a UIViewController
to your SDK instance:
Delegate Implementation
The delegate below must be implemented to handle the SDK results. When implementing the delegate extension, you will have access to an object depending on the return type. In each case, the object carries different information.
Loading Screen
To create a loading screen during the SDK validation processes, you need to implement a view with the loading screen and display this screen in the onConnectionChanged(_ state: FaceLiveness.LivenessState)
delegate function.
state | description | loading screen |
---|---|---|
closed | SDK has been closed | dismiss |
connecting | SDK is connecting to liveness server | display |
connected | SDK has been connected with the liveness server | dismiss |
In the SDK implementation, it is necessary to add the view to the view stack using the following code. This makes the view visible.
This view should be added before the Builder of each SDK.
SDK Returns
Success cases
At the end of a successful execution, you will receive an object of type LivenessResult
. This object carries a signedResponse
property containing a JWT token with the execution result. This token should be decrypted to obtain the execution results details.
Within the signedResponse
, the parameter isAlive
defines the execution of liveness, where true
is approved and false
is rejected (Error case will be returned).
SignedResponse params
Event | Description |
---|---|
| Request identifier. |
| Validation of a living person, identifies whether the user passed successfully or not. |
| Request token. |
| User identifier provided for the request. |
| Temporary link to the image, generated by our API. |
| User identifier provided for the SDK. |
| Sdk version in use. |
| Token expiration. |
The isAlive parameter is VERY IMPORTANT, as it dictates whether the validation process proceeds or halts. When isAlive: true
, the user gains passage to continue their journey; conversely, if isAlive: false
, the user is deemed invalid and access to further stages of the journey should be denied. This parameter plays a pivotal role in guiding the flow of operations.
Error cases
In the event of execution errors, you will receive an object of type SDKFailure
. This object encompasses an enum containing the errorType
, and a description
.
ErrorType | Description |
---|---|
| This error may occur if the device hardware or software does not meet the minimum requirements for facial recognition functionality. |
| This error typically occurs when the user denies access to the camera or if the app lacks the necessary permissions. |
| This error may occur due to various network issues such as a lack of internet connection, server timeouts, or network congestion. |
| This error may occur if the provided authentication token is invalid, expired, or lacks the necessary permissions to perform facial recognition tasks. |
| This error is typically returned when there is an issue with the server processing the facial recognition request. This could include server-side errors, misconfigurations, or service interruptions. |
Last updated