WebAuthenticationBroker Klasse

Referenz

Definition

Namespace:: Windows.Security.Authentication.Web

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

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: ContractVersionAttribute ThreadingAttribute

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:

Freigeben über