Документация / Портал и доступ

Ключи доступа и публикации

Различия ключей, однократная выдача, сохранение, замена и отзыв.

Три разных вида данных

Данные Формат Где используются Секрет
ID сервера srv_ и 32 шестнадцатеричных символа Портал, доступ игроков, публикация, URL шлюза Нет
Ключ доступа игроков 43 символа canonical base64url Шаг «Доступ игроков»; допуск новых подключений Да
Ключ публикации 32-байтовый Ed25519 seed, обычно 44 символа Base64 с = Файл .seed или поле ключа на шаге «Каталог OpenM» Да
publisher.json JSON с ID, keyId и адресом Конфигурация автоматического издателя Не содержит сам seed, но содержит служебные данные и адрес
Логин и пароль txAdmin Заданные локально Вход и повторная настройка панели Пароль — да

Ключ доступа и ключ публикации выпускаются независимо. Ключ Cfx.re не используется вместо них. Короткий код подключения также не является секретом доступа.

Получение ключа доступа игроков

  1. Откройте в портале нужную карточку.
  2. Убедитесь, что сервер одобрен с игровым адресом, а публикация разрешена.
  3. В блоке «Ключ доступа игроков» нажмите «Получить ключ доступа».
  4. Подтвердите действие. Скопируйте все 43 символа либо скачайте предложенный текстовый файл.
  5. Сохраните ключ в защищённом месте до закрытия окна: повторного чтения значения через портал нет.
  6. Вставьте ключ и ID в мастер настройки, шаг «Доступ игроков».

Файл ключа доступа не загружается в поле .seed. Если вы сохранили его текстовым файлом, откройте локально и перенесите значение в поле доступа. Не публикуйте его содержимое.

Получение ключа публикации

В той же карточке откройте «Ключи публикации» и выпустите ключ. Скачайте приватный .seed и publisher.json. Seed показывается однократно; конфигурацию для действующего ключа можно скачать повторно через действие «Конфигурация издателя».

Проверьте, что оба файла относятся к одной карточке и одному keyId. Имя файла может содержать key_…; имя вроде publisher (1).json само по себе не ошибка. Важны содержимое, ID и адрес, а не суффикс, добавленный браузером при повторном скачивании.

На шаге «Каталог OpenM» выберите JSON и .seed. Мастер сам создаёт локальную конфигурацию с корректными путями и локальным probe-адресом. Не редактируйте импортированный JSON, чтобы направлять издатель к произвольной службе.

Хранение после настройки

Для стандартного расположения состояние находится под C:\OpenM-Server\txData:

  • admission-token.txt — действующий ключ допуска игроков.
  • publisher.seed — приватный ключ подписи heartbeat.
  • publisher.json — рабочие параметры издателя и пути.
  • openm-settings.json — параметры мастера, ID и несекретные сведения о публикации.
  • admins.json — локальные аккаунты и хеши паролей txAdmin.

Не копируйте реальные секреты в server.cfg, sets, реплицируемые конвары, клиентские Lua-файлы или репозиторий. Архив с txData считается приватной резервной копией, даже если пароль панели хранится хешем.

Замена ключа доступа

Замена действует сразу на центральной стороне: старый ключ перестаёт разрешать новые подключения. Подготовьте доступ к игровому узлу и окно обслуживания заранее.

  1. Штатно остановите игровой процесс и монитор.
  2. В портале выпустите новый ключ доступа и сохраните его.
  3. Запустите Configure-Server.cmd и подтвердите текущий логин и пароль владельца txAdmin.
  4. Для того же ID вставьте новый ключ в шаг «Доступ игроков». Данные публикации сохраняйте, если их не меняете.
  5. Завершите мастер, запустите сервер, проверьте новое подключение игрока.

Не рассчитывайте на сохранение старого ключа «на случай отката»: после замены он недействителен. Возврат старого файла с диска не возвращает действительность ключа в портале. Для восстановления выпускайте новый ключ.

Отзыв и потеря

Отзыв ключа доступа закрывает новые подключения; не считайте его гарантированным отключением всех уже существующих сессий. При необходимости немедленно остановите игровой сервер отдельно. При потере однократно выданного значения выпустите новый ключ и настройте его на узле.

Ключ публикации можно приостановить, возобновить или окончательно отозвать. Отзыв .seed не равен отзыву admission. Чтобы заменить publication seed через текущий интерфейс, подготовьтесь к перерыву публикации: отзовите прежний ключ, выпустите новый, скачайте новую пару файлов и примените её в мастере. Возобновление допускается для приостановленного, но не окончательно отозванного ключа.

Повторная настройка без смены ключей

При повторном запуске мастера пустое поле admission сохраняет действующий ключ только для того же ID сервера. Для публикации можно оставить файлы невыбранными, если уже есть сохранённая конфигурация нужного сервера. Если меняете карточку/ID, используйте выданные ей данные; старые ключи не переносятся между серверами.

Ошибка про 43 символа

Если вставлен ключ из блока «Ключи публикации», мастер должен указать, что это seed. Не удаляйте последний =, не обрезайте строку и не перекодируйте её. Получите отдельный ключ доступа игроков. Если вставлен правильный ключ, проверьте полное копирование без кавычек, пропущенных символов и случайного текста вокруг значения.

Раздел диагностики помогает отличить неправильный формат ключа от недействительного ключа, проблем публикации или сети.

Введите название, параметр или текст ошибки.

Esc — закрыть · Tab — выбрать результат