OnlineIdServiceTicketRequest Classe

Definição

Namespace:

Windows.Security.Authentication.OnlineId

Fornece a capacidade de um aplicativo especificar o serviço e a política usados para autenticar um usuário do Live para obter propriedades de identidade e tíquetes.

Observação

Se você estiver desenvolvendo para o Windows 10 ou superior, use as APIs Windows.Security.Authentication.Web.Core . Para obter mais informações, consulte Gerenciador de contas 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

Herança

Object Platform::Object IInspectable OnlineIdServiceTicketRequest

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Exemplos

O exemplo a seguir mostra como especificar o serviço e a política usados para autenticar um usuário do 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();
                });
}

Construtores

OnlineIdServiceTicketRequest(String)	Cria uma instância da classe OnlineIdServiceTicketRequest. Observação Se você estiver desenvolvendo para o Windows 10 ou superior, use as APIs Windows.Security.Authentication.Web.Core . Para obter mais informações, consulte Gerenciador de contas Web.
OnlineIdServiceTicketRequest(String, String)	Cria uma instância da classe OnlineIdServiceTicketRequest. Observação Se você estiver desenvolvendo para o Windows 10 ou superior, use as APIs Windows.Security.Authentication.Web.Core . Para obter mais informações, consulte Gerenciador de contas Web.

Propriedades

Policy

A política usada para autenticar usuários. Os valores com suporte são JWT, que retorna dados usando o formato JSON. Para aplicativos que estão solicitando o consentimento do usuário para acessar o armazenado no Live, o desenvolvedor de aplicativos deve passar uma política de DELEGATION. Observação Se você estiver desenvolvendo para o Windows 10 ou superior, use as APIs Windows.Security.Authentication.Web.Core . Para obter mais informações, consulte Gerenciador de contas Web.

Service

Identifica o serviço que seu aplicativo usa. O nome do serviço deve corresponder ao nome DNS que você forneceu ao registrar seu aplicativo em http://go.microsoft.com/fwlink/p/?linkid=241860. Os tíquetes são emitidos apenas para esse serviço. Para aplicativos que estão solicitando o consentimento do usuário para acessar o armazenado no Live, você deve passar as ofertas para as quais seu aplicativo precisa de acesso. A lista disponível de ofertas pode ser encontrada em nossa página Escopos e Permissões . Em seguida, o tíquete pode ser usado com as apis REST do Live Connect para acessar os dados que um usuário consentiu em fornecer ao aplicativo. Confira nosso tópico de APIs REST para saber mais. Como alternativa, o aplicativo pode usar o SDK do Live Connect, que fará essas chamadas por si só. Observação Se você estiver desenvolvendo para o Windows 10 ou superior, use as APIs Windows.Security.Authentication.Web.Core . Para obter mais informações, consulte Gerenciador de contas Web.