Integration of the Presence ASM

AndroidiOS

Integration of the Presence ASM

Android

Dependencies

To integrate this ASM, first add the Common ASM to your application’s module build.gradle file. See Dependencies for more information about the Common ASM Android dependencies.

Next, add the Presence ASM artifact. After you added this, the build.gradle file should look like this:

dependencies {
  // CommonASM and its dependencies
  api files(‘path to library/FIDOUAFPresenceASM.aar’)
}

Descriptor and metadata

• Add the following line to the descriptorclass array in your res/raw/asmdescriptors.json file:

com.vasco.fido.uaf.asm.presence.PresenceASMDescriptor

See Embedding of an authenticator for more details.

The ASM is delivered with the following metadata files for Android:

• BD51#0000 (secure hardware protected devices with ECDSA)

• BD51#0002 (software protected devices with ECDSA)

Customization

You can omit the customization of the ASM—this is an optional feature of the FIDO Authentication Solution!

You can use the Android XML system to customize the ASM.

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

Presence ASM—Registration shows the customized registration screen on an Android device.

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.

Icon

You can customize the icon that is displayed when the user has to choose between authenticators. It depends on the following resource string:

• vds_asm_presence_icon_drawable_name

The string value (by default vds_asm_presence_icon) corresponds to the name of a drawable resource, usually located in the drawable part of the Android resources system (e.g. res/drawable/vds_asm_presence_icon.png).

iOS

Dependencies

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

• All the Common ASM iOS dependencies as listed in Dependencies.

• FIDOUAFPresenceASMResources.bundle (linked framework and libraries)

• FIDOUAFPresenceASM.xcframework (linked framework and libraries)            

Initialization and metadata

To integrate the Presence ASM with C++

1. Add the import at the beginning of AppDelegate file:

   #import <FIDOUAFPresenceASM/FIDOPresenceASMInstanceCreator.hpp>

2. Add the following lines to AppDelegate file in the didFinishLaunchingWithOptions: method:

   asmcore::ASMFactory::addAuthenticator
   (FIDOPresenceASMInstanceCreator::createInstance());

   See Embedding of an authenticator for more details.

   The ASM is delivered with the following metadata file for iOS:

   • BD51#0003 (secure hardware protected devices with ECDSA)

To integrate the Presence ASM with Swift/Objective-C

1. Add the import at the beginning of AppDelegate file:

   import FIDOUAFPresenceASM

2. Add the following lines to AppDelegate file in the didFinishLaunchingWithOptions: method:

   // Add presence authenticator to ASM
   FIDOPresenceASM.registerPresenceAuthenticator()

   See Embedding of an authenticator for more details.

   The ASM is delivered with the following metadata file for iOS:

   • BD51#0003 (secure hardware protected devices with ECDSA)

Customization

You can omit the customization of the ASM—this is an optional feature of the FIDO Authentication Solution!

You can use the iOS Localizable.strings to customize the ASM. Presence ASM—Registration shows the customized registration screen on an iOS device.

Presence ASM—Registration

Customization keys

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

Icon

You can customize the icon that is displayed when the user has to choose between authenticators. It depends on the following resource string:

• vds_asm_presence_icon

The string value (by default presence_icon) corresponds to the name of a drawable resource, usually located in the binary (e.g. presence_icon.png).

Dark mode support

The Tutorial App is delivered with a storyboard called FIDO_UAF_PresenceASM.storyboard (see Tutorial App—FIDO UAF Presence ASM Storyboard).

Modify this storyboard to customize fonts and colors. To manage the Dark mode, declare 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 AppFIDO UAF Presence ASM Storyboard—Error Message) is displayed by default and does not indicate that the compilation has failed.