Demo
Demo
База знаний PMTA›Блок конфигурации§ 3.3.21

<transmissions-api-listener>

Слушатель Transmissions API
Вторая дверь подачи, отдельная от почтовой

Блок описывает вход для подачи писем по HTTP — не по SMTP: адрес, порт и настройки шифрования. Клиенты подключаются по HTTPS, поэтому сертификат tls-certificate обязателен, а слушателей может быть несколько — у каждого свой.

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

⚠️ И имена директив тут обманчивы. Часть из них совпадает с именами почтового слушателя, но раздел руководства расписывает каждую заново, со своим синтаксисом и своим умолчанием. Читать их надо в своём разделе, а не по аналогии.

Потолок соединений задаётся отдельно — директивой уровня узла (total-max-transmissions-api), а не здесь.

Пример в конфигурации
# вход по HTTP — отдельный от почтового
<transmissions-api-listener 127.0.0.1:8443>
    tls-certificate /etc/pmta/api.pem</transmissions-api-listener>
Выделенная строка описана в своём разделе руководства, а не заимствована у почтового слушателя, — хотя имя то же самое. У нас этого блока нет: весь парк подаёт письма по SMTP.
жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.
Директивы блока: 15
TLS 12
tls-certificateСертификат, который вход Transmissions API предъявляет клиентамtls-min-versionНижняя граница версии TLS на входе Transmissions APItls-ca-fileФайл доверенных центров для клиентских сертификатов входа APItls-cipher-server-preferenceКто выбирает шифр на входе Transmissions API — узел или клиентtls-ciphersНабор шифров входа Transmissions API для версий до TLS 1.2tls-max-versionВерхняя граница версии TLS на входе Transmissions APItls-v1.3-ciphersuitesНаборы шифров входа Transmissions API для TLS 1.3tls-allow-sslv3устарелаПринимать ли SSLv3 на входе Transmissions API — директива не действуетtls-allow-tlsv1устарелаПринимать ли TLS 1.0 на входе Transmissions API — устаревший переключательtls-allow-tlsv1.1устарелаПринимать ли TLS 1.1 на входе Transmissions API — устаревший переключательtls-allow-tlsv1.2устарелаПринимать ли TLS 1.2 на входе Transmissions API — устаревший переключательtls-allow-tlsv1.3устарелаПринимать ли TLS 1.3 на входе Transmissions API — устаревший переключатель
Прокси 3
use-inbound-proxyОжидать ли заголовок балансировщика на входе подачи по HTTPinbound-proxy-timeoutСколько ждать заголовок балансировщика на входе подачи по HTTPlog-inbound-proxyЗаписывать ли заголовок балансировщика на входе входа Transmissions API
Совместимость
PowerMTA 6.0
описана в руководстве этой версии · платформа: любая
С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.
⇄

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

0 связей

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

total-max-transmissions-apiGlobalОграничивает соединения к слушателю, описанному в этом блоке. § 3.3.1.1

◇

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

3 статьи

◇Принять, направить, доставитьПуть письма внутри узла: принять, решить куда, доставить — и между этими тремя шагами живут все настройки.◇Четыре типа значений, на которых написан весь конфигЛогическое, образец домена, регулярное выражение и промежуток времени — определены один раз в § 3.2 и дальше используются всеми директивами.◇Перезагрузка настроек против перезапуска службыКонфигурация читается при старте, дальше правки подхватываются командой перезагрузки — кроме тех директив, которые руководство помечает как требующие перезапуска.

В Хабе
Цена ошибки
обратимо: вредит, пока стоит
Сценарии
Жизненный цикл конфигурации