OnlineIdServiceTicketRequest Класс

Определение

Пространство имен:

Windows.Security.Authentication.OnlineId

Предоставляет приложению возможность указать службу и политику, которые используются для проверки подлинности пользователя live, чтобы получить свойства удостоверения и билеты.

Примечание

При разработке для Windows 10 или более поздней версии используйте api Windows.Security.Authentication.Web.Core . Дополнительные сведения см. в разделе Диспетчер учетных записей.

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

Наследование

Object Platform::Object IInspectable OnlineIdServiceTicketRequest

Атрибуты

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Требования к Windows

Семейство устройств	Windows 10 (появилось в 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v1.0)

Примеры

В следующем примере показано, как указать службу и политику, которые используются для проверки подлинности пользователя 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();
                });
}

Конструкторы

OnlineIdServiceTicketRequest(String)	Создает экземпляр класса OnlineIdServiceTicketRequest. Примечание При разработке для Windows 10 или более поздней версии используйте api Windows.Security.Authentication.Web.Core . Дополнительные сведения см. в разделе Диспетчер учетных записей.
OnlineIdServiceTicketRequest(String, String)	Создает экземпляр класса OnlineIdServiceTicketRequest. Примечание При разработке для Windows 10 или более поздней версии используйте api Windows.Security.Authentication.Web.Core . Дополнительные сведения см. в разделе Диспетчер учетных записей.

Свойства

Policy

Политика, используемая для проверки подлинности пользователей. Поддерживаемые значения — JWT, который возвращает данные в формате JSON. Для приложений, запрашивающих согласие пользователя на доступ к хранящимся в Live, разработчик приложений должен передать политику ДЕЛЕГИРОВАНИЯ. Примечание При разработке для Windows 10 или более поздней версии используйте api Windows.Security.Authentication.Web.Core . Дополнительные сведения см. в разделе Диспетчер учетных записей.

Service

Определяет службу, которая используется приложением. Имя службы должно совпадать с DNS-именем, указанным при регистрации приложения в http://go.microsoft.com/fwlink/p/?linkid=241860. Билеты выдаются только для этой службы. Для приложений, запрашивающих согласие пользователя на доступ к хранящимся в Live, необходимо передать предложения, к которым приложению требуется доступ. Список доступных предложений можно найти на нашей странице "Области и разрешения ". Затем билет можно использовать с REST API Live Connect для доступа к данным, которые пользователь предоставил приложению. Дополнительные сведения см. в разделе REST API . Кроме того, приложение может использовать пакет SDK Live Connect, который будет выполнять эти вызовы самостоятельно. Примечание При разработке для Windows 10 или более поздней версии используйте api Windows.Security.Authentication.Web.Core . Дополнительные сведения см. в разделе Диспетчер учетных записей.