KSSIDP Integration Guideline
The following steps will guide you to easily integrate KSSIDP into your mobile app platforms.
Prerequisites
⚠️ On Android, KSSIDP always requires Android 10 (API level 29) or higher.
Otherwise, KSSIDP has the same requirements as MC SDK, see the MC SDK release notes for iOS and the MC SDK release notes for Android.
Step 1: Create your workspace with SmartDashBoard
- In the master of your SmartDashBoard, you can create as many workspaces and/or tenants as required.
- Each of your created workspaces operates with distinct workflows, client regulations, and user management.
- Once the workspace is created, follow the step below to integrate it into your project's assets directory.
Step 2: Add MC configuration files
Create an assets directory into your project and set the MC configuration files:
├──assets
│ └── yourEnvironment
│ ├── sdk_config.jwt
│ ├── mc_config.json
│ ├── app_config.json
│ └── SSL_certificate.pem
│
- Download and then add the sdk_config.jwt file to your assets directory.
⚠️ In order to download the sdk_config from your SmartDashBoard, use your server's SSL_certificate.
- To provide the connection between MC SDK and your workspace, add mc_config.json file to your assets directory.
Step 3: Implement MC SDK to your project
iOS/Swift
- Add SDK Framework to your project as mentioned in this link.
- To complete the interaction between SDK and (iOS+) apps, use the MC Adapter code block.
- Trigger KSMStartEventEx to begin with MC SDK.
Android/Kotlin
- Add SDK Dependency to your project as mentioned here.
- To complete the interaction between SDK and Android apps, use the MC Handler code block.
- Trigger StartEvent to begin with MC SDK.
Step 4: Initialize KSSIDP to an app
The final step is to add the KSSIDP initialization methods to the MC interaction code block of your application.
iOS/Swift
- Create a singletone instance of the KSSIDP SDKs in your project.
- Integrate your workspace by configuring the KSSIDP as metioned here.
- Add the KssIdp wrapper in your iOS app to access the SDKs functionality.
Android/Kotlin
- Create an SDK instance of the KSSIDP in your project.
- Initialize the KSSIDP SDK to your android app by utilizing the following method.
Step 5: Add KSSIDP SDKs Authentication methods to your project
| Description | Identity methods |
|---|---|
| Authenticate your users with their name, activation code and password | Activation |
| Log in a user with an username and password | Login |
| Authenticate multiple users in your project | Add User |
| Give your users the flexibility to change password | Change Password |
| Support your users who forgot their passwords | Forgot Password |