Interface IAuthenticationPlatformSupport

This interface abstracts common handling of platform-specific features in URL redirection flows.

Inherited Members
Namespace: Unity.Cloud.Identity
Syntax
public interface IAuthenticationPlatformSupport : IActivatePlatformSupport

Properties

CodeVerifierCacheStore

The code verifier cache store used in authenticated redirection flow.

Declaration
IKeyValueStore CodeVerifierCacheStore { get; }
Property Value
Type Description
IKeyValueStore

SecretCacheStore

The secret cache store used in authenticated redirection flow.

Declaration
IKeyValueStore SecretCacheStore { get; }
Property Value
Type Description
IKeyValueStore

UrlRedirectionInterceptor

The IUrlRedirectionInterceptor monitoring URL redirection requests.

Declaration
IUrlRedirectionInterceptor UrlRedirectionInterceptor { get; }
Property Value
Type Description
IUrlRedirectionInterceptor

Methods

GetAppStateOverride()

Gets a string override for the default random state parameter used in authenticated redirection flows.

Declaration
string GetAppStateOverride()
Returns
Type Description
String

This method returns a string override of the default random state or null if no override is defined.

GetCancellationUri()

Gets the cancellation URI expected from the browser when calling OpenUrlAndWaitForRedirectAsync(String, List<String>).

Declaration
string GetCancellationUri()
Returns
Type Description
String

The cancellation URI expected from the browser when calling OpenUrlAndWaitForRedirectAsync(String, List<String>).
Exceptions
Type Condition
InvalidOperationException

Thrown if the app isn't awaiting a URL redirection response.

GetRedirectionResult()

This method returns the UrlRedirectResult captured at app initializing time, or null if none available.

Declaration
UrlRedirectResult? GetRedirectionResult()
Returns
Type Description
Nullable<UrlRedirectResult>

The UrlRedirectResult captured at app initializing time, or null if none available on the specific platform.

GetRedirectUri(String)

Gets the redirection URI expected from the browser when calling OpenUrlAndWaitForRedirectAsync(String, List<String>).

Declaration
string GetRedirectUri(string operation = null)
Parameters
Type Name Description
String operation

Optional string to append to the path of the redirect URI
Returns
Type Description
String

The redirection URI expected from the browser when calling OpenUrlAndWaitForRedirectAsync(String, List<String>).

OpenUrlAndWaitForRedirectAsync(String, List<String>)

Creates a pending task that starts by opening a URL in a browser and is completed when response is intercepted, validated and returns a UrlRedirectResult.

Declaration
Task<UrlRedirectResult> OpenUrlAndWaitForRedirectAsync(string url, List<string> awaitedQueryArguments = null)
Parameters
Type Name Description
String url

The URL to open. It must trigger a redirection to the URI referenced by GetRedirectUri(String).
List<String> awaitedQueryArguments

The list of query arguments to validate when receiving the awaited callback url.
Returns
Type Description
Task<UrlRedirectResult>

A task that results in a UrlRedirectResult when completed.
Exceptions
Type Condition
TimeoutException

Thrown if no redirect occurred within the allotted time limit.

ProcessActivationUrl(List<String>)

Processes activation URL to either complete a URL redirection flow or consume an authenticated app resource.

Declaration
void ProcessActivationUrl(List<string> awaitedQueryArguments = null)
Parameters
Type Name Description
List<String> awaitedQueryArguments

The list of query arguments to validate when processing the activation URL.