Customize the Login Process for iOS

Library Mobile SDK for iOS Login APIs allow you to insert custom logic at different points during the login process and pass custom login parameters in login requests. See KB484291 for a demo of this functionality.

Add Custom Logic to the Login Process

You can add custom logic to the login process by creating a class that conforms to LoginDelegate protocol and adding your own logic in corresponding methods. Here are the methods of the LoginDelegate protocol:

To enable your customized login delegate class, you need to register it in DossierLoginDelegateManager. Methods that you override in the customized login delegate are called during the login process.

Property in DossierLoginDelegateManager:

Method in DossierLoginDelegateManager:

Implement Your Customized Login Process

1. Set up the environment to use the Library Mobile for iOS project. You are using this project as the basis for your customizations.
2. Create a custom app delegate.

3. Right-click the MicroStrategy Library folder and choose New File.

   

4. Click Swift File and Next.

   

5. Give the file a meaningful name, such as customLoginDelegate and click Create.

   

6. Navigate to the CustomAppDelegate.swift file you created in step 2. Import the MicroStrategyLibraryMobileSDK module to use LoginDelegate.

   

7. In the CustomLoginDelegate.swift file, define a class named CustomLoginDelegate that conforms to LoginDelegate. Add corresponding login methods and your own custom login logic in the methods.

   

   Copy

   import Foundation
   import MicroStrategyLibraryMobileSDK
   
   class CustomLoginDelegate: LoginDelegate {
       /**
          Called when login button is tapped.
          @param loginViewController:  The login viewController that holds the login button.
          @param loginType:  The login type of the button.
          @param completionHandler:  Note you should always call this block once you have done your work to let the app continue.
        */
       func loginButtonTapped(loginViewController: UIViewController, loginType: EnumLoginTypes, completionHandler: @escaping () -> Void) {
           
           // Do something when login button is tapped.
           
           completionHandler()
       }
       
       func handlePreMobileLogin(_ preLoginInfo: [AnyHashable : Any]) {
       
           // Do something before login requests being sent.
           
       }
       
       func handlePostMobileLogin(_ postLoginInfo: [AnyHashable : Any]) {
          
           // Do something after the login requests finished.  This function would be called after loginSuccess or loginFail is called.
           
       }
       
       func mobileLoginDidSucceed(_ successInfo: [AnyHashable : Any]) {
           
           // Do something when login requests succeed.
           
       }
      
       func mobileLoginDidFail(_ failureInfo: [AnyHashable : Any]) {
       
           // Do something when login requests failed.
           
       }
   }

8. Navigate to the CustomAppDelegate swift file created in step 2. Override the applicationDidFinishLaunching() function. Call DossierLoginDelegateManager to register your CustomLoginDelegate instance.

   

9. Clean and build your project. Your CustomLoginDelegate is registered before launching the application and your custom login logic is called at the appropriate time during login.

Pass custom login parameters

You can pass custom information in a login request for authentication purposes. Custom HTTP request parameters and custom HTTP headers can be provided in any requests made from the client to the Library server, while custom login parameters are only included in the authentication request body before being sent to the server. Define and manipulate these custom request parameters via the SDKEnvSettings util singleton class exposed via MSIGeneric.

Get SDKEnvSettings from MSIGeneric:

The following methods are exposed via the SDKEnvSettings class, relating to custom request parameters:

Examples for Passing Custom Login Parameters

Use the SDKEnvSettings singleton anywhere you want to store or update custom login parameters in your project like this:

MSIGeneric.getSDKEnvSettings()?.setServerParam("testValue", forKey: "testKey")

You can set an extra custom login parameter just before the login request is sent in the CustomLoginDelegate you previously created.