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.
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 |