Как начать работать с Yandex Cloud Postbox

С помощью этой инструкции вы создадите свой адрес и отправите проверочное письмо.

Перед началом работыПеред началом работы

Зарегистрируйтесь в Yandex Cloud и создайте платежный аккаунт:

1. Перейдите в консоль управления, затем войдите в Yandex Cloud или зарегистрируйтесь.
2. На странице Yandex Cloud Billing убедитесь, что у вас подключен платежный аккаунт, и он находится в статусе ACTIVE или TRIAL_ACTIVE. Если платежного аккаунта нет, создайте его и привяжите к нему облако.

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

Подробнее об облаках и каталогах.

Создайте сервисный аккаунт и ключиСоздайте сервисный аккаунт и ключи

1. Создайте сервисный аккаунт postbox-user и назначьте ему роль postbox.sender.

2. Создайте ключ для сервисного аккаунта:

   • Для отправки письма с помощью AWS CLI создайте статический ключ доступа. Надежно сохраните идентификатор и секретный ключ. После того как вы закроете окно, параметры секретного ключа станут недоступны.
   • Для отправки письма по протоколу SMTP создайте API-ключ. При создании API-ключа задайте область действия yc.postbox.send. Надежно сохраните полученный секретный ключ. После того как вы закроете окно, параметры секретного ключа станут недоступны.

3. Сгенерируйте ключ для создания DKIM-подписи:

   openssl genrsa -out privatekey.pem 2048
   

Создайте адресСоздайте адрес

Пройдите проверку владения доменомПройдите проверку владения доменом

Чтобы отправлять письма, подтвердите владение доменом. После создания адреса на его странице сформируются настройки DKIM-подписи. Их нужно указать в качестве значений ресурсной записи, которую необходимо добавить в вашу доменную зону. Вы можете добавить запись у вашего регистратора или в сервисе Yandex Cloud DNS, если вы делегировали ваш домен.

Пример создания ресурсной записи в Cloud DNS

Отправьте проверочное письмоОтправьте проверочное письмо

Отправить проверочное письмо можно с помощью AWS CLI или из почтового клиента по протоколу SMTP.

AWS CLIAWS CLI

1. Установите утилиту командной строки AWS CLI.

2. Настройте AWS CLI:

   1. Запустите интерактивную настройку профиля:

      aws configure
      

   2. Укажите полученный ранее идентификатор ключа сервисного аккаунта postbox-user:

      AWS Access Key ID [****************ver_]: <идентификатор_ключа_сервисного_аккаунта>
      

   3. Укажите полученный ранее секретный ключ сервисного аккаунта postbox-user:

      AWS Secret Access Key [****************w5lb]: <секретный_ключ_сервисного_аккаунта>
      

   4. Укажите имя региона по умолчанию ru-central1:

      Default region name [ru-central1]: ru-central1
      

   5. Укажите формат выходных данных по умолчанию json:

      Default output format [None]: json
      

3. Подготовьте два JSON-файла:

   • destination.json — файл со списком адресов назначения:

     {
       "ToAddresses": ["test@example.com"]
     }
     

   • message.json — файл с темой и содержимым письма:

     {
       "Simple": {
         "Subject": {
           "Data": "Test message",
           "Charset": "UTF-8"
         },
         "Body": {
           "Text": {
             "Data": "Test message. Hello!",
             "Charset": "UTF-8"
           }
         }
       }
     }
     

4. Отправьте письмо с помощью AWS CLI:

   aws sesv2 send-email \
     --from-email-address mail@example.com \
     --destination file://destination.json \
     --content file://message.json \
     --endpoint-url https://postbox.cloud.yandex.net
   

5. Проверьте почтовый ящик, указанный в destination.json, — туда должно прийти письмо.

SMTPSMTP

1. В настройках SMTP-сервера вашего почтового клиента укажите следующие параметры:

   • имя сервера — postbox.cloud.yandex.net;
   • порт — 587;
   • имя пользователя — API_KEY;
   • пароль — секретная часть созданного API-ключа.

   Примечание

   Почтовый клиент должен поддерживать расширение STARTTLS для шифрования передаваемых писем.

2. Отправьте письмо с помощью вашего почтового клиента и убедитесь, что оно пришло на указанные адреса.

См. такжеСм. также

• Уведомления о доставке писем
• Отправление письма