SDK Configurator
Automatic configuration can be done using the "SDK Configurator". The main responsibilities of this tool is to generate the required config models and setup certificate pinning. Optionally the SDK Configurator can also add the SecurityController to the project with jailbreak and debug detection disabled. In order to use the SDK Configurator a ZIP file containing certificates and app configuration is needed. This file can be downloaded from the Token Server Admin Panel. How to do this is described in the Application delivery lifecycle topic guide in the Token Server docs.
Requirements
• jq - JSON processor - can be downloaded from: https://stedolan.github.io/jq/download/
• Ruby - for more info go to https://www.ruby-lang.org/en/documentation/installation/
• Xcodeproj - can be installed with gem install xcodeproj
(or sudo gem install xcodeproj
if you are using the system ruby) - for more info go to
https://github.com/CocoaPods/Xcodeproj
How it works
The configurator is a bash script. After execution, the script will ask for all the following data:
- Choose between Android and iOS platform.
- Provide the path to ZIP file containing app's config and certificates.
- Provide the path to
.xcodeproj
file. - Provide the name of the target to which the generated files will be added.
The OneginiConfigModel.h
and OneginiConfigModel.m
files are generated along with certificate files in .pem
and .cer
formats. The files are added to
the project into the group named "Configuration". At runtime the SDK will detect these files and use them as the configuration. When the SDK Configurator
tool is used SDK is instantiated by calling -[ONGClientBuilder build]
method. It automatically finds OneginiConfigModel
in order to configure SDK correctly.