> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XBOX 服務使用者權限的伺服器端處理

> 透過解碼來自信賴憑證者的 XSTS 權杖並讀取每個使用者身分識別的權限宣告，在您的伺服器中強制執行 XBOX 服務權限。

使用本主題來設定您的[單一登入 (SSO) 服務](https://learn.microsoft.com/azure/active-directory/manage-apps/what-is-single-sign-on) (也稱為信賴憑證者)，以與 XBOX 服務權限整合。

## 必要條件

若要對您的服務強制執行以權限為基礎的存取控制，您必須擁有已針對 XBOX 服務設定 SSO 的服務。
這可讓 XBOX 安全性權杖服務 (XSTS) 發出以您在設定期間提供的公開金鑰加密的權杖。
這稱為*設定您的信賴憑證者*。

如需詳細資訊，請參閱[適用於遊戲服務的 XBOX 服務驗證](/zh-TW/services/xbox-services/fundamentals/s2s-auth-calls/service-authentication/live-title-service-authentication)。

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

用戶端應用程式必須使用 HTTP 要求的 "authorization" 標頭，為合作夥伴服務傳送 XSTS 權杖。

在合作夥伴服務解密權杖並驗證權杖的簽章之後，必須擷取權限宣告，並根據服務預期的權限加以驗證。

[Game Server](https://aka.ms/gdkdl) 範例是了解如何處理 XSTS 權杖和擷取所含宣告的良好資源。

<Note>XBOX 服務權杖可以包含多個使用者身分識別。權杖內的每個使用者身分識別都有權限宣告。</Note>

例如，您可以使用合作夥伴配對服務的程式碼，來判斷要求中的每位使用者是否獲授權加入多人遊戲工作階段。

### 權限的權杖格式

權限會攜帶在權杖每個使用者身分識別的使用者和權限宣告中。
權限宣告包含以空格分隔的整數集合。
每個整數代表一項特定權限。

如果某個值在集合中，表示使用者目前擁有該權限，並獲授權存取對應的功能。

下列程式碼是包含權限宣告的完全解密 JSON Web 權杖範例。

```json theme={null}
...
{ "enc":"A128CBC+HS256", ... }.
{ "typ":"JWT", ... }.
{
"aud":"rp://your_relying_party.com/",
"iss":"xsts.auth.xboxLive.com", ...
"cnf":"
{...}",
"xdi":"
{...}",
"xti":"
{...}",
"xui":"
[
{
"xid":"2533274991020393",
"gtg":"SampleGamertag1",
"agg":"Adult",
...,
"prv":"211 212 220 226 227 228 229 230 231 234 237 240 243 244 245 246 247 248 249 251 252 255"
},
{
"xid":"1234574991020397",
"gtg":"SampleGamertag2",
"agg":"Adult",
...,
"prv":"211 212 220 226 227 228 229 230 231 234 237 240 243 244 246 251 252 255"
}
]"
}
...
```

## 另請參閱

[XBOX 服務使用者權限概觀](/zh-TW/services/xbox-services/fundamentals/identity/privileges/live-user-privileges-overview)
[XBOX 服務使用者權限的用戶端使用](/zh-TW/services/xbox-services/fundamentals/identity/privileges/concepts/live-user-privileges-client)


## Related topics

- [XBOX 服務使用者權限](/zh-TW/services/xbox-services/fundamentals/identity/privileges/concepts/live-privileges-concepts-nav.md)
- [XBOX 服務使用者權限的用戶端使用](/zh-TW/services/xbox-services/fundamentals/identity/privileges/concepts/live-user-privileges-client.md)
- [概念](/zh-TW/services/xbox-services/fundamentals/identity/privileges/concepts/index.md)
- [權限](/zh-TW/services/xbox-services/fundamentals/identity/privileges/live-privileges-nav.md)
- [XBOX 服務使用者權限概觀](/zh-TW/services/xbox-services/fundamentals/identity/privileges/live-user-privileges-overview.md)