Configure Your App in Xcode

1. Open Xcode, then open your Xcode project.
2. Add the UniversalSSOLib.framework library by clicking the plus icon (+) under Linked Frameworks and Libraries, clicking And Other, and selecting the UniversalSSOLib.framework library.
   To use the functions provided in the library, you must #import <UniversalSSOLib/UniversalSSOLib.h>.
3. To configure the Info.plist file, click on your project in the navigation pane, then choose the target that corresponds to your app.
4. To set the app deep link, configure the URL types in the Info.plist file:
   1. For URL Schemes, enter a value with the format uniidentityappID, where appID is the Application ID of your mobile app configuration provided by MicroStrategy Identity. For example, uniidentity123.
      To determine your Application ID, in MicroStrategy Identity Manager, click Logical Gateways, then click Edit next to your app name.
   2. For Identifier, enter a value that uniquely distinguishes your scheme per Apple's recommendation, such as com.yourcompanyname.appid, where yourcompanyname is your actual company name or other unique identifier.

5. By default, the Identity single sign-on (SSO) SDK reads the following fields from your app's Info.plist file. Alternatively, you can set them programmatically.

   • UClientId: The Application ID for the mobile app that you registered with MicroStrategy Identity. This value is provided by MicroStrategy Identity Manager. (To determine your Application ID, in MicroStrategy Identity Manager, click Logical Gateways, then click Edit next to the name of your app.)

     • Programmatically:
       [[SSOClient sharedInstance] setApplicationID:@"applicationID"];
       where:

       ApplicationID is the Application ID (string data type).

   • UOrgId: The Organization ID of your Identity Network. This value is provided by MicroStrategy Identity Manager. (To determine your Organization ID, in MicroStrategy Identity Manager, click Logical Gateways, then click Edit next to the name of your app.)

     • Programmatically:

       [[SSOClient sharedInstance] setOrganizationID:@(OrganizationID)];

     where:

     OrganizationID is the Organization ID of your Identity Network (number data type)

   • UServerUrl: For on-premises implementations, the connection information for MicroStrategy Identity Server.

     • Programmatically:

       [[SSOClient sharedInstance] setServerURL:[NSURL URLWithString:@"https://server:port"]];

     where:

     • Server = the URL for MicroStrategy Identity Server (string data type).
     • Port = the port for MicroStrategy Identity Server (string data type).
6. Click Identity in the General tab of your project interface in Xcode. Note the values in the Bundle Identifier field.
7. In MicroStrategy Identity Manager, click Logical Gateways. Next to the app whose bundle IDs you want to verify, click Edit. The IDs will appear in the Bundle ID section.
8. Verify that the two sets of bundle IDs match.

Next, use the SSO library to implement MicroStrategy Identity authentication in your iOS app.