OnlineIdServiceTicketRequest Klasse

Definition

Namespace:

Windows.Security.Authentication.OnlineId

Bietet die Möglichkeit einer App, den Dienst und die Richtlinie anzugeben, die zum Authentifizieren eines Live-Benutzers zum Abrufen von Identitätseigenschaften und Tickets verwendet werden.

Hinweis

Wenn Sie für Windows 10 oder höher entwickeln, verwenden Sie stattdessen die Windows.Security.Authentication.Web.Core-APIs. Weitere Informationen finden Sie unter Webkonto-Manager.

public ref class OnlineIdServiceTicketRequest sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Security.Authentication.OnlineId.IOnlineIdServiceTicketRequestFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class OnlineIdServiceTicketRequest final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Security.Authentication.OnlineId.IOnlineIdServiceTicketRequestFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class OnlineIdServiceTicketRequest

function OnlineIdServiceTicketRequest(service, policy)

Public NotInheritable Class OnlineIdServiceTicketRequest

Vererbung

Object Platform::Object IInspectable OnlineIdServiceTicketRequest

Attribute

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

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

Beispiele

Das folgende Beispiel zeigt, wie der Dienst und die Richtlinie angegeben werden, die zum Authentifizieren eines Live-Benutzers verwendet werden.

function signIn() {
    var authenticator = new Windows.Security.Authentication.OnlineId.OnlineIdAuthenticator();
    var serviceTicketRequest = new Windows.Security.Authentication.OnlineId.OnlineIdServiceTicketRequest(
        "wl.basic wl.contacts_photos wl.calendars", "DELEGATION");

    sdkSample.displayStatus("Signing in...");

    authenticator.authenticateUserAsync(serviceTicketRequest)
        .done(function (authResult) {

            if ((authResult.tickets.size == 1) && (authResult.tickets[0].errorCode == 0)) {
                sdkSample.isSignedIn = true;
                sdkSample.displayStatus("Authorization succeeded.");
                sdkSample.accessToken = authResult.tickets[0];
                sdkSample.canSignOut = authenticator.canSignOut;
            }
        },

            function (authStatus) {
                if (authStatus && (authStatus.name !== "Canceled")) {
                    showErrorMessage("Autorization failed: " + authStatus.message);
                } else {
                    sdkSample.displayStatus("");
                }
                    showAccountStatus();
                });
}

Konstruktoren

OnlineIdServiceTicketRequest(String)	Erstellt eine instance der OnlineIdServiceTicketRequest-Klasse. Hinweis Wenn Sie für Windows 10 oder höher entwickeln, verwenden Sie stattdessen die Windows.Security.Authentication.Web.Core-APIs. Weitere Informationen finden Sie unter Webkonto-Manager.
OnlineIdServiceTicketRequest(String, String)	Erstellt eine instance der OnlineIdServiceTicketRequest-Klasse. Hinweis Wenn Sie für Windows 10 oder höher entwickeln, verwenden Sie stattdessen die Windows.Security.Authentication.Web.Core-APIs. Weitere Informationen finden Sie unter Webkonto-Manager.

Eigenschaften

Policy

Die Richtlinie, die zum Authentifizieren von Benutzern verwendet wird. Unterstützte Werte sind JWT, das Daten im JSON-Format zurückgibt. Für Apps, die die Zustimmung des Benutzers für den Zugriff auf in Live gespeicherte Apps anfordern, müssen App-Entwickler eine Delegierungsrichtlinie übergeben. Hinweis Wenn Sie für Windows 10 oder höher entwickeln, verwenden Sie stattdessen die Windows.Security.Authentication.Web.Core-APIs. Weitere Informationen finden Sie unter Webkonto-Manager.

Service

Identifiziert den Dienst, den Ihre App verwendet. Der Dienstname muss mit dem DNS-Namen übereinstimmen, den Sie beim Registrieren Ihrer App unter angegeben haben http://go.microsoft.com/fwlink/p/?linkid=241860. Tickets werden nur für diesen Dienst ausgestellt. Für Apps, die die Zustimmung des Benutzers für den Zugriff auf in Live gespeicherte Apps anfordern, müssen Sie die Angebote übergeben, auf die Ihre App Zugriff benötigt. Die verfügbare Liste der Angebote finden Sie auf unserer Seite Bereiche und Berechtigungen . Das Ticket kann dann mit den Live Connect-REST-APIs verwendet werden, um auf Daten zuzugreifen, die ein Benutzer der App erteilt hat. Weitere Informationen finden Sie in unserem Thema REST-APIs . Alternativ kann die App das Live Connect SDK verwenden, das diese Aufrufe selbst durchführt. Hinweis Wenn Sie für Windows 10 oder höher entwickeln, verwenden Sie stattdessen die Windows.Security.Authentication.Web.Core-APIs. Weitere Informationen finden Sie unter Webkonto-Manager.