1 E-pasts

Pārskats

Lai konfigurētu e-pastu kā ziņojumu piegādes kanālu, jums jākonfigurē e-pasts kā medija tips un jāpiešķir lietotājiem konkrētas adreses.

Vairāki paziņojumi par vienu notikumu tiks grupēti vienā un tajā pašā e-pasta sarakstē.

Konfigurācija

Lai konfigurētu e-pastu kā medija tipu:

  1. Dodieties uz Alerts > Media types.
  2. Noklikšķiniet uz Create media type (vai noklikšķiniet uz Email iepriekš definēto medija tipu sarakstā).

Cilnē Media type ir ietverti vispārīgie medija tipa atribūti:

Visi obligātie ievades lauki ir atzīmēti ar sarkanu zvaigznīti.

Eksportējot e-pasta medija tipa konfigurāciju, parole tiek eksportēta atklātā tekstā.

Tālāk norādītie parametri ir specifiski e-pasta medija tipam:

Parameter Description
Email provider Atlasiet e-pasta pakalpojumu sniedzēju: Generic SMTP, Gmail, Gmail relay, Office365 vai Office365 relay.
Ja atlasāt ar Gmail/Office365 saistītās opcijas, jums būs jānorāda tikai sūtītāja e-pasta adrese un parole; tādi lauki kā SMTP server, SMTP server port, SMTP helo un Connection security tiks automātiski aizpildīti no Zabbix. Skatiet arī: Automated Gmail/Office365 media types.
SMTP server Norādiet SMTP serveri izejošo ziņojumu apstrādei.
Šis lauks ir pieejams, ja kā e-pasta pakalpojumu sniedzējs ir atlasīts Generic SMTP.
SMTP server port Norādiet SMTP servera portu izejošo ziņojumu apstrādei.
Šis lauks ir pieejams, ja kā e-pasta pakalpojumu sniedzējs ir atlasīts Generic SMTP.
Email Šeit ievadītā adrese tiks izmantota kā nosūtīto ziņojumu From adrese.
Tiek atbalstīta sūtītāja attēlojamā vārda pievienošana kopā ar faktisko e-pasta adresi (piemēram, "Zabbix_info" formā Zabbix_info zabbix\@company.com iepriekš redzamajā ekrānuzņēmumā).
Salīdzinājumā ar RFC 5322 atļauto Zabbix e-pastos ir noteikti ierobežojumi attēlojamajiem vārdiem, kā parādīts piemēros:
Derīgi piemēri:
zabbix\@company.com (tikai e-pasta adrese, nav jāizmanto stūra iekavas)
Zabbix_info zabbix\@company.com (attēlojamais vārds un e-pasta adrese stūra iekavās)
∑Ω-monitoring zabbix\@company.com (UTF-8 rakstzīmes attēlojamajā vārdā)
Nederīgi piemēri:
Zabbix HQ zabbix\@company.com (ir attēlojamais vārds, bet e-pasta adrese nav ietverta stūra iekavās)
"Zabbix\@\<H(comment)Q\>" zabbix\@company.com (lai gan derīgs saskaņā ar RFC 5322, pēdiņās ietverti pāri un komentāri Zabbix e-pastos netiek atbalstīti)
SMTP helo Norādiet pareizu SMTP helo vērtību, parasti domēna nosaukumu.
Ja lauks ir tukšs, tiks nosūtīts e-pasta domēna nosaukums (t. i., tas, kas atrodas aiz @ laukā Email). Ja domēna nosaukumu nav iespējams iegūt, tiks reģistrēts brīdinājums atkļūdošanas līmenī, un kā HELO komandas domēns tiks nosūtīts servera resursdatora nosaukums.
Šis lauks ir pieejams, ja kā e-pasta pakalpojumu sniedzējs ir atlasīts Generic SMTP.
Connection security Atlasiet savienojuma drošības līmeni:
None - neizmantojiet opciju CURLOPT_USE_SSL
STARTTLS - izmantojiet opciju CURLOPT_USE_SSL ar vērtību CURLUSESSL_ALL
SSL/TLS - CURLOPT_USE_SSL izmantošana ir izvēles
SSL verify peer Atzīmējiet izvēles rūtiņu, lai pārbaudītu SMTP servera SSL sertifikātu.
Servera konfigurācijas direktīvas "SSLCALocation" vērtība sertifikāta validācijai jāievieto CURLOPT_CAPATH.
Tas iestata cURL opciju CURLOPT_SSL_VERIFYPEER.
SSL verify host Atzīmējiet izvēles rūtiņu, lai pārbaudītu, vai SMTP servera sertifikāta lauks Common Name vai Subject Alternate Name atbilst.
Tas iestata cURL opciju CURLOPT_SSL_VERIFYHOST.
Authentication Atlasiet autentifikācijas līmeni:
None - netiek iestatītas cURL opcijas
Username and password - nozīmē "AUTH=*", atstājot autentifikācijas mehānisma izvēli cURL ziņā
OAuth - OAuth autentifikācija
OAuth autentifikācija netiek atbalstīta e-pasta pakalpojumu sniedzējam Office365 relay.
Username Lietotājvārds, ko izmantot autentifikācijai.
Tas iestata CURLOPT_USERNAME vērtību.
Tiek atbalstīti lietotāja makrosi.
Password Parole, ko izmantot autentifikācijai.
Tas iestata CURLOPT_PASSWORD vērtību.
Tiek atbalstīti lietotāja makrosi.
Šeit ievadītā vērtība, eksportējot medija tipa konfigurāciju, tiek eksportēta tāda, kāda tā ir. Lai izvairītos no sensitīvu akreditācijas datu atklāšanas eksportētajos failos, izmantojiet lietotāja makro (piemēram, {$EMAIL_SMTP_PASSWORD}) literālas paroles vietā — tiks eksportēta makro atsauce, savukārt slepenā vērtība būs jākonfigurē (atkārtoti) mērķa sistēmā.
OAuth tokens Noklikšķiniet uz Configure, lai jaunā logā iestatītu parametrus OAuth tokenu iegūšanai.
Šis lauks ir pieejams tikai tad, ja laukā Authentication ir atlasīts "OAuth".
Message format Atlasiet ziņojuma formātu:
HTML - sūtīt kā HTML
Plain text - sūtīt kā vienkāršu tekstu

