Настройка почты Amazon SES

1. Подтвердите отправителя в регионе AWS

Откройте Amazon SES в US East (N. Virginia), us-east-1. Выберите Configuration → Identities → Create identity, укажите домен или адрес и завершите проверку DNS или электронной почты. Ниже используйте тот же регион и подтверждённого отправителя.

Новые аккаунты SES работают в песочнице: подтвердите и получателя либо используйте симулятор почтовых ящиков SES. Перед отправкой обычным клиентам запросите доступ к рабочей среде в Account dashboard. Открыть Amazon SES

2. Для SMTP выберите IAM SMTP credentials

В SES откройте SMTP settings → Create SMTP credentials. Выберите IAM SMTP credentials вместо Mail Manager с меткой Recommended. Карточка IAM содержит Manual credential management. No traffic policies or rule sets. Нажмите Create IAM credentials, задайте имя пользователя для отправки и скачайте данные SMTP до закрытия страницы.

Создать данные IAM · Управлять существующими

Эти ссылки используют us-east-1, где доступен классический IAM SMTP. Для другого поддерживаемого региона создайте его данные и используйте соответствующий SMTP-адрес. Скачанный пароль SMTP отличается от секретного ключа AWS; используйте его только в шаге 5. Инструкция AWS по SMTP

3. Избегайте лишних расходов Mail Manager

IAM SMTP и SES SDK отправляют напрямую через SES без политик трафика и наборов правил Mail Manager. Не создавайте необязательную открытую или mTLS-точку входа: по тарифу à la carte AWS указывает 50 долларов в месяц за точку. Аутентифицированные точки сейчас бесплатны, поэтому Recommended не всегда добавляет 50 долларов. Обычная стоимость отправки и выбранного плана сохраняется. Актуальные цены AWS

4. Отправляйте через AWS SDK

Этот режим использует API SES по HTTPS. В IAM дайте роли сервера или отдельному пользователю отправки право ses:SendEmail на подтверждённую идентичность SES. Для пользователя откройте Security credentials → Create access key и сохраните исходные ID и секретный ключ. Пароль SMTP не подходит для подписи запросов SDK.

В разработке поместите пример в apps/web/.env.local, в рабочей среде — в секреты хостинга. Замените отправителя и примеры значений. С ролью IAM или настроенным локальным профилем AWS оставьте оба поля ключей и AWS_SESSION_TOKEN пустыми: SDK использует стандартную цепочку. Явно заданные ключи требуют полной пары.

Для явно заданных временных данных укажите соответствующий AWS_SESSION_TOKEN и обновляйте все три значения после истечения срока. Данные роли обновляются SDK. Цепочка данных AWS SDK

EMAIL_PROVIDER=ses
EMAIL_FROM=Your App <[email protected]>
AWS_REGION=us-east-1
AWS_ACCESS_KEY_ID=<IAM-access-key-id>
AWS_SECRET_ACCESS_KEY=<original-IAM-secret-access-key>
# Temporary explicit credentials only:
AWS_SESSION_TOKEN=

5. Или используйте классический IAM SMTP

В альтернативной конфигурации используйте имя и пароль SMTP из шага 2. Порт 587 использует STARTTLS; SMTP_SECURE=false выбирает этот режим. Адрес, данные и подтверждённый отправитель должны относиться к одному региону.

Эти настройки комплекта покупателя общие для трёх платформ. Выберите один режим: EMAIL_PROVIDER=smtp использует данные SMTP, EMAIL_PROVIDER=ses — данные API SDK.

EMAIL_PROVIDER=smtp
EMAIL_FROM=Your App <[email protected]>
SMTP_HOST=email-smtp.us-east-1.amazonaws.com
SMTP_PORT=587
SMTP_SECURE=false
SMTP_USER=<downloaded-SMTP-username>
SMTP_PASSWORD=<downloaded-SMTP-password>

6. Настройте один раз для всех трёх платформ

Перезапустите сервер после изменений. С применёнными миграциями запросите код входа через /auth для разрешённого получателя и проверьте входящие и спам. Мобильное приложение обращается к тому же серверу; настольное загружает веб-приложение. Клиентам не нужны ключи AWS или пароль SMTP.

Храните данные только на сервере, никогда в NEXT_PUBLIC_, EXPO_PUBLIC_ или настольном пакете. При ошибках проверьте отправителя, ограничения песочницы, регион, права IAM и тип данных. queued означает принятие письма SES, а не доставку в ящик. Обзор настройки почты