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 Create media type (vai noklikšķiniet 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.

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

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ā ziņojumu From adrese.
Tiek atbalstīta sūtītāja parādāmā vārda pievienošana kopā ar faktisko e-pasta adresi (piemēram, "Zabbix_info" kā Zabbix_info <[email protected]> iepriekš redzamajā ekrānuzņēmumā).
Zabbix e-pastos parādāmajiem vārdiem ir noteikti daži ierobežojumi salīdzinājumā ar RFC 5322 atļauto, kā parādīts piemēros:
Derīgi piemēri:
[email protected] (tikai e-pasta adrese, nav jāizmanto leņķiekavas)
Zabbix_info <[email protected]> (parādāmais vārds un e-pasta adrese leņķiekavās)
∑Ω-monitoring <[email protected]> (UTF-8 rakstzīmes parādāmajā vārdā)
Nederīgi piemēri:
Zabbix HQ [email protected] (ir parādāmais vārds, bet e-pasta adrese nav ietverta leņķiekavās)
"Zabbix@<H(comment)Q>" <[email protected]> (lai gan tas ir derīgs saskaņā ar RFC 5322, Zabbix e-pastos netiek atbalstīti pēdiņās ietverti pāri un komentāri)
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 - neizmantot opciju CURLOPT_USE_SSL
STARTTLS - izmantot 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.
Vērtība no servera konfigurācijas direktīvas "SSLCALocation" 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 tiek eksportēta tāda, kāda tā ir, eksportējot medija tipa konfigurāciju. 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ā — makro atsauce tiks eksportēta, bet slepenā vērtība būs jākonfigurē (atkārtoti) mērķa sistēmā.
OAuth tokens Noklikšķiniet 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 server prasībās).

Skatiet arī common media type parameters, lai uzzinātu, kā konfigurēt noklusējuma ziņojumus un brīdinājumu apstrādes opcijas.

OAuth tokeni

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

Eksportējot e-pasta multivides tipa konfigurāciju, klienta noslēpums tiek eksportēts atklātā tekstā.

Parameter Description
Pāradresācijas galapunkts Ievadiet Zabbix lietotāja saskarne URL, uz kuru OAuth pakalpojums pāradresēs OAuth autorizāciju atpakaļ (izmantojot formātu https://<zabbix-frontend-url>/zabbix.php?action=oauth.authorize).
Tas tiek iestatīts automātiski jaunam e-pasta multivides tipam, ja ir definēts lietotāja saskarne URL.
Klienta ID Ievadiet unikālu klienta lietotnes identifikatoru, kas reģistrēts OAuth autorizācijas serverī.
Klienta noslēpums Ievadiet klienta lietotnes privāto noslēpumu, kas reģistrēts OAuth autorizācijas serverī.
Autorizācijas galapunkts Ievadiet OAuth autorizācijas servera URL, lai pieprasītu lietotāja autorizāciju.
Autorizācijas parametri Ievadiet autorizācijas galapunkta parametrus.
Autorizācijas kods Ievadiet autorizācijas kodu:
Automātiski - kods tiks izgūts automātiski, izmantojot pāradresācijas lapu
Manuāli - ievadiet kodu manuāli, ja automātiska izgūš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 piekļuves tokena parametrus.

OAuth tokenu izgūšanai ir automatizētas funkcijas e-pasta pakalpojumu sniedzējiem Gmail, Gmail relay un Office365. Šādā gadījumā ir jānorāda tikai parametru Pāradresācijas galapunkts, Klienta ID un Klienta noslēpums 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 mediju tips darbojas pareizi:

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

Veiksmīga vai neveiksmīga testa ziņojuma rezultāts 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.