Setting up the mobile app

Depending on your objectives, you can choose one of the following methods:


Quickstart: Using the precompiled Getting Started mobile app

Thales provides a compiled version of the “Getting Started app” for Android and iOS mobile devices.

For Android users, a pre-configured APK file will be sent for your IdCloud Authentication environment. After receiving the APK file, you will be able to install it manually on your Android device.

For iOS users, Apple TestFlight is used to share a version of the sample application that is pre-configured for your IdCloud Authentication environment. You have to provide the email addresses of the people who will test the application to Thales, so that Thales can send the TestFlight invites.

You may contact your sales representative for more information.


Advanced: Cloning the source code of the Getting Started mobile app

Clone or download the GitHub repository and compile the example codes provided. You will not be required to write the code yourself.

For Android development

Recommended environments

  • macOS / Windows / Linux
  • Android Studio 2 or later
  • Android SDK
  • Java 8

Instructions

  1. Install Git on your machine and type the following command to clone the Android repository:
$ git clone https://github.com/gemalto/idcloud-tutorials-android.git
  1. Launch Android Studio and open the project from the newly created folder.

  2. Copy Debug and Release folders from Mobile Protector SDK to <path_to_repository>/app/libs/ folder.

  3. Update modules configuration according to your onboarding output form:

File Property / Method Description
SetupConfig.java ACTIVATION_CODE Activation code is used to enable individual supported features
ProvisioningConfig.java PROVISIONING_URL The URL of the Enrollment API endpoint, e.g: “https://*******/api/provisioning/pp”
RSA_KEY_ID Identifier for the EPS server’s public RSA key.
RSA_KEY_EXPONENT The RSA exponent of the EPS public key (on provisioning protocol level, not transport level).
RSA_KEY_MODULUS The RSA modulus of the EPS public key (on provisioning protocol level, not transport level).
getTlsConfiguration This configuration will allow to weaken TLS configuration for debug purposes. It’s not allowed to modify in release mode.
OtpConfig.java getOcraSuite Suite will set all relevant OCRA settings accordingly.
  1. Build and run the app

For iOS development

Recommended environments

  • macOS Mojave 10.14.4 or later
  • Xcode 10.2 or later
  • iOS 9.0 or later

Instructions

  1. Install Git on your machine and type the following command to clone the iOS repository:
$ git clone https://github.com/gemalto/idcloud-tutorials-ios.git
  1. Launch Xcode and open the project named Mobile Protector Samples.xcodeproj from the newly created folder.

  2. Copy Debug and Release folders from Mobile Protector SDK to <path_to_repository>/Frameworks/ folder.

  3. Update modules configuration according to your onboarding output form:

File Property Description
Setup_Config.h C_ACTIVATION_CODE Activation code is used to enable individual supported features
Provisioning_Config.h C_PROVISION_URL The URL of the Enrollment API endpoint, e.g: “https://*******/api/provisioning/pp”
C_RSA_KEY_ID Identifier for the EPS server’s public RSA key.
C_RSA_KEY_EXPONENT The RSA exponent of the EPS public key (on provisioning protocol level, not transport level).
C_RSA_KEY_MODULUS The RSA modulus of the EPS public key (on provisioning protocol level, not transport level).
C_TLS_CONFIGURATION This configuration will allow to weaken TLS configuration for debug purposes. It’s not allowed to modify in release mode.
OTP_Config.h C_OCRA_SUITE Suite will set all relevant OCRA settings accordingly.
  1. Build and run the app