[comment]: # ({473c0010-d40475f4}) # 1 Email [comment]: # ({/473c0010-d40475f4}) [comment]: # ({860d77dd-9d59e93d}) #### Przegląd Aby skonfigurować e-mail jako kanał dostarczania wiadomości, należy skonfigurować e-mail jako typ mediów i przypisać użytkownikom określone adresy. ::: noteclassic Wiele powiadomień dla pojedynczego zdarzenia zostanie zgrupowanych w tym samym wątku e-mail. ::: [comment]: # ({/860d77dd-9d59e93d}) [comment]: # ({259509d6-3711e99d}) #### Konfiguracja Aby skonfigurować email jako typ nośnika: 1. Przejdź do *Alerts > Media types*. 2. Kliknij *Create media type* (lub kliknij *Email* na liście predefiniowanych typów nośnika). Karta **Media type** zawiera ogólne atrybuty typu nośnika: ![](../../../../../assets/en/manual/config/notifications/media/media_email.png){width="600"} Wszystkie wymagane pola wejściowe są oznaczone czerwoną gwiazdką. :::notewarning Hasło jest eksportowane jako zwykły tekst podczas eksportowania konfiguracji typu nośnika email. ::: Poniższe parametry są specyficzne dla typu nośnika email: |Parameter|Description| |--|--------| |*Email provider*|Wybierz dostawcę poczty email: *Generic SMTP*, *Gmail*, *Gmail relay*, *Office365* lub *Office365 relay*.
Jeśli wybierzesz opcje związane z Gmail/Office365, wystarczy podać adres email nadawcy i hasło; takie opcje jak *SMTP server*, *SMTP server port*, *SMTP helo* oraz *Connection security* zostaną automatycznie uzupełnione przez Zabbix. Zobacz także: [Automated Gmail/Office365 media types](/manual/config/notifications/media/email/gmail_office). | |*SMTP server*|Ustaw serwer SMTP do obsługi wiadomości wychodzących.
To pole jest dostępne, jeśli jako dostawca poczty email wybrano *Generic SMTP*.| |*SMTP server port*|Ustaw port serwera SMTP do obsługi wiadomości wychodzących.
To pole jest dostępne, jeśli jako dostawca poczty email wybrano *Generic SMTP*.| |*Email*|Adres wpisany tutaj będzie używany jako adres **From** dla wysyłanych wiadomości.
Obsługiwane jest dodanie wyświetlanej nazwy nadawcy (takiej jak "Zabbix\_info" w *Zabbix\_info * na powyższym zrzucie ekranu) wraz z rzeczywistym adresem email.
W Zabbix obowiązują pewne ograniczenia dotyczące nazw wyświetlanych w wiadomościach email w porównaniu z tym, co dopuszcza RFC 5322, co ilustrują przykłady:
Poprawne przykłady:
*zabbix\@company.com* (sam adres email, bez nawiasów ostrych)
*Zabbix\_info * (nazwa wyświetlana i adres email w nawiasach ostrych)
*∑Ω-monitoring * (znaki UTF-8 w nazwie wyświetlanej)
Niepoprawne przykłady:
*Zabbix HQ zabbix\@company.com* (nazwa wyświetlana obecna, ale bez nawiasów ostrych wokół adresu email)
*"Zabbix\\@\\" * (choć poprawne według RFC 5322, pary cytowane i komentarze nie są obsługiwane w wiadomościach email Zabbix)| |*SMTP helo*|Ustaw poprawną wartość SMTP helo, zwykle nazwę domeny.
Jeśli pole jest puste, zostanie wysłana nazwa domeny adresu email (czyli to, co znajduje się po `@` w polu *Email*). Jeśli nie uda się pobrać nazwy domeny, zostanie zapisane ostrzeżenie na poziomie debug, a jako domena dla polecenia HELO zostanie wysłana nazwa hosta serwera.
To pole jest dostępne, jeśli jako dostawca poczty email wybrano *Generic SMTP*.| |*Connection security*|Wybierz poziom bezpieczeństwa połączenia:
**None** - nie używaj opcji [CURLOPT\_USE\_SSL](http://curl.haxx.se/libcurl/c/CURLOPT_USE_SSL.html)
**STARTTLS** - użyj opcji CURLOPT\_USE\_SSL z wartością CURLUSESSL\_ALL
**SSL/TLS** - użycie CURLOPT\_USE\_SSL jest opcjonalne| |*SSL verify peer*|Zaznacz pole wyboru, aby zweryfikować certyfikat SSL serwera SMTP.
Wartość dyrektywy konfiguracji serwera "SSLCALocation" powinna zostać przekazana do [CURLOPT\_CAPATH](http://curl.haxx.se/libcurl/c/CURLOPT_CAPATH.html) w celu walidacji certyfikatu.
Ustawia to opcję cURL [CURLOPT\_SSL\_VERIFYPEER](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYPEER.html).| |*SSL verify host*|Zaznacz pole wyboru, aby zweryfikować, czy pole *Common Name* lub pole *Subject Alternate Name* certyfikatu serwera SMTP jest zgodne.
Ustawia to opcję cURL [CURLOPT\_SSL\_VERIFYHOST](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYHOST.html).| |*Authentication*|Wybierz poziom uwierzytelniania:
**None** - nie są ustawiane żadne opcje cURL
**Username and password** - oznacza "AUTH=\*", pozostawiając wybór mechanizmu uwierzytelniania cURL
**OAuth** - uwierzytelnianie OAuth
Uwierzytelnianie OAuth nie jest obsługiwane dla dostawcy poczty email *Office365 relay*.| |*Username*|Nazwa użytkownika używana do uwierzytelniania.
Ustawia wartość [CURLOPT\_USERNAME](http://curl.haxx.se/libcurl/c/CURLOPT_USERNAME.html).
Obsługiwane [makra użytkownika](/manual/appendix/macros/supported_by_location_user#other-locations).| |*Password*|Hasło używane do uwierzytelniania.
Ustawia wartość [CURLOPT\_PASSWORD](http://curl.haxx.se/libcurl/c/CURLOPT_PASSWORD.html).
Obsługiwane [makra użytkownika](/manual/appendix/macros/supported_by_location_user#other-locations).
Wartość wpisana tutaj jest eksportowana bez zmian podczas eksportowania konfiguracji typu nośnika. Aby uniknąć ujawnienia poufnych danych uwierzytelniających w eksportowanych plikach, użyj makra użytkownika (na przykład `{$EMAIL_SMTP_PASSWORD}`) zamiast jawnego hasła — odwołanie do makra zostanie wyeksportowane, a wartość tajna powinna zostać skonfigurowana ponownie w systemie docelowym.| |*OAuth tokens*|Kliknij *Configure*, aby w nowym oknie ustawić parametry pobierania [OAuth tokens](#oauth-tokens).
To pole jest dostępne tylko wtedy, gdy w polu *Authentication* wybrano opcję "OAuth".| |*Message format*|Wybierz format wiadomości:
**HTML** - wysyłaj jako HTML
**Plain text** - wysyłaj jako zwykły tekst| ::: noteimportant Aby włączyć uwierzytelnianie SMTP, serwer Zabbix musi zostać skompilowany z opcją [kompilacji](/manual/installation/install#configure-the-sources) `--with-libcurl`, która wymaga libcurl (szczegóły wersji znajdują się w wymaganiach dla [serwer](/manual/installation/requirements#serverproxy)). ::: Zobacz także [common media type parameters](/manual/config/notifications/media#common-parameters), aby uzyskać szczegółowe informacje o konfigurowaniu domyślnych wiadomości i opcji przetwarzania alertów. [comment]: # ({/259509d6-3711e99d}) [comment]: # ({6f74aa36-61f2be67}) #### Tokeny OAuth Do pobrania tokenów OAuth wymagane są następujące parametry: ![](../../../../../assets/en/manual/config/notifications/media/media_email_oauth.png){width="600"} |Parametr|Opis| |--|--------| |*Punkt końcowy przekierowania*|Wprowadź adres URL frontend Zabbix, do którego usługa OAuth przekieruje z powrotem autoryzację OAuth (w formacie `https:///zabbix.php?action=oauth.authorize`).
Dla nowego typu nośnika e-mail jest on ustawiany automatycznie, gdy zdefiniowano [adres URL frontend](/manual/web_interface/frontend_sections/administration/general#other).| |*ID klienta*|Wprowadź unikalny identyfikator aplikacji klienckiej zarejestrowanej na serwerze autoryzacji OAuth.| |*Tajny klucz klienta*|Wprowadź prywatny tajny klucz aplikacji klienckiej zarejestrowanej na serwerze autoryzacji OAuth.| |*Punkt końcowy autoryzacji*|Wprowadź adres URL serwera autoryzacji OAuth służący do żądania autoryzacji użytkownika.| |*Parametry autoryzacji*|Wprowadź parametry punktu końcowego autoryzacji.| |*Kod autoryzacji*|Wprowadź kod autoryzacji:
**Automatycznie** - kod zostanie pobrany automatycznie za pośrednictwem strony przekierowania
**Ręcznie** - wprowadź kod ręcznie, jeśli automatyczne pobranie się nie powiedzie| |*Punkt końcowy tokenu*|Wprowadź adres URL serwera autoryzacji OAuth służący do wymiany kodu autoryzacji na tokeny dostępu i odświeżania.| |*Parametry tokenu*|Wprowadź parametry tokenu dostępu.| :::notetip Pobieranie tokenów OAuth ma [zautomatyzowane funkcje](/manual/config/notifications/media/email/gmail_office#oauth-tokens) dla dostawców poczty e-mail **Gmail**, **Gmail relay** i **Office365**. Wymagane jest jedynie podanie wartości parametrów *Punkt końcowy przekierowania*, *ID klienta* i *Tajny klucz klienta*. Zabbix automatycznie uzupełni pozostałe wymagane wartości (zobacz [Domyślne adresy URL OAuth według dostawcy](/manual/config/notifications/media/email/gmail_office#oauth-url-defaults-by-provider)). ::: [comment]: # ({/6f74aa36-61f2be67}) [comment]: # ({cdcb5c81-7bf715f0}) ##### Pobieranie tokenów dostępu i odświeżania OAuth Po przesłaniu parametrów OAuth: 1. Otwierane jest wyskakujące okno przeglądarki, które kieruje użytkownika do *punktu końcowego autoryzacji*. 2. Użytkownik autoryzuje Zabbix w usłudze OAuth. 3. Usługa OAuth przekierowuje użytkownika do akcji frontendu Zabbix `oauth.authorize` z kodem autoryzacyjnym i wartością zakresu. 4. W odpowiedzi Zabbix wyśle żądanie do *punktu końcowego tokenu*, aby wymienić kod autoryzacyjny na token dostępu i token odświeżania. [comment]: # ({/cdcb5c81-7bf715f0}) [comment]: # ({50e8f033-98f29ec0}) #### Testowanie Aby sprawdzić, czy skonfigurowany typ nośnika e-mail działa poprawnie: 1. Znajdź odpowiednią wiadomość e-mail na [liście](/manual/config/notifications/media#overview) typów nośników. 2. Kliknij *Test* w ostatniej kolumnie listy (otworzy się okno testowania). 3. Wprowadź adres odbiorcy w polu *Send to*, treść wiadomości oraz opcjonalnie temat. 4. Kliknij *Test*, aby wysłać wiadomość testową. Komunikat o powodzeniu lub niepowodzeniu testu zostanie wyświetlony w tym samym oknie: ![](../../../../../assets/en/manual/config/notifications/media/test_email0.png){width="600"} [comment]: # ({/50e8f033-98f29ec0}) [comment]: # ({859be4b6-5e74f274}) #### Media użytkownika Po skonfigurowaniu typu mediów e-mail przejdź do sekcji *Użytkownicy > Użytkownicy* i edytuj profil użytkownika, aby przypisać użytkownikowi media e-mail. Kroki konfiguracji mediów użytkownika, wspólne dla wszystkich typów mediów, są opisane na stronie [Typy mediów](/manual/config/notifications/media#user-media). [comment]: # ({/859be4b6-5e74f274})