5.2 Authenticator Application Workspace Setup

This topic describes the systematic instruction to Authenticator Application Workspace Setup option.

  1. Copy UI (Directories – components, css, framework, images, pages, resources)from /dist directory to workspace/installer/app/src/main/assets/www/

    In case any popup appears, click Replace.


    Description of mnandrd41.png follows
    Description of the illustration mnandrd41.png

  2. Launch Android Studio and open existing project.
    Description of mnandrd42.png follows
    Description of the illustration mnandrd42.png

  3. Open OBDX_Installer/workspace_installer folder in Android Studio.
    Description of mnandrd43.png follows
    Description of the illustration mnandrd43.png

  4. Open gradle.properties file and update following properties with relevant proxy address if required.
    Description of mnandrd44.png follows
    Description of the illustration mnandrd44.png

    systemProp.http.proxyHost = <proxy_address>
         systemProp.https.proxyPort = <port_number>
         systemProp.https.proxyHost = <proxy_address>
         systemProp.http.proxyPort = <port_number>
  5. Open “assets\app.properties” file and update following properties as per requirement.
    Description of mnandrd45.png follows
    Description of the illustration mnandrd45.png


    Description of mnandrd46.png follows
    Description of the illustration mnandrd46.png

    connection_timeout = 
<timeout_in_milliseconds>
ssl_pinning_enabled = <YES or 
    Set OTP type to HOTP/TOTP as per requirement.
Set Server Type to OBDXTOKEN
Set MAX No Attempts greater than 0
Set UI Device root check to true if you want to add check on login button.

    Note:

    If selected authentication mechanism is not OAM based then remove shared_oam_url property.
  6. Click Build → Clean & Build → Rebuild project in Android Studio.
  7. Click on Build → Edit Build Type → app → release.

    Enable minify →true

    Add progurard file from workspace_installer/proguard-rules.pro

    Click OK.

  8. If using http protocol for development add (android:usesCleartextTraffic="true") to application tag of AndroidManifest.xml.
    Description of mnandrd47.png follows
    Description of the illustration mnandrd47.png

  9. For Generating Signed Apk: To Generate release-signed apk as follows:
  10. On menu bar click on Build → Generate Signed Apk.
    Description of mnandrd48.png follows
    Description of the illustration mnandrd48.png


    Description of mnandrd49.png follows
    Description of the illustration mnandrd49.png


    Description of mnandrd50.png follows
    Description of the illustration mnandrd50.png

    Click Finish to generate .apk

    The application has config page to add URL. This is for development purpose only and can be removed using below step (Update content src tag).


    Description of mnandrd51.png follows
    Description of the illustration mnandrd51.png

Parent topic: OBDX Authenticator Application