NotEnoughAuth [OAuth: Google, Discord, Telegram and more]

插件

· 作者 MrQuackDuck

适用于 Minecraft Paper 的插件(1.21.7+),支持 OAuth 认证,允许玩家通过多种提供商登录/注册 [Google、GitHub、GitLab、Discord、Twitch、Telegram]。

0 本站下载 0 关注 更新于 6 个月前

最新 1.0 · 26.1.2 · Paper / Purpur

一键开服(送7天)

NotEnoughAuth 是一个适用于 Paper (1.21.7+) 的插件,它允许你基于 Dialog 功能,使用 OAuth2 提供商(Google、GitHub、GitLab、Discord、Twitch、Telegram)来验证玩家身份。

设置方法 —— 请向下滚动至 ? 配置 部分。

? 截图

* 在验证过程中,你将看到“正在加入世界...”界面。
* 验证成功后,在显示“正在加入世界...”界面后,你将自动被重定向到服务器。

? 工作原理?

每个玩家会话都有一个描述客户端状态的哈希值,每次玩家加入时都会与数据库(data.yml)进行比对。
如果会话匹配——则允许进入服务器。如果不匹配,则强制进行身份验证。

会话哈希由多个因素组成:

? 命令

  • /link — 打开对话框,将额外的 OAuth2 提供商链接到你的账户。
  • /unlink — 打开对话框,从你的账户中取消链接 OAuth2 提供商。
  • /logout — 终止当前的会话哈希,下次加入时需要重新验证。
  • /auth info — 查看可用命令列表。
  • /auth reload — 重载插件。

别名:/nea、/notenoughauth。

? 权限

  • notenoughauth.admin (默认授予 管理员) — 允许使用 /auth reload。
  • notenoughauth.default (默认值为 true) — 允许使用 /auth info 命令。
  • notenoughauth.link (默认值为 true) — 允许使用 /link 命令。
  • notenoughauth.unlink (默认值为 true) — 允许使用 /unlink 命令。

? 默认配置

[注意] 别忘了将你的公网 IP 填入 webIp 字段。
此外,你需要在机器上开放 TCP 端口以便插件正常工作。默认为端口 4177.
否则,一切都将无法工作。

# 设置 'webIp' 和 'webPort' 后,请查看控制台输出;
# 你会看到 OAuth2 重定向 URL 列表 - 复制这些 URL 并将其粘贴到你创建应用凭证时的 OAuth 提供商设置中(例如 Google、GitHub)。
webIp: "127.0.0.1"
webPort: 4177

# 定义认证重定向链接是否包含 "http" 或 "https";
# 例如,如果你使用 Nginx/Apache 作为反向代理 ('80' → '4177') 并使用 Cloudflare 进行 SSL 证书加密,请将此设置为 'true';
# 对于本地测试,你可以将其保留为 'false'。
useHttps: false

# 如果你使用隧道软件(如 'playit.gg' 或 'ngrok'),你可以使用此字段覆盖基础 URL(例如 'https://4be8-112-41-125-11.ngrok-free.app')。
overriddenRedirectUrlBase: ""

# 玩家完成验证过程的时间(以秒为单位)。
timeout: 90

# 创建 Google 应用的链接: 
google:
  enabled: true
  clientId: "YOUR_GOOGLE_CLIENT_ID"
  secret: "YOUR_GOOGLE_CLIENT_SECRET"

# 创建 GitHub 应用的链接: https://github.com/settings/developers
github:
  enabled: true
  clientId: "YOUR_GITHUB_CLIENT_ID"
  secret: "YOUR_GITHUB_CLIENT_SECRET"

# 创建 GitLab 应用的链接: https://gitlab.com/-/user_settings/applications
gitlab:
  enabled: true
  clientId: "YOUR_GITLAB_APPLICATION_ID"
  secret: "YOUR_GITLAB_SECRET"

# 创建 Discord 应用的链接: https://discord.com/developers/applications
discord:
  enabled: true
  clientId: "YOUR_DISCORD_CLIENT_ID"
  secret: "YOUR_DISCORD_CLIENT_SECRET"

# 创建 Twitch 应用的链接: https://dev.twitch.tv/console/apps/create
twitch:
  enabled: true
  clientId: "YOUR_TWITCH_CLIENT_ID"
  secret: "YOUR_TWITCH_CLIENT_SECRET"

# Telegram 文档链接: https://core.telegram.org/bots/telegram-login#tldr
telegram:
  enabled: true
  clientId: "YOUR_TELEGRAM_BOT_CLIENT_ID"
  secret: "YOUR_TELEGRAM_BOT_CLIENT_SECRET"

