WebAuthenticationBroker.AuthenticateAsync(WebAuthenticationOptions, Uri) | authenticateAsync(WebAuthenticationOptions, Uri) method

1 out of 2 rated this helpful - Rate this topic

Starts the asynchronous authentication operation with two inputs. You can call this method multiple times in a single application or across multiple applications at the same time.

Syntax


Windows.Security.Authentication.Web.WebAuthenticationBroker.authenticateAsync(options, requestUri).done( /* Your success and error handlers */ );

Parameters

options

Type: WebAuthenticationOptions

The options for the authentication operation.

requestUri

Type: Uri [JavaScript] | System.Uri [.NET] | Windows::Foundation::Uri [C++]

The starting URI of the web service. This URI must be a secure address of https://.

Return value

Type: IAsyncOperation<WebAuthenticationResult>

The way to query the status and get the results of the authentication operation. If you are getting an invalid parameter error, the most common cause is that you are not using HTTPS for the requestUri parameter.

Remarks

There is no explicit callbackUri parameter in this method. The application's default URI is used internally as the terminator. For more information, see GetCurrentApplicationCallbackUri. This method must be called on the UI thread.

When this method is used, session state or persisted cookies are retained across multiple calls from the same or different Windows Store apps.

Requirements

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Namespace

Windows.Security.Authentication.Web
Windows::Security::Authentication::Web [C++]

Metadata

Windows.winmd

See also

Setting up single sign-on using the web authentication broker
Web authentication broker overview
GetCurrentApplicationCallbackUri
WebAuthenticationBroker
AuthenticateAsync(WebAuthenticationOptions, Uri, Uri)

 

 

Build date: 12/4/2012

Did you find this helpful?
(1500 characters remaining)
© 2013 Microsoft. All rights reserved.