Админ-доступ по HWID¶

adminHwids — список HWID устройств, которым провайдер выдал админ-привилегии в рамках конкретного домена подписки. Привилегий две: просмотр/правка конфигов серверов прямо в приложении и отправка push-уведомлений в обход модерации.

Где задаётся¶

Провайдер добавляет HWID в веб-панели в настройках домена, в разделе Админ-доступ. Поле хранится в SubscriptionSettings и возвращается клиенту через Premium API:

Поле	Тип	Описание
`adminHwids`	`string[]`	Массив HWID в формате, идентичном тому, что клиент отправляет как `x-hwid`

Формат HWID — см. hwid.md. Сравнение идёт посимвольно (без нормализации регистра), т. е. нужно скопировать HWID ровно в том виде, в каком его видит приложение в своих настройках.

Привилегия 1: просмотр и правка конфигов серверов¶

Если HWID устройства входит в adminHwids текущей подписки:

На карточке сервера в приложении появляется кнопка редактирования (обычно скрыта для остальных пользователей).
Устройство может править параметры VLESS/VMess/Trojan/… прямо в UI: адрес, порт, UUID, transport-настройки.
Правки действуют только локально на этом устройстве — они не уезжают обратно в подписку. При следующем refresh подписки сервер восстановится до версии провайдера.

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

Привилегия 2: отправка уведомлений без модерации¶

По умолчанию любое уведомление, которое провайдер отправляет из панели, ждёт модерации INCY (статус pending).

Если в таргетинге указан конкретный HWID и этот HWID присутствует в adminHwids какого-либо верифицированного домена провайдера:

Уведомление сразу получает статус approved (auto-approve по admin-HWID).
Рассылка запускается немедленно — без ожидания модерации.

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

Важно: auto-approve срабатывает только когда targetSegment.hwid задан и совпадает с одним из adminHwids. Уведомления без HWID-таргета или на чужой HWID всё равно проходят модерацию. Подробнее — provider-notifications.md.

Гигиена¶

Храните в adminHwids только собственные устройства. Админ-доступ даёт обход модерации push-уведомлений — случайный HWID чужого пользователя сможет спамить остальных подписчиков.
HWID устройства меняется при заводской очистке или переустановке ОС — список adminHwids нужно обновлять.
Удаление HWID из списка вступает в силу при следующем получении конфига устройством (typical 1–5 минут, зависит от кеша).