OnlineIdServiceTicketRequest Classe

Definizione

Spazio dei nomi:

Windows.Security.Authentication.OnlineId

Consente a un'app di specificare il servizio e i criteri usati per autenticare un utente live per ottenere proprietà e ticket di identità.

Nota

Se si sviluppa per Windows 10 o versione successiva, usare invece le API Windows.Security.Authentication.Web.Core. Per altre informazioni, vedere Gestione account Web.

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

Ereditarietà

Object Platform::Object IInspectable OnlineIdServiceTicketRequest

Attributi

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

Nell'esempio seguente viene illustrato come specificare il servizio e i criteri usati per autenticare un utente live.

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();
                });
}

Costruttori

OnlineIdServiceTicketRequest(String)	Crea un'istanza della classe OnlineIdServiceTicketRequest. Nota Se si sviluppa per Windows 10 o versione successiva, usare invece le API Windows.Security.Authentication.Web.Core. Per altre informazioni, vedere Gestione account Web.
OnlineIdServiceTicketRequest(String, String)	Crea un'istanza della classe OnlineIdServiceTicketRequest. Nota Se si sviluppa per Windows 10 o versione successiva, usare invece le API Windows.Security.Authentication.Web.Core. Per altre informazioni, vedere Gestione account Web.

Proprietà

Policy

Criteri usati per autenticare gli utenti. I valori supportati sono JWT, che restituisce dati usando il formato JSON. Per le app che richiedono il consenso dell'utente per l'accesso archiviato in Live, lo sviluppatore di app deve passare un criterio di DELEGA. Nota Se si sviluppa per Windows 10 o versione successiva, usare invece le API Windows.Security.Authentication.Web.Core. Per altre informazioni, vedere Gestione account Web.

Service

Identifica il servizio usato dall'app. Il nome del servizio deve corrispondere al nome DNS specificato durante la registrazione dell'app in http://go.microsoft.com/fwlink/p/?linkid=241860. I biglietti vengono emessi solo per questo servizio. Per le app che richiedono il consenso dell'utente per l'accesso archiviato in Live, devi passare le offerte a cui l'app deve accedere. L'elenco disponibile delle offerte è disponibile nella pagina Ambiti e autorizzazioni . Il ticket può quindi essere usato con le API REST di Live Connect per accedere ai dati che un utente ha acconsentito a fornire all'app. Per altre informazioni, vedere l'argomento sulle API REST . In alternativa, l'app può usare Live Connect SDK che effettuerà queste chiamate. Nota Se si sviluppa per Windows 10 o versione successiva, usare invece le API Windows.Security.Authentication.Web.Core. Per altre informazioni, vedere Gestione account Web.