WebAuthenticationBroker Clase

Definición

Espacio de nombres:

Windows.Security.Authentication.Web

Inicia la operación de autenticación. Puede llamar a los métodos de esta clase varias veces en una sola aplicación o en varias aplicaciones al mismo tiempo. El ejemplo de agente de autenticación web de la galería samples es un ejemplo de cómo usar la clase WebAuthenticationBroker para conexiones de inicio de sesión único (SSO).

public ref class WebAuthenticationBroker abstract sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class WebAuthenticationBroker final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public static class WebAuthenticationBroker

Public Class WebAuthenticationBroker

Herencia

Object Platform::Object IInspectable WebAuthenticationBroker

Atributos

ContractVersionAttribute ThreadingAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)
Características de aplicaciones	internetClient

Ejemplos

private void OutputToken(String TokenUri)
{
   Page outputFrame = (Page)rootPage.OutputFrame.Content;
   TextBox FacebookReturnedToken = outputFrame.FindName("FacebookReturnedToken") as TextBox;
   FacebookReturnedToken.Text = TokenUri;
}


try
{
    String FacebookURL = "https://www.facebook.com/dialog/oauth?client_id=" + FacebookClientID.Text + "&redirect_uri=" + Uri.EscapeUriString(FacebookCallbackUrl.Text) + "&scope=read_stream&display=popup&response_type=token";

    System.Uri StartUri = new Uri(FacebookURL);
    System.Uri EndUri = new Uri(FacebookCallbackUrl.Text);

    WebAuthenticationResult WebAuthenticationResult = await WebAuthenticationBroker.AuthenticateAsync(
                                            WebAuthenticationOptions.None,
                                            StartUri,
                                            EndUri);
    if (WebAuthenticationResult.ResponseStatus == WebAuthenticationStatus.Success)
    {
        OutputToken(WebAuthenticationResult.ResponseData.ToString());
    }
    else if (WebAuthenticationResult.ResponseStatus == WebAuthenticationStatus.ErrorHttp)
    {
        OutputToken("HTTP Error returned by AuthenticateAsync() : " + WebAuthenticationResult.ResponseErrorDetail.ToString());
    }
    else
    {
        OutputToken("Error returned by AuthenticateAsync() : " + WebAuthenticationResult.ResponseStatus.ToString());
    }
}
catch (Exception Error)
{
    //
    // Bad Parameter, SSL/TLS Errors and Network Unavailable errors are to be handled here.
    //
}

<TextBlock x:Name="InputTextBlock1"  TextWrapping="Wrap" Grid.Row="0" Style="{StaticResource BasicTextStyle}" HorizontalAlignment="Left" > 
    Connect to Facebook using the OAuth 2.0 protocol for authentication and authorization. 
</TextBlock> 
<StackPanel Orientation="Vertical" Margin="0,10,0,0" Grid.Row="1"> 
    <StackPanel Orientation="Horizontal"> 
        <TextBlock TextWrapping="Wrap" Style="{StaticResource BasicTextStyle}" Text="App ID   : " VerticalAlignment="Bottom"/> 
        <TextBox x:Name="FacebookClientID" Height="14" Width="173" Text=""/> 
    </StackPanel> 
    <StackPanel Orientation="Horizontal"> 
        <TextBlock TextWrapping="Wrap" Style="{StaticResource BasicTextStyle}" Text="Site URL : " VerticalAlignment="Bottom"/> 
        <TextBox x:Name="FacebookCallbackUrl" Height="14" Width="433" Text=""/> 
    </StackPanel> 
    <StackPanel Orientation="Vertical" Margin="0,10,0,0"> 
        <Button x:Name="Launch" Content="Launch" Margin="0,0,10,0" Click="Launch_Click"/> 
    </StackPanel> 
</StackPanel>  

Comentarios

Todos los miembros de esta clase son estáticos. Puede acceder a ellos sin crear un objeto. Para solucionar problemas al usar esta clase, consulte el registro de eventos. Para ver el registro de eventos, inicie Eventvwr.exe y vaya a Registros de aplicaciones y servicios Microsoft >> Windows > WebAuth > Operational.

Métodos

AuthenticateAndContinue(Uri)	Inicia la operación de autenticación con una entrada.
AuthenticateAndContinue(Uri, Uri)	Inicia la operación de autenticación con dos entradas.
AuthenticateAndContinue(Uri, Uri, ValueSet, WebAuthenticationOptions)	Inicia la operación de autenticación con cuatro entradas.
AuthenticateAsync(WebAuthenticationOptions, Uri)	Inicia la operación de autenticación asincrónica con dos entradas. Puede llamar a este método varias veces en una sola aplicación o en varias aplicaciones al mismo tiempo.
AuthenticateAsync(WebAuthenticationOptions, Uri, Uri)	Inicia la operación de autenticación asincrónica con tres entradas. Puede llamar a este método varias veces en una sola aplicación o en varias aplicaciones al mismo tiempo.
AuthenticateSilentlyAsync(Uri)	Inicia la operación de autenticación asincrónica de forma silenciosa (no se mostrará ninguna interfaz de usuario) con una entrada. Puede llamar a este método varias veces en una sola aplicación o en varias aplicaciones al mismo tiempo.
AuthenticateSilentlyAsync(Uri, WebAuthenticationOptions)	Inicia la operación de autenticación asincrónica de forma silenciosa (no se mostrará ninguna interfaz de usuario) con dos entradas. Puede llamar a este método varias veces en una sola aplicación o en varias aplicaciones al mismo tiempo.
GetCurrentApplicationCallbackUri()	Obtiene el URI de devolución de llamada de la aplicación actual.

Consulte también

• Autenticación e identidad de usuario (JavaScript)
• Autenticación e identidad de usuario
• Inicio rápido: Conexión a un proveedor de identidades en línea (JavaScript)
• Agente de autenticación web
• ejemplo de agente de autenticación de Windows
• Ejemplo de WebAuthenticationBroker (Windows 10)