Zh:Microsoft Authentication Scheme - Revision history

imported>Xiaoyi311: Add Minecraft API Apply

2024-01-24T07:39:10Z

Add Minecraft API Apply

← Older revision		Revision as of 07:39, 24 January 2024
Line 11:		Line 11:
	不论如何，你需要把 <code>XboxLive.signin</code> 包含在认证请求的 <code>scope</code> 参数内，否则下一个终结点会报错。		不论如何，你需要把 <code>XboxLive.signin</code> 包含在认证请求的 <code>scope</code> 参数内，否则下一个终结点会报错。

			<b>请注意</b>：根据 Mojang 发布的 [https://help.minecraft.net/hc/en-us/articles/16254801392141 新Java版游戏服务API审核或应用程序流程] 规定，新建的 OAuth 应用程序必须使用此表单申请使用 Minecraft API 的使用权限，如果您的应用程序没有对应权限 <code>api.minecraftservices.com</code> 将返回 403

	== XBL身份验证 ==		== XBL身份验证 ==

imported>Heipiao at 09:51, 13 January 2023

2023-01-13T09:51:25Z

@@ Line 4: / Line 4: @@
 == 微软OAuth流程 ==
-第一步，我们登入微软账号。这一步必须在浏览器/网页视图中完成！并没有测试其他的重定向链接，客户端id（<code>client_id</code>）被硬编码为(<code>00000000402b5328</code>)，也就是Minecraft这个游戏的id。
+在所有这些步骤之前，你需要先通过创建一个 [https://learn.microsoft.com/zh-cn/azure/active-directory/develop/quickstart-register-app 微软 Azure 应用程序] 来获得一个客户端 ID。你''不''需要获得一个客户端密码。
- https://login.live.com/oauth20_authorize.srf
+你可以通过 [https://learn.microsoft.com/zh-cn/azure/active-directory/develop/v2-oauth2-auth-code-flow OAuth 2.0 授权代码流] 来获取一个访问令牌。你需要向用户显示一个登录页面，一旦完成，会重定向到一个指定的 URL，并在查询参数里传递 token。在非 web 应用程序中这需要通过搭建一个临时 HTTP 服务器来处理这个重定向。如果你不希望这样，可以使用（不那么自动化的）[https://learn.microsoft.com/zh-cn/azure/active-directory/develop/v2-oauth2-device-code 设备代码流] 代替。
-用户需要在此处输入用户名（邮箱、手机号或别的登录方法）以及密码。如果用户名和密码正确，那么用户会被重定向。在这一步中用户不需要拥有MC，那会在之后再检查。
+不论如何，你需要把 <code>XboxLive.signin</code> 包含在认证请求的 <code>scope</code> 参数内，否则下一个终结点会报错。
@@ Line 79: / Line 25: @@
          "AuthMethod": "RPS",
          "SiteName": "user.auth.xboxlive.com",
-         "RpsTicket": "d=<access_token>" // 第二步中获取的访问令牌
+         "RpsTicket": "d=<access_token>" // 第一步中获取的访问令牌
      },
      "RelyingParty": "http://auth.xboxlive.com",

imported>Heipiao: Fix typo

2023-01-13T05:55:02Z

Fix typo

← Older revision		Revision as of 05:55, 13 January 2023
Line 1:		Line 1:
	Minecraft正在迁移至微软账号。自2020年12月起，所有新账号已经使用了新版系统，旧的账号也将在之后迁移，详见[https://www.minecraft.net/en-us/article/java-edition-moving-house 这篇博文]。		Minecraft正在迁移至微软账号。自2020年12月起，所有新账号已经使用了新版系统，旧的账号也将在之后迁移，详见[https://www.minecraft.net/en-us/article/java-edition-moving-house 这篇博文]。

	~~新版系统需要多个步骤以及不同的令牌，但是最后你还是回获得一个普通的Mineceaft令牌。启动游戏本身并没有改变。~~		新版系统需要多个步骤以及不同的令牌，但是最后你还是回获得一个普通的Minecraft令牌。启动游戏本身并没有改变。

	== 微软OAuth流程 ==		== 微软OAuth流程 ==

imported>MangoFanFanw: /* 检查游戏拥有情况 */

2022-12-30T02:07:04Z

检查游戏拥有情况

← Older revision		Revision as of 02:07, 30 December 2022
Line 173:		Line 173:
	GET https://api.minecraftservices.com/entitlements/mcstore		GET https://api.minecraftservices.com/entitlements/mcstore

	访问令牌在验证文件头中：<code>Authorization: Bearer token</code>		访问令牌在验证文件头中：<code>Authorization: Bearer token</code>。请注意，<code>Bearer</code>必须保留，<code>token</code>是上一步获取到的访问令牌。

	如果用户拥有游戏，那么响应会看起来像这样：		如果用户拥有游戏，那么响应会看起来像这样：

imported>Heipiao: /* 获取档案 */

2022-10-28T09:13:19Z

获取档案

← Older revision		Revision as of 09:13, 28 October 2022
Line 261:		Line 261:
	</syntaxhighlight>		</syntaxhighlight>

	~~那么这样就可以知道所有必要的数据（MC访问令牌、用户名和uuid）来启动游戏了。干的漂亮！~~		那么这样就可以知道所有必要的数据（MC访问令牌、用户名和uuid）来启动游戏了。干得漂亮！

	== 示例实现 ==		== 示例实现 ==
	这里有个简易的Java示例实现（使用了javafx和它的webview）：https://github.com/MiniDigger/MiniLauncher/blob/master/launcher/src/main/java/me/minidigger/minecraftlauncher/launcher/gui/MsaFragmentController.java 。		这里有个简易的Java示例实现（使用了javafx和它的webview）：https://github.com/MiniDigger/MiniLauncher/blob/master/launcher/src/main/java/me/minidigger/minecraftlauncher/launcher/gui/MsaFragmentController.java 。

imported>AzurIce: 修改了错误的XBL身份验证请求格式

2022-04-09T04:46:52Z

修改了错误的XBL身份验证请求格式

← Older revision		Revision as of 04:46, 9 April 2022
Line 79:		Line 79:
	"AuthMethod": "RPS",		"AuthMethod": "RPS",
	"SiteName": "user.auth.xboxlive.com",		"SiteName": "user.auth.xboxlive.com",
	"RpsTicket": "access_token" // 第二步中获取的访问令牌		"RpsTicket": "d=<access_token>" // 第二步中获取的访问令牌
	},		},
	"RelyingParty": "http://auth.xboxlive.com",		"RelyingParty": "http://auth.xboxlive.com",

imported>Liumingedwin at 23:52, 30 August 2021

2021-08-30T23:52:26Z

← Older revision		Revision as of 23:52, 30 August 2021
Line 105:		Line 105:
	</syntaxhighlight>		</syntaxhighlight>

	我们需要保存这里的<code>Token</code>和<code>uhs</code>~~。我还没弄明白这里的uhs是啥。（TODO：搞清楚它）~~		我们需要保存这里的<code>Token</code>和<code>uhs</code>。uhs是user hash的缩写，为用户信息哈希值。

	== XSTS身份验证 ==		== XSTS身份验证 ==

imported>Liumingedwin: 增加 refresh_token

2021-08-30T23:50:51Z

增加 refresh_token

@@ Line 53: / Line 53: @@
 </syntaxhighlight>
-我们需要关注到这里的<code>access_token</code>（TODO：看看这里的<code>refresh_token</code>能干什么）
+我们需要关注到这里的<code>access_token</code>
 == XBL身份验证 ==

imported>Kaniol: Created page with "Minecraft正在迁移至微软账号。自2020年12月起，所有新账号已经使用了新版系统，旧的账号也将在之后迁移，详见[https://www.minecraft.net/e..."

2020-12-08T05:02:42Z

Created page with "Minecraft正在迁移至微软账号。自2020年12月起，所有新账号已经使用了新版系统，旧的账号也将在之后迁移，详见[https://www.minecraft.net/e..."

New page

Minecraft正在迁移至微软账号。自2020年12月起，所有新账号已经使用了新版系统，旧的账号也将在之后迁移，详见[https://www.minecraft.net/en-us/article/java-edition-moving-house 这篇博文]。

新版系统需要多个步骤以及不同的令牌，但是最后你还是回获得一个普通的Mineceaft令牌。启动游戏本身并没有改变。

== 微软OAuth流程 ==
[[File:minecraft_login.png|frame|Example of the login page]]

第一步，我们登入微软账号。这一步必须在浏览器/网页视图中完成！并没有测试其他的重定向链接，客户端id（<code>client_id</code>）被硬编码为(<code>00000000402b5328</code>)，也就是Minecraft这个游戏的id。

https://login.live.com/oauth20_authorize.srf
?client_id=00000000402b5328
&response_type=code
&scope=service%3A%3Auser.auth.xboxlive.com%3A%3AMBI_SSL
&redirect_uri=https%3A%2F%2Flogin.live.com%2Foauth20_desktop.srf

用户需要在此处输入用户名（邮箱、手机号或别的登录方法）以及密码。如果用户名和密码正确，那么用户会被重定向。在这一步中用户不需要拥有MC，那会在之后再检查。

重定向链接看起来会像这样：
https://login.live.com/oauth20_desktop.srf?code=codegoeshere&lc=1033

你需要提取出其中的<code>code</code>参数，这是你的微软授权码。

== 授权码 -> 授权令牌 ==

下一步是从授权码中获取授权令牌。由于安全原因，这一步不在浏览器中完成。
POST https://login.live.com/oauth20_token.srf
Content:

<syntaxhighlight lang="java" line='line'>
Map<Object, Object> data = Map.of(
"client_id", "00000000402b5328", // 还是Minecraft客户端id
"code", authcode, // 第一步中获取的代码
"grant_type", "authorization_code",
"redirect_uri", "https://login.live.com/oauth20_desktop.srf",
"scope", "service::user.auth.xboxlive.com::MBI_SSL"
);
</syntaxhighlight>

不要忘记设置<code>Content-Type: application/x-www-form-urlencoded</code>

响应看起来会像这样：

<syntaxhighlight lang="json" line='line'>
{
"token_type":"bearer",
"expires_in":86400,
"scope":"service::user.auth.xboxlive.com::MBI_SSL",
"access_token":"token here",
"refresh_token":"M.R3_BAY.token here",
"user_id":"889ed4a3d844f672",
"foci":"1"
}
</syntaxhighlight>

我们需要关注到这里的<code>access_token</code>（TODO：看看这里的<code>refresh_token</code>能干什么）

== XBL身份验证 ==

现在，我们已通过微软身份验证，可以向xbox live进行身份验证。

我们需要发送：

<syntaxhighlight lang="json" line='line'>
POST https://user.auth.xboxlive.com/user/authenticate
{
"Properties": {
"AuthMethod": "RPS",
"SiteName": "user.auth.xboxlive.com",
"RpsTicket": "access_token" // 第二步中获取的访问令牌
},
"RelyingParty": "http://auth.xboxlive.com",
"TokenType": "JWT"
}
</syntaxhighlight>

同样，也得设置<code>Content-Type: application/json</code>以及<code>Accept: application/json</code>

响应看起来会像这样：

<syntaxhighlight lang="json" line='line'>
{
"IssueInstant":"2020-12-07T19:52:08.4463796Z",
"NotAfter":"2020-12-21T19:52:08.4463796Z",
"Token":"token", // 保存它，这是你的xbl令牌
"DisplayClaims":{
"xui":[
{
"uhs":"uhs" // 保存它
}
]
}
}
</syntaxhighlight>

我们需要保存这里的<code>Token</code>和<code>uhs</code>。我还没弄明白这里的uhs是啥。（TODO：搞清楚它）

== XSTS身份验证 ==

现在，我们已经通过XBL进行了身份验证，我们需要获取XSTS令牌，我们可以使用它来登录Minecraft。

<syntaxhighlight lang="json" line='line'>
POST https://xsts.auth.xboxlive.com/xsts/authorize
{
"Properties": {
"SandboxId": "RETAIL",
"UserTokens": [
"xbl_token" // from above
]
},
"RelyingParty": "rp://api.minecraftservices.com/",
"TokenType": "JWT"
}
</syntaxhighlight>

同样还是设置<code>Content-Type: application/json</code>以及<code>Accept: application/json</code>

响应看起来会像这样：

<syntaxhighlight lang="json" line='line'>
{
"IssueInstant":"2020-12-07T19:52:09.2345095Z",
"NotAfter":"2020-12-08T11:52:09.2345095Z",
"Token":"token", // 保存它，这是你的xsts令牌
"DisplayClaims":{
"xui":[
{
"uhs":"" // 与上个请求相同
}
]
}
}
</syntaxhighlight>

== Minecraft身份验证 ==

现在，我们终于可以回到Minecraft身上了，上一各请求中获取的XSTS令牌允许我们验证Minecraft。

<syntaxhighlight lang="json" line='line'>
POST https://api.minecraftservices.com/authentication/login_with_xbox
{
"identityToken": "XBL3.0 x=<uhs>;<xsts_token>"
}
</syntaxhighlight>

响应：
<syntaxhighlight lang="json" line='line'>
{
"username" : "some uuid", // 这并不是账号的uuid
"roles" : [ ],
"access_token" : "minecraft access token", // jwt，你的老朋友Minecraft访问令牌
"token_type" : "Bearer",
"expires_in" : 86400
}
</syntaxhighlight>

这个访问令牌（<code>access_token</code>）允许我们启动游戏，但是，我们甚至还没有检查该账号是否拥有游戏。之前我们做的所有工作都是与微软账号进行的！

== 检查游戏拥有情况 ==

那么现在让我们使用MC的访问令牌来检查该账号是否包含产品许可。
GET https://api.minecraftservices.com/entitlements/mcstore

访问令牌在验证文件头中：<code>Authorization: Bearer token</code>

如果用户拥有游戏，那么响应会看起来像这样：

<syntaxhighlight lang="json" line='line'>
{
"items" : [ {
"name" : "product_minecraft",
"signature" : "jwt sig"
}, {
"name" : "game_minecraft",
"signature" : "jwt sig"
} ],
"signature" : "jwt sig",
"keyId" : "1"
}
</syntaxhighlight>

第一个jwts会包含值：
<syntaxhighlight lang="json" line='line'>
{
"typ": "JWT",
"alg": "RS256",
"kid": "1"
}.{
"signerId": "2535416586892404",
"name": "product_minecraft"
}.[Signature]
</syntaxhighlight>

最后一个jwt看起来是这样解码的：

<syntaxhighlight lang="json" line='line'>
{
"typ": "JWT",
"alg": "RS256",
"kid": "1"
}.{
"entitlements": [
{
"name": "product_minecraft"
},
{
"name": "game_minecraft"
}
],
"signerId": "2535416586892404"
}.[Signature]
</syntaxhighlight>

如果该账号没有拥有游戏，那么项目为空。

== 获取档案 ==

现在我们知道了该账号拥有游戏，那么可以获取他的档案来得到uuid：
GET https://api.minecraftservices.com/minecraft/profile

同样，访问令牌在验证文件头中：<code>Authorization: Bearer token</code>

如果账号拥有游戏，响应看起来会像这样：

<syntaxhighlight lang="json" line='line'>
{
"id" : "986dec87b7ec47ff89ff033fdb95c4b5", // 账号的真实uuid
"name" : "HowDoesAuthWork", // 该账号的mc用户名
"skins" : [ {
"id" : "6a6e65e5-76dd-4c3c-a625-162924514568",
"state" : "ACTIVE",
"url" : "http://textures.minecraft.net/texture/1a4af718455d4aab528e7a61f86fa25e6a369d1768dcb13f7df319a713eb810b",
"variant" : "CLASSIC",
"alias" : "STEVE"
} ],
"capes" : [ ]
}
</syntaxhighlight>

否则会看起来像这样：

<syntaxhighlight lang="json" line='line'>
{
"path" : "/minecraft/profile",
"errorType" : "NOT_FOUND",
"error" : "NOT_FOUND",
"errorMessage" : "The server has not found anything matching the request URI",
"developerMessage" : "The server has not found anything matching the request URI"
}
</syntaxhighlight>

那么这样就可以知道所有必要的数据（MC访问令牌、用户名和uuid）来启动游戏了。干的漂亮！

== 示例实现 ==
这里有个简易的Java示例实现（使用了javafx和它的webview）：https://github.com/MiniDigger/MiniLauncher/blob/master/launcher/src/main/java/me/minidigger/minecraftlauncher/launcher/gui/MsaFragmentController.java 。