API-ключи, внешний доступ и IP-allowlist

v1.0.x · обновлено 2026-07-08

Эта страница описывает три экрана Web UI, отвечающих за доступ к инстансу снаружи: API-ключи, Внешний доступ и IP-allowlist.

API-ключи

Экран «API-ключи» выпускает ключи для control-plane и чата. «+ Выпустить»:

user_ref — пользователь (можно выбрать из локальных или ввести свободно);
имя ключа;
области (scopes) — чекбоксы: chat, admin:read, admin:write, mcp, a2a, * (всё);
лимит RPM.

Значение ключа показывается один раз — сохраните его сразу. Для строки ключа доступны действия «Зарегистрировать как OAuth-клиента» (выдаёт client_id / client_secret один раз) и «Отозвать». Ключи имеют префикс ah- и передаются как Bearer-токен (см. Swagger).

Внешний доступ

Экран «Внешний доступ» настраивает работу за обратным прокси и публичные адреса, четырьмя блоками:

Публичный адрес — AIHUMMER_PUBLIC_URL (обязателен), а также публичные адреса Telegram, iOS-прокси и pocket-agent.
Только HTTPS — AIHUMMER_REQUIRE_SECURE.
За прокси — доверенные прокси, CORS-источники, CSP.
Web UI слушатель — включение, адрес и origin приватного порта Web UI.

Каждое поле — текст или переключатель; при сохранении сообщается, применилось ли изменение сразу или требует перезапуска.

IP-allowlist

Экран «IP-allowlist» — одно текстовое поле со списком CIDR, по одному на строку, ограничивающее доступ к admin-API определёнными сетями. Пустой список — без ограничения.

[!TIP] IP-allowlist — грубый, но надёжный барьер. Комбинируйте его с RBAC и «Только HTTPS» для доступа только из офиса/VPN.

Что дальше

Swagger — обозреватель API и авторизация ключом.
Сеть, аудит и air-gapped.
Модель портов — публичный vs приватный.