Automatyczne typy mediów Gmail/Office365

Przegląd

Użytkownicy Gmaila lub Office365 mogą skorzystać z automatycznych funkcji w konfiguracji typu mediów.

Konfiguracja

Pole Dostawca poczty w konfiguracji typu nośnika wiadomości e-mail umożliwia wybranie wstępnie skonfigurowanych opcji dla Gmaila i Office 365.

W przypadku wybrania opcji związanych z Gmailem lub Office 365 wystarczy podać adres e-mail nadawcy i hasło, aby utworzyć działający typ nośnika.

Po podaniu adresu e-mail i hasła Zabbix będzie mógł automatycznie uzupełnić wszystkie wymagane ustawienia typów nośników Gmaila i Office 365 rzeczywistymi lub zalecanymi wartościami, tj. serwer SMTP, port serwera SMTP, helo SMTP oraz Zabezpieczenia połączenia. Ze względu na tę automatyzację pola te nie są nawet wyświetlane, jednak szczegóły serwera SMTP i wiadomości e-mail można zobaczyć na liście typów nośników (w kolumnie Szczegóły).

Należy również pamiętać, że:

  • Hasło nie jest wymagane w przypadku opcji przekazywania.
  • W przypadku przekazywania za pośrednictwem Office 365 nazwa domeny podanego adresu e-mail zostanie użyta do dynamicznego uzupełnienia serwera SMTP (tj. zastąpienia ciągu „example.com” w example-com.mail.protection.outlook.com rzeczywistą wartością).

Tokeny OAuth

Pobieranie tokenów OAuth ma zautomatyzowane funkcje dla dostawców poczty e-mail Gmail, Gmail relay i Office365.

Konieczne jest podanie jedynie ograniczonego zestawu parametrów do uzyskania dostępu OAuth oraz pobrania tokenu odświeżania — Redirection endpoint, Client ID i Client secret. Zabbix automatycznie uzupełni pozostałe wymagane wartości (zobacz Domyślne adresy URL OAuth według dostawcy).

Należy pamiętać, że możliwe jest również użycie formularza Generic SMTP do skonfigurowania autoryzacji OAuth dla tych dostawców.

SmtpClientAuthentication musi być włączone albo dla użytkownika/współdzielonej skrzynki pocztowej, albo dla całej dzierżawy w Office365 (domyślnie nie jest włączone).

Domyślne adresy URL OAuth według dostawcy

Poniższa tabela zawiera domyślne wartości adresów URL OAuth i parametrów dla poszczególnych dostawców używane przez Zabbix.

Parametr Gmail Office365 Generic SMTP
Punkt końcowy autoryzacji https://accounts.google.com/o/oauth2/v2/auth https://login.microsoftonline.com/common/oauth2/v2.0/authorize Brak wartości domyślnej
scope https://mail.google.com https://outlook.office.com/SMTP.Send, offline_access Brak wartości domyślnej
access_type offline Nieużywane Brak wartości domyślnej
prompt consent Nieużywane Brak wartości domyślnej
redirect_uri Wartość pola Redirection endpoint jest dodawana automatycznie przez kod. Nie jest wymieniona w parametrach Authorization endpoint.
state Unikalny hash identyfikujący nośnik aktualizowany tokenem OAuth jest dodawany automatycznie przez kod. Nie jest wymieniony w parametrach Authorization endpoint.
Punkt końcowy tokenu https://oauth2.googleapis.com/token https://login.microsoftonline.com/common/oauth2/v2.0/token Brak wartości domyślnej
grant_type authorization_code authorization_code Brak wartości domyślnej
redirect_uri Wartość pola Redirection endpoint jest dodawana automatycznie przez kod. Nie jest wymieniona w parametrach Token endpoint.
state Unikalny hash identyfikujący nośnik aktualizowany tokenem OAuth jest dodawany automatycznie przez kod. Nie jest wymieniony w parametrach Token endpoint.

Obejście dla kont osobistych Office365

Konta osobiste Office365 nie obsługują ciągów zapytań w adresie URL przekierowania.

Aby obejść ten problem, administrator serwera WWW Apache może dodać następującą regułę przepisywania do pliku .htaccess:

RewriteEngine On
RewriteRule ^/oauth\.authorize$ /zabbix.php?action=oauth.authorize [QSA,L,PT]

Umożliwia to użycie uproszczonego adresu URL przekierowania, takiego jak:

http://server-name/zabbix/oauth.authorize

zamiast adresu URL z parametrami zapytania, co zapewnia zgodność z kontami osobistymi Office365.