Version 2020

Enable the System Browser for SAML Login in iOS

If your Library server is running version 11.2.2 or above, you can add a setting that allows the user to choose between the system in-app browser or an embedded browser. There are two ways to enable this setting:

Some things to keep in mind:

  • Adding a parameter to the configuration URL overrides the same parameter in Library Mobile SDK.
  • The systemBrowserCallBackURLScheme cannot contain the following special characters: %!*'();:@&=+$,/?#[].

Add a parameter to the configuration URL

  1. Append useSystemBrowserForAuthentication=1 to the configuration URL to use the system in-app browser.
  2. Append supportSingleLogout=1 to the configuration URL to use the system browser for single logout. This setting is optional and should only be used when single logout is supported by your identity provider (IDP).

    dossier://?url=https%3A%2F%2Ftec-w-002529.labs.microstrategy.com%3A8443%2FMicroStrategyLibrary%2Fapi%2Fconfig%2Fmobile%2Fdefault&mode=0&append=true&useSystemBrowserForAuthentication=1&supportSingleLogout=1

Expose a parameter using Library Mobile SDK

Make the following changes to MSTRCustomizations.plist:

  1. Set useSystemBrowserForAuthentication to YES.
  2. Set systemBrowserCallBackURLScheme to the customized app scheme. This step is optional.
  3. Set supportSingleLogout to YES. This setting is optional and should only be used when single logout is supported by your identity provider (IDP).