Documentation – Робота з SMTP клієнтом

Python-Net: Налаштування підключення SMTP‑клієнта

Mon, 01 Jan 0001 00:00:00 +0000

Підключитися до SMTP-сервера з SSL

Щоб встановити захищене з’єднання з SMTP‑сервером, який підтримує SSL, потрібно налаштувати наступні ключові властивості SmtpClient клас:

Хост: Адреса SMTP‑сервера (наприклад, smtp.gmail.com)
Порт: Порт, що використовується для зв’язку з SSL (зазвичай 465 для неявного SSL або 587 для явного SSL/TLS)
Ім’я користувача: Ім’я облікового запису, що використовується для автентифікації
Пароль: Пароль для SMTP‑акаунту
Опції безпеки: Тип шифрування, який буде використано (SSLEXPLICIT, SSLIMPLICIT, тощо)

Наступний приклад коду демонструє, як налаштувати та підключитися до SMTP‑сервера з підтримкою SSL:

Встановити тайм‑аут для відповіді привітання від сервера

При встановленні з’єднання з SMTP‑сервером сервер зазвичай надсилає рядок привітання після успішного підключення. Ця відповідь підтверджує, що сервер готовий продовжувати обмін.

У деяких сценаріях поштові клієнти працюють в режимі автоматичного підключення, пробуючи різні комбінації протоколів безпеки та портів (наприклад, неявний SSL або STARTTLS) для встановлення успішного з’єднання. Якщо конфігурація клієнта не відповідає очікуваному сервером режиму безпеки, сервер не надсилатиме рядок привітання. Таке невідповідність змушує клієнт чекати до закінчення загального тайм‑ауту перед спробою наступної комбінації — що призводить до повільної обробки підключення.

Щоб поліпшити цю поведінку, Aspose.Email надає greeting_timeout властивість у SmtpClient class. Ця властивість встановлює конкретний тайм‑аут (у мілісекундах) очікування рядка привітання сервера. Якщо привітання не отримано протягом вказаного інтервалу, клієнт негайно переходить до наступної конфігурації — значно прискорюючи процес автоматичного підключення.

Наступний приклад коду демонструє, як реалізувати властивість у проєкті:

import aspose.email as ae

client = ae.clients.smtp.SmtpClient("localhost", 25, "username", "password")
client.greeting_timeout = 4000

Надсилати листи через SMTP, використовуючи SOCKS‑проксі

Aspose.Email підтримує версії 4, 4a та 5 протоколу SOCKS‑проксі. Наступний приклад коду демонструє, як надіслати лист через SMTP з використанням SOCKS‑проксі:

import aspose.email as ae

client = ae.clients.smtp.SmtpClient("smtp.domain.com", "username", "password")

client.security_options = ae.clients.SecurityOptions.SSL_IMPLICIT
# proxy address
proxy_address = "192.168.203.142"
#proxy port
proxy_port = 1080
socks_proxy = ae.clients.SocksProxy(proxy_address, proxy_port, ae.clients.SocksVersion.SOCKS_V5)
client.proxy = socks_proxy
client.send(ae.MailMessage("sender@domain.com", "receiver@domain.com", "Sending Email via proxy", "Implement socks proxy protocol for versions 4, 4a, 5 (only Username/Password authentication)"))

Надсилати листи через SMTP, використовуючи HTTP‑проксі

Нижче наведений приклад коду демонструє використання HTTP‑проксі для надсилання електронного листа через SMTP‑сервер:

import aspose.email as ae

http_proxy = ae.clients.HttpProxy("18.222.124.59", 8080)
client = ae.clients.smtp.SmtpClient("host", 587, "username", "password")
client.proxy = http_proxy
client.send(ae.MailMessage("sender@domain.com", "receiver@domain.com", "Sending Email via proxy", "Body"))

Виберіть підтримувані методи SMTP‑автентифікації у Python

Щоб забезпечити безпечне та сумісне підключення до SMTP‑сервера, важливо використовувати метод автентифікації, підтримуваний як клієнтом, так і сервером. Aspose.Email for Python via .NET надає вбудовані властивості для керування цим:

