Turnstile

Turnstile

Turnstile — это серверный мод для Fabric, который добавляет аутентификацию по токену на серверах Minecraft в офлайн-режиме. Игроки проходят аутентификацию, подключаясь через адрес сервера, где в качестве первого поддомена используется личный токен, так что команда входа в игре не требуется.

Turnstile предназначен для серверов в офлайн-режиме. Он не заменяет аутентификацию аккаунта Mojang/Microsoft и не нужен на серверах с включённым онлайн-режимом.

Требования

• Fabric Loader 0.19.3 или совместимый
• Fabric API 0.153.0+26.2 или совместимый Настройте DNS-запись с подстановочным знаком, например *.mc.example.com, указывающую на ваш сервер или прокси. Этот мод не подходит для серверов без доменного имени.

Как это работает

1. Игрок подключается, используя свой личный токен в качестве домена нижнего уровня:

TOKEN.mc.example.com

2. Turnstile проверяет токен по UUID игрока в офлайн-режиме.
3. Если токен действителен, игрок может войти. Токен остаётся действительным, пока не будет перегенерирован или отозван.

Генерация токена

Подключённый клиент должен запросить токен, выполнив команду /turnstile token generate или взаимодействуя с подсказками. В целях безопасности оператор сервера не может сгенерировать токен для другого игрока. Из-за этого игрокам нужно выдать одноразовый пропуск, прежде чем они смогут запросить токен. Токен не логируется на сервере и хешируется перед сохранением. Генерация нового токена заменяет предыдущий для этого игрока.

Одноразовые пропуска

Модераторы сервера могут выдать одноразовые пропуска, чтобы игрок мог войти без своего токена. После входа с пропуском игроку предлагается сгенерировать новый токен. Когда игрок успешно проходит аутентификацию со своим токеном, его пропуска сбрасываются.

Команды

Команда	Права	Описание
/turnstile token generate	Любой игрок	Генерирует новый токен для себя.
`/turnstile token revoke `	Модератор	Отзывает токен игрока.
/turnstile passes get	Любой игрок	Показывает ваши оставшиеся одноразовые пропуска.
`/turnstile passes get `	Модератор	Показывает оставшиеся одноразовые пропуска игрока.
`/turnstile passes set `	Модератор	Задаёт количество одноразовых пропусков игрока. Используйте 0, чтобы убрать все пропуска.

Конфигурация

Домен сервера

При выдаче токена игроку сервер может вернуть полный адрес вместо просто токена. Для этого домен сервера должен быть записан в config/turnstile.txt. Если сервер хочет отображать только токен, файл не должен существовать. Например, файл с содержимым mc.example.com отобразит игроку TOKEN.mc.example.com.

Игровое правило

Аутентификацию можно включать или отключать во время работы:

/gamerule turnstile:enable true

По умолчанию она включена. Отключение возвращает обычное поведение входа в офлайн-режиме.

Вопросы безопасности

Поскольку токены видны в имени хоста, они доступны DNS-провайдерам и прокси, а также могут записываться в логи. Используйте программный стек, который вы контролируете, и делитесь серверной инфраструктурой только с людьми, которым доверяете. Всегда делайте резервные копии сервера. Мод в настоящее время находится в бета-версии и может содержать другие уязвимости. В будущих версиях ожидается внедрение других подходов к аутентификации, функций безопасности и изменений интерфейса.