LogoLogo
Useful links
  • Home
  • Product guides
  • API
  • SDKs
  • Overview
  • First steps
  • ANDROID
    • Getting Started with the SDK
    • Standalone Modules
      • Document Detector
        • Release Notes
        • Current Version
        • Requirements
        • Gradle Dependencies
        • Gradle Source Code
        • Setting up the SDK
          • Setting properties
          • Capture Stages
          • Messages Settings
          • Customization
          • Security Settings
          • Detection Steps
          • Upload Mode
          • Advanced Settings
            • Proxy configuration
            • Preview configuration
        • Start Document Detection
        • Source Code
        • Google security form
        • Reduce SDKs size
        • SDKs response
        • References
        • FAQ
      • Face Liveness
        • Release Notes
        • Current Version
        • Requirements
        • Gradle Dependencies
        • Gradle Source Code
        • SDK Lifecycle
        • Building the SDK
        • Start Liveness Verification
        • Source Code
        • References
        • Advanced Features
        • FAQ
      • Face Authenticator
        • Release Notes
      • Smart Auth
        • Release Notes
        • Current Version
        • Requirements
        • Gradle Dependencies
        • Gradle Source Code
        • Permissions
        • SDK Lifecycle
        • Building the SDK
        • Start Smart Authentication
        • Source Code
        • References
        • FAQ
      • Face Liveness (deprecated)
        • Release Notes
  • iOS
    • Getting Started with the SDK
    • Standalone Modules
      • Document Detector
        • Release Notes
        • Current Version
        • Requirements
        • Installing the SDK
        • Setting up the SDK
          • Setting properties
          • Messages Settings
          • Customization
          • Detection Steps
          • Upload Mode
          • Advanced Settings
            • Proxy configuration
            • Preview configuration
        • Start Document Detection
        • References
        • FAQ
      • Face Liveness
        • Release Notes
        • Installation
        • Current Version
        • Requirements
        • SDK Lifecycle
        • Building the SDK
        • Start Liveness Verification
        • Source Code
        • References
        • FAQ
      • Face Authenticator
        • Release Notes
        • Installation
        • Current Version
        • Requirements
        • Building the SDK
        • Start the SDK
        • References
        • FAQ
      • Smart Auth
        • Release Notes
        • Installation
        • Current Version
        • Requirements
        • SDK Lifecycle
        • Building the SDK
        • Start Smart Authentication
        • Source Code
        • References
        • FAQ
      • Face Liveness (deprecated)
        • Release Notes
  • REACT NATIVE
    • Standalone Modules
      • Document Detector
        • Release Notes
        • Current Version
        • Requirements
        • Installation
        • Hooks
        • Start Document Verification
        • Source Code
        • TypeScript References
        • Customizing Style
        • FAQ
      • Face Liveness
        • Release Notes
        • Current Version
        • Requirements
        • Installation
        • Hooks
        • Start Liveness Verification
        • Source Code
        • TypeScript References
        • FAQ
      • Face Authenticator
        • Release Notes
        • Current Version
        • Requirements
        • Installation
        • Hooks
        • Start Authentication Verification
        • Source Code
        • TypeScript References
        • FAQ
      • Smart Auth
        • Getting started
        • Release notes
        • Using Native Modules
          • Requirements
          • Gradle Source Code
          • Podfile Source Code
          • Native Module Android
          • Native Module iOS
          • Import Native Modules
          • Source Code
          • TypeScript References
          • FAQ
        • Using Expo Modules
          • Requirements
          • Create Local Expo Module
          • Gradle Source Code
          • Podspec Source Code
          • Native Module Android
          • Native Module iOS
          • Import Expo Modules
          • Source Code
          • TypeScript References
          • FAQ
  • WEB (JAVASCRIPT)
    • Standalone Modules
      • Document Detector
        • Getting started
        • SDK builder options
          • Analytics
          • Appearance
          • Messages
        • SDK methods
        • Event listeners
        • Customization
        • Release notes
      • Face Liveness
        • Customization
        • Release notes
      • Face Authenticator
        • Customization
        • Release notes
      • Smart Auth
        • SDK errors
        • Customization
        • Release notes
LogoLogo

2025 © Caf. - All rights reserved

On this page
  • Creating a FaceAuthSDK instance
  • Builder Properties
  • Builder Methods
  • Example
  1. iOS
  2. Standalone Modules
  3. Face Authenticator

Building the SDK

Creating a FaceAuthSDK instance

To create a FaceAuthSDK instance, use the Builder class. This class provides a set of methods to configure the SDK instance.

Builder Properties

Property
Type
Description
Required

stage

CAFStage

Defines the environment stage (e.g., .prod, .beta). Default is .prod.

❌

sessionId

String

Session ID for the current authentication process.

✅

withLoading

Bool

Indicates whether to show a loading screen. Default is false.

❌

token

String

Authentication token required for the SDK.

✅

filter

Filter

Defines the filter for liveness detection. Default is .lineDrawing.

❌

personId

String

Identifier for the person being authenticated. Default is an empty string.

❌

imageUrlExpirationTime

Time

Expiration time for image URLs. Default is .thirtyMin.

❌

Builder Methods

Method
Type
Description
Required

setStage(stage:)

CAFStage

Sets the environment stage for the SDK. Default is .prod.

❌

setSessionId(sessionId:)

String

Sets the session ID for the authentication process.

✅

setLoading(withLoading:)

Bool

Configures whether a loading screen should be shown.

❌

setAuthBaseUrl(authBaseUrl:)

String

Sets the base URL for authentication.

✅

setLivenessBaseUrl(livenessBaseUrl:)

String

Sets the base URL for liveness detection.

✅

setFilter(filter:)

Filter

Configures the liveness detection filter. Default is .lineDrawing.

❌

setCertificates(certificates:)

[String]

Adds certificates required for secure communication.

✅

setImageUrlExpirationTime(time:)

Time

Sets the expiration time for image URLs. Default is .thirtyMin.

❌

Example

import FaceLiveness

let faceAuthSDK: FaceAuthSDK?

private func setupFaceAuthSDK() {
    faceAuthSDK = FaceAuthSDK.Builder()
        .setStage(stage: .prod)
        .setSessionId(sessionId: "session123")
        .setLoading(withLoading: true)
        .setAuthBaseUrl(authBaseUrl: "https://auth.example.com")
        .setLivenessBaseUrl(livenessBaseUrl: "https://liveness.example.com")
        .setFilter(filter: .lineDrawing)
        .setCertificates(certificates: ["cert1", "cert2"])
        .setImageUrlExpirationTime(time: .thirtyMin)
        .build()
}

Last updated 2 months ago