Scenarios
OATH
References
Abbreviations and terminology
Mobile Protector SDK
REST API
REST API scenarios

Build the application from the source code (iOS)

The sample mobile application project (source code) is provided and needs to be compiled. It includes the complete Xcode project. Before compiling the code, a few steps need to be executed.

  • Apple notifications: Several scenarios rely on Apple notifications, using the β€œAPNS HTTP2” protocol. Our IdCloud Authentication services require several inputs to be allowed to send these notifications.
    • To use notifications, you must provide Thales with the following: Client certificate (p12), certificate password, bundle id. Contact your sales representative for more information.
  • Mobile Protector Libraries: Libraries from the Mobile Protector SDK need to be copied into the project.
  • Configuration settings: All the settings specific to a customer are contained in one file. They need to be configured before the application can be compiled.

Instructions

  1. Clone or download the IdCloud Mobile Sample App Github repository for iOS
  2. Open the project under sample-app folder in Xcode.
  3. Deploy the Thales Mobile Protector SDK in the system.
  4. Configure the location of the Mobile Protector SDK in the Xcode setting Framework Search Path.
  5. If MSM and the Apple notifications are used (out of band scenarios):
    1. Use your Apple account to sign the application () The bundle ID, certificate (p12 format) and certificate password will need to be provided to Thales to enable notifications.
  6. Update the code with the IdCloud Authentication account configuration:
    1. Open the file: [Sample App Project]/EzioMobileSampleApp_IdCloud/Helpers/Configuration.m
    2. Update the contents of the file, based on the output forms provided by Thales IdCloud (see the section Configuration Settings Mapping below).
Parameter Section Output form property
C_CFG_SDK_ACTIVATION_CODE Contact your Thales Sales representative to obtain this value N/A
C_CFG_OTP_RSA_KEY_MODULUS EPS Project Provisioner Endpoint > Public Key Modulus
C_CFG_OTP_RSA_KEY_EXPONENT EPS Project Provisioner Endpoint > Public Key Exponent
C_CFG_OTP_PROVISION_URL EPS Project Provisioner Endpoint > URL
C_CFG_OTP_RSA_KEY_ID EPS Project Provisioner Endpoint > Public Key ID
C_CFG_OOB_RSA_KEY_MODULUS MSM Project Applications > Application Public Key Modulus
C_CFG_OOB_RSA_KEY_EXPONENT MSM Project Applications > Application Public Key Exponent
C_CFG_OOB_URL MSM Project Client API > URL
C_CFG_OOB_DOMAIN MSM Project Provider API > Tenant Name
C_CFG_OOB_APP_ID MSM Project Applications > Application ID
C_CFG_OOB_PROVIDER_ID MSM Project Provider API > Provider ID
C_CFG_FACE_ID_PRODUCT_KEY Contact your Thales Sales representative for more details on how to obtain a license. N/A
C_CFG_FACE_ID_SERVER_URL Contact your Thales Sales representative for more details on how to obtain a license. N/A
C_CFG_MSP_OBFUSCATION_CODE Reserved for future use. N/A
C_CFG_MSP_SIGN_KEYS Reserved for future use. N/A
C_CFG_TUTO_BASICAUTH_USERNAME CAS Project User Creation and Admin API > Customer admin user
C_CFG_TUTO_BASICAUTH_PASSWORD CAS Project User Creation and Admin API > Customer admin password
C_CFG_TUTO_URL_ROOT POC Tutorial Web Site URL

Parameters not included in this list can be left β€œas is” for this proof of concept. They will however need to be customized for a production release. All the values are found in the β€œOnboarding Output Form” PDF that has been provided to you by Thales.

  1. Compile the application.
  2. Deploy the application in an iOS device.