Integration of the Common ASM

Integration of the Common ASM—Customization of the Transaction ScreenAndroidiOS

Integration of the Common ASM—Customization of the Transaction Screen

Android

Dependencies

To be able to use the Common ASM, you have to link it and its dependencies to a project. Use the following code to configure these dependencies in your application’s module build.gradle file:

repositories {
     google()
     maven({ url '<path to your repository>' })
}
dependencies {
     api files ('<path to library>/FIDOUAFCommonASM.aar')
     api "com.noknok:ak_uaf:<current NokNok Android version>"
     api "com.noknok:asmsdk_uaf:<current NokNok Android version>"
     api files ('<path to library>/DeviceBindingSDK.aar')
     api files ('<path to library>/SecureStorageSDK.aar')
     api files ('<path to library>/UtilitiesSDK.aar')
     api "com.google.android.material:material:1.4.0"
     api "androidx.annotation:annotation:1.2.0"
}

The local maven repository is included in the FIDO UAF SDK package and located at

NokNok/App SDKs/Android/Version current Android version/app_dev_and_eval_current Android version/AppSDK/android-studio/m2repository.

The Device Binding SDK, Secure Storage SDK, and Utilities SDK are included in the OneSpan Mobile Security Suite product package.

For more details how to integrate Secure Storage SDK, refer to the Secure Storage SDK Integration Guide.

Customization

To facilitate the customization, you can use the default resources from the package (FIDO UAF SDK /Android/ Common ASM/Values).

Strings

The following raw string values can be customized via the strings.xml file:

Colors

The following colors in #argb and #rgb hex format can be customized via the colors.xml file.

Dimensions

The following dimen-type dimensions with values like dp, px, or sp can be customized via the dimens.xml file.

iOS

Dependencies

To integrate the Common ASM, add the following dependencies to your app:

• FIDOUAFCommonASM.xcframework (linked framework and libraries)

• FIDOUAFCommonASMResources.bundle (linked framework and libraries)

• MSSDeviceBinding.xcframework (embedded framework)

• MSSSecureStorage.xcframework (linked framework and libraries)

• UtilitiesSDK.xcframework (linked framework and libraries)

The MSSDeviceBinding, MSSSecureStorage and UtilitiesSDK frameworks are included in the OneSpan Mobile Security Suite product package.

MSSDeviceBinding and MSSSecureStorage frameworks must be set to Embed & Sign in your Xcode project or there is a risk of your application terminating unexpectedly.

Customization

Customization keys

The following keys are available for the customization of this authenticator:

Dark mode support

The Tutorial App is delivered with a storyboard called FIDO_UAF_Common.storyboard (see Tutorial App—Common Storyboard).

Modify this storyboard to customize fonts and colors. The Dark mode is managed by declaring named colors in the Assets catalog Images.xcassets.   The storyboard takes over the string customization of colors as soon as it is added in the integrating project.

This feature requires iOS 11 or later.

This storyboard contains several links to outlets that are defined inside the FIDOUAFCommonASM.xcframework. These links cannot be restored if they are removed.

The error in the storyboard (see Tutorial App Common Storyboard—Error Message) is displayed by default and does not indicate that the compilation has failed.