OnlineIdAuthenticator Classe

Definizione

Spazio dei nomi:

Windows.Security.Authentication.OnlineId

Fornisce a un'app la possibilità di avviare la richiesta di autenticazione per ottenere token JSON (JavaScript Object Notation) da usare con il servizio o i ticket di richiesta che possono essere usati per ottenere i dati a cui l'utente ha acconsentito per l'app usando Live ConnectAPI.

In un'app desktop, prima di usare un'istanza di questa classe in modo da visualizzare l'interfaccia utente, dovrai associare l'oggetto all'handle della finestra del proprietario. Per altre info ed esempi di codice, vedi Visualizzare gli oggetti dell'interfaccia utente WinRT che dipendono da CoreWindow.

Nota

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

public ref class OnlineIdAuthenticator 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(65536, "Windows.Foundation.UniversalApiContract")]
class OnlineIdAuthenticator 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(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class OnlineIdAuthenticator

function OnlineIdAuthenticator()

Public NotInheritable Class OnlineIdAuthenticator

Ereditarietà

Object Platform::Object IInspectable OnlineIdAuthenticator

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 gestire una richiesta di autenticazione utente.

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

OnlineIdAuthenticator()

Crea un'istanza di OnlineIdAuthenticator. In un'app desktop, prima di usare un'istanza di questa classe in modo da visualizzare l'interfaccia utente, dovrai associare l'oggetto all'handle della finestra del proprietario. Per altre info ed esempi di codice, vedi Visualizzare gli oggetti dell'interfaccia utente WinRT che dipendono da CoreWindow. Nota Se si sviluppa per Windows 10 o versioni successive, usare invece le API Windows.Security.Authentication.Web.Core. Per altre informazioni, vedere Gestione account Web.

Proprietà

ApplicationId	Restituisce l'ID dell'applicazione come GUID. 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.
AuthenticatedSafeCustomerId	Restituisce l'ID di un utente che è stato autenticato correttamente per l'app. 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.
CanSignOut	Indica se un utente può disconnettersi dall'app e se visualizzare il collegamento di disconnessione nell'app. 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.

Metodi

AuthenticateUserAsync(IIterable<OnlineIdServiceTicketRequest>, CredentialPromptType)	Avvia la richiesta di autenticazione asincrona con più OnlineIdServiceTicketRequests e consente di controllare l'esperienza utente impostando CredentialPromptType per ottenere i ticket. Se un utente ha eseguito l'accesso a un sistema Windows 8 con un account Microsoft, questo utente verrà usato per la richiesta di autenticazione. 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.
AuthenticateUserAsync(OnlineIdServiceTicketRequest)	Avvia la richiesta di autenticazione asincrona con un oggetto OnlineIdServiceTicketRequest visualizzando la richiesta di credenziali, se necessario, per raccogliere le credenziali o il consenso e ottenere il ticket. Se un utente ha eseguito l'accesso a un sistema Windows 8 con un account Microsoft, questo utente verrà usato per la richiesta di autenticazione. 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.
SignOutUserAsync()	Consente agli utenti di disconnettersi dall'app. 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.