Table of Contents
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.3 4 - 4.3.1 Jelly Bean 4.4 KitKat (API level 1819)
Supported U2F Authenticator Transports
...
- NFC (requires
- USB HID
- Bluetooth Low Energy (A.K.A. BLE, Bluetooth Smart) Coming Soon!
- Virtual (included in client)
APKs
SurePassID FIDO U2F Client App
This app is the U2F Client. It is only run directly to update the settings. Otherwise it is call via an Implicit Intent from an app needing a U2F Client.
surePassIdFidoU2fClient-general-debug.apk
surePassIdFidoU2fAppDemo-general-debug.apk
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)
Code Block |
---|
$ 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'