[comment]: # ({473c0010-d40475f4})
# 1 E-Mail
[comment]: # ({/473c0010-d40475f4})
[comment]: # ({860d77dd-9d59e93d})
#### Übersicht
Um E-Mail als Zustellkanal für Nachrichten zu konfigurieren, müssen Sie E-Mail als Medientyp konfigurieren und Benutzern bestimmte Adressen zuweisen.
::: noteclassic
Mehrere Benachrichtigungen für ein einzelnes Ereignis werden im selben E-Mail-Thread zusammengefasst.
:::
[comment]: # ({/860d77dd-9d59e93d})
[comment]: # ({259509d6-3711e99d})
#### Konfiguration
Um E-Mail als Medientyp zu konfigurieren:
1. Gehen Sie zu *Alerts > Medientypen*.
2. Klicken Sie auf *Medientyp erstellen* (oder klicken Sie in der Liste der vordefinierten Medientypen auf *E-Mail*).
Die Registerkarte **Medientyp** enthält allgemeine Attribute des Medientyps:
{width="600"}
Alle obligatorischen Eingabefelder sind mit einem roten Sternchen markiert.
:::notewarning
Das Passwort wird beim Export der E-Mail-Medientyp-Konfiguration im Klartext exportiert.
:::
Die folgenden Parameter sind spezifisch für den E-Mail-Medientyp:
|Parameter|Beschreibung|
|--|--------|
|*Email provider*|Wählen Sie den E-Mail-Anbieter aus: *Generic SMTP*, *Gmail*, *Gmail relay*, *Office365* oder *Office365 relay*.
Wenn Sie die Gmail-/Office365-bezogenen Optionen auswählen, müssen Sie nur die Absender-E-Mail-Adresse und das Passwort angeben; Optionen wie *SMTP server*, *SMTP server port*, *SMTP helo* und *Connection security* werden von Zabbix automatisch ausgefüllt. Siehe auch: [Automated Gmail/Office365 media types](/manual/config/notifications/media/email/gmail_office). |
|*SMTP server*|Legen Sie einen SMTP-Server für ausgehende Nachrichten fest.
Dieses Feld ist verfügbar, wenn *Generic SMTP* als E-Mail-Anbieter ausgewählt ist.|
|*SMTP server port*|Legen Sie den SMTP-Server-Port für ausgehende Nachrichten fest.
Dieses Feld ist verfügbar, wenn *Generic SMTP* als E-Mail-Anbieter ausgewählt ist.|
|*Email*|Die hier eingegebene Adresse wird als **From**-Adresse für die gesendeten Nachrichten verwendet.
Das Hinzufügen eines Anzeigenamens des Absenders (wie "Zabbix\_info" in *Zabbix\_info * im obigen Screenshot) zusammen mit der tatsächlichen E-Mail-Adresse wird unterstützt.
Im Vergleich zu RFC 5322 gibt es in Zabbix-E-Mails einige Einschränkungen für Anzeigenamen, wie die folgenden Beispiele zeigen:
Gültige Beispiele:
*zabbix\@company.com* (nur E-Mail-Adresse, keine spitzen Klammern erforderlich)
*Zabbix\_info * (Anzeigename und E-Mail-Adresse in spitzen Klammern)
*∑Ω-monitoring * (UTF-8-Zeichen im Anzeigenamen)
Ungültige Beispiele:
*Zabbix HQ zabbix\@company.com* (Anzeigename vorhanden, aber keine spitzen Klammern um die E-Mail-Adresse)
*"Zabbix\\@\\" * (obwohl nach RFC 5322 gültig, werden quoted pairs und Kommentare in Zabbix-E-Mails nicht unterstützt)|
|*SMTP helo*|Legen Sie einen korrekten SMTP-helo-Wert fest, normalerweise einen Domainnamen.
Wenn das Feld leer ist, wird der Domainname der E-Mail gesendet (d. h. das, was im Feld *Email* nach `@` steht). Wenn der Domainname nicht ermittelt werden kann, wird eine Warnung auf Debug-Ebene protokolliert und der Server-Hostname wird als Domain für den HELO-Befehl gesendet.
Dieses Feld ist verfügbar, wenn *Generic SMTP* als E-Mail-Anbieter ausgewählt ist.|
|*Connection security*|Wählen Sie die Stufe der Verbindungssicherheit aus:
**None** - die Option [CURLOPT\_USE\_SSL](http://curl.haxx.se/libcurl/c/CURLOPT_USE_SSL.html) nicht verwenden
**STARTTLS** - die Option CURLOPT\_USE\_SSL mit dem Wert CURLUSESSL\_ALL verwenden
**SSL/TLS** - die Verwendung von CURLOPT\_USE\_SSL ist optional|
|*SSL verify peer*|Aktivieren Sie das Kontrollkästchen, um das SSL-Zertifikat des SMTP-Servers zu überprüfen.
Der Wert der Serverkonfigurationsanweisung "SSLCALocation" sollte für die Zertifikatsvalidierung in [CURLOPT\_CAPATH](http://curl.haxx.se/libcurl/c/CURLOPT_CAPATH.html) eingetragen werden.
Dadurch wird die cURL-Option [CURLOPT\_SSL\_VERIFYPEER](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYPEER.html) gesetzt.|
|*SSL verify host*|Aktivieren Sie das Kontrollkästchen, um zu überprüfen, ob das Feld *Common Name* oder das Feld *Subject Alternate Name* des SMTP-Serverzertifikats übereinstimmt.
Dadurch wird die cURL-Option [CURLOPT\_SSL\_VERIFYHOST](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYHOST.html) gesetzt.|
|*Authentication*|Wählen Sie die Stufe der Authentifizierung aus:
**None** - es werden keine cURL-Optionen gesetzt
**Username and password** - impliziert "AUTH=\*", wobei die Wahl des Authentifizierungsmechanismus cURL überlassen wird
**OAuth** - OAuth-Authentifizierung
Die OAuth-Authentifizierung wird für den E-Mail-Anbieter *Office365 relay* nicht unterstützt.|
|*Username*|Benutzername, der für die Authentifizierung verwendet wird.
Dadurch wird der Wert von [CURLOPT\_USERNAME](http://curl.haxx.se/libcurl/c/CURLOPT_USERNAME.html) gesetzt.
[Benutzermakros](/manual/appendix/macros/supported_by_location_user#other-locations) werden unterstützt.|
|*Password*|Passwort, das für die Authentifizierung verwendet wird.
Dadurch wird der Wert von [CURLOPT\_PASSWORD](http://curl.haxx.se/libcurl/c/CURLOPT_PASSWORD.html) gesetzt.
[Benutzermakros](/manual/appendix/macros/supported_by_location_user#other-locations) werden unterstützt.
Der hier eingegebene Wert wird beim Export der Medientyp-Konfiguration unverändert exportiert. Um zu vermeiden, dass vertrauliche Anmeldedaten in exportierten Dateien offengelegt werden, verwenden Sie stattdessen ein Benutzermakro (zum Beispiel `{$EMAIL_SMTP_PASSWORD}`) anstelle eines Klartext-Passworts — die Makro-Referenz wird exportiert, während der geheime Wert auf dem Zielsystem (neu) konfiguriert werden sollte.|
|*OAuth tokens*|Klicken Sie auf *Konfigurieren*, um in einem neuen Fenster Parameter zum Abrufen von [OAuth tokens](#oauth-tokens) einzurichten.
Dieses Feld ist nur verfügbar, wenn im Feld *Authentication* *OAuth* ausgewählt ist.|
|*Message format*|Wählen Sie das Nachrichtenformat aus:
**HTML** - als HTML senden
**Plain text** - als Klartext senden|
::: noteimportant
Um die SMTP-Authentifizierung zu aktivieren, muss der Zabbix-Server mit der [Kompilierungs](/manual/installation/install#configure-the-sources)option `--with-libcurl` kompiliert werden, wofür libcurl erforderlich ist (siehe [Server](/manual/installation/requirements#serverproxy)-Anforderungen für Versionsdetails).
:::
Siehe auch [allgemeine Medientyp-Parameter](/manual/config/notifications/media#common-parameters) für Details zur Konfiguration von Standardnachrichten und Optionen zur Alarmverarbeitung.
[comment]: # ({/259509d6-3711e99d})
[comment]: # ({6f74aa36-61f2be67})
#### OAuth-Token
Die folgenden Parameter sind zum Abrufen von OAuth-Token erforderlich:
{width="600"}
|Parameter|Beschreibung|
|--|--------|
|*Umleitungsendpunkt*|Geben Sie die URL des Zabbix Frontends ein, zu der der OAuth-Dienst nach der OAuth-Autorisierung zurückleitet (im Format `https:///zabbix.php?action=oauth.authorize`).
Bei einem neuen E-Mail-Medientyp wird dieser automatisch gesetzt, wenn die [Frontend-URL](/manual/web_interface/frontend_sections/administration/general#other) definiert ist.|
|*Client-ID*|Geben Sie die eindeutige Kennung der Client-Anwendung ein, die im OAuth-Autorisierungsserver registriert ist.|
|*Client-Secret*|Geben Sie das private Geheimnis der Client-Anwendung ein, die im OAuth-Autorisierungsserver registriert ist.|
|*Autorisierungsendpunkt*|Geben Sie die URL des OAuth-Autorisierungsservers für die Anforderung der Benutzerautorisierung ein.|
|*Autorisierungsparameter*|Geben Sie Parameter für den Autorisierungsendpunkt ein.|
|*Autorisierungscode*|Geben Sie den Autorisierungscode ein:
**Automatisch** - der Code wird automatisch über eine Umleitungsseite abgerufen
**Manuell** - geben Sie den Code manuell ein, wenn der automatische Abruf fehlschlägt|
|*Token-Endpunkt*|Geben Sie die URL des OAuth-Autorisierungsservers ein, um den Autorisierungscode gegen Zugriffs- und Aktualisierungs-Token auszutauschen.|
|*Token-Parameter*|Geben Sie Parameter für das Zugriffstoken ein.|
:::notetip
Das Abrufen von OAuth-Token verfügt für die E-Mail-Anbieter **Gmail**, **Gmail relay** und **Office365** über [automatisierte Funktionen](/manual/config/notifications/media/email/gmail_office#oauth-tokens). Es ist nur erforderlich, Werte für die Parameter *Umleitungsendpunkt*, *Client-ID* und *Client-Secret* anzugeben. Zabbix füllt die anderen erforderlichen Werte automatisch aus (siehe [Standardwerte für OAuth-URLs nach Anbieter](/manual/config/notifications/media/email/gmail_office#oauth-url-defaults-by-provider)).
:::
[comment]: # ({/6f74aa36-61f2be67})
[comment]: # ({cdcb5c81-7bf715f0})
##### Abruf von OAuth-Zugriffs- und Aktualisierungs-Token
Nach dem Absenden der OAuth-Parameter:
1. Ein Browser-Popup wird geöffnet und leitet den Benutzer zum *Authorization endpoint* weiter.
2. Der Benutzer autorisiert Zabbix im OAuth-Dienst.
3. Der OAuth-Dienst leitet den Benutzer zur Zabbix-Frontend-Aktion `oauth.authorize` mit dem Autorisierungscode und dem Scope-Wert weiter.
4. Als Antwort sendet Zabbix eine Anfrage an den *Token endpoint*, um den Autorisierungscode gegen Zugriffs- und Aktualisierungs-Token auszutauschen.
[comment]: # ({/cdcb5c81-7bf715f0})
[comment]: # ({50e8f033-98f29ec0})
#### Testen
So testen Sie, ob ein konfigurierter E-Mail-Medientyp korrekt funktioniert:
1. Suchen Sie die entsprechende E-Mail in der [Liste](/manual/config/notifications/media#overview) der Medientypen.
2. Klicken Sie in der letzten Spalte der Liste auf *Test* (ein Testfenster wird geöffnet).
3. Geben Sie eine Empfängeradresse in *Send to*, den Nachrichtentext und optional einen Betreff ein.
4. Klicken Sie auf *Test*, um eine Testnachricht zu senden.
Eine Meldung über Erfolg oder Fehlschlag des Tests wird im selben Fenster angezeigt:
{width="600"}
[comment]: # ({/50e8f033-98f29ec0})
[comment]: # ({859be4b6-5e74f274})
#### Benutzermedien
Sobald der E-Mail-Medientyp konfiguriert ist, gehen Sie zum Abschnitt *Benutzer > Benutzer* und bearbeiten Sie das Benutzerprofil, um dem Benutzer E-Mail-Medien zuzuweisen.
Die Schritte zum Einrichten von Benutzermedien, die für alle Medientypen gleich sind, werden auf der Seite [Medientypen](/manual/config/notifications/media#user-media) beschrieben.
[comment]: # ({/859be4b6-5e74f274})