witte-mobile-sample-ios

The WITTE mobile sample showcases the integration of the Tapkey Mobile SDK in an iOS app. Its focus is on simplicity, so it is easy to understand with the least dependencies possible. Therefore, it is not a reference implementation that adheres to architectural best practices.

Please visit the flinkey for Developers pages for a Getting Started guide and further information:

• https://developers.flinkey.de/mobile-sdk/getting-started/iOS/

What it does

1. Authenticates with the Tapkey Mobile SDK
2. Triggers flinkey boxes
3. Checks digital keys

Prerequisites

• Access to the flinkey UAT Portal with activated developer feature
• A flinkey box in the flinkey UAT environment
• An actual iPhone (the simulator will not work)

Build & Run

Add your Customer Id, SDK Key, flinkey-API-Key and API Manager Credentials

This sample includes requests to the flinkey API which require ids, keys and credentials. This allows to use the app in a self-contained way without having an app backend in place.

None of these ids, keys and credentials must be included in production apps!

Production apps must not call the flinkey API themselfes. Instead they need their own backend which handles the communication to the flinkey API via server to server communication.

// File: DemoBackendAccessor.swift

/**
    Your flinkey Customer-ID.
    TODO: Add your flinkey Customer Id here.
 */
public static let FlinkeyCustomerId: Int = ...;

/**
    Your SDK Key.
    TODO: Add your SDK Key here.
 */
public static let FlinkeySdkKey: String = ...;

/**
    Your flinkey-API-Key.
    TODO: Add your flinkey-API-Key here.
 */
public static let FlinkeyApiKey: String = ...;

/**
    Your flinkey API Manager Username.
    TODO: Add your flinkey API Manager Username here.
 */
private static let FlinkeyApiManagerUsername: String = ...;

/**
    Your flinkey API Manager Password.
    TODO: Add your flinkey API Manager Password here.
 */
private static let FlinkeyApiManagerPassword: String = ...;

Add a flinkey user Id

For the sake of simplicity this sample app uses a single user Id. Production apps will retrieve the user Ids dynamically through their own back backend.

// File: DemoBackendAccessor.swift

/**
    User Id of one specific flinkey user (this needs to be retrieved at runtime in production apps).
    TODO: Add your flinkey user Id here.
 */
public static let FlinkeyUserId: Int = ...;

More Information

• flinkey for Developers: https://developers.flinkey.de/
• Tapkey for Developers: https://developers.tapkey.io/
• Tapkey Mobile Library Reference Documentation: https://developers.tapkey.io/mobile/ios/reference/TapkeyMobileLib/latest/