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

Release Notes

Quick links: Overview | Building the SDK | Start Liveness Verification | UI Customization | Installation | Current Version | Requirements | Source Code | Result Reference | Release Notes | FAQ

v2.1.0

Distributed in CafSDKiOS 7.5.0.

New Features

  • UI customization: new optional uiCustomization: CerttaUiCustomization? parameter on startSDK to brand the liveness screen — header bar (title, colors, close button, logo), guidance prompt (colors, rounded corners), area around the face oval (color, blur) and font. Fully optional and backward compatible: omitting it, or leaving individual fields nil, keeps the current appearance. See UI Customization.

Distribution

  • CocoaPods: pod 'CafSDKiOS/CafFaceLivenessLite', '7.5.0'

v2.0.2

Distributed in CafSDKiOS 7.4.1.

Improvements

  • Analytics: Improving observability and troubleshooting.

Updates

  • Updated iProov dependency to 13.2.0.

  • iProov SP change: The SDK now follows the iProov SP provided by the backend. Server-side change — no integration changes required.

Distribution

  • CocoaPods: pod 'CafSDKiOS/CafFaceLivenessLite', '7.4.1'

v2.0.1

Distributed in CafSDKiOS 7.3.2.

Bug Fixes

  • cancelled() delivery timing: CafFaceLivenessLiteDelegate.cancelled() is now delivered only after iProov's camera view controller has finished dismissing.

Distribution

  • CocoaPods: pod 'CafSDKiOS/CafFaceLivenessLite', '7.3.2'

v2.0.0

Distributed in CafSDKiOS 7.3.1.

Breaking changes

  • Async-only transaction start: After capture, the SDK now calls the async route. The response contains only an opaque signedResponse JWT. The final liveness result (isAlive, images) must be retrieved by your backend out-of-band — the SDK does not poll.

  • executeFaceAuth removed: Face Auth is no longer supported by CafFaceLivenessLite. Calls that pass executeFaceAuth will fail to compile. Use the full Face Liveness / Face Auth products if you need that flow.

Migration

New Features

  • customLocalizationBundle: Optional Bundle? parameter on startSDK that maps to iProov options.stringsBundle. Use it together with customLocalization (strings table name) when your Localizable.strings live in a framework or host bundle other than the main app bundle — for example Bundle(for: CafFaceLivenessLiteSDK.self).

Distribution

  • CocoaPods: pod 'CafSDKiOS/CafFaceLivenessLite', '7.3.1'

v1.2.1

New Features

  • Security Monitoring: Added enableSecurity: Bool = true constructor parameter to CafFaceLivenessLiteSDK. When enabled, the SDK performs jailbreak detection, dylib monitoring, and instrumentation detection. Disable only in automated testing environments.

  • New Error Types: Added four new cases to CafErrorType:

    • cameraException: Camera hardware error

    • certificateException: Certificate validation failed

    • invalidOptionsException: Invalid SDK configuration options provided

    • securityException: Security violation detected (raised when enableSecurity: true and instrumentation or hooking is detected)

Distribution

  • CocoaPods: pod 'CafSDKiOS/CafFaceLivenessLite', '6.4.2'

v1.2.0

Updates

  • Minimum supported iOS version updated to 15.0+.

  • Updated iProov dependency to 13.1.0.

  • New Failure Options: Added new failure cases to CafFailureType: eyewear, faceNotFound, framesBlurry, lightingIssues, motionIssue, backgroundIssue, deviceIssue, deviceRestart, systemError, rejected, timeout, userNotFound, processingFault.

Important Notice

  • Reverse proxy support will be discontinued in a future release. A necessary iProov-related update is required to keep iProov working and prevent certificate issues. After March 15, 2026, Faceliveness and Faceauth services could be unavailable.

v1.1.0

New Features

  • Face Authentication Error Handling: Added a new faceAuthentication case to CafErrorType to specifically handle backend errors when executeFaceAuth is enabled.

v1.0.0

Initial release of the lightweight face liveness SDK.

Highlights

  • Smaller footprint with streamlined integration

  • Delegate-based lifecycle with success, failure, and error callbacks

  • Optional FaceAuth execution after liveness

  • Basic localization override via customLocalization

Last updated