MSALGlobalConfig

Objective-C

@interface MSALGlobalConfig : NSObject

Swift

class MSALGlobalConfig : NSObject

MSAL configuration interface responsible for globally applicable authentication properties.

Note

Configuration changes inside MSALGlobalConfig will apply to all instances of MSALPublicClientApplication

Configuration options

  • Network configuration, refer to MSALHTTPConfig for more details

    Declaration

    Objective-C

    @property (class, readonly) MSALHTTPConfig *_Nonnull httpConfig;

    Swift

    class var httpConfig: MSALHTTPConfig { get }

  • Telemetry configurations, refer to MSALTelemetryConfig for more details

    Declaration

    Objective-C

    @property (class, readonly) MSALTelemetryConfig *_Nonnull telemetryConfig;

    Swift

    class var telemetryConfig: MSALTelemetryConfig { get }

  • Logger configurations, refer to MSALLoggerConfig for more details

    Declaration

    Objective-C

    @property (class, readonly) MSALLoggerConfig *_Nonnull loggerConfig;

    Swift

    class var loggerConfig: MSALLoggerConfig { get }

  • Setting to define MSAL behavior when Microsoft Authenticator application is installed. By default, MSAL will always try to use Microsoft Authenticator application when getting a token interactively. Set this property to MSALBrokeredAvailabilityNone to disable this behavior

    Declaration

    Objective-C

    @property (class) MSALBrokeredAvailability brokerAvailability;

    Swift

    class var brokerAvailability: Int32 { get set }

  • When enabled, MSAL will attempt to acquire bound app refresh tokens for the app. These refresh tokens are bound to the device ensuring they can’t be redeemed on any other device other than this one. The device must be registered using most secure storage and Authenticator(Broker) must be present on the device to bootstrap bound app refresh tokens.

    Note

    Platform behavior: This setting is currently only applied on iOS (TARGET_OS_IPHONE). On other Apple platforms (for example, macOS), this flag is a no-op and does not change token acquisition behavior.

    Note

    Initialization timing: This value is read during MSALPublicClientApplication initialization (when configuring the application cache/BART support). To take effect, it must be set before creating any MSALPublicClientApplication instances.

    Declaration

    Objective-C

    @property (class) BOOL shouldRequestBoundAppRefreshTokens;

    Swift

    class var shouldRequestBoundAppRefreshTokens: Bool { get set }

Unavailable initializers

  • Unavailable

    Use class properties instead.

    Declaration

    Objective-C

    - (nonnull instancetype)init;

  • Unavailable

    Use class properties instead.

    Declaration

    Objective-C

    + (nonnull instancetype)new;