App developer quickstart

Get your app with secured data from a backend service running in just 5 easy steps

Step 1: Access to the Onegini SDK

To gain access to the Onegini SDK you need to signup using the following form. We can provide you with a free trial if you want to give our software a try.

Step 2: Configured Token Server API

The server component (Token Server) is required for the Onegini SDK to work and to provide enterprise level security. You can use our hosted demo api for this. It's running on:

https://demo-msp.onegini.com/

Please note that the url above will show you a 404 not found error in a browser. If you'd like to see how Onegini SDK interacts with this API, take a look at the test client: https://demo-msp.onegini.com/client/test.

Step 3: Use a sample Resource Gateway

Mobile users should have secure access to company data through backend services. For example a bank customer should see their balance or transfer money. To see this in action we provide a backend service which is configured to use our Token Server.

Also this step has been done for you.On https://demo-msp.onegini.com/resources we've setup a service for you to play with. It provides a list of devices that a user registered.

By the way: the resource gateway we've setup is open source. You can find the source code of the example on https://github.com/Onegini/example-resource-gateway.

Step 4: Example apps for all platforms

iOS Example app

We’ve created an iOS example app for you in 
Swift.

Android Example app

Get the Android example app

Cordova example app

Apache Cordova promises to build apps using just HTML, CSS & JS. If this is your skillset, you may consider our Cordova example. 
It uses the same SDK under the hood through the additional Cordova plugin.

Optional Step 5: Use the SDK Configurator

The example apps have already been configured to work with the token server and resource gateway in steps 2 and 3. That's why this step is optional for the quickstart.

The SDK configurator (choose the latest 3.x release) can be used to update your configuration, so you can use your own token server and resource gateway. Amongst other things it generates config models and performs certificate pinning. The SDK configurator requires a ZIP file containing certificates and additional configuration so it communicates with the correct Token Server. This ZIP file can be downloaded from your Token Server instance or you can ask the Token Server administrator to give it to you.

For the quickstart you can use this iOS ZIP file or this Android ZIP file to see the sdk configurator in action.

Run the following command to configure the Android example app:

onegini-sdk-configurator android --app-dir your_path/android-example-app --config your_path/exampleapp-2.0.0-android.zip --module-name app --debugDetection=false --rootDetection=false

Run the following command to configure the iOS example app:

onegini-sdk-configurator ios --app-dir your_path/ios-example-app --config your_path/exampleapp-2.1.0-ios.zip --target-name OneginiExampleApp --debugDetection=false --rootDetection=false

In the Cordova example app, config from either onegini-config-android.zip or onegini-config-ios.zip in the project directory is picked up automatically.