OBDX AUTHENTICATOR APPLICATION

This document includes following topics:

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

1. Building Authenticator UI

• Extract OBDX_Installer.zip. It contains OBDX_Installer/installables/mobile/authenticator/ui folder. 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:

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

• After running above commands and getting below result. This error can be ignored and a new folder will be created in “ui” folder with name as “dist”.

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 Installer/installables/mobile/authenticator/ui/ios/www folder must look like:

• Double click on OBDXSecureAuthenticator.xccodeproj to open the project in Xcode

Update HOTP or TOTP in above screenshots and update the server URL.

• The application can be archived using steps in Section 4.3 for running on device
• To run the application on simulator, copy & replace the framework from simulator/ObdxAuthenticator.framework to /authenticator/platforms/ios/

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