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ā multivides tipu:

  1. Atveriet Alerts > Media types.
  2. Noklikšķiniet uz Create media type (vai sarakstā ar iepriekš definētajiem multivides tipiem noklikšķiniet uz Email).

Cilnē Media type ir pieejami vispārīgie multivides tipa atribūti:

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

Eksportējot e-pasta multivides tipa konfigurāciju, parole tiek eksportēta nešifrētā veidā.

Tālāk norādītie parametri ir specifiski e-pasta multivides 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ā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 par e-pasta pakalpojumu sniedzēju ir atlasīts Generic SMTP.
SMTP server port Norādiet SMTP servera portu izejošo ziņojumu apstrādei.
Šis lauks ir pieejams, ja par e-pasta pakalpojumu sniedzēju 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 (piemēram, "Zabbix_info" ekrānuzņēmumā redzamajā Zabbix_info <[email protected]>), norādot faktisko e-pasta adresi.
Zabbix e-pastos attēlojamajiem vārdiem ir daži ierobežojumi salīdzinājumā ar RFC 5322 atļauto, kā parādīts tālāk sniegtajos piemēros:
Derīgi piemēri:
[email protected] (tikai e-pasta adrese, leņķiekavas nav jāizmanto)
Zabbix_info <[email protected]> (attēlojamais vārds un 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 norādīts attēlojamais vārds, bet ap e-pasta adresi nav leņķiekavu)
"Zabbix@<H(comment)Q>" <[email protected]> (lai gan tas ir derīgs saskaņā ar RFC 5322, Zabbix e-pastos netiek atbalstīti citētie 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 atkļūdošanas līmeņa brīdinājums un kā HELO komandas domēns tiks nosūtīts servera resursdatora nosaukums.
Šis lauks ir pieejams, ja par e-pasta pakalpojumu sniedzēju 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 nav obligāta
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.
Tādējādi tiek iestatīta cURL opcija 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.
Tādējādi tiek iestatīta cURL opcija CURLOPT_SSL_VERIFYHOST.
Authentication Atlasiet autentifikācijas līmeni:
None - cURL opcijas netiek iestatītas
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 Autentifikācijai izmantojamais lietotājvārds.
Tādējādi tiek iestatīta CURLOPT_USERNAME vērtība.
Tiek atbalstīti lietotāja makrosi.
Password Autentifikācijai izmantojamā parole.
Tādējādi tiek iestatīta CURLOPT_PASSWORD vērtība.
Tiek atbalstīti lietotāja makrosi.
Šeit ievadītā vērtība, eksportējot multivides tipa konfigurāciju, tiek eksportēta nemainīta. Lai eksportētajos failos netiktu atklāti sensitīvi akreditācijas dati, burtiskas paroles vietā izmantojiet lietotāja makrosu (piemēram, {$EMAIL_SMTP_PASSWORD}) - tiks eksportēta makrosa atsauce, savukārt slepenā vērtība galamērķa sistēmā būs jāiestata (atkārtoti).
OAuth tokens Noklikšķiniet uz Configure, lai jaunā logā iestatītu OAuth tokens izgūšanas parametrus.
Šis lauks ir pieejams tikai tad, ja laukā Authentication ir atlasīts "OAuth".
Message format Atlasiet ziņojuma formātu:
HTML - nosūtīt HTML formātā
Plain text - nosūtīt vienkārša teksta formātā

Lai iespējotu SMTP autentifikāciju, Zabbix serveris jākompilē ar --with-libcurl kompilēšanas opciju, kurai nepieciešama libcurl bibliotēka (informāciju par versijām skatiet servera prasībās).

Detalizētu informāciju par noklusējuma ziņojumu un trauksmju apstrādes opciju konfigurēšanu skatiet arī sadaļā common media type parameters.

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.