Configuration

• Configuring the Onegini SDKs
  • Install the SDK Configurator
  • Adding the Token Server configuration to your project
  • Setting application preferences
  • Customizing the configuration hook
  • Customizing the resolve dependencies hook

Configuring the Onegini SDKs

The following steps describe how to configure our native Android and iOS SDKs for your platform. When you add a platform to your Cordova project, the Onegini Cordova Plugin will automatically try to invoke the Onegini SDK Configurator. The SDK Configurator then reads the Token Server Configuration from configuration zip files you can obtain from your Token Server admin panel. Configuration settings not relevant to your Token Server will be read from your project's config.xml file.

Install the SDK Configurator

Download the configurator for your platform from the release page and extract the zip file. Please make sure you are using the correct configurator version for your Onegini Cordova Plugin version. You can check which version should be used in the configurator readme. You will then need to point the Onegini Cordova Plugin to your Configurator executable.

The easiest way the Plugin can find your Configurator is by setting the ONEGINI_SDK_CONFIGURATOR_PATH environment variable.

export ONEGINI_SDK_CONFIGURATOR_PATH=/path/to/onegini-sdk-configurator

The Plugin will also try to find the configurator in your $PATH if ONEGINI_SDK_CONFIGURATOR_PATH is not set. If you set the Configurator in your PATH, you can also run the configurator from the command line.

Adding the Token Server configuration to your project

Download the configuration zips from your Token Server admin panel under Configuration > Applications > My App. Under Platform versions click Actions > Export Platform version config.

The easiest way the plugin can find your configuration files is to store them as onegini-config-android.zip and onegini-config-ios.zip in the root of your Cordova Project.

You can specify alternative locations for these files by Customizing the configuration hook.

Setting application preferences

Apart from your Token Server Configuration, the Configurator will read some properties from your config.xml file. Changes in these preferences are only picked up after re-running the Configurator. The following preferences can be set:

Add these to your config.xml file as follows:

<preference name="Preference" value="Value" />

For more information on Cordova Preferences refer to the Cordova Documentation.

Customizing the configuration hook

The configuration hook is used to invoke the Configurator. The hook can be customized by setting the following environment variables:

For example, to change the location of the Android and iOS configuration zips you can set:

export ONEGINI_CONFIG_ANDROID_PATH=/path/to/android-config.zip
export ONEGINI_CONFIG_IOS_PATH=/path/to/ios-config.zip

Customizing the resolve dependencies hook

This hook is only triggered for iOS platforms since the Android the SDK is downloaded and managed by Gradle which is automatically invoked when building your Android project.

The resolve dependencies hook can be customized using the following environment variables:

For example, to change the location of the SDK download path you can set:

export ONEGINI_SDK_DOWNLOAD_PATH=/opt/onegini/sdk

For example, to strip simulator architectures you can set:

export ONEGINI_STRIP_SIMULATOR_ARCHITECTURES=true