タイトル Web サイト向け XBOX services サインイン

​

認証の概要

• Web サイトまたは Web アプリは、Microsoft アカウントで使用するための ID をプロビジョニングします。
• この登録はパブリッシャーの Microsoft Entra ID で行われます。

1. ユーザーが Web サイトにアクセスするか、アプリを起動します。
2. ユーザーは OAuth2.0 エンドポイント経由で Microsoft アカウントにログインするようにリダイレクトされます。
3. ユーザーは資格情報を正常に入力し、Web サイトまたはアプリが自分に代わって XBOX services 情報にアクセスすることに同意します。
4. Web サイトまたはアプリは認可コードを受け取ります。
5. Web サイトまたはアプリは、認可コードを利用し正しいスコープを要求して、アクセス トークンを要求します。
6. Web サイトまたはアプリはアクセス トークン (および要求した場合はリフレッシュ トークン) を受け取ります。

7. Web サイトまたはアプリはアクセス トークンを使用して、XBOX services ユーザー トークン (U トークン) を要求します。
8. その後、ユーザー トークンを使用して、XBOX Security Token Service (XSTS) から X トークン (アクセス トークン) を取得し、XBOX services またはタイトル サービスにアクセスします。

​

Web サイトの登録

1. Microsoft Entra ID 内でアプリを登録する権限を持つアカウントで Azure Portal にログインします。
2. “App Registration” を選択します。
3. ”+ New Registration” を選択します。
   • このアプリケーションの名前を入力します。
   • “Supported account types” では “Personal Microsoft accounts only” を選択します。
   • 認証が成功した後、認証フローがユーザーをリダイレクトする先のリダイレクト URL を入力します。後で必要になるのでメモしておいてください。 後で追加の URI も追加できます。
   • アプリ登録を完了します。
4. Application (client) ID と Directory (tenant) ID をメモしておきます。
5. Certificates & Secrets を選択します。
   • ”+ New Client Secret” を選択します。
   • 説明を入力します。
   • 有効期限の範囲を選択します。
   • Add をクリックします。
   • 作成されたクライアント シークレット値は後で必要になるのでメモしておいてください。この値はサービス上でのみ安全に使用および保存する必要があります。

​

統合

1. 認可コードを要求して OAuth2.0 フローを開始します:
   • ユーザーを次の URL に誘導します: https://login.microsoftonline.com/consumers/oauth2/v2.0/authorize?client_id=[Application (client) ID from Registration]&response_type=code&redirect_uri=[RedirectUI given during registration]&scope=xboxlive.signin&xboxlive.offline_access この例では、サインイン トークンと、期限切れ後にアクセス トークンをリフレッシュするために使用できるオフライン トークンへのアクセスを要求しています。これにより、正しいアカウント プライバシーおよびアクティビティの通知もユーザーに表示されます。
   • ユーザーが Microsoft アカウントへのログインを完了すると、認可コードが "code=" に続けて追加されたリダイレクト URI にリダイレクトされます。
   • xboxlive.offline_access スコープの使用はオプションで、元のサインイン トークンが期限切れになった後の呼び出しを必要とするシナリオでのみ必要です。この要求では、他の追加スコープを使用できません。
2. 認可コードとアプリケーション登録プロセス中に生成されたクライアント シークレットを使用して Microsoft アカウントのアクセス トークンを引き換えます:
   • 次のプロパティで POST Web 要求を作成します: URL: https://login.microsoftonline.com/consumers/oauth2/v2.0/token Header: Content-Type: application/x-www-form-urlencoded Body:

     client_id=[Application (Client) ID]&code=[Authorization Code received above]&
     redirect_uri=[A redirect UI set in the application]&
     grant_type=authorization_code&client_secret=[Client secret value from application registration]

• サービスからの応答には、次の情報を含む JSON 応答が含まれます: Token Type: Bearer Scope: XboxLive.signin XboxLive.offline_access Expires_in: Value Access_token: [token value] これはアクセス トークンであり、XBOX services と交換して XBOX ユーザー トークンを取得するために使用します。

3. XBOX 認証エンドポイントを呼び出して XBOX ユーザー トークンを要求し、次の要求を完了することで、Microsoft アカウントのアクセス トークンを XBOX ユーザー トークンと交換できます:
   • 次のプロパティで POST Web 要求を作成します: URL: https://user.auth.xboxlive.com/user/authenticate Header: x-xbl-contract-version: 1 Header: content-type: application/json Body: 次のデータを含む適切な形式の JSON ペイロード:

     {
       "RelyingParty": "http://auth.xboxlive.com",
       "TokenType": "JWT",
       "Properties": {
         "AuthMethod": "RPS",
         "SiteName": "user.auth.xboxlive.com",
         "RpsTicket": "d=[Microsoft Account access token received in the last step]"
       }
     }

• サービスからの応答には、XBOX ユーザー トークンを含む次の情報を含む JSON ペイロードが含まれます。次のステップで XBOX ユーザー トークンが必要になります:

     {
       "IssueInstant": "2021-06-08T23:45:50.2531302Z",
       "NotAfter": "2021-06-22T23:45:50.2531302Z",
       "Token": "d=[Xbox User Token]",
       "DisplayClaims": {
       "xui": [
           {
             "uhs": "[USER HASH]"
           }
         ]
       }
     }

4. その後、ユーザー トークンを X トークンと交換できます。ユーザーに代わってサービス間呼び出しを実行したい場合、および DelegationToken クレームやユーザーの XUID が必要な場合は、独自の証明書利用者に対する X トークンを要求し、通常どおりそのトークンを処理して必要なクレームを抽出できます。

   POST https://xsts.auth.xboxlive.com/xsts/authorize HTTP/1.1
   x-xbl-contract-version: 1
   Content-Type: application/json
   Host: xsts.auth.xboxlive.com
   Content-Length: 1425
   Expect: 100-continue
   {
                   "Properties": {
                                   "SandboxId": "XDKS.1",
                                   "UserTokens": ["eyJlbmMiOiJBMTI4Q0JDK0hTMjU2IiwiYWxnIjoiUlN..."]
                   },
                   "RelyingParty": "[Your Relying Party here]",
                   "TokenType": "JWT"
   }