Настройка Postfix для отправки через Yandex Cloud Postbox

В этом руководстве вы научитесь отправлять электронные письма через Yandex Cloud Postbox с использованием Postfix на виртуальной машине Yandex Compute Cloud.

Чтобы начать отправлять электронные письма:

1. Подготовьте облако к работе.
2. Создайте ВМ для Postfix.
3. Установите и настройте Postfix.
4. Отправьте письмо.
5. Отправьте MIME-письмо с вложением.

Если созданные ресурсы вам больше не нужны, удалите их.

Подготовьте облако к работеПодготовьте облако к работе

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

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

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

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

Необходимые платные ресурсыНеобходимые платные ресурсы

В стоимость поддержки инфраструктуры входят:

• плата за постоянно запущенную ВМ (см. тарифы Yandex Compute Cloud);
• плата за использование публичного IP-адреса (см. тарифы Yandex Virtual Private Cloud);
• плата за использование Yandex Cloud Postbox (см. тарифы Yandex Cloud Postbox);
• плата за публичные DNS-запросы и зоны DNS, если вы создаете ресурсную запись в Cloud DNS (см. тарифы Cloud DNS).

Подготовьте ресурсыПодготовьте ресурсы

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

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

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

4. Назначьте сервисному аккаунту роль postbox.sender.

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

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

Создайте ВМ для PostfixСоздайте ВМ для Postfix

Установите и настройте PostfixУстановите и настройте Postfix

1. Подключитесь к ВМ по SSH:

   ssh -i <путь_к_закрытому_SSH-ключу> <имя_пользователя_ВМ>@<публичный_IP-адрес_ВМ>
   

2. Установите Postfix и необходимые модули:

   sudo apt update
   sudo apt install -y postfix libsasl2-modules
   

3. После установки в терминале появится интерфейс настройки Postfix:

   1. На первом шаге выберите Internet with smarthost, затем с помощью клавиш TAB и Enter нажмите OK.
   2. Нажмите OK на всех последующих шагах.
   3. Дождитесь завершения настройки.

4. Выполните команду настройки Postfix:

   sudo postconf -e \
   "relayhost = postbox.cloud.yandex.net:587" \
   "smtp_sasl_auth_enable = yes" \
   "smtp_sasl_security_options = noanonymous" \
   "smtp_sasl_password_maps = hash:/etc/postfix/sasl_passwd" \
   "smtp_use_tls = yes" \
   "smtp_tls_security_level = secure" \
   "smtp_tls_note_starttls_offer = yes"
   

5. Проверьте, не задана ли в конфигурации директива резервного узла доставки, и отключите ее:

   1. Откройте файл /etc/postfix/master.cf и найдите строку:

      -o smtp_fallback_relay=
      

   2. Если такая строка есть, закомментируйте ее, добавив символ # в начало строки.

   3. Сохраните файл.

6. Укажите учетные данные SMTP для Yandex Cloud Postbox:

   1. Откройте (или создайте) файл /etc/postfix/sasl_passwd и добавьте в него строку:

      postbox.cloud.yandex.net:587 SMTP_USERNAME:SMTP_PASSWORD
      

   2. Аутентифицируйтесь:

      API-ключ

      Cтатический ключ доступа

      В файле /etc/postfix/sasl_passwd:

      • Замените SMTP_USERNAME на идентификатор API-ключа, который вы получили при подготовке ресурсов.
      • Замените SMTP_PASSWORD на секретную часть API-ключа.

      1. Создайте файл generate.py и вставьте в него код:

         #!/usr/bin/env python3
         
         import hmac
         import hashlib
         import base64
         import argparse
         import sys
         
         # These values are required to calculate the signature. Do not change them.
         DATE = "20230926"
         SERVICE = "postbox"
         MESSAGE = "SendRawEmail"
         REGION = "ru-central1"
         TERMINAL = "aws4_request"
         VERSION = 0x04
         
         
         def sign(key, msg):
             return hmac.new(key, msg.encode("utf-8"), hashlib.sha256).digest()
         
         
         def calculate_key(secret_access_key):
             signature = sign(("AWS4" + secret_access_key).encode("utf-8"), DATE)
             signature = sign(signature, REGION)
             signature = sign(signature, SERVICE)
             signature = sign(signature, TERMINAL)
             signature = sign(signature, MESSAGE)
             signature_and_version = bytes([VERSION]) + signature
             smtp_password = base64.b64encode(signature_and_version)
             return smtp_password.decode("utf-8")
         
         
         def main():
             if sys.version_info[0] < 3:
                 raise Exception("Must be using Python 3")
         
             parser = argparse.ArgumentParser(
                 description="Convert a Secret Access Key to an SMTP password."
             )
             parser.add_argument("secret", help="The Secret Access Key to convert.")
             args = parser.parse_args()
         
             print(calculate_key(args.secret))
         
         
         if __name__ == "__main__":
             main()
         

      2. Сгенерируйте пароль:

         python3 generate.py <секретный_ключ>
         

         Где <секретный_ключ> — секретный ключ статического ключа доступа сервисного аккаунта, который вы получили при подготовке ресурсов.

         Используйте Python не ниже версии 3.

      3. В файле /etc/postfix/sasl_passwd:

         • Замените SMTP_USERNAME на идентификатор статического ключа доступа.
         • Замените SMTP_PASSWORD на сгенерированный пароль.

   3. Сохраните файл /etc/postfix/sasl_passwd.

