Integration of the FIDO ASMs on iOS

Before you integrate the FIDO ASM with the Tutorial App Plus application on iOS and/or Android, ensure that the FIDO Server has been configured correctly. For more information, see Configuration of the FIDO Server and the NokNok Labs documentation.

Follow the steps below to integrate the ASMs on iOS.

To integrate the OneSpanFIDO 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 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 of 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.