Лицензирование (Umbryx EE)

Относится только к EE — Core работает без лицензии. Операционная выжимка; полное описание жизненного цикла — в Umbryx EE.

Где что находится

System → License (platform admin):

• Текущее состояние: tier, стадия жизненного цикла (active / grace / wind_down), срок
• Карточка активации (без лицензии): скачать activation request (umbryx-activation-request.c2v.json), Check now и импорт .lic для air-gapped установок
• Переключатель канала: онлайн (продление heartbeat раз в 24 ч) / офлайн

Активация

Один файл в каждую сторону — идентичность машины (fingerprint, hwid, ключ экземпляра, nonce) едет внутри файла запроса активации, копировать вручную больше нечего.

1. Скачайте activation request на экземпляре и отправьте .c2v.json вендору.
2. Вендор привязывает его к лицензии в админке License Server (лицензия → Activate → загрузить файл запроса активации).
3. Онлайн: загружать обратно нечего — нелицензированный экземпляр опрашивает сервер каждые несколько минут и применяет токен автоматически, как только привязка появилась (Check now — подтянуть мгновенно). Дальнейшее продление — обычный heartbeat раз в 24 ч (LICENSE_SERVER_URL, по умолчанию https://update.umbryx.pro).
4. Air-gapped: вендор дополнительно скачивает подписанный .lic и отправляет его → Import .lic на экземпляре → переключите канал в offline. Исходящих вызовов в этом режиме нет.

Исходы продления: renewed или inactive (сервер сообщил об отсутствии лицензии → стартует отсчёт grace); недоступный сервер ничего не меняет до контрактного срока. Перепривязка на новое железо — действие вендора: администратор нажимает Activate со свежим файлом запроса активации (или сначала сбрасывает привязку устройства).

Чем управляет лицензия

Лимиты tier (участники, инфраструктурные экземпляры, workstation, retention аудита) и флаги возможностей (классы cloud-провайдеров, SSO, загрузка плагинов, несколько организаций, …) переносятся внутри подписанного токена; GET /api/system/license/state их отдаёт. Ручные override планов по org существуют (PATCH /api/marketplace/plans/{org_id}) и heartbeat их не трогает.

Поведение wind-down

После истечения + grace (по умолчанию 14 дней):

• Мутации возвращают 402 (в UI — незакрываемый баннер)
• Просмотр, экспорт и teardown продолжают работать
• Ничего не удаляется; развёрнутая инфраструктура платформой не останавливается

Устранение неполадок

Симптом	Диагностика
402 на запись	лицензия в wind_down — загрузите обновлённый токен
В логах heartbeat unreachable	license-сервер недоступен с экземпляра (сеть/прокси) — не критично до контрактного срока
Токен отвергается при загрузке	чужой экземпляр: токен привязан к хэшам железа и ключу экземпляра (переезд требует повторной активации)