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 sarakstā ar iepriekš definētajiem medija tipiem noklikšķiniet Email).

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, eksportējot e-pasta medija tipa konfigurāciju, 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, būs jānorāda tikai sūtītāja e-pasta adrese un parole; tādas opcijas kā SMTP server, SMTP server port, SMTP helo un Connection security Zabbix aizpildīs automātiski. 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 <[email protected]>).
Zabbix e-pastos ir noteikti daži ierobežojumi attēlojamajiem vārdiem salīdzinājumā ar RFC 5322 atļautajiem, kā parādīts tālākajos piemēros.
Derīgi piemēri:
[email protected] (tikai e-pasta adrese; leņķiekavas nav nepieciešamas)
Zabbix_info <[email protected]> (attēlojamais vārds, kam seko e-pasta adrese leņķiekavās)
∑Ω-monitoring <[email protected]> (UTF-8 rakstzīmes attēlojamajā vārdā)
Nederīgi piemēri:
Zabbix HQ [email protected] (ir attēlojamais vārds, bet e-pasta adrese nav ietverta leņķiekavās)
"Zabbix@<H(comment)Q>" <[email protected]> (lai gan derīgs saskaņā ar RFC 5322, Zabbix e-pastos netiek atbalstīti quoted pairs 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 CURLUSESSL_ALL vērtību
SSL/TLS - CURLOPT_USE_SSL izmantošana nav obligāta.
SSL verify peer Atzīmējiet izvēles rūtiņu, lai pārbaudītu SMTP servera SSL sertifikātu.
Sertifikāta validācijai servera konfigurācijas direktīvas "SSLCALocation" vērtība 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 eksportētajos failos neizpaustu sensitīvus akreditācijas datus, izmantojiet lietotāja makro (piemēram, {$EMAIL_SMTP_PASSWORD}) nevis burtisku paroli — makro atsauce tiks eksportēta, bet slepenā vērtība mērķa sistēmā būs jākonfigurē (atkārtoti).
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 detaļas skatiet prasībās server sadaļā).

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

OAuth tokeni

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

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

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 OAuth autorizācijas serverī reģistrētās klienta lietotnes unikālo identifikatoru.
Klienta noslēpums Ievadiet OAuth autorizācijas serverī reģistrētās klienta lietotnes privāto noslēpumu.
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 Pāradresācijas galapunkts, Klienta ID un Klienta noslēpums parametru 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 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.

Veiksmīga vai neveiksmīga testa ziņojuma rezultāts tiks parādīts tajā pašā logā:

Lietotāja mediji

Kad e-pasta mediju tips ir konfigurēts, dodieties uz Lietotāji > Lietotāji sadaļu un rediģējiet lietotāja profilu, lai piešķirtu lietotājam e-pasta mediju. Lietotāja mediju iestatīšanas soļi, kas ir kopīgi visiem mediju tipiem, ir aprakstīti lapā Mediju tipi.