Demo
Demo
База знаний PMTA›Блок <domain>›Директива§ 3.3.10.113.3

sparkpost-sandbox

<domain>

Отправка с песочного домена SparkPost
в конфигурации это строкаsparkpost-sandbox falseвнутри блока <domain>
Первые письма без своего домена

Умолчание — false. Строка передаёт SparkPost одноимённую настройку — песочницу. Руководство PowerMTA ограничивается словами «Sets the sandbox SparkPost option»; смысл описан в документации SparkPost.

Песочница — это домен отправки, а не сухой прогон. Письмо уходит с тестового домена sparkpostbox.com: так SparkPost позволяет отправить первое письмо, не заводя собственного домена отправки.

Лимит жёсткий: по документации SparkPost — не больше пяти песочных писем за всё время жизни аккаунта, а у корпоративных аккаунтов песочницы нет вовсе. Для проверки перенаправления трафика на живом потоке она не годится.

Главная ловушка — принять песочницу за безопасную проверку. Письма в ней не придерживаются, а уходят с чужого тестового домена, и лимит в пять писем на аккаунт кончится на первой же настоящей проверке; на корпоративном аккаунте песочницы нет.

Вторая половина: строка живёт в блоке получателя и подчиняется слиянию. Оставленная в широком блоке, она достанется не только маршруту {sparkpost}.

Что делает Хаб. Не пишет: перенаправление трафика в SparkPost Хаб не задействует.
Рекомендуемые значения

Что ставить:

Значение Когда
false, умолчание рабочий поток через {sparkpost}
true первые письма аккаунта без своего домена отправки, в пределах лимита SparkPost

Лимит считает SparkPost, а не узел: сколько песочных писем осталось, узел не знает.

Умолчание и назначение строки — из руководства, § 3.3.10.113.3; домен песочницы, лимит в пять писем и отсутствие песочницы у корпоративных аккаунтов — из документации SparkPost (Transmissions API, раздел о песочном домене). Разбор — наш.
Пример в конфигурации
# первые письма аккаунта без своего домена отправки
<domain {sparkpost}>
    auth-username SMTP_Injection
    auth-password d41d8cd98f00b204e9800998ecf8427e
    sparkpost-sandbox true</domain>
Письма уйдут с домена песочницы SparkPost; лимит песочницы — пять писем на весь аккаунт.
жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.
▲

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

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

Проверяют песочницей живой маршрут

наш опыт

Чем чреватоПисьма уходят с тестового домена SparkPost, а лимит в пять писем на аккаунт кончается раньше, чем проверка закончена.
Как заметитьПервые письма пришли с чужого домена, дальнейшие песочные отправки отклоняются.
Как правильноПроверять перенаправление на своём домене отправки и контрольном ящике, а песочницу оставить для первых писем нового аккаунта.

Ставят песочницу в широкий блок получателей

наш опыт

Чем чреватоПо правилу слияния она достаётся всем получателям, которые сами не сказали обратного, — а не только тому маршруту, который проверяли.
Как заметитьСтрока стоит в блоке * или в блоке шире, чем зарезервированный домен.
Как правильноДержать её только в блоке {sparkpost}.
Совместимость
PowerMTA 6.0
описана в руководстве этой версии · платформа: любая
С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.
Справочные данные
Синтаксис
sparkpost-sandbox <boolean>
Значения
yes | no | true | false
Умолчание
false § 3.3.10.113.3
Применение
reload, перезапуск не нужен
Очередь
уже поставленное в очередь не затронет
Где писать
<domain>
Сколько раз
один раз в блоке
Всё здесь — из руководства, с разделом.
Наследование
Директива живёт в <domain> и подчиняется слиянию блоков получателей — но осмысленна только в зарезервированном домене {sparkpost}. Оставленная в широком блоке, она достанется всем получателям, которые сами не сказали обратного.
⇄

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

1 связь

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

auth-username<domain>Перенаправление начинается с авторизации у службы; без неё песочница ни к чему не относится. § 3.3.10.113.3

Как проверить на узле
Со стороны узла состояние песочницы не видно — только строка в конфигурации:
grep -n -A5 'domain {sparkpost}' /etc/pmta/config
Больше проверять нечем: настройка уезжает в SparkPost, а узел пишет в учёт обычную передачу в очередь {sparkpost}.
◇

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

3 статьи

◇Ключ активации — условие установки, а не шаг после неёБез ключа активации от поддержки SparkPost MTA не ставится и не работает, а уровень лицензии задаёт потолок исходящих соединений: на стандартной всё сверх 200 игнорируется.◇Ограничения облакаОблака ограничивают исходящую почту через порт 25, пока не попросишь снять лимит, а их диапазоны адресов почтовики встречают с подозрением.◇Как перевести план отправки в железоДве постоянные, по которым считается любой узел: около 2 КБ памяти на каждого получателя в очереди и место под спул, пропорциональное суммарному размеру писем.

В Хабе
Цена ошибки
безопасно: неверное значение ничего не ломает
Сценарии
Планирование мощности
Соседние настройки блока <domain>:http-delivery-urlhttp-delivery-extra-headerssparkpost-ip-pooladd-x-msys-api-headeradd-x-msys-api-header-metadataВсе 135 директив блока →