messages: "prefix": "&#C8D1DE[NotEnoughAuth]" "auth-required": "&f需要身份验证才能加入此服务器。" "title": "&#FFDB60欢迎!" "description": "让我们使用 OAuth2 验证您的身份。\n系统将提示您打开浏览器。" "google": "&#D5DEEAGoogle 账号" "google-hover": "点击以进行 Google 身份验证" "github": "&#D5DEEAGitHub 账号" "github-hover": "点击以进行 GitHub 身份验证" "gitlab": "&#D5DEEAGitLab 账号" "gitlab-hover": "点击以进行 GitLab 身份验证" "discord": "&#D5DEEADiscord 账号" "discord-hover": "点击以进行 Discord 身份验证" "twitch": "&#D5DEEATwitch 账号" "twitch-hover": "点击以进行 Twitch 身份验证" "telegram": "&#D5DEEATelegram 账号" "telegram-hover": "点击以进行 Telegram 身份验证" "auth-success": "身份验证成功。" "auth-success-description": "您现在可以返回 Minecraft。" "auth-failed": "身份验证失败。" "account-mismatch": "此 Minecraft 账号与此 OAuth 提供商下的另一个账号关联。" "provider-mismatch": "此提供商未与该玩家的账号关联。" "invalid-state": "无效或过期的状态。请重试。" "timeout": "超时。" "link-title": "&#FFDB60关联一个提供商" "link-description": "您可以&#A4D400&n关联&r额外的 oAuth2 提供商到您的账号,以便在此服务器上将其用作额外的登录选项。" "link-hover": "点击以关联此提供商" "unlink-title": "&#FFDB60取消关联一个提供商" "unlink-description": "您可以选择一个账号&#EB4C42&n取消关联&r。如果需要,您将能够再次关联该提供商。" "unlink-hover": "点击以取消关联此提供商" "unlink-confirm-title": "&#FFDB60确定吗?" "unlink-confirm-description": "此提供商将从您的账号中移除。" "confirm-unlink": "&#E74C3C确认取消关联" "confirm-unlink-hover": "永久取消关联此提供商" "confirm": "&#A4D400确认" "cancel": "&#EB4C42取消" "back": "&#EB4C42← 返回" "back-hover": "返回服务器列表" "info-header": "<prefix> &#ECF4FB命令:" "info-link": "\n &#D8E5EC&n/link&r&#ECF4FB - 将额外的提供商关联到您的账号。" "info-unlink": "\n &#D8E5EC&n/unlink&r&#ECF4FB - 从您的账号中取消关联其中一个提供商。" "info-logout": "\n &#D8E5EC&n/logout&r&#ECF4FB - 退出账号。" "info-reload": "\n &#D8E5EC&n/auth reload&r&#ECF4FB - 重新加载插件配置。" "successfully-linked": "<prefix> &#A4D400关联成功!" "successfully-unlinked": "<prefix> &#A4D400取消关联成功!" "provider-linked": "提供商关联成功!" "logged-out": "&f您已成功注销。" "reloaded": "<prefix> &#ECF4FB已重新加载!" "disconnected": "已断开连接。" "command-not-found": "<prefix> &#E03E3E哎呀!该命令不存在,或者您没有足够的权限。" "not-enough-permissions": "<prefix> &#E03E3E权限不足。" "one-provider-left": "<prefix> &#E03E3E您的账号仅剩一个关联的提供商。" "all-providers-already-linked": "<prefix> &#ECF4FB您已将所有可能的提供商都关联到了您的账号!" "rejoin": "<prefix> &#E03E3E会话哈希不匹配。请重新加入。" "an-error-occurred": "<prefix> &#E03E3E重新加载期间发生错误!请检查控制台日志以获取详细信息。"

? 安装

[重要] 在开始之前,请确保插件版本与您的服务器版本兼容。

  1. 从 Releases 选项卡下载最新版本的插件。
  2. 将下载的 .jar 文件放入服务器的 /plugins 文件夹中。
  3. 重启服务器或输入 /reload 命令。

? 配置

[注意] 切勿分享 config.yml 中显示的客户端密钥、机器人令牌或其他凭据。任何拥有这些访问权限的人都可以冒充您的应用程序。
指南中截图中显示的所有凭据均已撤销且不再有效。

先决条件:

  1. 确保将服务器的公网 IP 填入 config.yml 中的 webIp 字段。
  2. 在服务器上打开一个 TCP 端口(默认为 4177),其值需与 config.yml 中的 webPort 字段一致。

如何配置特定提供商:

Google
  1. 点击链接以打开 Google Cloud Console:

  2. 创建一个项目:

  3. 点击 "Create credentials" → "OAuth client ID":

  4. 将 "Application type" 设置为 "Web application" 并提供名称:

  5. 输入 /auth reload 并复制 Google 回调链接(在此之前,请确保在配置中用服务器的公网 IP 或域名填充 webIp):

  6. 将来自控制台的链接添加到 "Authorized redirect URIs" 部分并点击 "Create":

  7. 复制 "Client ID" 和 "Client Secret":

  8. 在 google 部分,将 YOUR_GOOGLE_CLIENT_ID 和 YOUR_GOOGLE_CLIENT_SECRET 替换为获得的凭据:

  9. ✅ 输入 /auth reload 并享受吧!

