Лицензирование и биллинг — AiHummer Документация

AiHummer — это self-hosted продукт с коммерческой моделью лицензирования. Любая установка работает — без лицензии и без аккаунта — на бесплатном тарифе Community; платный тариф расширяет лимиты и открывает enterprise-функции. Вся проверка прав выполняется в вашем собственном шлюзе (никакие ваши данные не покидают ваш хост) и закрывается в Community при отказе: отсутствующая, подделанная или истёкшая лицензия сводится к бесплатному тарифу, а не к безлимиту.

Тарифы

«AI-сотрудник» — это настроенный агент/персона. Тарифы — единый источник истины, общий для шлюза и страницы с ценами.

Тариф	AI-сотрудники	Арендаторы	Каналы	Enterprise-функции
Community (бесплатно)	2	1	Только базовые каналы	—
Starter	3	1	Все каналы	—
Business	5	1	Все каналы	White-label, RBAC, аудит
Enterprise	Без лимита	Без лимита	Все каналы	+ SSO, RLS, SLA

Подписанная лицензия может дополнительно нести явные переопределения MaxSeats / MaxTenants / Features, которые имеют приоритет над значениями тарифа по умолчанию.

Как лицензия попадает на ваш инстанс

Лицензирование инстанс-центрично и в типичном случае не требует ручного переноса токенов:

Авторегистрация. При первом запуске шлюз сам регистрируется в вендорской fleet-службе по аутентифицированной шине с закреплённым (pinned) TLS. Без лицензии он регистрируется как Community — это штатное поведение и ничего от вас не требует.
Покупка / управление тарифом в личном кабинете my.aihummer.ru. Вендор назначает тариф вашему инстансу.
Доставка лицензии по шине. Биллинг подписывает лицензию, привязанную к отпечатку (fingerprint) именно вашего инстанса, и отправляет её шлюзу по шине. Шлюз проверяет подпись по корню доверия, вшитому в бинарник, и применяет новые права на лету — без перезапуска и без копипаста.

Подписанная лицензия привязана к отпечатку вашего инстанса, поэтому её нельзя использовать на другом хосте.

Офлайн-фолбэк: detached-токен

Если ваш инстанс не может достучаться до шины (полностью изолированная сеть), вендор может выпустить detached-токен лицензии, который вы устанавливаете вручную:

aihummer license show          # посмотреть текущую лицензию / тариф

Вставьте выданный токен через админ Web UI (или через окружение, описанное установщиком) — шлюз проверит и применит его так же. Токен по-прежнему привязан к отпечатку вашего инстанса.

Флоу апгрейда по коду 402

Проверка прав мягкая: существующие ресурсы никогда не отключаются и не «кирпичатся». Блокируется только новое действие, которое превысило бы ваш тариф, и оно возвращает HTTP 402 Payment Required с машиночитаемым телом:

{
  "error": "Plan limit reached: your plan allows 2 AI employees.",
  "code": "plan_limit",
  "feature": "ai_employees",
  "upgrade": "https://aihummer.ru/pricing/"
}

Например, создание 3-го AI-сотрудника на Community, включение не-базового канала, включение white-label-брендинга, RBAC или чтения аудита ниже нужного тарифа — всё это вернёт такой ответ. Админ Web UI показывает ссылку upgrade, чтобы оператор мог перейти на более высокий тариф; уже созданные ресурсы продолжают работать.

[!NOTE] Ответы по лимитам тарифа / биллингу используют этот отдельный формат 402 plan_limit и не входят в общий реестр кодов AIH-* (справочник) — они описаны здесь.

Личный кабинет

Тарифы, оплата, реквизиты и закрывающие документы живут в личном кабинете my.aihummer.ru. После покупки или продления лицензия приходит на ваш инстанс автоматически по шине — как self-hosting-клиент вы взаимодействуете с лицензированием через свой шлюз и, при необходимости, через офлайн-фолбэк с detached-токеном выше. По вопросам смены тарифа обращайтесь к вендору через страницу «Поддержка» админки.

Где выполняется проверка прав

Только в вашем шлюзе. Права каждый раз пере-выводятся повторной проверкой подписи лицензии; единого удаляемого переключателя «if licensed» нет.
Fail-closed. Любая недоверенная лицензия → Community, никогда не безлимит.
Мягкая. Новые действия сверх лимита блокируются (402); существующие ресурсы не трогаются.