xAuth v2.6.x
适用于 Bukkit 服务器的认证插件
简介
xAuth 是一款双因素身份验证插件,可用于保护服务器上玩家账号的安全。随着插件功能的不断演进,其发展方向和主要用途已扩展至更多可能性。例如,如果你运营一个社区论坛,借助 xAuth,玩家可以使用论坛账号或基于网页的账户管理系统进行登录认证。此外,还可以从外部数据库获取凭据。
重要通知
在升级之前,请阅读 xAuth 文档(外部链接)。我已在我的 Confluence 实例上添加了文档,并将随时间持续更新。权限节点(Permissions Node)已更改!如果你遇到“命令受限”提示,很可能是因为你未查阅发布日志。
更多操作说明请参阅该文档。
概念
本防护插件的基本理念是允许玩家基于用户名和密码(可选邮箱地址)注册账号。当已注册的玩家连接服务器时,系统会提示其通过登录进行身份验证。只有在提供有效密码的情况下,玩家才能重新获得对其账号的完全控制权,直至会话过期。
权限说明(必读)
此插件具备阻止访客(Guests)和已注册的 xAuth 玩家执行几乎所有操作(包括命令执行)的能力。它不使用否定型权限(negated permissions),以避免与现有插件产生冲突。权限状态分为“允许(allowed)”或“受限(restricted)”。
重要提示:
若要限制已注册的 xAuth 玩家执行的某些操作,你需要显式地对其进行限制,因为 xAuth 玩家被视为可信用户。这与访客不同,访客在未设置默认值时默认为“受限”,因为访客属于未知状态。访客相关的权限节点只能通过配置文件设置,并且即使你拥有执行任何命令的权限,访客节点的设置也具有最终决定权。
请注意,若要阻止管理员命令,你需要通过 xauth.restrict.player.command.xauth.* 进行限制,或将每个命令添加到相应的组中。
这可能在初期令人困惑,但有其优势,因为你可以通过权限节点而非项目符号直观地查看某项权限是被限制还是允许。更多详情可参见 权限系统页面
功能特性
- 在注册/登录前,玩家无法:
- 聊天、执行命令、与物体交互(如拉杆或箱子)、移动或拾取物品
- 破坏或放置方块
- 受到伤害或造成伤害、被敌对生物锁定(跟随)
- 背包与位置保护
- 命令自动补全功能,包含配置节点浏览器!
- 深入的设置与消息配置
- 支持跨服务器重启的持久化登录会话
- 玩家名称过滤与密码复杂度配置
- 可在配置的时间后踢出未登录(但已注册)的玩家
- 细粒度的 权限系统,允许你进一步限制交互或命令
- 支持 PermissionsEx、Bukkit、GroupManager 等权限插件
- 在配置次数内多次登录失败后,踢出玩家或暂时封锁其 IP 地址
- 自定义且高度安全的密码哈希算法
- 使用 /login <password> 进行登录认证
- 支持 H2 / MySQL 数据库存储
- 通过 URL 进行认证(AuthURL),可连接论坛或网站数据库
- 自动更新器(感谢 Gravity 提供支持)
新闻
有关详细信息,请查看 新闻与即将变更的内容 页面。
维基(Wiki)
维基托管在 GitHub 上。
请访问
GitHub 项目页面 并点击 Wiki
致谢
所有荣誉归于 Bukkit 论坛上的 CypherX,是他创建了这款插件。感谢他的辛勤工作与长期支持!
旧的 Bukkit 讨论帖可在此处找到:这里
联系方式
如需关于此插件的帮助,请使用导航栏中的问题反馈链接,或通过私信联系我。
xAuth v2.6.x
Authentication plugin for bukkit powered servers
About
xAuth is a second-factor authentication plugin that can be used to secure player accounts on your server. As the plugin has been enhanced over time, the direction and main purpose have expanded to new possibilities. Let's say you run a community page. With xAuth, players can authenticate using their forum accounts or using a web-driven account management system. It is also possible to get the credentials from a foreign database.
Important Notice
Before upgrading please read xAuth Documentation (external link). I have added documenation to my Confluence instance that will be updated over time. Permissions Node changed! If you get "command is restricted" you most likely did not check the release log.
Further Instructions can be found there.
Concept
The basic idea of this protection plugin is allowing players to register an account based on their player name and a supplied password and optionally their email-address. When a registered player connects to the server, that player will be prompted to authenticate his or herself by logging in. If and only if a valid password is supplied, they will regain full control of their account until their session expires.
Permissions (READ ME)
This plugin has the ability to block almost any action (including command execution) for guests and registered xauth players. It also does not use negated permissions in order to not interfere with existing plugins. Permissions are "allowed" or "restricted".
Important-Note:
In order to restrict certain actions executed by registered xauth players you need to restrict them since xauth players are trusted. This is different from guests since the default for guests is always "restrict" if not set since a guest is an unknown state. Guest nodes can also only be set via configuration and have the last say even if you might have the right to execute any command.
Please keep in mind in order to block admin commands you need to restrict them via xauth.restrict.player.command.xauth.* or add each command to a group.
This might be confusing at first but has its cons since you always can see if a permission is restricted or allowed via permission node and not via bullet point. More details can be found on page Permission-System
Features
- Before registering/logging in, players can't:
- Chat, execute commands, interact with objects (like levers or chests), move or pickup items
- Break or place blocks
- Receive or give damage, be targeted (followed) by hostile mobs
- Inventory and location protection
- Command TabCompletion including Configuration Node Browser!
- In-depth setting and message configuration
- Persistent login session through server restarts
- Player name filter and password complexity configuration
- Kick non-logged in (but registered) players after a configureable amount of time
- Fine graded Permission System that also allows you to block interactions or commands
- Permissions support (PermissionsEx, Bukkit, GroupManager)
- Kick or temporarily lockout the IP address of a player who fials to log in after a configureable amount of tries
- Custom, highly secure password hashing
- Authenticate yourself with /login <password>
- H2 / mySQL Database storage supported
- Authentication over URL (AuthURL) allows for connection to forum or website databases
- Auto-Updater (thanks to Gravity)
News
Checkout the News & Upcoming-Changes page for details.
Wiki
The Wiki is located on github.
Please visit the
Github Project-Page and click on Wiki
Credits
All credits goes to CypherX from bukkit forums who created this plugin. Thanks for your work and long time support!
The old bukkit-thread can be found here
Contact
If you need help regarding the plugin please use the Issue Link in the navigation bar or contact me via private message.
评论 0
登录后参与评分
还没有评论,来抢沙发吧