1 Автоматизированные типы медиа Gmail/Office365
Обзор
Пользователи Gmail или Office365 могут воспользоваться автоматизированными функциями в настройке типа медиа.
Настройка
Поле Поставщик электронной почты в настройках типа носителя электронной почты позволяет выбрать предварительно настроенные параметры для Gmail и Office 365.
При выборе параметров, связанных с Gmail/Office365, для создания рабочего типа носителя достаточно указать адрес электронной почты и пароль отправителя.
После указания адреса электронной почты и пароля Zabbix сможет автоматически заполнить все необходимые настройки типов носителей Gmail/Office365 фактическими или рекомендуемыми значениями: SMTP-сервер, Порт SMTP-сервера, SMTP HELO и Безопасность соединения. Благодаря этой автоматизации данные поля даже не отображаются, однако сведения о SMTP-сервере и электронной почте можно просмотреть в списке типов носителей (см. столбец Подробности).
Также обратите внимание:
- Пароль не требуется для параметров ретрансляции.
- Для ретрансляции Office365 доменное имя указанного адреса электронной почты будет использоваться для динамического заполнения SMTP-сервера (то есть значение
"example.com"вexample-com.mail.protection.outlook.comбудет заменено фактическим значением).
OAuth tokens
Получение OAuth tokens имеет автоматизированные функции для почтовых провайдеров Gmail, Gmail relay и Office365.
Для получения OAuth access token и refresh token необходимо указать только ограниченный набор параметров - Redirection endpoint, Client ID и Client secret. Zabbix автоматически заполнит остальные требуемые значения (см. OAuth URL defaults by provider).
Обратите внимание, что для настройки OAuth authorization для этих провайдеров также можно использовать форму Generic SMTP.
SmtpClientAuthentication должно быть включено либо для каждого пользователя/общего почтового ящика, либо для всего tenant в Office365 (по умолчанию в настройках не включено).
Значения OAuth URL по умолчанию в зависимости от провайдера
В следующей таблице перечислены значения OAuth URL по умолчанию и параметры для каждого провайдера, используемые Zabbix.
| Параметр | Gmail | Office365 | Generic SMTP | |
|---|---|---|---|---|
| Authorization endpoint | https://accounts.google.com/o/oauth2/v2/auth |
https://login.microsoftonline.com/common/oauth2/v2.0/authorize |
Нет значения по умолчанию | |
| scope | https://mail.google.com |
https://outlook.office.com/SMTP.Send, offline_access |
Нет значения по умолчанию | |
| access_type | offline |
Не используется | Нет значения по умолчанию | |
| prompt | consent |
Не используется | Нет значения по умолчанию | |
| redirect_uri | Значение поля Redirection endpoint автоматически добавляется кодом. Не указано в параметрах Authorization endpoint. | |||
| state | Уникальный хэш для идентификации медиа, обновляемого с помощью OAuth token, автоматически добавляется кодом. Не указано в параметрах Authorization endpoint. | |||
| Token endpoint | https://oauth2.googleapis.com/token |
https://login.microsoftonline.com/common/oauth2/v2.0/token |
Нет значения по умолчанию | |
| grant_type | authorization_code |
authorization_code |
Нет значения по умолчанию | |
| redirect_uri | Значение поля Redirection endpoint автоматически добавляется кодом. Не указано в параметрах Token endpoint. | |||
| state | Уникальный хэш для идентификации медиа, обновляемого с помощью OAuth token, автоматически добавляется кодом. Не указано в параметрах Token endpoint. | |||
Обходное решение для личных учетных записей Office365
Личные учетные записи Office365 не поддерживают строки запроса в URL перенаправления.
Чтобы обойти эту проблему, администратор веб-сервера Apache может добавить следующее правило переписывания в файл .htaccess:
RewriteEngine On
RewriteRule ^/oauth\.authorize$ /zabbix.php?action=oauth.authorize [QSA,L,PT]Это позволяет использовать упрощенный URL перенаправления, например:
http://server-name/zabbix/oauth.authorizeвместо URL с параметрами запроса, обеспечивая совместимость с личными учетными записями Office365.