Integration of the FIDO ASMs

Follow the steps below to integrate the ASMs on Android.

To integrate the OneSpan FIDO ASMs on Android with the Tutorial App Plus application

1. Make sure that the value for minSdkVersion (which you can find in the main build.gradle file) of the Tutorial App Plus is equal to or higher than the value for minSdkVersion of the ASMs—see Supported platforms.
2. Change the gradle-wrapper.properties file to use gradle 6.1.1:

   distributionUrl=https\://services.gradle.org/distributions/gradle-6.1.1-bin.zip
   

3. Change the gradle to use Java 11:
   In Android Studio, go to File->Settings->Build, Execution, Deployment->Build Tools->Gradle and select Java 11 (or JDK 11).

4. Copy the ASM libraries (.aar files) and their dependencies to a directory in the Tutorial App, e.g. app/libs.
5. Integrate the Presence ASM in your app—see Integration of the Presence ASM for more detailed information.
6. Integrate the User Input ASM (PIN/password) in your app—see Integration of the User Input ASM (PIN/Password) for more detailed information.
7. Integrate the Native Biometric Authentication ASM—see Integration of the Native Biometric Authentication ASM for more detailed information.
8. (OPTIONAL) Embed an authenticator—see Embedding an authenticator for more detailed information.
9. After the integration of the FIDO ASMs is completed, raw/asmdescriptors.json should look like this:

   {
         "descriptorclass":[
        "com.vasco.fido.uaf.asm.biometric.NativeBiometricAuthenticationASMDescriptor",
        "com.vasco.fido.uaf.asm.presence.PresenceASMDescriptor",
        "com.vasco.fido.uaf.asm.userinput.PinASMDescriptor",
        "com.vasco.fido.uaf.asm.userinput.PasswordASMDescriptor"
     ]
   }

10. Configure your server endpoint in the TutorialApp class: modify the host variable:

    public static final String host = "https://<your endpoint>";

11. In the build.gradle, add the following inside the android{} block:

    packagingOptions {
    exclude 'META-INF/lib_release.kotlin_module'
    }

12. In the app/build.gradle, add the following lines inside dependencies{} block:

    constraints {
          implementation("org.jetbrains.kotlin:kotlin-stdlib-jdk7:1.8.0") {
               because("kotlin-stdlib-jdk7 is now a part of kotlin-stdlib")
          }
         implementation("org.jetbrains.kotlin:kotlin-stdlib-jdk8:1.8.0") {
              because("kotlin-stdlib-jdk8 is now a part of kotlin-stdlib")
         }
    }
    api files('libs/FIDOUAFCommonASM.aar')
    api files('libs/FIDOUAFNativeBiometricAuthenticationASM.aar')
    api files('libs/FIDOUAFPresenceASM.aar')
    api files('libs/FIDOUAFUserInputASM.aar')
    api files('libs/BiometricSensorSDK.aar')
    api files('libs/DeviceBindingSDK.aar')
    api files('libs/SecureStorageSDK.aar')
    api files('libs/UtilitiesSDK.aar')
    api "androidx.biometric:biometric:1.1.0"
    api "androidx.constraintlayout:constraintlayout:2.0.4"
    
    implementation fileTree(dir: 'libs', include: ['*.jar', '*.aar'])
    implementation 'androidx.constraintlayout:constraintlayout:2.0.4'
    implementation "androidx.annotation:annotation:1.2.0"
    implementation "com.esotericsoftware:kryo:5.1.1"
    implementation "org.bouncycastle:bcprov-jdk15on:1.65"
    implementation 'org.jetbrains.kotlin:kotlin-stdlib-jdk7:1.2.61'"

13. Customize the transaction screen—Common ASM; see Integration of the Common ASM—Customization of the Transaction Screen for more detailed information.
14. Customize the anti-hammering protection; see Customization of the Anti-hammering Protection for more detailed information.
15. Run the Tutorial App Plus application.

Follow the steps below to integrate the ASMs on iOS.

To integrate the OneSpan FIDO ASMs on iOS with the Tutorial App Plus application

1. Copy all required ASM frameworks and their dependencies (libraries) to a directory in the Tutorial App Plus, e.g. TutorialAppPlus/.../Frameworks.

   If you chose a different directory than TutorialAppPlus/.../Frameworks, you need to configure search paths in the build settings for the frameworks and their dependencies.

2. Integrate the Presence ASM in your app—see Integration of the Presence ASM for more detailed information.
3. Integrate the User Input ASM (PIN/password) in your app—see Integration of the User Input ASM (PIN/Password) for more detailed information.
4. Integrate the Native Biometric Authentication ASM—see Integration of the Native Biometric Authentication ASM for more detailed information.
5. (OPTIONAL) Embed an authenticator—see Embedding an authenticator for more detailed information.

The following examples illustrates how to add all OneSpanFIDO ASMs to the AppDelegate class:

C++

//Add presence authenticator to ASM
asmcore::ASMFactory::addAuthenticator(FIDOPresenceASMInstanceCreator::createInstance());
//Add Touch ID authenticator to ASM
asmcore::ASMFactory::addAuthenticator(FIDONativeBiometricAuthenticationASMInstanceCreator::createTouchIDInstance());
//Add Face ID authenticator to ASM
asmcore::ASMFactory::addAuthenticator(FIDONativeBiometricAuthenticationASMInstanceCreator::createFaceIDInstance());
//Add PIN/Password authenticator to ASM
asmcore::ASMFactory::addAuthenticator(FIDOUserInputASMInstanceCreator::createPinInstance());
asmcore::ASMFactory::addAuthenticator(FIDOUserInputASMInstanceCreator::createPasswordInstance());

Swift/Objective-C

// Add presence authenticator to ASM
FIDOPresenceASM.registerPresenceAuthenticator()
// Add Touch ID authenticator to ASM
FIDOBiometricASM.registerTouchIDAuthenticator()
// Add Face ID authenticator to ASM
FIDOBiometricASM.registerFaceIDAuthenticator()
// Add PIN/Password authenticator to ASM
FIDOUserInputASM.registerPinAuthenticator()
FIDOUserInputASM.registerPasswordAuthenticator()

6. Configure your server URLs in the Constant.h file.
   You need to modify the endpoints of the following constants:

   • LOGIN_SERVER_URL
   • REG_SERVER_URL
   • AUTH_SERVER_URL
   • WEBVIEW_URL
   • APPID
7. Customize the transaction screen—Common ASM; see Integration of the Common ASM—Customization of the Transaction Screen for more detailed information.
8. Customize the anti-hammering protection; see Customization of the Anti-hammering Protection for more detailed information.
9. Run the Tutorial App Plus application.