К содержимому
Tickwise
КритичноVelocity и проксиSIG-VE-002

Forwarding secret Velocity не совпадает с секретом backend

Платформы
Paper · Purpur · Velocity · вся сеть
Проверено
Проверено
Уверенность
Уверенность 85%

Как это выглядит в логе

Достаточно одной из строк. Агент сверяет их с логом локально, на вашем сервере.

logs/latest.log
  • Unable to verify player details

Симптомы

  • Все игроки кикаются при входе на backend с «Unable to verify player details»
  • Modern forwarding включён с обеих сторон, но HMAC-проверка данных игрока на backend не проходит

Причина

Backend получил modern-forwarding данные, но их подпись (HMAC-SHA256) не сходится: значение proxies.velocity.secret на backend отличается от forwarding secret прокси.

Вероятные причины

  • proxies.velocity.secret в config/paper-global.yml не совпадает с содержимым forwarding.secret прокси (опечатка, лишний пробел/перевод строки, секрет от другого прокси)
  • Секрет на прокси перегенерирован (файл forwarding.secret удалён — Velocity создал новый) или задан переменной окружения VELOCITY_FORWARDING_SECRET, а backend не обновлён
  • Backend не перезапущен после смены секрета

Как исправитьСредний риск

  1. На прокси найдите действующий секрет: файл из forwarding-secret-file в velocity.toml (по умолчанию forwarding.secret); если задана переменная окружения VELOCITY_FORWARDING_SECRET, действует она.
  2. На каждом backend в config/paper-global.yml установите proxies.velocity.secret ровно в это значение (без лишних пробелов и переносов строк). Копируйте локально — не пересылайте секрет в чаты, тикеты и сторонние сервисы; Tickwise сравнивает секреты без раскрытия.
  3. Если за прокси несколько backend — секрет должен быть одинаковым на всех.
  4. Перезапустите backend: секрет читается только при старте.

Источники