Demo
Demo
База знаний PMTA›Механизм§ 7.1

Что нужно обвязке подачи

API submission requirements
Библиотека, права и группа

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

Права: на Unix программа работает от root или от пользователя из группы pmta; на Windows — от SYSTEM или пользователя группы Administrators.

Языки: Perl 5.12 и новее, .NET 2.0 и новее, Java 6 и новее — для JavaMail ещё её библиотеки.

Узел: источнику подачи нужны always-allow-relaying yes и allow-mailmerge yes — или always-allow-api-submission yes, который включает слияние сам.

Это и есть цена альтернативы SMTP: почтовое соединение умеет любая платформа без единой правки, обвязка требует кода и доступа.

Главная ловушка — большие пакеты. Руководство советует не больше 5000 получателей в одной подаче: при сбое пакета пострадает меньше адресов, и памяти уходит меньше.
Что делает Хаб. Мы обвязками не пользуемся — подача идёт по SMTP. Запись полезна тем, что показывает, чего стоит альтернатива.
Рекомендуемые значения

Требования:

Что Требование
права на Unix root или группа pmta
права на Windows SYSTEM или Administrators
источник подачи always-allow-relaying и allow-mailmerge
размер пакета до 5000 получателей
Права, версии языков, настройки источника и совет про размер пакета — из руководства (§ 7.1). Таблица — наша.
Пример в конфигурации
<source 10.0.0.5>
    always-allow-relaying yes
    always-allow-api-submission yes</source>
always-allow-api-submission включает и слияние, так что отдельная строка allow-mailmerge не нужна.
жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.
Совместимость
PowerMTA 6.0
описана в руководстве этой версии · платформа: любая
С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.
⇄

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

4 связи

Без чего не работает

always-allow-api-submission<source>Директива, которой этот механизм и включается. § 7.1allow-mailmerge<source>Директива, которой этот механизм и включается. § 7.1Группа, дающая право управлятьСмежный механизм: они работают вместе. § 7.1

Зависит от

Кому разрешено сдавать почту и для кого её приниматьСмежный механизм: они работают вместе. § 7.1

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

Подача — сетевая служба, и в неё можно войтиСоединение с паролем — одна из функций той же библиотеки подачи. § 7.1Как обвязка сообщает об ошибкеСмежный механизм: они работают вместе. § 7.1

Как проверить на узле
Проверить права пользователя программы и сами обвязки:
id appuser
ls /opt/pmta/api
Группа pmta в выводе id — право на обвязки есть; каталог /opt/pmta/api — сами обвязки на Linux.
◇

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

3 статьи

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

В Хабе
Цена ошибки
обратимо: вредит, пока стоит
Сценарии
Безопасность узла · Подключить платформу отправки