7. Создайте хеш-таблицу с учетными данными:

   sudo postmap hash:/etc/postfix/sasl_passwd
   

8. (Рекомендуется) Ограничьте доступ к файлам с учетными данными:

   sudo chown root:root /etc/postfix/sasl_passwd /etc/postfix/sasl_passwd.db
   sudo chmod 0600 /etc/postfix/sasl_passwd /etc/postfix/sasl_passwd.db
   

9. Укажите корневой сертификат для проверки TLS-соединения:

   sudo postconf -e 'smtp_tls_CAfile = /etc/ssl/certs/ca-certificates.crt'
   

10. Перезапустите Postfix, чтобы применить настройки:

    sudo systemctl restart postfix
    

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

В этом примере вы отправите письмо с простым текстом без вложений.

1. Выполните команду:

   sendmail -f <адрес_отправителя> <адрес_получателя>
   

   Важно

   Здесь и далее адрес отправителя должен соответствовать домену, для которого вы проходили проверку владения при подготовке ресурсов.

2. Вставьте в терминал следующий текст и нажмите Enter:

   From: <адрес_отправителя>
   Subject: Test Yandex Cloud Postbox via Postfix
   
   This is a test message sent via Yandex Cloud Postbox (SMTP, Postfix).
   .
   

3. Проверьте почтовый ящик получателя.

   Если письмо не пришло, изучите лог Postfix: /var/log/mail.log.

Отправьте MIME-письмо с вложениемОтправьте MIME-письмо с вложением

В этом примере вы отправите письмо с текстом в формате HTML и прикрепленным файлом example.txt.

1. Создайте файл mime-email.txt и вставьте в него код:

   From: <адрес_отправителя>
   Subject: Test email via Yandex Cloud Postbox
   MIME-Version: 1.0
   Content-Type: multipart/mixed; boundary="BOUNDARY-OUTER"
   
   --BOUNDARY-OUTER
   Content-Type: multipart/alternative; boundary="BOUNDARY-INNER"
   
   --BOUNDARY-INNER
   Content-Type: text/plain; charset=UTF-8
   Content-Transfer-Encoding: quoted-printable
   
   This is the plain text part sent via Yandex Cloud Postbox SMTP.
   
   --BOUNDARY-INNER
   Content-Type: text/html; charset=UTF-8
   Content-Transfer-Encoding: quoted-printable
   
   <html>
     <body>
       <h1>Hello!</h1>
       <p>This is the HTML part sent via Yandex Cloud Postbox SMTP.</p>
     </body>
   </html>
   --BOUNDARY-INNER--
   
   --BOUNDARY-OUTER
   Content-Type: application/octet-stream
   MIME-Version: 1.0
   Content-Transfer-Encoding: base64
   Content-Disposition: attachment; filename="example.txt"
   
   U2FtcGxlIGF0dGFjaG1lbnQgY29udGVudA==
   --BOUNDARY-OUTER--
   

   Где:

   • From: — адрес отправителя.
   • Subject: — тема письма.

2. Отправьте письмо:

   sendmail -f <адрес_отправителя> <адрес_получателя> < mime-email.txt
   

3. Проверьте почтовый ящик получателя.

   Если письмо не пришло, изучите лог Postfix: /var/log/mail.log.

Удалите созданные ресурсыУдалите созданные ресурсы

Чтобы перестать платить за созданные ресурсы:

1. Удалите ВМ postfix-server.
2. Удалите адрес.
3. Удалите зону DNS, если создавали в ней ресурсную запись.