跳轉到主要內容
使用本主題來設定您的單一登入 (SSO) 服務 (也稱為信賴憑證者),以與 XBOX 服務權限整合。

必要條件

若要對您的服務強制執行以權限為基礎的存取控制,您必須擁有已針對 XBOX 服務設定 SSO 的服務。 這可讓 XBOX 安全性權杖服務 (XSTS) 發出以您在設定期間提供的公開金鑰加密的權杖。 這稱為設定您的信賴憑證者。 如需詳細資訊,請參閱適用於遊戲服務的 XBOX 服務驗證。

在合作夥伴服務中實作以權限為基礎的存取控制

用戶端應用程式必須使用 HTTP 要求的 “authorization” 標頭,為合作夥伴服務傳送 XSTS 權杖。 在合作夥伴服務解密權杖並驗證權杖的簽章之後,必須擷取權限宣告,並根據服務預期的權限加以驗證。 Game Server 範例是了解如何處理 XSTS 權杖和擷取所含宣告的良好資源。
XBOX 服務權杖可以包含多個使用者身分識別。權杖內的每個使用者身分識別都有權限宣告。
例如,您可以使用合作夥伴配對服務的程式碼,來判斷要求中的每位使用者是否獲授權加入多人遊戲工作階段。

權限的權杖格式

權限會攜帶在權杖每個使用者身分識別的使用者和權限宣告中。 權限宣告包含以空格分隔的整數集合。 每個整數代表一項特定權限。 如果某個值在集合中,表示使用者目前擁有該權限,並獲授權存取對應的功能。 下列程式碼是包含權限宣告的完全解密 JSON Web 權杖範例。

另請參閱

XBOX 服務使用者權限概觀 XBOX 服務使用者權限的用戶端使用
最後修改於 2026年10月8日