特権は複数の要因に基づく
XBOX services ユーザーの実効特権は、次の要因に基づきます。- そのユーザーのサブスクリプション権利
- XBOX services へのアクセスに使用されるデバイスの種類
- 現在実行中のアプリ
- そのユーザーのアカウントに適用されるペアレンタル コントロール
- XBOX services の オンラインの安全と適用モデレーター からの入力 (XBOX services の一時停止など)
特権は認証時に計算される
ユーザーの実効特権は、ユーザーがサインインして XBOX services への認可を受けたときに XBOX services によって計算されて発行されます。 ユーザーの特権は、認証時に受信するトークンに含まれます。 特権はトークン クレームで発行されます。XBOX services の特権情報
クライアント アプリがユーザーの特権情報を取得するためには、ユーザーは以下のスクリーンショットのように XBOX services にアクセスする必要があります。ユーザーの特権情報のフロー
- XBOX services クライアント (タイトルまたはアプリの代理として) が、XBOX Security Token Service (XSTS) にトークンを要求します。
- XSTS は要求されたリライング パーティに対してトークンを返します。次に、XSTS は要求内のすべてのユーザーの特権を計算し、トークン クレームを発行します。クライアント アプリからの要求には、次の自動化されたアクションが含まれます。
- アプリは XBOX services を直接呼び出し、要求の認可ヘッダーにトークンを含めます。
- XBOX services は、トークン内の特権に基づいて、要求された機能 (
XPRIVILEGE_MULTIPLAYER_SESSIONSなど) へのアクセスを許可します。
- XBOX services は、トークン内の特権に基づいて、要求された機能 (
- あるいは、アプリは SSO 用に構成されたリライング パーティ サービスを呼び出します。
- サービスは、要求の認可ヘッダーにあるトークンを含めます。
パートナー SSO サービスが XBOX services 機能の実装 (たとえば、
XPRIVILEGE_USER_CREATED_CONTENTなどのダウンロード可能なユーザー作成コンテンツ) を提供する場合、パートナー サービスはトークン内の特権を使用して、要求された機能へのアクセスを許可します。 - XBOX services のトークンを復号化して逆シリアル化するには、パートナー サービスが SSO 用に構成されている必要があります。
- この構成の詳細については、タイトル サービス向け XBOX services 認証 を参照してください。
- サービスは、要求の認可ヘッダーにあるトークンを含めます。
パートナー SSO サービスが XBOX services 機能の実装 (たとえば、
[!NOTE] クライアントは、XBOX プラットフォーム API を使用して、XBOX services への要求を発行する前に、ユーザー体験をカスタマイズし、解決 (アップセル、ペアレンタル オーバーライドなど) を進めることができます。
- アプリは XBOX services を直接呼び出し、要求の認可ヘッダーにトークンを含めます。
- パートナー サービスは、委任された認可トークンを使用して、ユーザーの代理として XBOX services にリクエストを行うことができます。
- リクエストが特定の特権 (
XPRIVILEGE_COMMUNICATIONSなど) を必要とする機能に対するものである場合、パートナー サービスはユーザーの代理として XBOX services 用の委任された認可トークンを取得し、それを要求の認可ヘッダーに含める必要があります。 - XBOX services は、ユーザーの特権に基づいて、要求機能へのアクセスを許可します。
- リクエストが特定の特権 (
ユーザー ID 内の特権
特権はユーザー ID 内の クレーム であり、そのクレームには、次のヘッダー クレームに示すようにユーザーの現在の実効特権のコレクションが含まれます。 特権がコレクション内にある場合、ユーザーは現在、対応する機能へのアクセスを認可されています。 特権がコレクション内にない場合、ユーザーは現在認可されていません。 ユーザーの実効特権は動的で、次のシナリオに依存します。- 期限切れになったサブスクリプション権利
- 現在実行中のアプリ
- 同じクライアント デバイスにサインインしているすべてのアカウント
- クライアント デバイスの状態
- そのユーザーのアカウントに適用されるペアレンタル コントロール
- オンラインの安全と適用モデレーターからの入力 (XBOX services の一時停止など)
ユーザーが特定の時点で機能に対して認可されている場合でも、そのユーザーが後で機能にアクセスすることが認可されていることを保証するものではありません。
