Настройка вебхуков разбора входящей почты для мультитенантных платформ

Разбор входящей почты преобразует SMTP-трафик в структурированные JSON-данные для передачи через webhook API. Опасной ошибкой является отсутствие проверки подписи, что позволяет поддельным запросам обходить защиту. Для безопасной работы настройте корректную маршрутизацию MX-записей и валидацию заголовков с помощью HMAC-SHA256.

Архитектурный обзор обработки входящей почты

Разбор входящей почты преобразует потоки SMTP в структурированные вебхуки для вашей мультитенантной коммуникационной платформы. Когда получатель отвечает на сообщение, MX-записи направляют SMTP-сессию на пограничные шлюзы. Конвейер извлекает заголовки, многочастные MIME-тела и вложения, преобразуя их в объекты JSON.

Настройка DNS-записей и MX-маршрутизации

Безопасная маршрутизация входящей почты требует точной конфигурации DNS для каждого домена. Субарендаторы настраивают MX-записи, указывающие на шлюзы платформы, вместе с CNAME для подтверждения владения доменом. При подключении доменов система запускает автоматическую проверку распространения DNS перед активацией трафика.

Проектирование полезной нагрузки вебхуков и безопасности

Надежность доставки вебхуков зависит от детерминированных структур данных и механизмов аутентификации эндпоинтов. Каждое исходящее сообщение содержит подпись HMAC-SHA256 в заголовках HTTP, вычисленную с использованием секретного ключа субарендатора. Ваши серверы должны проверять эту подпись до обработки JSON, чтобы предотвратить подделку запросов.

Управление лимитами скорости и обратным давлением

Объемные входящие кампании могут перегрузить эндпоинты клиентов при отсутствии лимитов и контроля нагрузки. Платформа устанавливает ограничения для субарендаторов, защищая серверы от внезапных всплесков трафика. При росте нагрузки система помещает входящие данные в буферы, применяя контролируемое обратное давление.

Операционное устранение неполадок и ресурсы

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

Related: Пилотная неделя email: живая проверка аутентификации перед реальной рассылкой · Пилотная неделя API: ключи и вебхуки на реальном трафике · лимиты API от пилота к production.

Начните с IOSOR

Направьте MX на parse-хост и создайте inbound webhook URL с отдельным shared secret на тенанта. Сохраните payload до ответа 2xx. Повторяйте по message-id, чтобы повтор webhook не открыл второй тикет. Докажите, что одно входящее письмо попало в очередь этого тенанта в ledger.

Итог IOSOR

HTTP 200 с потерянным payload — тихий провал. ACK после записи, не до.

Делайте: сначала persist, потом 2xx; на 5xx повторяйте webhook. Не делайте: не ACK-айте на 200, пока парсер ещё буферит, и не делите один секрет webhook между тенантами.