OBDX AUTHENTICATOR APPLICATION

This document includes following topics:

• Authenticator UI
• Authenticator Application Workspace Setup
• Building Authenticator Application

3.1 Authenticator UI (Follow any one step below) Using built UI

For Non-OAM - Unzip dist.tar.gz directory from OBDX_Patch_Mobile\authenticator\NON-OAM

For OAM - Unzip dist.tar.gz directory from OBDX_Patch_Mobile\authenticator\OAM

3.2 Building UI manually

• Extract authenticator_ui.tar.gz from OBDX_Patch_Mobile\authenticator\unbuilt_ui. The folder structure is as shown :

(a) OAM based Authentication

• Open Terminal at “_build” level.
• Run following command:

  sudo npm install -g grunt-cli
  sudo npm install
  node render-requirejs/render-requirejs.js
  grunt authenticator --verbose
  

• After running above commands and getting result as “Done, without errors.” a new folder will be created at “_build” level with name as “dist”.

(b) Non-OAM Based Authentication

1. Copy “non-oam/login” folder and Replace it at location “components/modules/” [in ui folder] location. This will replace existing “login” folder.

2. Open Terminal at “_build” level.
3. Run following command

   sudo npm install -g grunt-cli
   sudo npm install
   node render-requirejs/render-requirejs.js
   grunt authenticator --verbose
   

• After running above commands and getting result as “Done, without errors.” a new folder will be created at “_build” folder level with name as “dist”.

3.2 Authenticator Application Workspace Setup

• Unzip and navigate to iOS workspace as shipped in installer
• Open the “OBDX_Installer/installables/mobile/authenticator/ui/ios/www” folder in the finder and paste and replace the following generated UI files from “ui/dist” folder :

• components
• css
• framework
• images
• pages
• resources

Finally the OBDX_Installer/installables/mobile/authenticator/ui/ios/www folder must look like:

• Generate a certificate(.cer) for your server and rename it to trustedCertificate.cer

Nowcopy and paste this trustedCertificate.cer to OBDX_Installer/installables/mobile/authenticator/ui/ios/ObdxAuthenticator/Resources/ directory

• In xcode navigator, right click on Settings.bundle -> Delete -> Move to Trash

• To change the OAM URL / SERVER URL / OTP_TYPE,

Go to the app.plist in Xcode navigator and set the values. Values for OTP_TYPE will be either HOTP or TOTP

Note: For NONOAM/DB authenticator setups leave OAM URL blank and set the Server url/OTP_TYPE (example shown below for NONOAM/DB Authenticator/LDAP setups)

• Now, again go to the Xcode and run the project either in Simulator or device
• To update Application name, Click on the project in Xcode, then under Targets -> Build Settings -> Packaging -> Product Name and update the Application Name to the desired one. To change the package name, Change the Bundle Identifier.

• To update Application icon/ Launch Image go to Resources -> Image.xcassets and show in Finder.

• Replace the images with icons/launch Images of the choice of each dimension of the icon/launch Image already present.

3.3 Building Authenticator Application

• Set the simulator to Generic iOS device. Then go to Product -> Archive.

• Choose your Archive and then click “Export”. .ipa file will be generated

Back