supported_authentication — отримує список методів автентифікації, підтримуваних SMTP‑сервером.
allowed_authentication — отримує або встановлює методи автентифікації, які дозволено використовувати клієнту.

Використовуючи ці властивості, розробники можуть узгодити можливості клієнта з вимогами сервера та уникнути невдач автентифікації під час процесу підключення.

Наступний фрагмент коду демонструє, як вказати дозволений метод SMTP‑автентифікації, використовуючи allowed_authentication властивість:

client.allowed_authentication = ae.clients.smtp.SmtpKnownAuthenticationType.LOGIN

Встановити тайм‑аут SMTP‑сервера

При надсиланні електронних листів по мережі встановлення відповідного тайм‑ауту є важливим, щоб запобігти зависанню вашого застосунка, якщо сервер не відповідає. timeout властивість SmtpClient class у Aspose.Email for Python via .NET дозволяє визначити максимальний час очікування (у мілісекундах) на відповіді сервера.

Ця властивість застосовується до операцій, таких як встановлення з’єднання або надсилання SMTP‑команд. Якщо сервер не відповідає протягом заданого часу, клієнт викидає виключення тайм‑ауту, що допомагає ефективніше обробляти не відповідаючі сервери.

Використайте наведений фрагмент коду, щоб встановити час очікування відповіді сервера:

import aspose.email as ae

client = ae.clients.smtp.SmtpClient("host", 587, "username", "password", ae.clients.SecurityOptions.SSL_EXPLICIT)
# 60 seconds
client.timeout = 60000

Увімкнути шифрування TLS для безпечних SMTP‑з’єднань

Aspose.Email підтримує захищений зв’язок з SMTP‑сервером за допомогою криптографічних протоколів SSL та TLS. Ці протоколи захищають дані, які обмінюються між вашим застосунком і поштовим сервером, забезпечуючи конфіденційність та цілісність під час передачі.

