Demo
Demo
База знаний PMTA›Блок Global›Директива§ 3.3.1.16

smtp-server-tls-allow-tlsv1.3

Globalустарела

Принимать ли TLS 1.3 — устаревший переключатель
в конфигурации это строкаsmtp-server-tls-allow-tlsv1.3 trueвнутри блока Global
Старый способ выбирать версии на приёме

Строка разрешает или запрещает узлу согласовывать TLS 1.3 при приёме почты. Объявлена устаревшей начиная с PowerMTA 5.5: вместо пяти переключателей вендор предлагает две границы — smtp-server-tls-min-version и smtp-server-tls-max-version.

Одна из пяти таких пятёрок в конфигурации. Те же переключатели стоят на отправке приёмнику, на приёме почты узлом, у слушателя, у входа Transmissions API и у веб-монитора — двадцать пять строк на пять мест. Правило переноса везде одно.

Зачем страница нужна. Такие строки годами живут в конфигурациях, перенесённых с прежних версий. Встретив их, надо понимать не как их настроить, а чем заменить.

Главная ловушка — смешать два способа в одной конфигурации. Переключатели и границы описывают одно и то же, и какая из настроек победит, руководство не объясняет. Предупреждения при применении не будет.
Что делает Хаб. Не пишет: пользуется парой границ, точнее — их умолчаниями. Строку стоит знать в лицо при разборе чужой конфигурации: она означает, что настройки TLS перенесены с версии старше 5.5.
Рекомендуемые значения

Значение переводить не надо — надо переносить:

Что было Что стало
разрешены tlsv1.2 и tlsv1.3 smtp-server-tls-min-version tlsv1.2
разрешены все от tlsv1 smtp-server-tls-min-version tlsv1
запрещена tlsv1.3 smtp-server-tls-max-version tlsv1.2
всё по умолчанию обе строки не нужны

Умолчание границы на приёме — tlsv1.2, строже, чем на отправке. После переноса это стоит перепроверить: старые переключатели могли разрешать больше.

Устаревание с версии 5.5 и умолчание true — из руководства (§ 3.3.1). Таблица переноса — наша.
Пример в конфигурации
# так было раньше
smtp-server-tls-allow-tlsv1.3 true
# так пишут теперь
smtp-server-tls-min-version tlsv1.2
Нижняя строка — замена верхней. Пара границ описывает весь диапазон разом, и читать её проще, чем пять отдельных переключателей.
жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.
▲

Типичные ошибки и проблемы

что делают не так и чем это кончается2 ошибки▶

Оставляют переключатели рядом с границами

§ 3.3.1

Чем чреватоДва способа описывают одно и то же, и приоритет между ними руководство не называет. Конфигурация читается неоднозначно, а применяется без предупреждений.
Как заметитьСогласуемая версия не совпадает ни с тем, что разрешают переключатели, ни с тем, что задают границы.
Как правильноУбрать переключатели целиком и оставить только границы.

Переносят, не заметив разницы в умолчаниях

наш опыт

Чем чреватоУмолчание границы на приёме tlsv1.2, а старые переключатели могли разрешать tlsv1.1. Простое удаление строк ужесточает приём — иногда это и нужно, но узнать об этом лучше заранее.
Как заметитьПосле переноса часть подающих клиентов перестаёт подключаться.
Как правильноСверять, что разрешали переключатели, с умолчанием границы, и задавать границу явно, если поведение должно остаться прежним.
Совместимость
PowerMTA 6.0
описана в руководстве этой версии · платформа: любая
С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.
Справочные данные
Синтаксис
smtp-server-tls-allow-tlsv1.3 <boolean>
Значения
yes | no | true | false
Умолчание
true § 3.3.1.16
Применение
reload, перезапуск не нужен
Очередь
уже поставленное в очередь не затронет
Где писать
Global
Сколько раз
один раз в блоке
Всё здесь — из руководства, с разделом.
Наследование
Директива пишется в корне файла, раздел Global, и действует на весь узел. У отдельного слушателя есть свой набор таких же переключателей в <smtp-listener> — и та же пара границ им на замену.
⇄

Связанные директивы

1 связь

Чем заменена

smtp-server-tls-min-versionGlobalПришла на смену всей пятёрке переключателей: диапазон версий на приёме задаётся парой границ, а не пятью строками. § 3.3.1.16

Как проверить на узле
Найти такие строки в конфигурации — первый шаг переноса:
grep -rn "tls-allow-" /etc/pmta/
Найдутся переключатели отправки, приёма узлом, слушателя, входа Transmissions API и веб-монитора. Заменять их надо парами границ, а результат сверять согласованием.
◇

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

3 статьи

◇Подача по HTTPS на своём приёмнике, по образцу SparkPostОтдельный вход: свой приёмник с сертификатом, свои ключи и зарезервированное имя источника, через которое к такой почте применяются обычные настройки подачи.◇Приёмник объявляет требование шифрования на своём сайтеУзел забирает политику получателя по HTTPS и, если та в режиме принуждения, доставляет только при совпадении MX, шифровании и проверенном сертификате.◇Приёмник объявляет требование шифрования в своей зоне DNSУзел смотрит записи DANE получателя и, если тот требует STARTTLS, отправляет только по зашифрованному каналу с проверенным по отпечатку сертификатом.

В Хабе
Цена ошибки
безопасно: неверное значение ничего не ломает
Сценарии
Шифрование соединений
Соседние настройки блока Global:smtp-server-tls-certificateopenssl-security-levelsmtp-server-tls-min-versionhttp-tls-min-versionsmtp-server-tls-cipher-server-preferenceВсе 108 директив блока →