Zh:Authentication - Revision history

imported>Kaniol at 09:30, 11 November 2019

2019-11-11T09:30:51Z

← Older revision		Revision as of 09:30, 11 November 2019
Line 1:		Line 1:
	Minecraft 1.6引入了一种全新的叫作'''Yggdrasil'''的认证方案，它彻底地取代了[[ZH:~~旧版认证~~\|先前的认证系统]]。Mojang的其他游戏，Scrolls，同样也使用了该认证方法。Mojang曾经说过[https://twitter.com/KrisJelbring/status/453573406341206016 每个人都应使用此认证系统来进行自定义登录]，但是[https://twitter.com/KrisJelbring/status/461390585086361600 永远不会从用户收集凭据]。		Minecraft 1.6引入了一种全新的叫作'''Yggdrasil'''的认证方案，它彻底地取代了[[ZH:Legacy Authentication\|先前的认证系统]]。Mojang的其他游戏，Scrolls，同样也使用了该认证方法。Mojang曾经说过[https://twitter.com/KrisJelbring/status/453573406341206016 每个人都应使用此认证系统来进行自定义登录]，但是[https://twitter.com/KrisJelbring/status/461390585086361600 永远不会从用户收集凭据]。

	== 请求格式 ==		== 请求格式 ==

imported>Kaniol: 暴力更新不可取

2019-11-11T09:30:03Z

暴力更新不可取

Show changes

imported>Hempflower: /* 错误 */

2019-11-06T02:20:50Z

错误

← Older revision		Revision as of 02:20, 6 November 2019
Line 43:		Line 43:
	\|-		\|-
	\| <code>Method Not Allowed</code>		\| <code>Method Not Allowed</code>
			\|
	\| 请求所使用的方法不允许访问当前URI，这里通常是由于非POST方法引起的。		\| 请求所使用的方法不允许访问当前URI，这里通常是由于非POST方法引起的。
			\|
	\|-		\|-
	\| <code>Not Found</code>		\| <code>Not Found</code>
	\|		\|
	\| 服务器没有找到URI所对应的资源		\| 服务器没有找到URI所对应的资源
			\|
	\|-		\|-
	\| <code>ForbiddenOperationException</code>		\| <code>ForbiddenOperationException</code>

imported>Hempflower at 02:17, 6 November 2019

2019-11-06T02:17:35Z

Show changes

imported>Kaniol: Kaniol moved page ZH:认证 to ZH:Authentication

2019-09-30T22:08:56Z

Kaniol moved page ZH:认证 to ZH:Authentication

← Older revision	Revision as of 22:08, 30 September 2019
(No difference)

imported>Kaniol: /* 错误 */

2019-09-30T17:58:28Z

错误

← Older revision		Revision as of 17:58, 30 September 2019
Line 36:		Line 36:
	{\| class="wikitable"		{\| class="wikitable"
	\|-		\|-
	! ~~Error~~		! 错误
	! ~~Cause~~		! 原因
	! ~~Error message~~		! 错误信息
	! ~~Notes~~		! 注释
	\|-		\|-
	\| <code>Method Not Allowed</code>		\| <code>Method Not Allowed</code>

imported>Kaniol at 15:57, 30 September 2019

2019-09-30T15:57:43Z

← Older revision		Revision as of 15:57, 30 September 2019
Line 49:		Line 49:
	\|		\|
	\| The server has not found anything matching the request URI<br/>服务器未找到与请求URI匹配的任何内容		\| The server has not found anything matching the request URI<br/>服务器未找到与请求URI匹配的任何内容
	\| ~~调用了不存在的后缀。~~		\| 调用了不存在的端点。
	\|-		\|-
	\| <code>ForbiddenOperationException</code>		\| <code>ForbiddenOperationException</code>
Line 96:		Line 96:
	使用密码认证用户。		使用密码认证用户。

	=== 后缀 ===		=== 端点 ===

	/authenticate		/authenticate
Line 160:		Line 160:
	有一些实例曾观察到Mojang对于旧版账号失败的刷新请求返回了一个平坦的<code>null</code>。还不清楚什么实际错误绑定了这个空响应，而且它极为罕见，但作为实现应该注意对该响应的空输出。		有一些实例曾观察到Mojang对于旧版账号失败的刷新请求返回了一个平坦的<code>null</code>。还不清楚什么实际错误绑定了这个空响应，而且它极为罕见，但作为实现应该注意对该响应的空输出。

	~~这个后缀是严格速率限制的：短时间内同一账号的多次~~<code>/authenticate</code>请求（例如在几秒内3次请求），即使密码正确也会导致一个<code>Invalid credentials.</code>响应。该错误会在几秒后被清除。		这个端点是严格速率限制的：短时间内同一账号的多次<code>/authenticate</code>请求（例如在几秒内3次请求），即使密码正确也会导致一个<code>Invalid credentials.</code>响应。该错误会在几秒后被清除。

	== 刷新 ==		== 刷新 ==
Line 166:		Line 166:
	刷新一个有效的<code>accessToken</code>。它可以用于在游戏会话间保持登录状态，这优于在文件中保存用户的密码（见[[ZH:lastlogin\|lastlogin]]）。		刷新一个有效的<code>accessToken</code>。它可以用于在游戏会话间保持登录状态，这优于在文件中保存用户的密码（见[[ZH:lastlogin\|lastlogin]]）。

	=== 后缀 ===		=== 端点 ===

	/refresh		/refresh
Line 215:		Line 215:
	== 验证 ==		== 验证 ==

	检查<code>accessToken</code>是否可用于Minecraft服务器的认证。Minecraft启动器（自1.6.~~13版本起）会在启动器调用此后缀来验证保存的令牌是否仍然可用，并会在返回错误时调用~~<code>/refresh</code>。		检查<code>accessToken</code>是否可用于Minecraft服务器的认证。Minecraft启动器（自1.6.13版本起）会在启动器调用此端点来验证保存的令牌是否仍然可用，并会在返回错误时调用<code>/refresh</code>。

	请注意<code>accessToken</code>可能会不可用与Minecraft服务器的认证，而对于<code>/refresh</code>来说足够可用。这主要会发生在一个人使用了另一个客户端（如在别的PC上使用相同的帐号游玩了Minecraft）。看起来只有给定帐号最新获得的<code>accessToken</code>才能可靠地用于认证（第二新的令牌看起来也仍然有效，但请不要依赖它）。		请注意<code>accessToken</code>可能会不可用与Minecraft服务器的认证，而对于<code>/refresh</code>来说足够可用。这主要会发生在一个人使用了另一个客户端（如在别的PC上使用相同的帐号游玩了Minecraft）。看起来只有给定帐号最新获得的<code>accessToken</code>才能可靠地用于认证（第二新的令牌看起来也仍然有效，但请不要依赖它）。
Line 221:		Line 221:
	<code>/validate</code>可以在有或没有<code>clientToken</code>时调用。如果提供了<code>clientToken</code>，它应当与获取<code>accessToken</code>的那个相匹配。Minecraft启动器会向<code>/validate</code>发送<code>clientToken</code>。		<code>/validate</code>可以在有或没有<code>clientToken</code>时调用。如果提供了<code>clientToken</code>，它应当与获取<code>accessToken</code>的那个相匹配。Minecraft启动器会向<code>/validate</code>发送<code>clientToken</code>。

	=== 后缀 ===		=== 端点 ===

	/validate		/validate
Line 242:		Line 242:
	使用帐号的用户名和密码使<code>accessToken</code>失效。		使用帐号的用户名和密码使<code>accessToken</code>失效。

	=== 后缀 ===		=== 端点 ===

	/signout		/signout
Line 263:		Line 263:
	使用client/access令牌对使<code>accessToken</code>失效。		使用client/access令牌对使<code>accessToken</code>失效。

	=== 后缀 ===		=== 端点 ===

	/invalidate		/invalidate

imported>Kaniol at 15:39, 30 September 2019

2019-09-30T15:39:43Z

Show changes

imported>Kaniol: Created page with "Minecraft 1.6引入了一种全新的叫作'''Yggdrasil'''的认证方案，它彻底地取代了先前的认证系统。Mojang的其他游戏，Scrolls，..."

2019-09-30T15:13:36Z

Created page with "Minecraft 1.6引入了一种全新的叫作'''Yggdrasil'''的认证方案，它彻底地取代了先前的认证系统。Mojang的其他游戏，Scrolls，..."

New page

Minecraft 1.6引入了一种全新的叫作'''Yggdrasil'''的认证方案，它彻底地取代了[[ZH:旧版认证|先前的认证系统]]。Mojang的其他游戏，Scrolls，同样也使用了该认证方法。Mojang曾经说过[https://twitter.com/KrisJelbring/status/453573406341206016 每个人都应使用此认证系统来进行自定义登录]，但是[https://twitter.com/KrisJelbring/status/461390585086361600 永远不会从用户收集凭据]。

== 请求格式 ==
所有对Yggdrasil的请求都会发送到以下服务器：

https://authserver.mojang.com

此外，它们应满足以下规则：

* 为<code>POST</code>请求
* <code>Content-Type</code>头设置为<code>application/json</code>
* 以包含[[wikipedia:zh:JSON|JSON]]编码的字典作为负载

如果请求成功，服务器将响应：

* 状态码<code>200</code>
* 根据以下规范使用[[wikipedia:zh:JSON|JSON]]编码的字典

但如果请求失败，服务器会响应：

* 适当的非200[[wikipedia:zh:HTTP状态码|HTTP状态码]]
* 拥有以下格式的[[wikipedia:zh:JSON|JSON]]编码的字典：

<syntaxhighlight lang="javascript">
{
"error": "Short description of the error",
"errorMessage": "Longer description which can be shown to the user",
"cause": "Cause of the error" // 可选的
}
</syntaxhighlight>

== 错误 ==

这些是可能遇到的一些错误：

{| class="wikitable"
|-
! Error
! Cause
! Error message
! Notes
|-
| <code>Method Not Allowed</code>
|
| The method specified in the request is not allowed for the resource identified by the request URI
| Something other than a POST request was received.
|-
| <code>Not Found</code>
|
| The server has not found anything matching the request URI
| Non-existing endpoint was called.
|-
| <code>ForbiddenOperationException</code>
| <code>UserMigratedException</code>
| Invalid credentials. Account migrated, use e-mail as username.
|
|-
| <code>ForbiddenOperationException</code>
|
| Invalid credentials. Invalid username or password.
|
|-
| <code>ForbiddenOperationException</code>
|
| Invalid credentials.
| Too many login attempts with this username recently (see <code>/authenticate</code>). Note that username and password may still be valid!
|-
| <code>ForbiddenOperationException</code>
|
| Invalid token.
| <code>accessToken</code> was invalid.
|-
| <code>IllegalArgumentException</code>
|
| Access token already has a profile assigned.
| Selecting profiles isn't implemented yet.
|-
| <code>IllegalArgumentException</code>
|
| credentials is null
| Username/password was not submitted.
|-
| <code>IllegalArgumentException</code>
|
| Invalid salt version
| ???
|-
| <code>Unsupported Media Type</code>
|
| The server is refusing to service the request because the entity of the request is in a format not supported by the requested resource for the requested method
| Data was not submitted as application/json
|}

== 认证 ==

通过密码认证用户。

=== 后缀 ===

/authenticate

=== 负载 ===

<syntaxhighlight lang="javascript">
{
"agent": { // 默认为Minecraft
"name": "Minecraft", // 对于Mojang的其他游戏Scrolls，则应该使用"Scrolls"
"version": 1 // 以后的原版客户端
// 可能会增加该数字
},
"username": "mojang account name", // 可以是电子邮箱地址或
// 玩家名称（对于为迁移的账号）
"password": "mojang account password",
"clientToken": "client identifier", // 可选的
"requestUser": true // 可选的，默认为false，若为true则将user对象加入到响应中
}
</syntaxhighlight>

<code>clientToken</code>应该是一个随机生成的标识符而且必须每次请求都是相同的。原版启动器会在第一次运行时生成一个随机的（v4）UUID并保存，在后续每次请求中复用它。如果省略，那么服务器会生成一个基于Java的[http://docs.oracle.com/javase/7/docs/api/java/util/UUID.html#toString() <code>UUID.toString()</code>]的随机令牌，它应该由客户端保存下来。然而这也会使用户之前在所有客户端上获取的<code>accessToken</code>失效。

=== 响应 ===

<syntaxhighlight lang="javascript">
{
"accessToken": "random access token", // 十六进制
"clientToken": "client identifier", // 与接收到的相同
"availableProfiles": [ // 仅在接收到agent字段时出现
{
"id": "profile identifier", // 十六进制
"name": "player name",
"legacy": true or false // 事实上它仅为true时出现。默认为false。
}
],
"selectedProfile": { // 仅在接收到agent字段时出现
"id": "uuid without dashes",
"name": "player name",
"legacy": true or false
},
"user": { // 仅在请求负载中的requestUser为true出现
"id": "user identifier", // 十六进制
"properties": [
{
"name": "preferredLanguage", // 也许不会对所有账号显示
"value": "en" // Java locale格式（https://docs.oracle.com/javase/8/docs/api/java/util/Locale.html#toString--）
},
{
"name": "twitch_access_token", // 仅在关联twitch账号时出现（见https://account.mojang.com/me/settings）
"value": "twitch oauth token" // OAuth 2.0令牌，字母+数字，如https://api.twitch.tv/kraken?oauth_token=[...]
// Twitch API的文档：https://github.com/justintv/Twitch-API
}
]
}
}
</syntaxhighlight>

'''注意：'''如果用户希望能在他们的电脑上保存登录状态，那么强烈建议应该存储<code>accessToken</code>而不是密码本身。

当前每个账号只拥有一个档案，一个账号拥有多个档案还在未来计划中。如果用户尝试登入一个没有附加Minecraft许可的Mojang账号，那么认证将会成功，但是响应将不包含<code>selectedProfile</code>字段，而且<code>availableProfiles</code>数组也是空的。

有一些实例曾观察到Mojang对于旧版账号失败的刷新请求返回了一个平坦的<code>null</code>。还不清楚什么实际错误绑定了这个空响应，而且它极为罕见，但作为实现应该注意对该响应的空输出。

这个后缀是严格速率限制的：短时间内同一账号的多次<code>/authenticate</code>请求（例如在几秒内3次请求），即使密码正确也会导致一个<code>Invalid credentials.</code>响应。该错误会在几秒后被清除。

== 刷新 ==

刷新一个有效的<code>accessToken</code>。它可以用于在游戏会话间保持登录状态，这优于在文件中保存用户的密码（见[[ZH:lastlogin|lastlogin]]）。

=== 后缀 ===

/refresh

=== 负载 ===
<syntaxhighlight lang="javascript">
{
"accessToken": "valid accessToken",
"clientToken": "client identifier", // 这需要与第一处用来获取
// accessToken的那个相同
"selectedProfile": { // 可选的，发送它将导致错误
"id": "profile identifier", // 十六进制
"name": "player name"
},
"requestUser": true // 可选的，默认为false，若为true则将user对象加入到响应中
}
</syntaxhighlight>

注意：提供的<code>accessToken</code>将失效。

=== 响应 ===

<syntaxhighlight lang="javascript">
{
"accessToken": "random access token", // 十六进制
"clientToken": "client identifier", // 与接收到的相同
"selectedProfile": {
"id": "profile identifier", // 十六进制
"name": "player name"
},
"user": { // 仅在请求负载中的requestUser为true出现
"id": "user identifier", // 十六进制
"properties": [
{
"name": "preferredLanguage", // 也许不会对所有账号显示
"value": "en" // Java locale格式（https://docs.oracle.com/javase/8/docs/api/java/util/Locale.html#toString--）
},
{
"name": "twitch_access_token", // 仅在关联twitch账号时出现（见https://account.mojang.com/me/settings）
"value": "twitch oauth token" // OAuth 2.0令牌，字母+数字，如https://api.twitch.tv/kraken?oauth_token=[...]
// Twitch API的文档：https://github.com/justintv/Twitch-API
}
]
}
}
</syntaxhighlight>

== 验证 ==

检查<code>accessToken</code>是否可用于Minecraft服务器的认证。Minecraft启动器（自1.6.13版本起）会在启动器调用此后缀来验证保存的令牌是否仍然可用，并会在返回错误时调用<code>/refresh</code>。

请注意<code>accessToken</code>可能会不可用与Minecraft服务器的认证，而对于<code>/refresh</code>来说足够可用。这主要会发生在一个人使用了另一个客户端（如在别的PC上使用相同的帐号游玩了Minecraft）。看起来只有给定帐号最新获得的<code>accessToken</code>才能可靠地用于认证（第二新的令牌看起来也仍然有效，但请不要依赖它）。

<code>/validate</code>可以在有或没有<code>clientToken</code>时调用。如果提供了<code>clientToken</code>，它应当与获取<code>accessToken</code>的那个相匹配。Minecraft启动器会向<code>/validate</code>发送<code>clientToken</code>。

=== 后缀 ===

/validate

=== 负载 ===

<syntaxhighlight lang="javascript">
{
"accessToken": "valid accessToken",
"clientToken": "associated clientToken" // 可选的，见上
}
</syntaxhighlight>

=== 响应 ===

若成功返回空响应（<code>204 No Content</code>），否则返回错误JSON和状态码<code>403 Forbidden</code>。

== 登出 ==

使用帐号的用户名和密码使<code>accessToken</code>失效。

=== 后缀 ===

/signout

=== 负载 ===

<syntaxhighlight lang="javascript">
{
"username": "mojang account name",
"password": "mojang account password"
}
</syntaxhighlight>

=== 响应 ===

若成功返回一个空负载。

== 使失效 ==

使用client/access令牌对使<code>accessToken</code>失效。

=== 后缀 ===

/invalidate

=== 负载 ===

<syntaxhighlight lang="javascript">
{
"accessToken": "valid accessToken",
"clientToken": "client identifier" // 这需要与第一处用来获取
// accessToken的那个相同
}
</syntaxhighlight>

=== 响应 ===

若成功返回一个空负载。

== 加入服务器 ==

见[[ZH:协议加密#认证|协议加密#认证]]

[[Category:ZH:协议细节]]
[[Category:ZH:Minecraft Modern]]