ExternalUserAgent enum

Inheritance

• Object
• Enum
• ExternalUserAgent

Available extensions

• EnumName

Values

asWebAuthenticationSession → const ExternalUserAgent

Uses the ASWebAuthenticationSession APIs where possible.

This is the default for macOS and iOS 12 and above. On iOS 11, it will use SFAuthenticationSession instead.

Behind the scenes, the plugin makes use of the default external user-agent provided by the AppAuth iOS SDK. This will use the best user-agent available on the device. Specifically, on iOS it will use OIDExternalUserAgentIOS and on macOS it will use OIDExternalUserAgentMac.

Using this follows the best practices on using the appropriate native APIs based on the OS version.

ephemeralAsWebAuthenticationSession → const ExternalUserAgent

Indicates a preference in using an ephemeral sessions by using the ASWebAuthenticationSession APIs where possible.

This is only applicable to macOS and iOS 12 and above. On these platforms, the session will not share browser data with user's normal browser session and does not keep the cache.

Like asWebAuthenticationSession, it fallback to use SFAuthenticationSession on iOS 11 where there's no support for ephemeral sessions.

sfSafariViewController → const ExternalUserAgent

Uses the SFSafariViewController APIs.

This does not share browser data with the user's normal browser session but keeps the cache.

This is only applicable to iOS. On macOS, it will use the same behavior as asWebAuthenticationSession.

One reason for using this is when applications trigger an end session request but wants to avoid the prompt that would have appeared when the ASWebAuthenticationSession APIs are used. In this case, there's concern that the system-generated prompt would confuse the user as they are trying to sign out but the prompt states that it's taking the user through a sign-in flow.

Note that as this does not follow the best practices on using the appropriate native APIs based on the OS version, developers should use this at their own discretion.

Properties

hashCode → int

The hash code for this object.

no setter, inherited

index → int

A numeric identifier for the enumerated value.

no setter, inherited

name → String

Available on Enum, provided by the EnumName extension

The name of the enum value.

no setter

runtimeType → Type

A representation of the runtime type of the object.

no setter, inherited

Methods

noSuchMethod(Invocation invocation) → dynamic

Invoked when a nonexistent method or property is accessed.

inherited

toString() → String

A string representation of this object.

inherited

Operators

operator ==(Object other) → bool

The equality operator.

inherited

Constants

values → const List<ExternalUserAgent>

A constant List of the values in this enum, in order of their declaration.