Contents
This document walks you through integrating the TruValidate Multifactor Authentication Core Auth SDK for iOS and Android apps. To use our library, you must have the TruValidate Multifactor Authentication Service and TruValidate Multifactor Authentication Core Auth SDK configured and connected.
Before integrating the TruValidate Multifactor Authentication Authenticator SDK with your app, an administrator must complete the following steps:
These permissions are declared in the SDK’s manifest and are automatically merged by the Android Gradle plugin. Keep this in mind if your build process modifies the manifest for any reason.
...
<!-- IF INTERESTED IN SUPPORTING THE NOW-DEPRECATED PEBBLE KIT SDK -->
<uses-sdk tools:overrideLibrary="com.getpebble.android.kit"/>
<uses-permission android:name="android.permission.USE_BIOMETRIC" />
<uses-permission android:name="android.permission.USE_FINGERPRINT"/>
<!-- permission required by Samsung's Pass SDK -->
<uses-permission android:name= "com.samsung.android.providers.context.permission.WRITE_USE_APP_FEATURE_SURVEY"/>
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
<!-- Needed only if your app targets Android 5.0 (API level 21) or higher. -->
<uses-feature android:name="android.hardware.location.gps" />
Add the following .plist permissions to your project and provide description values for each permission.
Required
<key>NSBluetoothPeripheralUsageDescription</key>
<string>Bluetooth is used for the Wearables auth method</string>
<key>NSCameraUsageDescription</key>
<string>The camera is used to capture QR codes</string>
<key>NSLocationWhenInUseUsageDescription</key>
<string>Location services are used for the Locations auth method</string>
<key>NSFaceIDUsageDescription</key>
<string>Face ID is used as an auth method</string>
//Required for Xcode 11+
<key>NSBluetoothAlwaysUsageDescription</key>
<string>Bluetooth is used for the Wearables auth method</string>
To use the Core Auth SDK,
Our SDK artifacts and source code are publically available here for Android and iOS.
project
level build.gradleallprojects {
...
repositories {
...
maven {
url "https://github.com/iovation/launchkey-android-authenticator-sdk/raw/master/lk-auth-sdk"
}
}
}
app
level build.gradledependencies {
...
implementation 'com.launchkey.android.authenticator.sdk:lk-auth-sdk-core:1.0.0'
}
Ensure that the permissions requirements are met.
After including the sdk into your app, you must configure the sdk. Read the next section for more information.
The Core Auth SDK for both platforms can be split up into separate packages/modules, each with their own set of responsibilities and functionality. To take advantage of our SDK, you need to setup each module. Begin with Authentication Management as it is a dependency for the others.
The basic setup for the Core Auth SDK should now be fully configured. The SDK can be configured to use and handle additional features. It is recommended to read the following components to enable a more UX friendly experience for your application.
TransUnion links to user contributed code as a resource to its community. TransUnion does not in any way guarantee or warrant the quality and security of these code bases. User contributed code is supported by the creators. If you do find a link from the site to user contributed code that is malicious or inappropriate in any way, please report that link to TransUnion immediately and we will investigate the claim. Submit any issue to TransUnion support at https://transunion.com/support. ×