Консоль

Актуально для: SimpleTwo 1.0.50 и новее · агент 1.0.14 · каталог 1.4.26 · Проверено: 03.11.2026

Консоль администратора — страница /admin. Через неё администрируются координатор и все роли установки: каталог, почта, диск, переписка, prov и другие.

1. Как консоль ходит в роли

Браузер обращается только к консоли. Вызовы к ролям консоль передаёт сама — через шлюз: страница открывает адрес /gateway/<имя роли>/control/… на своём же адресе, а консоль пересылает вызов роли с вашим собственным токеном, без изменений.

• Права решает роль, как и раньше: по вашему токену и вашим ролям в каталоге. В журнале роли — вы, а не консоль. Своих прав и токенов у консоли нет.
• Компьютеру администратора нужен доступ только к консоли. Публичные имена ролей из сети администратора открываться не обязаны — их открывает консоль.
• Окна выбора сертификата больше нет. prov спрашивает сертификат у каждого клиента (так в него входят устройства Poly); теперь к нему подключается консоль, а не браузер.
• Шлюз ведёт только на адреса ролей этой установки и только к их администрированию (/control/…, у каталога ещё /scim/v2/…). Произвольный адрес через него не открыть.
• Аварийный вход ролями не администрирует: у него нет токена каталога. Карточки ролей говорят об этом.

2. Где работает консоль

По умолчанию консоль работает внутри координатора: её открывают по адресу координатора, ничего ставить не нужно.

Отдельной ролью консоль ставится, когда админку нужно держать в другом месте — например, в сети администраторов, а координатор в DMZ. Консолей может быть несколько.

1. Серверы → Добавить хост, роль console, публичное имя консоли (например, admin.example.com). DNS-имя должно указывать на этот хост.
2. Выполните на хосте команду присоединения. Агент поставит службу simpletwo-console, а координатор закажет сертификат для имени (или импортируйте свой: Серверы → Сертификат).
3. Откройте https://<имя консоли>/admin и войдите через каталог, как обычно.

Хосту консоли нужен доступ к координатору (HTTPS) и к публичным именам ролей (HTTPS). Порт — 443. Своих данных у консоли нет: потерять её хост — значит поставить консоль заново.

Страница и /admin/api — координатора: консоль их пересылает, поэтому версия консоли всегда совпадает с версией координатора и обновляется вместе с ним. Аварийный вход тоже работает через отдельную консоль.

3. Как закрыть администрирование ролей от интернета

Настройки → Консоль и control API → Сети, из которых control API ролей принимает вызовы. Впишите адреса консолей (через запятую, адрес или сеть CIDR) — и /control/… каждой роли будет отвечать только им. Пока страницу отдаёт и координатор, впишите и его адрес. Пусто — любые сети (по умолчанию).

Обращения с самого хоста роли (127.0.0.1) пропускаются всегда. Поэтому у роли за TLS-фронтом на её же хосте — это диск — список не ограничивает ничего: для неё сеть закрывают на межсетевом экране перед хостом.

Остальные параметры там же:

Параметр	По умолчанию	Что значит
Вызовов в минуту на токен у роли	по умолчанию роли (600)	сколько вызовов роль принимает от одного токена
Наибольшее тело через консоль	2048 МиБ	предел размера загрузки через шлюз (самое большое — образы прошивок prov)
Время одного вызова	1800 с	сколько может идти один вызов, включая передачу тела
Вызовов в минуту на токен через консоль	1200	предел частоты на шлюзе

Сеть и частота доходят до ролей с их желаемым состоянием за минуту-две, без перезапуска консоли.

4. Если что-то не так

Признак	Причина	Что сделать
Карточка роли: «не отвечает через консоль»	консоль не доходит до публичного имени роли или не доверяет её сертификату	проверить с хоста консоли (координатора): curl -I https://<имя роли>/control/about — 401 или 403 значат, что сеть в порядке
Роль отвечает 403 the control API is not open to this network	адрес консоли не в списке сетей	добавить адрес консоли в Настройки → Консоль и control API
Вход на отдельной консоли возвращает ошибку redirect_uri	каталог ещё не знает имя консоли	дождаться, пока каталог получит новое желаемое состояние (минута-две); каталог должен быть 1.4.26 или новее
Консоль не стартует: «no certificate … yet»	сертификат для имени консоли ещё не выпущен	проверить DNS-имя и Серверы → Сертификат