Configuration

A configuration is a group of rules you can apply to an outgoing email. If you apply a configuration, all the rules configured within it will apply to your email. You cannot apply individual rules separately.

RulesRules

A configuration may contain the following rules:

• Subscriptions: Notifications about operations with emails, e.g., sending, delivery delay, etc. This allows you to redirect notifications about operations to other services for analysis and set up automatic actions in response to selected operations.

• Delivery settings: Mandatory TLS encryption when emails go from Yandex Cloud Postbox to recipient servers. Ensures extra data transmission security and protects email contents.

• Statistics collection settings: Settings for collection of statistics on email opens and clicks. They enable automatically collecting and analyzing the Openings and Clicks metrics.

Email delivery options with mandatory TLS encryption onEmail delivery options with mandatory TLS encryption on

For emails from the client to Yandex Cloud Postbox, a secure TLS connection is used at all times. The transmission protocol depends on the sending method:

• HTTPS: If using an Amazon API compatible API.
• SMTP over TLS: If using port 465.
• STARTTLS: If using port 587.

The Delivery settings option:

• With Delivery settings off, Yandex Cloud Postbox will still try to use TLS to send emails. If there is a TLS error or the recipient's server does not support TLS, the email will be sent unencrypted.
• With Delivery settings on, Yandex Cloud Postbox will require a valid TLS certificate issued by a trusted CA and support for the minimum TLS version specified in the configuration settings. If the recipient's server does not meet these requirements, the email will not be delivered, and you will get a non-delivery notification.

Applying a configuration to an emailApplying a configuration to an email

You can apply a configuration to an email using the following methods:

• By associating the configuration with an address: In this case, the configuration will apply to all emails sent from this address.

  You can associate a configuration only with an address with domain ownership confirmed. One address can be associated with one configuration only; however, one configuration can be associated with more than one address.

• By providing the configuration name in the X-Ses-Configuration-Set header.

  The configuration must reside in the same folder as the address. If no configuration of the given name is found in the folder the address is in, you will get an error when sending your email. The configuration provided in the X-Ses-Configuration-Set header overrides the configuration associated with the address.

• By providing the configuration name in the ConfigurationSetName field, if using the AWS-compatible API SendEmail method.

  The configuration must reside in the same folder as the address. If no configuration of the given name is found in the folder the address is in, you will get an error when sending your email. The configuration provided in the ConfigurationSetName field overrides the configuration associated with the address.