Skip to main content

MC Configuration Files Overview

A KOBIL Secured app is always tied to a KOBIL Security Server installation; therefore, such an app must provide some configuration files to the MasterController. The required files depend on the KOBIL solution used.

Configuration Requirements by Solution​

For KOBIL Shift Lite KSSIDP (KOBIL Secure Sign-In with Identity Provider), the Security Server consists of AST Services in combination with a KOBIL IDP server. The required configuration files are:

  • sdk_config.jwt - Signed by AST Services
  • mc_config.json - Contains Master Controller configuration

Detailed Configuration Guides:

Project File Structure Examples​

Android/Kotlin Projects​

Structure of the Kotlin projects.
├── artifacts
│
├── app
│   └── src
│       ├── main
│       │   ├── AndroidManifest.xml
│       │   ├── java
│       │   │   └── com
│       │   │       └── yourCompany
│       │   │               └── yourApp
│       │   │                       ├── ...
│       │   │               
│       │   └── assets
│       │       └── yourEnvironment
│       │                  ├── sdk_config.xml/.jwt
│       │                  ├── mc_config.json
│       │                  └── SSL_certificate.pem
│       │

iOS/Swift Projects​

Structure of the Swift projects.
├── artifacts
│
├── yourApp
│   ├── Extensions
│   ├── Models
│   ├── Views
│   └── Resources
│         └── assets
│              └── yourEnvironment
│                         ├── sdk_config.xml/.jwt
│                         ├── mc_config.json
│                         └── SSL_certificate.pem

Trust Store Management​

These configuration files (and some other places) require you to manage a "trust store." We recommend first reading and understanding the documentation on which certificates to put into that trust store before creating configuration files.

The trust store contains certificates that your application trusts for secure communication with KOBIL servers. Proper trust store configuration is critical for security and successful connection establishment.