Skip to main content
このトピックを参照して、XBOX services の特権と統合するように シングル サインオン (SSO) サービス (リライング パーティとも呼ばれます) を構成してください。

前提条件

サービスに対する特権ベースのアクセス制御を適用するには、XBOX services との SSO 用に構成されたサービスが必要です。 これにより、XBOX Secure Token Service (XSTS) は、構成時に指定する公開鍵で暗号化されたトークンを発行できます。 これを リライング パーティの構成 と呼びます。 詳細については、タイトル サービス向け XBOX services 認証 を参照してください。

パートナー サービスでの特権ベースのアクセス制御の実装

クライアント アプリは、HTTP 要求の “authorization” ヘッダーを使用して、パートナー サービスの XSTS トークンを送信する必要があります。 トークンがパートナー サービスによって復号化され、トークンの署名が検証された後、特権クレームを抽出し、サービスに期待される特権と照合して検証する必要があります。 Game Server サンプルは、XSTS トークンの取り扱いと含まれるクレームの取得の例として役立ちます。
XBOX services のトークンには複数のユーザー ID を含めることができます。トークン内の各ユーザー ID には特権クレームがあります。
たとえば、パートナー マッチメイキング サービスのコードを使用して、リクエスト上の各ユーザーがマルチプレイヤー セッションに参加することが認可されているかどうかを判定できます。

特権のトークン形式

特権は、トークン内の各ユーザー ID のユーザーおよび特権クレームに含まれます。 特権クレームには、スペース区切りの整数のコレクションが含まれます。 各整数は特定の特権を表します。 値がコレクション内にある場合、ユーザーは現在その特権を持っていて、対応する機能へのアクセスが認可されていることを意味します。 以下のコードは、特権クレームを含む完全に復号された JSON Web トークンの例です。

関連項目

XBOX services ユーザー特権の概要 XBOX services ユーザー特権のクライアント側での使用
最終更新日 2026年8月25日