[comment]: # ({473c0010-d40475f4})
# 1 E-pasts

[comment]: # ({/473c0010-d40475f4})

[comment]: # ({860d77dd-9d59e93d})
#### 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.

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

[comment]: # ({/860d77dd-9d59e93d})

[comment]: # ({259509d6-3711e99d})
#### 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:

![](../../../../../assets/en/manual/config/notifications/media/media_email.png){width="600"}

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

:::notewarning
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*.<br>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](/manual/config/notifications/media/email/gmail_office). |
|*SMTP server*|Norādiet SMTP serveri izejošo ziņojumu apstrādei.<br>Š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.<br>Š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.<br>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ā).<br>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:<br>Derīgi piemēri:<br>*zabbix\@company.com* (tikai e-pasta adrese, nav jāizmanto stūra iekavas)<br>*Zabbix\_info <zabbix\@company.com>* (attēlojamais vārds un e-pasta adrese stūra iekavās)<br>*∑Ω-monitoring <zabbix\@company.com>* (UTF-8 rakstzīmes attēlojamajā vārdā)<br>Nederīgi piemēri:<br>*Zabbix HQ zabbix\@company.com* (ir attēlojamais vārds, bet e-pasta adrese nav ietverta stūra iekavās)<br>*"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.<br>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.<br>Šis lauks ir pieejams, ja kā e-pasta pakalpojumu sniedzējs ir atlasīts *Generic SMTP*.|
|*Connection security*|Atlasiet savienojuma drošības līmeni:<br>**None** - neizmantojiet opciju [CURLOPT\_USE\_SSL](http://curl.haxx.se/libcurl/c/CURLOPT_USE_SSL.html)<br>**STARTTLS** - izmantojiet opciju CURLOPT\_USE\_SSL ar vērtību CURLUSESSL\_ALL<br>**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.<br>Servera konfigurācijas direktīvas "SSLCALocation" vērtība sertifikāta validācijai jāievieto [CURLOPT\_CAPATH](http://curl.haxx.se/libcurl/c/CURLOPT_CAPATH.html).<br>Tas iestata cURL opciju [CURLOPT\_SSL\_VERIFYPEER](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYPEER.html).|
|*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.<br>Tas iestata cURL opciju [CURLOPT\_SSL\_VERIFYHOST](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYHOST.html).|
|*Authentication*|Atlasiet autentifikācijas līmeni:<br>**None** - netiek iestatītas cURL opcijas<br>**Username and password** - nozīmē "AUTH=\*", atstājot autentifikācijas mehānisma izvēli cURL ziņā<br>**OAuth** - OAuth autentifikācija<br>OAuth autentifikācija netiek atbalstīta e-pasta pakalpojumu sniedzējam *Office365 relay*.|
|*Username*|Lietotājvārds, ko izmantot autentifikācijai.<br>Tas iestata [CURLOPT\_USERNAME](http://curl.haxx.se/libcurl/c/CURLOPT_USERNAME.html) vērtību.<br>Tiek atbalstīti [lietotāja makrosi](/manual/appendix/macros/supported_by_location_user#other-locations).|
|*Password*|Parole, ko izmantot autentifikācijai.<br>Tas iestata [CURLOPT\_PASSWORD](http://curl.haxx.se/libcurl/c/CURLOPT_PASSWORD.html) vērtību.<br>Tiek atbalstīti [lietotāja makrosi](/manual/appendix/macros/supported_by_location_user#other-locations).<br>Š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](#oauth-tokens) iegūšanai.<br>Šis lauks ir pieejams tikai tad, ja laukā *Authentication* ir atlasīts "OAuth".|
|*Message format*|Atlasiet ziņojuma formātu:<br>**HTML** - sūtīt kā HTML<br>**Plain text** - sūtīt kā vienkāršu tekstu|

::: noteimportant
Lai iespējotu SMTP autentifikāciju, Zabbix serverim jābūt kompilētam ar `--with-libcurl` [kompilēšanas](/manual/installation/install#configure-the-sources) opciju, kurai nepieciešams libcurl (versijas informāciju skatiet prasībās [serveris](/manual/installation/requirements#serverproxy)).
:::

Skatiet arī [common media type parameters](/manual/config/notifications/media#common-parameters), lai iegūtu informāciju par noklusējuma ziņojumu un brīdinājumu apstrādes opciju konfigurēšanu.

[comment]: # ({/259509d6-3711e99d})

[comment]: # ({6f74aa36-61f2be67})
#### OAuth tokeni

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

![](../../../../../assets/en/manual/config/notifications/media/media_email_oauth.png){width="600"}

|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`).<br>Jaunam e-pasta medija tipam tas tiek iestatīts automātiski, ja ir definēts [lietotāja saskarnes URL](/manual/web_interface/frontend_sections/administration/general#other).|
|*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:<br>**Automātiski** — kods tiks iegūts automātiski, izmantojot pāradresācijas lapu<br>**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.|

:::notetip
OAuth tokenu iegūšanai ir [automatizētas iespējas](/manual/config/notifications/media/email/gmail_office#oauth-tokens) 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](/manual/config/notifications/media/email/gmail_office#oauth-url-defaults-by-provider)).
:::

[comment]: # ({/6f74aa36-61f2be67})

[comment]: # ({cdcb5c81-7bf715f0})
##### 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.

[comment]: # ({/cdcb5c81-7bf715f0})

[comment]: # ({50e8f033-98f29ec0})
#### Testēšana

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

1. Atrodiet attiecīgo e-pastu mediju tipu [sarakstā](/manual/config/notifications/media#overview).
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ā:

![](../../../../../assets/en/manual/config/notifications/media/test_email0.png){width="600"}

[comment]: # ({/50e8f033-98f29ec0})

[comment]: # ({859be4b6-5e74f274})
#### 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](/manual/config/notifications/media#user-media).

[comment]: # ({/859be4b6-5e74f274})
