Конфигурация

Конфигурация — это группа правил, которые можно применить к письму при его отправке. Если конфигурация применяется к письму, к нему применяются все правила, заданные в конфигурации. Применять правила по отдельности нельзя.

ПравилаПравила

Конфигурация может содержать следующие правила:

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

• Настройки доставки — настройка обязательного использования TLS-шифрования при отправке писем от Yandex Cloud Postbox до серверов получателя. Позволяет обеспечить дополнительную безопасность передачи данных и защиту содержимого писем.

• Настройки сбора статистики — настройка сбора статистики открытия писем и переходов по ссылкам в письмах. Позволяет автоматически включить сбор метрик Открытия и Переходы и анализировать их.

Особенности доставки писем при включении обязательного TLS-шифрованияОсобенности доставки писем при включении обязательного TLS-шифрования

При оправке письма от клиента сервису Yandex Cloud Postbox всегда используется защищенное соединение по протоколу TLS. Протокол передачи зависит от выбранного способа отправки письма:

• HTTPS — если используется API, совместимый с API Amazon;
• SMTP поверх TLS — если используется порт 465;
• STARTTLS — если используется порт 587.

Если опция Настройки доставки:

• не включена, Yandex Cloud Postbox все равно будет пытаться использовать TLS при отправке писем. Если при отправке письма возникнет ошибка TLS или сервер получателя не поддерживает TLS, письмо будет отправлено без шифрования.
• включена, Yandex Cloud Postbox будет требовать неистекшего сертификата TLS, выпущенного доверенным центром сертификации, и поддержку минимальной версии TLS, указанной в настройках конфигурации. Если сервер получателя не соответствует этим требованиям, письмо не будет доставлено, и вы получите уведомление о недоставке.

Применение конфигурации к письмуПрименение конфигурации к письму

Применить конфигурацию к письму можно следующими способами:

• привязав конфигурацию к адресу — тогда конфигурация будет применяться ко всем письмам, которые отправляются с него.

  Конфигурацию можно привязать только к адресу, для которого подтверждено владение доменом. К одному адресу можно привязать только одну конфигурацию, но одну конфигурацию можно привязать к нескольким адресам.

• передав имя конфигурации в заголовке X-Ses-Configuration-Set.

  Конфигурация должна находиться в том же каталоге, в котором находится адрес. Если конфигурация с указанным именем не будет найдена в каталоге, в котором находится адрес, при отправке письма возникнет ошибка. Конфигурация, переданная в заголовке X-Ses-Configuration-Set, переопределяет конфигурацию, привязанную к адресу.

• передав имя конфигурации в поле ConfigurationSetName, если используется метод SendEmail AWS совместимого API.

  Конфигурация должна находиться в том же каталоге, в котором находится адрес. Если конфигурация с указанным именем не будет найдена в каталоге, в котором находится адрес, при отправке письма возникнет ошибка. Конфигурация, переданная в поле ConfigurationSetName, переопределяет конфигурацию, привязанную к адресу.

Полезные ссылкиПолезные ссылки

• Создание конфигурации