GitHub
  1. 点击链接打开 GitHub Developer Settings:

  2. 点击 "New OAuth App":

  3. 输入 /auth reload 并复制用于 GitHub 回调的链接(在此之前,请确保在配置中填写 webIp 为你的服务器公网 IP 或域名):

  4. 填写 "Application name"、"Homepage URL",并将插件控制台中的重定向 URL 粘贴到 "Authorization callback URL" 字段中,然后点击 "Register application":

  5. 复制 "Client ID",然后单击 "Generate a new client secret" 并复制生成的密钥:

  6. 在 github 部分中,将 YOUR_GITHUB_CLIENT_ID 和 YOUR_GITHUB_CLIENT_SECRET 替换为获取到的凭据:

  7. ✅ 输入 /auth reload 并享受吧!

GitLab
  1. 点击链接打开 GitLab User Application Settings:

  2. 点击 "Add new application":

  3. 输入 /auth reload 并复制用于 GitLab 回调的链接(在此之前,请确保在配置中填写 webIp 为你的服务器公网 IP 或域名):

  4. 填写 "Name" 字段,将插件控制台中的重定向 URL 粘贴到 "Redirect URI" 字段中,并选择 read_user 作用域,然后点击 "Save application":

  5. 复制 "Application ID" 和 "Secret":

  6. 在 gitlab 部分中,将 YOUR_GITLAB_APPLICATION_ID 和 YOUR_GITLAB_SECRET 替换为获取到的凭据:

  7. ✅ 输入 /auth reload 并享受吧!

Discord
  1. 点击链接打开 Discord Developer Portal:

  2. 点击 "New Application",输入你的应用名称,然后点击 "Create":

  3. 在左侧边栏中选择 "OAuth2" 选项卡。复制 "Client ID" 和 "Client Secret":

  4. 输入 /auth reload 并复制用于 Discord 回调的链接(在此之前,请确保在配置中填写 webIp 为你的服务器公网 IP 或域名):

  5. 在同一 OAuth2 页面的 "Redirects" 部分下,点击 "Add Redirect",粘贴来自插件控制台的 redirect URL,然后点击 "Save Changes":

  6. 在 discord 部分中,将 YOUR_DISCORD_CLIENT_ID 和 YOUR_DISCORD_CLIENT_SECRET 替换为获取到的凭据:

  7. ✅ 输入 /auth reload 并享受吧!

Twitch
  1. 点击链接打开 Twitch Developer Console:

  2. 输入 /auth reload 并复制用于 Twitch 回调的链接(在此之前,请确保在配置中填写 webIp 为你的服务器公网 IP 或域名):

  3. 填写 "Name" 字段,将插件控制台中的重定向 URL 粘贴到 "OAuth Redirect URLs" 字段中,然后点击 "Add",接着选择任意 "Category"(例如 "Website Integration"),最后点击 "Create":

  4. 返回到 "Applications" 列表,找到你刚刚创建的应用,然后点击 "Manage":

  5. 复制 "Client ID",然后单击 "New Secret" 并复制生成的 "Client Secret":

  6. 在 twitch 部分中,将 YOUR_TWITCH_CLIENT_ID 和 YOUR_TWITCH_CLIENT_SECRET 替换为获取到的凭据:

  7. ✅ 输入 /auth reload 并享受吧!

Telegram
  1. 打开 Telegram 并与 @BotFather 开始聊天:

  2. 打开 @BotFather 迷你应用,点击 "Create a New Bot" 并按照表单操作:

  3. 创建机器人后,转到 "Login Widget" 选项卡:

  4. 点击 "Switch to OpenID Connect Login":

  5. 复制 "Client ID" 和 "Client Secret":

  6. 输入 /auth reload 并复制 Telegram 回调的基础域名/IP(在此之前,请确保在配置文件中用服务器的公共 IP 或域名填充 webIp):

  7. 在 "Redirect URIs" 部分下,点击 "Add a Redirect URI",粘贴来自插件控制台的重定向 URL:

  8. 在 telegram 部分中,将 YOUR_TELEGRAM_BOT_CLIENT_ID 和 YOUR_TELEGRAM_BOT_CLIENT_SECRET 替换为获取到的凭据:

  9. ✅ 输入 /auth reload 并享受吧!

? SSL 证书和 HTTPS

[注意] 如果您没有域名,像 ngrok 或 playit.gg 这样的隧道软件也可以提供 HTTPS URL - 为此请使用 config.yml 中的 overriddenRedirectUrlBase 字段。

某些 OAuth2 提供商要求您拥有域名,在某些情况下还需要 SSL 证书(即使用 'https')。

您可以在 Cloudflare、Spaceship 等网站上购买域名。
域名价格比较工具和聚合器 - .

OAuth2 提供商及其灵活性表:

Provider Can use without a private domain Can use without SSL (HTTPS)
Google ❌ ✅
GitHub ✅ ✅
GitLab ✅ ✅
Discord ✅ ✅
Twitch ❌ ❌
Telegram ✅ ✅

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源