WebAuthenticationBroker Klasse

Definition

Startet den Authentifizierungsvorgang. Sie können die Methoden dieser Klasse mehrmals in einer einzelnen Anwendung oder in mehreren Anwendungen gleichzeitig aufrufen. Das Webauthentifizierungsbrokerbeispiel im Beispielkatalog ist ein Beispiel für die Verwendung der WebAuthenticationBroker-Klasse für SSO-Verbindungen (Single Sign On, einmaliges Anmelden).

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
Vererbung
Object Platform::Object IInspectable WebAuthenticationBroker
Attribute

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)
App-Funktionen
internetClient

Beispiele

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>  

Hinweise

Alle Member dieser Klasse sind statisch. Sie können darauf zugreifen, ohne ein Objekt zu erstellen. Informationen zur Problembehandlung bei der Verwendung dieser Klasse finden Sie im Ereignisprotokoll. Um das Ereignisprotokoll anzuzeigen, starten Sie Eventvwr.exe, und navigieren Sie zu Anwendungs- und Dienstprotokolle > Microsoft > Windows > WebAuth > Operational.

Methoden

AuthenticateAndContinue(Uri)

Startet den Authentifizierungsvorgang mit einer Eingabe.

AuthenticateAndContinue(Uri, Uri)

Startet den Authentifizierungsvorgang mit zwei Eingaben.

AuthenticateAndContinue(Uri, Uri, ValueSet, WebAuthenticationOptions)

Startet den Authentifizierungsvorgang mit vier Eingaben.

AuthenticateAsync(WebAuthenticationOptions, Uri)

Startet den asynchronen Authentifizierungsvorgang mit zwei Eingaben. Sie können diese Methode mehrmals in einer einzelnen Anwendung oder in mehreren Anwendungen gleichzeitig aufrufen.

AuthenticateAsync(WebAuthenticationOptions, Uri, Uri)

Startet den asynchronen Authentifizierungsvorgang mit drei Eingaben. Sie können diese Methode mehrmals in einer einzelnen Anwendung oder in mehreren Anwendungen gleichzeitig aufrufen.

AuthenticateSilentlyAsync(Uri)

Startet den asynchronen Authentifizierungsvorgang im Hintergrund (keine Benutzeroberfläche wird angezeigt) mit einer Eingabe. Sie können diese Methode mehrmals in einer einzelnen Anwendung oder in mehreren Anwendungen gleichzeitig aufrufen.

AuthenticateSilentlyAsync(Uri, WebAuthenticationOptions)

Startet den asynchronen Authentifizierungsvorgang im Hintergrund (keine Benutzeroberfläche wird angezeigt) mit zwei Eingaben. Sie können diese Methode mehrmals in einer einzelnen Anwendung oder in mehreren Anwendungen gleichzeitig aufrufen.

GetCurrentApplicationCallbackUri()

Ruft den aktuellen Anwendungsrückruf-URI ab.

Gilt für:

Weitere Informationen