Android FIDO Client API

Owned by Mirko Ploch
Last updated: Apr 16, 2018


General

The Android FIDO Client API provides a wrapper for all calls to the SurePassID FIDO Server as well as initiating the Google FIDO U2F Client.

Requirements

Minimum SDK Version: Android 4.4 - 4.4.4 KitKat (API level 19)

Supported U2F Authenticator Transports

  • NFC
  • Bluetooth Low Energy (A.K.A. BLE, Bluetooth Smart)

Maven Repository Access

Access to the SurePassID Maven Repository is required to build the demo application code below. Please request a username and password for access. The gradle build scripts use system environment variables for to resolve your username and password for the maven repository. The environment variable names are "MVN_USERNAME" and "MVN_PASSWORD". Please refer to your OS instructions for setting these environment variables.

Google FIDO U2F Client API - Demo App

Follow these steps to build, install and run the U2F App using the Intent API demo code.

1. Create an account to use with the app that you are about ready to build and install. It is important to include an email address and phone number when creating the account.

https://fidocert.surepassid.com/account.aspx

2. Clone the code from GitHub. (you must request access to this repository for your GitHub account from SurePassID)

$ git clone https://github.com/SurePassID/U2FApp

3. Open the project that you just cloned using Android Studio.

File > Open...

4. When the project loads you will see the following two errors. 

/U2FApp/U2FApp/build.gradle
Error:(34, 13) Failed to resolve: com.surepassid.ui:ui-lib:1.0-SNAPSHOT
Error:(33, 13) Failed to resolve: com.surepassid.fido:u2f-client-intent-api:1.1-SNAPSHOT

5. To correct these error edit the file /U2FApp/build.gradle and add the maven repository information that was provided to you. After saving the changes select the following from the Android Studio menu.

Tools > Android > Sync Project with Gradle Files

6. You can now run the app on your Android device.

Run > Run 'U2FApp-U2FApp'