Demo
Demo
База знаний PMTA›Экран монитора§ 5.2

Консоль

Command
🔴 Команды узла через браузер

Выполняет команды консоли узла прямо из браузера — как если бы оператор вошёл на машину и набрал pmta.

Ссылка на страницу появляется, только когда служба PowerMTA на машине работает.

🔴 Сюда проходит и удаление писем, и смена режима очереди. Запуск команд открывает уровень operator в http-access; уровня monitor для этой страницы мало.

Для программы есть POST /command — с ключом из http-api-key.

Главная ловушка — ждать отмены. Удаление писем из очереди необратимо: что ушло командой, того в спуле больше нет, и никакая кнопка монитора его не вернёт.
Что делает Хаб. Страницей не пользуется: те же команды он отправляет в POST /command с ключом узла — со своей проверкой цели, предпросмотром охвата и записью в журнал операций.
Рекомендуемые значения

На какой вопрос отвечает страница:

Вопрос Она ли
выполнить команду без захода на машину да — уровень operator
выполнить её из программы нет — POST /command
кто и что выполнял через монитор нет — журнал обращений, если включён http-log-requests
Назначение страницы, условие её появления и уровень operator для команд — из руководства (§ 5.2, § 3.3.1.58.3); точка /command — § 8.4. Разграничение вопросов наше.
Пример в конфигурации
# то же из программы: команда и ключ
curl -s -H 'X-API-Key: KEY' 'http://127.0.0.1:8080/command' -F command='show status' -F format=json-text
json-text отдаёт тот же текст, что страница консоли, обёрнутым в JSON.
жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.
Совместимость
PowerMTA 6.0
описана в руководстве этой версии · платформа: любая
С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.
⇄

Связанные записи

1 связь

Зависит от

Что защищает веб-монитор и чем эта защита не являетсяДоступ к экрану решают права и адреса, заданные на уровне узла. § 5.2

Сюда ссылаются

Начальная страница монитораСмежная запись каталога. § 5.2

Как проверить на узле
Посмотреть, кому страница открыта и пишутся ли обращения:
grep -n 'http-access' /etc/pmta/config
grep -n 'http-log-requests' /etc/pmta/config
Страница открыта адресам с уровнями operator и admin. Обмен с монитором по умолчанию не пишется — для следа включают http-log-requests.
◇

Что ещё почитать

3 статьи

◇Кому разрешено сдавать почту и для кого её приниматьИз коробки узел принимает подачу только с самой машины; два разных вопроса — «кто может слать через нас» и «на чьи адреса мы принимаем» — решаются разными директивами.◇Группа, дающая право управлятьЧленство в группе pmta даёт непривилегированному пользователю право звать команды узла и пользоваться подачей.◇Как узел выбирает источник и складывает его настройкиСоединение попадает под все блоки источника, чьи адреса его накрывают, и действуют они слитно — узкий перекрывает широкий; именованные блоки подключаются только по прямой ссылке.

В Хабе
Цена ошибки
опасно: последствия переживут откат
Сценарии
Аварийная остановка · Безопасность узла