beaconauth

beaconauth

使用BeaconAuth模组和自托管认证服务器,为Minecraft服务器提供安全Web、OAuth和通行密钥认证。

基础库

BeaconAuth 为 Minecraft 社区添加了一层安全登录机制。它将 Minecraft 服务器连接到自托管的 BeaconAuth Web 服务,使服务器所有者能够要求模组客户端进行基于 Web 的身份验证,同时保持账户验证清晰、可配置,并处于自己的掌控之下。

功能特性

  • 基于 Web 的 Minecraft 登录流程
  • 通过 BeaconAuth 服务器支持 OAuth 和通行密钥(passkey)
  • 使用 JWT 和 JWKS 的签名会话验证
  • 可配置的服务器端身份验证行为
  • 支持社区管理的 BeaconAuth 账户
  • 本地化的客户端消息
  • Minecraft 模组中不包含第三方分析、广告、遥测或外部文件下载

工作原理

当玩家加入使用 BeaconAuth 的服务器时,模组可以在玩家的浏览器中打开配置的 BeaconAuth 登录页面。登录完成后,模组会将签名的身份验证结果返回给 Minecraft 服务器,并在服务器上根据配置的 BeaconAuth 服务器密钥进行验证。

服务器所有者自行托管并配置自己的 BeaconAuth 服务器 URL。

支持的版本

Minecraft 版本 Fabric Forge NeoForge
1.20.1 是 是 否
1.21.1 是 否 是
1.21.8 是 否 是

请从 Files 标签页安装与你的 Minecraft 版本和加载器相匹配的 jar 文件。

隐私与网络使用

Minecraft 模组会在登录流程中连接到服务器所有者配置的 BeaconAuth 服务器。它不包含广告、分析、遥测或后台文件下载。

客户端可能会在玩家的浏览器中打开配置的 BeaconAuth 网页,并使用临时的本地回调监听器来完成登录流程。

服务器所有者需自行负责其 BeaconAuth 部署、日志、OAuth 提供商配置以及社区隐私声明。

许可证

BeaconAuth 采用 MIT 许可证授权。