OnlineIdServiceTicketRequest 類別

定義

命名空間:

Windows.Security.Authentication.OnlineId

提供應用程式指定用來驗證 Live 使用者以取得身分識別屬性和票證的服務與原則的功能。

注意

如果您要針對Windows 10或更新版本進行開發，請改用Windows.Security.Authentication.Web.Core API。 如需詳細資訊，請參閱 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

繼承

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或更新版本進行開發，請改用Windows.Security.Authentication.Web.Core API。 如需詳細資訊，請參閱 Web 帳戶管理員。
OnlineIdServiceTicketRequest(String, String)	建立 OnlineIdServiceTicketRequest 類別的實例。 注意 如果您要針對Windows 10或更新版本進行開發，請改用Windows.Security.Authentication.Web.Core API。 如需詳細資訊，請參閱 Web 帳戶管理員。

屬性

Policy

用來驗證使用者的原則。 支援的值為 JWT，其會使用 JSON 格式傳回資料。 對於要求使用者同意存取 Live 的應用程式，應用程式開發人員必須傳遞委派原則。 注意 如果您要針對Windows 10或更新版本進行開發，請改用Windows.Security.Authentication.Web.Core API。 如需詳細資訊，請參閱 Web 帳戶管理員。

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。 如需詳細資訊，請參閱 Web 帳戶管理員。