Lai iespējotu SMTP autentifikāciju, Zabbix serverim jābūt kompilētam ar --with-libcurl kompilēšanas opciju, kurai nepieciešams libcurl (versijas informāciju skatiet prasībās serveris).

Skatiet arī common media type parameters, lai iegūtu informāciju par noklusējuma ziņojumu un brīdinājumu apstrādes opciju konfigurēšanu.

OAuth tokeni

Lai iegūtu OAuth tokenus, ir nepieciešami šādi parametri:

Parametrs Apraksts
Pāradresācijas galapunkts Ievadiet Zabbix lietotāja saskarnes URL, uz kuru OAuth pakalpojums pāradresēs atpakaļ OAuth autorizāciju (izmantojot formātu https://<zabbix-frontend-url>/zabbix.php?action=oauth.authorize).
Jaunam e-pasta medija tipam tas tiek iestatīts automātiski, ja ir definēts lietotāja saskarnes URL.
Klienta ID Ievadiet unikālu klienta lietotnes identifikatoru, kas reģistrēta OAuth autorizācijas serverī.
Klienta slepenā atslēga Ievadiet klienta lietotnes privāto slepeno atslēgu, kas reģistrēta OAuth autorizācijas serverī.
Autorizācijas galapunkts Ievadiet OAuth autorizācijas servera URL lietotāja autorizācijas pieprasīšanai.
Autorizācijas parametri Ievadiet parametrus autorizācijas galapunktam.
Autorizācijas kods Ievadiet autorizācijas kodu:
Automātiski — kods tiks iegūts automātiski, izmantojot pāradresācijas lapu
Manuāli — ievadiet kodu manuāli, ja automātiskā iegūšana neizdodas
Tokena galapunkts Ievadiet OAuth autorizācijas servera URL, lai apmainītu autorizācijas kodu pret piekļuves un atsvaidzināšanas tokeniem.
Tokena parametri Ievadiet parametrus piekļuves tokenam.

OAuth tokenu iegūšanai ir automatizētas iespējas e-pasta pakalpojumu sniedzējiem Gmail, Gmail relay un Office365. Nepieciešams norādīt tikai parametru Pāradresācijas galapunkts, Klienta ID un Klienta slepenā atslēga vērtības. Zabbix automātiski aizpildīs pārējās nepieciešamās vērtības (skatiet OAuth URL noklusējuma vērtības pēc pakalpojumu sniedzēja).

OAuth piekļuves un atsvaidzināšanas marķiera iegūšana

Pēc OAuth parametru iesniegšanas:

  1. Tiek atvērts pārlūkprogrammas uznirstošais logs, novirzot lietotāju uz autorizācijas galapunktu.

  2. Lietotājs autorizē Zabbix OAuth servisā.

  3. OAuth serviss novirza lietotāju uz Zabbix lietotāja saskarnes darbību oauth.authorize ar autorizācijas kodu un tvēruma vērtību.

  4. Atbildot uz to, Zabbix veiks pieprasījumu uz marķiera galapunktu, lai apmainītu autorizācijas kodu pret piekļuves un atsvaidzināšanas marķieriem.

Testēšana

Lai pārbaudītu, vai konfigurētais e-pasta medija tips darbojas pareizi:

  1. Atrodiet attiecīgo e-pastu mediju tipu sarakstā.
  2. Saraksta pēdējā kolonnā noklikšķiniet uz Test (tiks atvērts testēšanas logs).
  3. Ievadiet adresāta adresi laukā Send to, ziņojuma tekstu un, pēc izvēles, tēmu.
  4. Noklikšķiniet uz Test, lai nosūtītu testa ziņojumu.

Ziņojums par testa veiksmi vai neveiksmi tiks parādīts tajā pašā logā:

Lietotāja mediji

Kad e-pasta medija tips ir konfigurēts, dodieties uz sadaļu Users > Users un rediģējiet lietotāja profilu, lai piešķirtu lietotājam e-pasta mediju. Darbības lietotāja mediju iestatīšanai, kas ir kopīgas visiem mediju tipiem, ir aprakstītas lapā Media types.