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

dsn-failed-from-template

Global

Шаблон заголовка From в отчётах о неудаче
в конфигурации это строкаdsn-failed-from-templateвнутри блока Global
От кого приходит отчёт

Значение — строка заголовка From для формируемого отчёта. Подстановки те же девять, что и у остальных шаблонов; их перечень — у dsn-failed-body-template-from.

Строк с этим назначением две. Более старая custom-dsn-from-header задаёт заголовок дословно, без подстановок; эта — с ними. Различие в этом и состоит, и держать обе в конфигурации незачем.

Умолчания руководство не называет — не написана, MTA берёт свою.

Главная ловушка — адрес, на который никто не смотрит. Отчёт приходит отправителю исходного письма, и на него будут отвечать: спрашивать, почему письмо не дошло, жаловаться, просить отписать. Адрес в этом заголовке должен вести в читаемый ящик, а не в postmaster@ на узле, откуда почту никто не забирает.

Вторая половина — привычная для этой группы: имя подстановки руководство пишет двумя способами, и неверное написание останется в заголовке как есть.

Что делает Хаб. Не пишет — и проявиться строка не может: формирование отчётов выключено suppress-local-dsn во всех источниках подачи.

Тот же вопрос — «куда напишет человек, увидевший наше служебное письмо» — Хаб решает в другом месте: приём на роль-адреса открыт правилом /^(dmarc|postmaster|abuse)@/, и письма туда разбирает обработчик.

Рекомендуемые значения

Что ставить. Требование одно и оно не про формат:

Значение Когда
не писать отчёты не формируются либо разбираются машиной
адрес читаемого ящика отчёты уходят людям, и на них будут отвечать

Подстановка имени узла в отображаемом имени удобна при разборе: по ней сразу видно, какой узел сформировал отчёт.

Назначение, поддержка подстановок и общность их набора с шаблоном тела — из руководства, § 3.3.1.29. Умолчания там не названо. Требование к адресу наше.
Пример в конфигурации
# имя узла в отображаемом имени помогает при разборе
dsn-failed-from-template "${hostname} <postmaster@abc.com>"
Подстановка даёт имя узла, сформировавшего отчёт. Адрес при этом должен вести в ящик, который читают: на отчёты отвечают.
жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.
▲

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

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

Ставят адрес, из которого почту не забирают

наш опыт

Чем чреватоНа отчёты отвечают: спрашивают, почему письмо не дошло, жалуются, просят отписать. Ответы уходят в ящик, который никто не читает, и человек считает, что вы не отвечаете.
Как заметитьВ заголовке стоит служебный адрес узла, а не рабочий ящик.
Как правильноУказать ящик, который читают, и убедиться, что приём на него открыт правилом.

Держат обе строки заголовка отправителя

§ 3.3.1.28

Чем чреватоСтарая задаёт заголовок дословно, новая — с подстановками. Какая победит, руководство не оговаривает, и разбираться придётся опытом.
Как заметитьВ конфигурации встречаются обе строки.
Как правильноОставить ту, что нужна: с подстановками — эту, дословную — соседнюю.
Совместимость
PowerMTA 6.0
описана в руководстве этой версии · платформа: любая
С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.
Справочные данные
Синтаксис
dsn-failed-from-template "<template>"
Значения
строка заголовка From с подстановками
Применение
reload, перезапуск не нужен
Очередь
уже поставленное в очередь не затронет
Где писать
Global
Сколько раз
один раз в блоке
Всё здесь — из руководства, с разделом.
Наследование
Директива пишется в корне файла конфигурации и действует на весь узел: блока для неё нет, и наследования тоже. Разных отправителей отчёта для разных доменов задать нельзя.
⇄

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

1 связь

Зависит от

dsn-failed-body-template-fromGlobalТам перечислен набор подстановок, общий для всех трёх шаблонов отчёта. § 3.3.1.29

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

custom-dsn-from-headerGlobalТа же задача с подстановками; эта задаёт заголовок дословно. § 3.3.1.29

Как проверить на узле
Проверять надо и строку, и то, что стоит рядом:
grep -n 'dsn-failed-from-template\|custom-dsn-from-header\|suppress-local-dsn' /etc/pmta/config
Если нашлись обе строки заголовка отправителя, конфигурацию надо привести к одной. Если подавление отчётов включено, ни одна из них не проявится.
◇

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

3 статьи

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

В Хабе
Цена ошибки
безопасно: неверное значение ничего не ломает
Сценарии
Приём входящей почты
Соседние настройки блока Global:dsn-failed-subject-templatecustom-dsn-from-headerdsn-failed-body-template-frompostmasterhost-nameВсе 108 директив блока →