简易认证本地会话

简易认证本地会话

一个用于 Minecraft 1.20.1 Fabric 的补丁(mixin)模组,为 NikitaCartes 的 EasyAuth 模组添加本地存储的会话以实现自动授权,从而为离线玩家提供无需密码的无缝登录。

工具

一个适用于 Minecraft 1.20.1 Fabric 的补丁(mixin)模组,为 NikitaCartes 的 EasyAuth 模组添加本地存储的会话以实现自动授权,从而为离线玩家提供无需密码的无缝登录。

功能

  • 客户端:根据服务器请求进行无缝授权
  • 客户端:首次使用密码认证后存储生成的授权令牌
  • 客户端:如果服务器不接受授权令牌(例如服务器未安装此补丁或授权令牌无效),则回退到常规行为
  • 客户端:本地存储的授权令牌使用由玩家 UUID 和服务器 IP 地址派生的密钥进行加密(AES-GCM-256)
  • 客户端:授权令牌通过哈希派生密钥得到进一步保护,以防设备上的恶意软件
  • 服务端:生成的授权令牌经过哈希处理,以减轻文件系统泄露攻击

客户端保存的授权令牌(针对你加入的服务器)存储在 config/EasyAuthLocalSessions-client/ 目录中

服务端保存的授权令牌(针对加入你服务器的玩家)存储在 EasyAuth/EasyAuthLocalSessions-server 中

安装

服务端:

  1. 将此模组下载到服务器
  2. (可选但强烈推荐!)在 config/EasyAuth/main.conf 中将 session-timeout 设置为 -1 以禁用 IP 授权(这种方式不安全,且使用此模组后不再需要)

客户端:

出于显而易见的原因,不要将此模组安装到访客电脑上,离开时请键入 /logout

  1. 将此模组下载到客户端
  2. 加入服务器并首次也是唯一一次使用密码登录
  3. 从此以后,每次你加入服务器(且服务器提示授权)时,模组都会静默发送授权令牌
  4. 如果你想停止此行为,请在你想登出的服务器上键入 /logout
  5. 如果你认为你的授权令牌已泄露,更改密码 会撤销你账号在服务器上的所有授权令牌

重要注意事项:

  • 本地存储的授权令牌与确切的服务器地址(参见 issue #1)以及玩家 UUID(离线玩家由 名称派生)绑定
  • 如果服务器更改了 IP 地址、端口、域名,你将需要重新授权。即使你加入 example.org:25565 而不是 example.org,它也会被视为具有独立令牌的独立服务器( 参见 issue #1)。反之, 如果有人在相同的域名或 IP 地址下托管服务器,模组会将授权令牌发送给它, 该令牌随后可能被用于重放攻击。 参见 issue #2