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 за Python чрез .NET предоставя вграден свойства за управление на това:

supported_authentication — извлича списък с методи за удостоверяване, подкрепяни от SMTP сървъра.
allowed_authentication — получава или задава методите за удостоверяване, които клиентът може да използва.

Чрез използването на тези свойства, разработчиците могат да съгласуват възможностите на клиента с изискванията на сървъра и да избегнат провали при удостоверяване по време на процеса на свързване.

Следният кодов фрагмент демонстрира как да зададете позволения метод за SMTP удостоверяване, използвайки allowed_authentication свойство:

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

Задаване на таймаут за SMTP сървъра

При изпращане на имейли по мрежа, задаването на подходящ таймаут е от съществено значение, за да се предотврати зависване на приложението, ако сървърът не отговори. The timeout свойство на SmtpClient клас в Aspose.Email за Python чрез .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 за Python чрез .NET поддържа механизма за удостоверяване CRAM-MD5, който подобрява сигурността, като избягва предаването на пароли в чист текст по време на SMTP удостоверяване. Този метод е особено полезен при свързване към сървъри, които изискват удостоверяване чрез предизвикателство-отговор.

За да активирате удостоверяване с CRAM-MD5, задайте allowed_authentication свойство на SmtpClient клас към CRAM_MD5, както е показано в следния примерен код:

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

Python-Net: Изпращане на имейли и препращане на съобщения чрез SMTP в Python

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

Този 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 клас, демонстриращ как да се изпращат стандартни и разширени имейл съобщения с пълен контрол върху конфигурацията и доставката.

Изпращане на имейли синхронно

Този 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.
Създайте Plain Text AlternateView, използвайки create_alternate_view_from_string.
Добавете алтернативния изглед към alternate_views колекция от MailMessage.
Създайте и конфигурирайте SmtpClient екземпляр.
Изпратете имейла, като използвате send метод.

Как да изпратите масови имейли

Изпращането на големи количества имейли включва изпращане на множество съобщения наведнъж — всяко потенциално адресирано към различен получател. Aspose.Email предоставя тази възможност, използвайки SmtpClient клас.

Примерният код по-долу демонстрира как да изпратите партида имейли наведнъж:

Създайте инстанция на SmtpClient клас и конфигурирайте неговия хост, порт, идентификационни данни и настройки за сигурност.
Създайте множество 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.
Задайте данните за сървъра като хост, порт, потребителско име, парола и криптиране.
Активирайте режим с многобройни връзки, като зададете 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: Utility Features - SMTP клиент

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

Изброяване на разширения на сървъра с използване на Smtp клиент

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

Python-Net: Включване на запис на активността на SMTP клиента

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

Aspose.Email за Python чрез .NET предоставя вградена поддръжка за записване на SMTP активност. Тази функция — обикновено известна като запис на активност — позволява на разработчиците систематично да проследяват имейл транзакции, събития или грешки по време на процеса на изпращане. Тя може да бъде особено полезна за отстраняване на грешки, одит или поддържане на оперативна прозрачност в сървърните приложения.

Този 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 сървъра | Валидиране на 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.")