WebAuthenticationBroker.AuthenticateAsync Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Overloads
AuthenticateAsync(WebAuthenticationOptions, Uri) |
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. |
AuthenticateAsync(WebAuthenticationOptions, Uri, Uri) |
Starts the asynchronous authentication operation with three inputs. You can call this method multiple times in a single application or across multiple applications at the same time. |
AuthenticateAsync(WebAuthenticationOptions, Uri)
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.
public:
static IAsyncOperation<WebAuthenticationResult ^> ^ AuthenticateAsync(WebAuthenticationOptions options, Uri ^ requestUri);
/// [Windows.Foundation.Metadata.Overload("AuthenticateWithoutCallbackUriAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
static IAsyncOperation<WebAuthenticationResult> AuthenticateAsync(WebAuthenticationOptions const& options, Uri const& requestUri);
[Windows.Foundation.Metadata.Overload("AuthenticateWithoutCallbackUriAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<WebAuthenticationResult> AuthenticateAsync(WebAuthenticationOptions options, System.Uri requestUri);
function authenticateAsync(options, requestUri)
Public Shared Function AuthenticateAsync (options As WebAuthenticationOptions, requestUri As Uri) As IAsyncOperation(Of WebAuthenticationResult)
Parameters
- options
- WebAuthenticationOptions
The options for the authentication operation.
The starting URI of the web service. This URI must be a secure address of https://.
Returns
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.
- Attributes
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.
See also
- GetCurrentApplicationCallbackUri()
- AuthenticateAsync(WebAuthenticationOptions, Uri, Uri)
- Authentication and user identity (JavaScript)
- Authentication and user identity
- Quickstart: Connecting to an online identity provider (JavaScript)
- Web authentication broker
- Windows authentication broker sample
Applies to
AuthenticateAsync(WebAuthenticationOptions, Uri, Uri)
Starts the asynchronous authentication operation with three inputs. You can call this method multiple times in a single application or across multiple applications at the same time.
public:
static IAsyncOperation<WebAuthenticationResult ^> ^ AuthenticateAsync(WebAuthenticationOptions options, Uri ^ requestUri, Uri ^ callbackUri);
/// [Windows.Foundation.Metadata.Overload("AuthenticateWithCallbackUriAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
static IAsyncOperation<WebAuthenticationResult> AuthenticateAsync(WebAuthenticationOptions const& options, Uri const& requestUri, Uri const& callbackUri);
[Windows.Foundation.Metadata.Overload("AuthenticateWithCallbackUriAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<WebAuthenticationResult> AuthenticateAsync(WebAuthenticationOptions options, System.Uri requestUri, System.Uri callbackUri);
function authenticateAsync(options, requestUri, callbackUri)
Public Shared Function AuthenticateAsync (options As WebAuthenticationOptions, requestUri As Uri, callbackUri As Uri) As IAsyncOperation(Of WebAuthenticationResult)
Parameters
- options
- WebAuthenticationOptions
The options for the authentication operation.
The starting URI of the web service. This URI must be a secure address of https://.
The callback URI that indicates the completion of the web authentication. The broker matches this URI against every URI that it is about to navigate to. The broker never navigates to this URI, instead the broker returns the control back to the application when the user clicks a link or a web server redirection is made.
Returns
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.
- Attributes
Remarks
When this method is used, no session state or persisted cookies are retained across multiple calls from the same or different UWP app. This method must be called on the UI thread.
See also
- AuthenticateAsync(WebAuthenticationOptions, Uri)
- Authentication and user identity (JavaScript)
- Authentication and user identity
- Quickstart: Connecting to an online identity provider (JavaScript)
- Web authentication broker
- Windows authentication broker sample