OnlineIdServiceTicketRequest 클래스

정의

네임스페이스:

Windows.Security.Authentication.OnlineId

앱이 라이브 사용자를 인증하여 ID 속성 및 티켓을 가져오는 데 사용되는 서비스 및 정책을 지정하는 기능을 제공합니다.

참고

Windows 10 이상용으로 개발하는 경우 Windows.Security.Authentication.Web.Core API를 대신 사용합니다. 자세한 내용은 웹 계정 관리자를 참조하세요.

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에서 도입되었습니다.)

예제

다음 예제에서는 라이브 사용자를 인증하는 데 사용되는 서비스 및 정책을 지정하는 방법을 보여줍니다.

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 클래스의 instance 만듭니다. 참고 Windows 10 이상용으로 개발하는 경우 Windows.Security.Authentication.Web.Core API를 대신 사용합니다. 자세한 내용은 웹 계정 관리자를 참조하세요.
OnlineIdServiceTicketRequest(String, String)	OnlineIdServiceTicketRequest 클래스의 instance 만듭니다. 참고 Windows 10 이상용으로 개발하는 경우 Windows.Security.Authentication.Web.Core API를 대신 사용합니다. 자세한 내용은 웹 계정 관리자를 참조하세요.

속성

Policy

사용자를 인증하는 데 사용되는 정책입니다. 지원되는 값은 JSON 형식을 사용하여 데이터를 반환하는 JWT입니다. 라이브에 저장된 액세스에 대한 사용자 동의를 요청하는 앱의 경우 앱 개발자는 DELEGATION 정책을 전달해야 합니다. 참고 Windows 10 이상용으로 개발하는 경우 Windows.Security.Authentication.Web.Core API를 대신 사용합니다. 자세한 내용은 웹 계정 관리자를 참조하세요.

Service

앱에서 사용하는 서비스를 식별합니다. 서비스 이름은 에 http://go.microsoft.com/fwlink/p/?linkid=241860앱을 등록할 때 제공한 DNS 이름과 일치해야 합니다. 티켓은 이 서비스에 대해서만 발급됩니다. Live에 저장된 액세스에 대한 사용자 동의를 요청하는 앱의 경우 앱에 액세스해야 하는 제안을 전달해야 합니다. 사용 가능한 제안 목록은 범위 및 사용 권한 페이지에서 찾을 수 있습니다. 그런 다음 Live Connect REST API와 함께 티켓을 사용하여 사용자가 앱에 제공하기로 동의한 데이터에 액세스할 수 있습니다. 자세한 내용은 REST API 항목을 확인하세요. 또는 앱에서 이러한 호출 자체를 만드는 Live Connect SDK를 사용할 수 있습니다. 참고 Windows 10 이상용으로 개발하는 경우 Windows.Security.Authentication.Web.Core API를 대신 사용합니다. 자세한 내용은 웹 계정 관리자를 참조하세요.