Skip to content

An iOS application that showcases the capabilities of Fingerprint Identification SDK.

License

Notifications You must be signed in to change notification settings

fingerprintjs/fingerprint-device-intelligence-ios-demo

Repository files navigation

Fingerprint

Supported Xcode versions Supported Swift versions Supported iOS versions Fingerprint Identification SDK version User interface framework Dependency manager

Discord server

Fingerprint’s Device Intelligence platform for iOS helps you to accurately identify the devices on which your mobile app is being used. The platform also provides high-quality Smart Signals that will help you identify risky transactions before they happen. The Fingerprint Pro Demo App for iOS allows you to effortlessly experience the capabilities of our device intelligence platform.

Fingerprint Pro Demo App in the App Store

App Store


About

This repository contains the source code for the Fingerprint Pro Demo App for iOS. It shall serve as a good example

  • For integrating the Fingerprint Identification SDK in your iOS app;
  • For best practices to follow when using the Fingerprint Identification SDK in your app;
  • For creating a privacy manifest file for your app.

Getting Started

Get the app up and running in a few simple steps:

  1. Clone the repository:

    git clone https://github.com/fingerprintjs/fingerprint-device-intelligence-ios-demo.git
    cd fingerprint-device-intelligence-ios-demo
  2. Set up the development environment:

    make environment

Note

In line with the shift-left security approach, the installed pre-commit hook uses gitleaks to prevent your API keys from being inadvertently committed to the repository.

  1. Open the Xcode project (FingerprintProDemo.xcodeproj):

    xed .
  2. Open up the FingerprintProDemo/Config/ConfigVariable.swift file (⇧ + ⌘ + O to Open Quickly) and assign your Public API Key + Region to Developer.apiKey and Developer.region static fields respectively. You can find the API key in your dashboard at App Settings > API Keys.

  3. Go to FingerprintProDemo target settings, click Signing & Capabilities, and select your development team.

  4. Build and run the app on the selected simulated or real device (⌘ + R).

Fingerprint Identification SDK

Following up on the information provided in our Getting Started Guide, you might refer to this repository for an example of:

Getting the response

The SDK configuration code and getVisitorIdResponse() call are abstracted away by the DeviceIdentificationService<ClientFactory> struct (see FingerprintProDemo/Domain/Services/DeviceIdentification), a concrete implementation of the DeviceIdentificationServiceProtocol protocol. While creating such an abstraction layer is not mandatory, it is a good practice that improves code maintainability and testability.

Examining the response

The DeviceIdentificationService<ClientFactory>.fingerprintDevice() method is called by the DeviceFingerprintViewModel, which further passes the obtained FingerprintResponse instance to the ClientResponseEventViewModel. This is where the individual field values are being extracted from the response and prepared for presentation inside the EventDetailsView<Presentation, Actions>. The view models can be found in FingerprintProDemo/Features/Home/ViewModel.

Stubbing the response for SwiftUI previews and/or testing

To make the most out of SwiftUI previews in Xcode, you should have full control over the data that describes the view's state. See FingerprintProDemo/PreviewContent for an example of how you can create and use a stubbed FingerprintResponse for your previews. Likewise, the same technique can be used for writing the automated tests.

License

The source code in this repository is licensed under the MIT license.