[comment]: # ({473c0010-d40475f4}) # 1 E-mail [comment]: # ({/473c0010-d40475f4}) [comment]: # ({860d77dd-9d59e93d}) #### Обзор Чтобы настроить электронную почту в качестве канала доставки сообщений, необходимо настроить электронную почту как тип оповещения и назначить пользователям соответствующие адреса. ::: noteclassic Несколько уведомлений для одного события будут сгруппированы в одной цепочке писем. ::: [comment]: # ({/860d77dd-9d59e93d}) [comment]: # ({8dc4cca3-3711e99d}) #### Настройка Чтобы настроить электронную почту как тип средства оповещения: 1. Перейдите в *Оповещения > Способы оповещения*. 2. Нажмите *Создать способ оповещения* (или нажмите *Email* в списке предопределённых способов оповещения). Вкладка **Способ оповещения** содержит общие атрибуты типа средства оповещения: ![](../../../../../assets/en/manual/config/notifications/media/media_email.png){width="600"} Все обязательные поля ввода отмечены красной звёздочкой. :::notewarning Пароль экспортируется в открытом виде при экспорте конфигурации способа оповещения Email. ::: Следующие параметры являются специфичными для способа оповещения Email: |Параметр|Описание| |--|--------| |*Провайдер электронной почты*|Выберите провайдера электронной почты: *Generic SMTP*, *Gmail*, *Gmail relay*, *Office365* или *Office365 relay*.
Если вы выберете варианты, связанные с Gmail/Office365, вам потребуется указать только адрес электронной почты отправителя и пароль; такие параметры, как *SMTP server*, *SMTP server port*, *SMTP helo* и *Connection security*, будут автоматически заполнены Zabbix. См. также: [Автоматизированные типы средств оповещения Gmail/Office365](/manual/config/notifications/media/email/gmail_office). | |*SMTP server*|Укажите SMTP-сервер для обработки исходящих сообщений.
Это поле доступно, если в качестве провайдера электронной почты выбран *Generic SMTP*.| |*SMTP server port*|Укажите порт SMTP-сервера для обработки исходящих сообщений.
Это поле доступно, если в качестве провайдера электронной почты выбран *Generic SMTP*.| |*Email*|Указанный здесь адрес будет использоваться как адрес **From** для отправляемых сообщений.
Поддерживается добавление отображаемого имени отправителя (например, "Zabbix\_info" в *Zabbix\_info * на снимке экрана выше) вместе с фактическим адресом электронной почты.
Для отображаемых имён в электронных письмах Zabbix действуют некоторые ограничения по сравнению с тем, что допускается RFC 5322, как показано в примерах:
Допустимые примеры:
*zabbix\@company.com* (только адрес электронной почты, угловые скобки не требуются)
*Zabbix\_info * (отображаемое имя и адрес электронной почты в угловых скобках)
*∑Ω-monitoring * (символы UTF-8 в отображаемом имени)
Недопустимые примеры:
*Zabbix HQ zabbix\@company.com* (отображаемое имя присутствует, но адрес электронной почты не заключён в угловые скобки)
*"Zabbix\\@\\" * (хотя это допустимо по RFC 5322, экранированные пары и комментарии не поддерживаются в электронных письмах Zabbix)| |*SMTP helo*|Укажите корректное значение SMTP helo, обычно это доменное имя.
Если поле пустое, будет отправлено доменное имя из адреса электронной почты (то есть часть после `@` в поле *Email*). Если получить доменное имя невозможно, в журнал будет записано предупреждение уровня отладки, а в качестве домена для команды HELO будет отправлено имя узла сервера.
Это поле доступно, если в качестве провайдера электронной почты выбран *Generic SMTP*.| |*Connection security*|Выберите уровень безопасности соединения:
**None** — не использовать параметр [CURLOPT\_USE\_SSL](http://curl.haxx.se/libcurl/c/CURLOPT_USE_SSL.html)
**STARTTLS** — использовать параметр CURLOPT\_USE\_SSL со значением CURLUSESSL\_ALL
**SSL/TLS** — использование CURLOPT\_USE\_SSL является необязательным| |*SSL verify peer*|Установите флажок, чтобы проверять SSL-сертификат SMTP-сервера.
Значение директивы конфигурации сервера "SSLCALocation" должно быть передано в [CURLOPT\_CAPATH](http://curl.haxx.se/libcurl/c/CURLOPT_CAPATH.html) для проверки сертификата.
Это задаёт параметр cURL [CURLOPT\_SSL\_VERIFYPEER](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYPEER.html).| |*SSL verify host*|Установите флажок, чтобы проверять совпадение поля *Common Name* или поля *Subject Alternate Name* сертификата SMTP-сервера.
Это задаёт параметр cURL [CURLOPT\_SSL\_VERIFYHOST](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYHOST.html).| |*Authentication*|Выберите уровень аутентификации:
**None** — параметры cURL не задаются
**Username and password** — подразумевает "AUTH=\*", оставляя выбор механизма аутентификации cURL
**OAuth** — аутентификация OAuth
Аутентификация OAuth не поддерживается для провайдера электронной почты *Office365 relay*.| |*Username*|Имя пользователя для аутентификации.
Это задаёт значение [CURLOPT\_USERNAME](http://curl.haxx.se/libcurl/c/CURLOPT_USERNAME.html).
Поддерживаются [пользовательские макросы](/manual/appendix/macros/supported_by_location_user#other-locations).| |*Password*|Пароль для аутентификации.
Это задаёт значение [CURLOPT\_PASSWORD](http://curl.haxx.se/libcurl/c/CURLOPT_PASSWORD.html).
Поддерживаются [пользовательские макросы](/manual/appendix/macros/supported_by_location_user#other-locations).
Введённое здесь значение экспортируется как есть при экспорте конфигурации способа оповещения. Чтобы избежать раскрытия конфиденциальных учётных данных в экспортируемых файлах, используйте пользовательский макрос (например, `{$EMAIL_SMTP_PASSWORD}`) вместо явного пароля — при экспорте будет сохранена ссылка на макрос, а секретное значение должно быть заново настроено в целевой системе.| |*OAuth tokens*|Нажмите *Configure*, чтобы настроить параметры для получения [OAuth tokens](#oauth-tokens) в новом окне.
Это поле доступно только если в поле *Authentication* выбрано "OAuth".| |*Message format*|Выберите формат сообщения:
**HTML** — отправлять как HTML
**Plain text** — отправлять как обычный текст| ::: noteimportant Чтобы включить SMTP-аутентификацию, сервер Zabbix должен быть скомпилирован с параметром [компиляции](/manual/installation/install/sources#configure-the-sources) `--with-libcurl`, для которого требуется libcurl (подробности о версии см. в требованиях к [серверу](/manual/installation/requirements#serverproxy)). ::: См. также [общие параметры способов оповещения](/manual/config/notifications/media#common-parameters) для получения подробной информации о настройке сообщений по умолчанию и параметров обработки оповещений. [comment]: # ({/8dc4cca3-3711e99d}) [comment]: # ({6f74aa36-61f2be67}) #### Токены OAuth Для получения токенов OAuth требуются следующие параметры: ![](../../../../../assets/en/manual/config/notifications/media/media_email_oauth.png){width="600"} |Параметр|Описание| |--|--------| |*Конечная точка перенаправления*|Введите URL веб-интерфейса Zabbix, на который сервис OAuth будет перенаправлять обратно после авторизации OAuth (используя формат `https:///zabbix.php?action=oauth.authorize`).
Для нового типа медиа email задается автоматически, если определен [URL веб-интерфейса](/manual/web_interface/frontend_sections/administration/general#other).| |*Client ID*|Введите уникальный идентификатор клиентского приложения, зарегистрированного на сервере авторизации OAuth.| |*Client secret*|Введите приватный секрет клиентского приложения, зарегистрированного на сервере авторизации OAuth.| |*Конечная точка авторизации*|Введите URL сервера авторизации OAuth для запроса авторизации пользователя.| |*Параметры авторизации*|Введите параметры для конечной точки авторизации.| |*Код авторизации*|Введите код авторизации:
**Автоматически** - код будет получен автоматически через страницу перенаправления
**Вручную** - введите код вручную, если автоматическое получение не удалось| |*Конечная точка токена*|Введите URL сервера авторизации OAuth для обмена кода авторизации на токены доступа и обновления.| |*Параметры токена*|Введите параметры для токена доступа.| :::notetip Получение токенов OAuth имеет [автоматизированные возможности](/manual/config/notifications/media/email/gmail_office#oauth-tokens) для провайдеров электронной почты **Gmail**, **Gmail relay** и **Office365**. Требуется указать только значения параметров *Конечная точка перенаправления*, *Client ID* и *Client secret*. Zabbix автоматически заполнит остальные необходимые значения (см. [Значения URL OAuth по умолчанию в зависимости от провайдера](/manual/config/notifications/media/email/gmail_office#oauth-url-defaults-by-provider)). ::: [comment]: # ({/6f74aa36-61f2be67}) [comment]: # ({cdcb5c81-7bf715f0}) ##### Получение токенов доступа и обновления OAuth После отправки параметров OAuth: 1. Открывается всплывающее окно браузера, перенаправляющее пользователя к *Authorization endpoint*. 2. Пользователь авторизует Zabbix в сервисе OAuth. 3. Сервис OAuth перенаправляет пользователя к действию веб-интерфейса Zabbix `oauth.authorize` с кодом авторизации и значением области действия. 4. В ответ Zabbix выполнит запрос к *Token endpoint*, чтобы обменять код авторизации на токены доступа и обновления. [comment]: # ({/cdcb5c81-7bf715f0}) [comment]: # ({50e8f033-98f29ec0}) #### Тестирование Чтобы проверить, правильно ли работает настроенный тип оповещения по электронной почте: 1. Найдите соответствующее письмо в [списке](/manual/config/notifications/media#overview) типов оповещений. 2. Нажмите *Тест* в последнем столбце списка (откроется окно тестирования). 3. Введите адрес получателя в поле *Отправить кому*, текст сообщения и, при необходимости, тему. 4. Нажмите *Тест*, чтобы отправить тестовое сообщение. Сообщение об успешном или неуспешном результате теста будет отображено в том же окне: ![](../../../../../assets/en/manual/config/notifications/media/test_email0.png){width="600"} [comment]: # ({/50e8f033-98f29ec0}) [comment]: # ({859be4b6-5e74f274}) #### Способ оповещения пользователя После настройки способа оповещения Email перейдите в раздел *Пользователи > Пользователи* и отредактируйте профиль пользователя, чтобы назначить пользователю способ оповещения Email. Шаги по настройке способа оповещения пользователя, общие для всех типов способов оповещения, описаны на странице [Типы способов оповещения](/manual/config/notifications/media#user-media). [comment]: # ({/859be4b6-5e74f274})