NOTE: Only versions of SSL/TLS supported by your current Python framework can be applied. Unsupported protocol versions will be silently ignored without raising exceptions. If you need to bypass compatibility checks and explicitly set the encryption protocols, use the `set_supported_encryption_unsafe(value)` method of the [SmtpClient](https://reference.aspose.com/email/python-net/aspose.email.clients.smtp/smtpclient/#smtpclient-class) class.

Наступний приклад коду демонструє, як встановити TLS 1.3 для SMTP‑зв’язку:

import aspose.email as ae

client = ae.clients.smtp.SmtpClient("host", 587, "username", "password", ae.clients.SecurityOptions.SSL_EXPLICIT)
client.supported_encryption = ae.clients.base.EncryptionProtocols.TLS13

Використання механізму CRAM-MD5 для автентифікації

Aspose.Email for Python via .NET підтримує механізм автентифікації CRAM-MD5, що підвищує безпеку, уникаючи передачі паролів у відкритому вигляді під час SMTP‑автентифікації. Цей метод особливо корисний при підключенні до серверів, що вимагають автентифікації challenge‑response.

Щоб увімкнути автентифікацію CRAM-MD5, встановіть allowed_authentication властивість SmtpClient class до CRAM_MD5, як показано у наступному прикладі коду:

client.allowed_authentication = ae.clients.smtp.SmtpKnownAuthenticationType.CRAM_MD5

Python-Net: Надсилання листів та пересилання повідомлень через SMTP у Python

Mon, 01 Jan 0001 00:00:00 +0000

The SmtpClient клас у Aspose.Email for Python via .NET забезпечує надійний та гнучкий інтерфейс для надсилання електронних листів за допомогою протоколу Simple Mail Transfer Protocol (SMTP). Це основна точка входу для розробників, які хочуть доставляти електронні повідомлення у своїх застосунках.

Ключові особливості SmtpClient включення класу:

SMTP доставка електронної пошти: Дозволяє надсилати листи безпосередньо через SMTP-сервер.
Альтернативні варіанти доставки: Підтримує додаткові методи доставки, такі як збереження повідомлень у файлову систему або запис у чергу повідомлень.
Синхронні та асинхронні операції:
- Синхронний режим: Використовуйте методи Send, щоб заблокувати поточний потік, доки електронна пошта не буде повністю передана.
- Асинхронний режим: Використовуйте методи SendAsync для надсилання повідомлень у фоні, дозволяючи застосунку залишатися реактивним.
Підтримка TNEF: Дозволяє надсилати повідомлення у форматі Transport Neutral Encapsulation Format (TNEF) для сумісності з функціями Microsoft Outlook.

У цій статті розглядаються всі основні функціональності, доступні через SmtpClient клас, демонструючи, як надсилати стандартні та розширені листи з повним контролем над конфігурацією та доставкою.

Синхронне надсилання листів

The SmtpClient.send метод дозволяє синхронно надсилати електронне повідомлення. Такий підхід корисний, коли застосунок потребує підтвердження доставки перед подальшою роботою.

Щоб синхронно надіслати простий текстовий лист за допомогою Aspose.Email для Python через .NET, скористайтеся нижченаведеними кроками та прикладом коду:

Створіть MailMessage екземпляр і встановіть відправника, одержувач(ів), тему та тіло листа.
Налаштуйте SmtpClient з хостом сервера, портом, ім’ям користувача та паролем.
Викличте send метод на SmtpClient екземпляр і передайте у MailMessage об’єкт.

# Create email
eml = ae.MailMessage()
eml.subject = "Message with Plain Text Body"
eml.body = "This is text body."
eml.from_address = "from@gmail.com"
eml.to.append(ae.MailAddress("to@gmail.com", "Recipient 1")) 

# Configure SmtpClient object
client = SmtpClient("smtp.gmail.com", 995, "username", "password")
client.security_options = SecurityOptions.AUTO 

# Send email
client.send(eml)

Асинхронне надсилання листів не підтримується API.

Надіслати заздалегідь створений файл EML через SMTP

Якщо вам потрібно надіслати електронне повідомлення, яке вже створено та збережено у форматі EML, ви можете завантажити та надіслати його програмно за допомогою Aspose.Email for Python via .NET.

Наступний фрагмент коду зі кроками демонструє, як надіслати файл EML за допомогою SmtpClient:

Завантажте файл EML за допомогою MailMessage.load метод.
Створіть та налаштуйте екземпляр SmtpClient, вказуючи хост SMTP-сервера, ім’я користувача та пароль для аутентифікації.
Викличте send метод на SmtpClient екземпляр і передайте завантажене повідомлення.

import aspose.email as ae

message = ae.MailMessage.load("test.eml")

# Send this message using SmtpClient
client = ae.clients.SmtpClient("host", "username", "password")
client.send(message)

Надіслати простий текстовий лист

Ви можете надіслати простий текстовий лист за допомогою Aspose.Email, вказавши тіло повідомлення як простий текст. MailMessage.body властивість використовується для визначення вмісту, тоді як SmtpClient клас обробляє процес надсилання.

Наступний фрагмент коду зі кроками демонструє, як надіслати простий текстовий лист:

Створіть екземпляр MailMessage клас.
Встановіть електронні адреси відправника та отримувача.
Призначте простий текстовий вміст властивості body.
Створіть екземпляр SmtpClient клас з деталями сервера та обліковими даними.
Надішліть електронний лист, використовуючи send метод.

Надіслати HTML лист

Aspose.Email for Python via .NET дозволяє надсилати листи з HTML‑форматованим тілом, використовуючи MailMessage клас. Присвоюючи HTML‑вміст до html_body властивість і налаштування is_body_html на True, ви можете створювати багаті, стилизовані повідомлення.

Наступний приклад коду зі кроками демонструє, як надіслати HTML‑листа:

Створіть екземпляр MailMessage клас.
Встановіть електронні адреси відправника та отримувача.
Встановити is_body_html = True щоб вказати HTML‑форматування.
Призначте ваш HTML‑вміст до html_body властивість.
Створіть і налаштуйте SmtpClient екземпляр.
Використайте send метод для передачі повідомлення.

Примітка: Хоча цей приклад використовує базовий HTML, ви можете додати більш складні HTML‑структури для створення адаптивних і брендованих макетів листів.

Надіслати HTML лист з альтернативою у вигляді простого тексту

При надсиланні HTML‑листь, найкращою практикою є включення простого текстового варіанту для отримувачів, чия поштові клієнти не підтримують HTML. Aspose.Email for Python via .NET пропонує AlternateView клас, щоб включати і HTML, і простий текст в один лист, підвищуючи сумісність та зручність для користувачів.

Наступний приклад коду та кроки демонструють, як надіслати лист з альтернативним текстовим вмістом:

Створіть екземпляр MailMessage клас.
Встановіть електронні адреси відправника та отримувача.
Призначте HTML‑вміст до html_body властивість і встановіть is_body_html = True.
Створіть простий текстовий AlternateView за допомогою create_alternate_view_from_string.
Додайте альтернативний вигляд до alternate_views колекція MailMessage.
Створіть і налаштуйте SmtpClient екземпляр.
Надішліть електронний лист, використовуючи send метод.

Як надсилати масові листи

Надсилання масових листів передбачає одночасне надсилання кількох повідомлень — кожне, можливо, адресоване різному одержувачу. Aspose.Email забезпечує цю можливість за допомогою SmtpClient клас.

Нижче наведений приклад коду демонструє, як надіслати пакет листів за один раз:

Створіть екземпляр SmtpClient клас і налаштуйте його host, port, облікові дані та параметри безпеки.
Створіть кілька MailMessage екземпляри — кожен представляє окреме електронне повідомлення.
Вкажіть відправника, одержувача, тему та тіло повідомлення для кожного листа.
Додайте всі MailMessage об’єкти до MailMessageCollection.
Викличте send метод SmtpClient клас, передаючи MailMessageCollection як аргумент.

import aspose.email as ae
from aspose.email.clients import SmtpClient, SecurityOptions
from aspose.email import MailMessage, MailMessageCollection

# Create individual email messages
message1 = MailMessage("from@gmail.com", "to1@gmail.com", "Bulk Email - Message 1", "Hello, this is message 1.")
message2 = MailMessage("from@gmail.com", "to2@gmail.com", "Bulk Email - Message 2", "Hello, this is message 2.")
message3 = MailMessage("from@gmail.com", "to3@gmail.com", "Bulk Email - Message 3", "Hello, this is message 3.")

# Add messages to a collection
many_messages = MailMessageCollection()
many_messages.append(message1)
many_messages.append(message2)
many_messages.append(message3)

# Configure SMTP client
client = SmtpClient("smtp.gmail.com", 995, "username", "password")
client.security_options = SecurityOptions.AUTO

# Send all messages in bulk
client.send(many_messages)

Надсилати листи з підтримкою мультиз’єднань

Aspose.Email for Python via .NET дозволяє використовувати кілька одночасних з’єднань під час надсилання листів через SmtpClient клас. Ця функція може допомогти оптимізувати продуктивність при надсиланні великої кількості листів, розподіляючи навантаження між кількома з’єднаннями. Однак пам’ятайте, що увімкнення режиму мультиз’єднань не гарантує підвищення продуктивності у всіх випадках — це залежить від конфігурації сервера та мережевих умов.

Ключові властивості:

use_multi_connection: Увімкнути або вимкнути режим мультиз’єднань для SMTP‑клієнта.
connections_quantity: Визначає кількість з’єднань, які відкриватимуться при увімкненому режимі мультиз’єднань.

Наступний приклад коду показує, як увімкнути режим мультиз’єднань:

Створіть та налаштуйте екземпляр SmtpClient.
Вкажіть параметри сервера, такі як host, port, ім’я користувача, пароль та шифрування.
Увімкніть режим мультиз’єднань, встановивши use_multi_connection.
Вкажіть кількість з’єднань за допомогою connections_quantity.

import aspose.email as ae

client = ae.clients.smtp.SmtpClient
client.host = "<HOST>"
client.username = "<USERNAME>"
client.password = "<PASSWORD>"
client.port = 587
client.supported_encryption = ae.clients.base.EncryptionProtocols.TLS
client.security_options = ae.clients.SecurityOptions.SSL_EXPLICIT

client.connections_quantity = 5
client.use_multi_connection = ae.clients.MultiConnectionMode.ENABLE
client.send(messages)

Надіслати листи у форматі TNEF

Transport Neutral Encapsulation Format (TNEF) — це пропрієтарний формат електронної пошти, що використовується Microsoft Outlook та Exchange для збереження багатого форматування, вбудованих об’єктів і спеціальних функцій, таких як кнопки голосування. Стандартні поштові клієнти можуть не зберігати це форматування під час використання типових повідомлень на основі MIME.

Aspose.Email for Python via .NET підтримує надсилання листів у форматі TNEF, щоб забезпечити збереження всіх розширених форматувань та функцій. Це досягається шляхом увімкнення use_tnef властивість SmtpClient клас.

Наступний приклад коду та кроки демонструють, як надіслати лист у форматі TNEF:

Завантажте існуюче EML‑повідомлення або створіть нове за допомогою MailMessage клас.
Встановіть адреси відправника та отримувача.
Увімкніть форматування TNEF, встановивши use_tnef = True на SmtpClient екземпляр.
Надішліть повідомлення, використовуючи send() метод.

Надіслати запити на зустрічі електронною поштою

Microsoft Outlook та інші поштові клієнти з підтримкою календаря, такі як IBM Lotus Notes, дозволяють користувачам керувати зустрічами безпосередньо зі своєї поштової скриньки. Коли користувач отримує запрошення на зустріч, він може прийняти або відхилити його безпосередньо у своєму поштовому клієнті. За допомогою Aspose.Email for Python via .NET розробники можуть програмно створювати та надсилати такі запрошення у відповідності зі стандартом iCalendar (RFC 2445).

Як надсилати запрошення на зустрічі електронною поштою

Aspose.Email забезпечує вбудовану підтримку створення та надсилання запитів на зустріч iCalendar у складі листа. Ці запити сумісні з популярними календарними клієнтами і дозволяють одержувачам легко відповідати на запрошення.

|Запит на зустріч iCalendar, надісланий електронною поштою| | :- | ||

Наступний фрагмент коду показує, як надсилати запити електронною поштою:

Створіть MailMessage екземпляр.
Вкажіть електронні адреси відправника та отримувача.
Створіть Appointment об’єкт з місцем, часом початку/закінчення, відправником та одержувачами.
Встановіть резюме та опис зустрічі.
Прикріпіть зустріч до листа, використовуючи add_alternate_view().
Надішліть електронний лист, використовуючи SmtpClient.

Підтримка iCalendar для IBM Lotus Notes

Aspose.Email використовує формат iCalendar (RFC 2445), що забезпечує сумісність ваших запитів на зустрічі з Microsoft Outlook, IBM Lotus Notes та іншими клієнтами, які підтримують цей стандарт. Той самий процес можна застосовувати незалежно від платформи отримувача.

Переадресовувати листи за допомогою SMTP‑клієнта

Переадресація листів — поширене завдання у цифровій комунікації, часто використовується для поширення отриманих повідомлень. Aspose.Email for Python via .NET дозволяє розробникам програмно переадресовувати листи, використовуючи SmtpClient клас. Метод forward дозволяє переадресовувати збережені або отримані листи новим одержувачам без участі оригінального відправника.

Нижче наведений приклад коду демонструє, як переадресувати лист, використовуючи MailMessage клас:

Переадресовувати EML‑файли без завантаження у MailMessage

Aspose.Email також підтримує пряме переадресування .eml‑файлів без попереднього завантаження їх у MailMessage об’єкт. Це особливо корисно у випадках, коли потрібно мінімізувати використання пам’яті системи.

Нижче наведений приклад коду демонструє, як безпосередньо переадресувати файл EML:

import aspose.email as ae

client = ae.clients.smtp.SmtpClient(host, smtp_port, username, password, ae.clients.SecurityOptions.AUTO)
file = open("test.eml", "rb")
client.forward(sender, recipients, file)

Python-Net: Отримати розширення SMTP-сервера | Перевірити облікові дані SMTP

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Email SmtpClient клас забезпечує розширені можливості поза простим надсиланням листів. Він дозволяє розробникам:

Отримання підтримуваних розширень сервера таких як IDLE, UNSELECT, QUOTA тощо, щоб забезпечити сумісність перед використанням певних функцій.
Перевірка облікових даних SMTP без фактичного надсилання листа, що корисно для верифікації входу та тестування з’єднання.

Отримання розширень SMTP-сервера

Перед використанням конкретних функцій SMTP корисно перевірити, які розширення підтримує поштовий сервер. get_capabilities() метод отримує їх у вигляді списку рядків.

Нижче наведено фрагмент коду, який показує, як отримати розширення сервера:

Перевірка облікових даних SMTP без надсилання листа

Щоб перевірити, чи є надані облікові дані дійсними — без надсилання тестового повідомлення — ви можете використати validate_credentials() метод SmtpClient клас. Це корисно для перевірки автентифікації та діагностики системи.

Нижче наведено приклад коду, який можна використати для перевірки облікових даних, наданих для автентифікації з SMTP-сервером, без надсилання листа:

import aspose.email as ae

client = ae.clients.smtp.SmtpClient("Url", port, "username", "password", ae.clients.SecurityOptions.AUTO)
client.timeout = 4000   # Set timeout in milliseconds

# Validate login
if client.validate_credentials():
    print("Credentials are valid.")
else:
    print("Invalid credentials or unable to connect.")

Python-Net: Увімкнути журналювання активності SMTP-клієнта

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Email для Python через .NET забезпечує вбудовану підтримку журналювання активності SMTP. Ця функція — зазвичай називана журналюванням активності — дозволяє розробникам систематично відстежувати транзакції електронної пошти, події або помилки під час процесу надсилання. Це може бути особливо корисно для налагодження, аудиту або підтримки прозорості операцій у серверних застосунках.

The SmtpClient клас пропонує такі властивості для ввімкнення та налаштування журналювання активності:

log_file_name: Вказує повний шлях та назву файлу журналу.
use_date_in_log_file_name: Визначає, чи слід додавати поточну дату до імені файлу журналу, що корисно для створення щоденних журналів.

Наведений нижче приклад коду демонструє, як увімкнути журналювання активності SMTP у коді програми:

import aspose.email as ae

# Initialize and configure the SMTP client
client = ae.clients.smtp.SmtpClient
client.host = "<HOST>"
client.username = "<USERNAME>"
client.password = "<PASSWORD>"
client.port = 587
client.security_options = ae.clients.SecurityOptions.SSL_EXPLICIT

# Set the log file name and enable/disable date in file name
client.log_file_name = "C:\Aspose.Email.Smtp.log"

# Set to True to append current date
client.use_date_in_log_file_name = False

# Prepare and send the email
eml = ae.MailMessage("from address", "to address", "this is a test subject", "this is a test body")
client.send(eml)

Python-Net: Утилітні функції – SMTP Client

Mon, 01 Jan 0001 00:00:00 +0000

Перелік розширень сервера за допомогою Smtp Client

Pop3Client від Aspose.Email дозволяє отримати розширення сервера, які підтримує сервер, такі як IDLE, UNSELECT, QUOTA тощо. Це допомагає визначити наявність розширення перед використанням клієнта для конкретної функціональності. Метод GetCapabilities() повертає типи підтримуваних розширень у вигляді масиву рядків.

Отримання розширень сервера

Наступний фрагмент коду показує, як отримати розширення сервера.

Перевірка облікових даних поштового сервера без надсилання листа

Метод ‘validate_credentials()’ класу SmtpClient клас використовується для перевірки дійсності наданих облікових даних шляхом встановлення з’єднання з SMTP‑сервером. Якщо облікові дані дійсні і з’єднання успішне, можна виконувати подальші дії. Наступний приклад коду можна використати для перевірки облікових даних, наданих для автентифікації на SMTP‑сервері, без надсилання листа:

import aspose.email as ae

client = ae.clients.smtp.SmtpClient("Url", port, "username", "password", ae.clients.SecurityOptions.AUTO)
client.timeout = 4000

if client.validate_credentials():
  # to do something