E-Mail

Übersicht

Um E-Mail als Zustellkanal für Nachrichten zu konfigurieren, müssen Sie E-Mail als Medientyp konfigurieren und Benutzern bestimmte Adressen zuweisen.

Mehrere Benachrichtigungen für ein einzelnes Ereignis werden im selben E-Mail-Thread zusammengefasst.

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:

Alle obligatorischen Eingabefelder sind mit einem roten Sternchen markiert.

Das Passwort wird beim Export der Konfiguration des E-Mail-Medientyps 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 eine der 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.
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 mit der tatsächlichen E-Mail-Adresse (zum Beispiel Zabbix_info <[email protected]>) wird unterstützt.
Im Vergleich zu den in RFC 5322 zulässigen Anzeigenamen gibt es in Zabbix-E-Mails einige Einschränkungen, wie die folgenden Beispiele zeigen.
Gültige Beispiele:
[email protected] (nur eine E-Mail-Adresse; spitze Klammern sind nicht erforderlich)
Zabbix_info <[email protected]> (ein Anzeigename gefolgt von der E-Mail-Adresse in spitzen Klammern)
∑Ω-monitoring <[email protected]> (UTF-8-Zeichen im Anzeigenamen)
Ungültige Beispiele:
Zabbix HQ [email protected] (ein Anzeigename ist vorhanden, aber die E-Mail-Adresse steht nicht in spitzen Klammern)
"Zabbix@<H(comment)Q>" <[email protected]> (obwohl dies nach RFC 5322 gültig ist, werden quoted pairs und Kommentare in Zabbix-E-Mails nicht unterstützt).
SMTP helo Legen Sie einen korrekten SMTP-helo-Wert fest, normalerweise einen Domänennamen.
Wenn das Feld leer ist, wird der Domänenname der E-Mail gesendet (d. h. der Teil nach @ im Feld Email). Wenn der Domänenname nicht ermittelt werden kann, wird eine Warnung auf Debug-Ebene protokolliert und der Hostname des Servers wird als Domäne 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 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 Serverkonfigurationsdirektive "SSLCALocation" sollte für die Zertifikatsvalidierung in CURLOPT_CAPATH eingetragen werden.
Dies setzt die cURL-Option CURLOPT_SSL_VERIFYPEER fest.
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.
Dies setzt die cURL-Option CURLOPT_SSL_VERIFYHOST fest.
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 werden soll.
Dies setzt den Wert von CURLOPT_USERNAME fest.
Benutzermakros werden unterstützt.
Password Passwort, das für die Authentifizierung verwendet werden soll.
Dies setzt den Wert von CURLOPT_PASSWORD fest.
Benutzermakros werden unterstützt.
Der hier eingegebene Wert wird beim Export der Medientypkonfiguration 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 Makroreferenz wird exportiert, während der geheime Wert auf dem Zielsystem (erneut) konfiguriert werden sollte.
OAuth tokens Klicken Sie auf Konfigurieren, um in einem neuen Fenster Parameter zum Abrufen von OAuth tokens festzulegen.
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 Nur-Text senden.

Um die SMTP-Authentifizierung zu aktivieren, muss der Zabbix-Server mit der Kompilierungsoption --with-libcurl kompiliert werden, wofür libcurl erforderlich ist (siehe Server-Anforderungen für Versionsdetails).

Siehe auch allgemeine Parameter des Medientyps für Details zur Konfiguration von Standardnachrichten und Optionen zur Alarmverarbeitung.

OAuth-Tokens

Die folgenden Parameter sind für das Abrufen von OAuth-Tokens erforderlich:

Das Client-Geheimnis wird im Klartext exportiert, wenn die Konfiguration des E-Mail-Medientyps exportiert wird.

Parameter Beschreibung
Redirection endpoint Geben Sie die Zabbix-Frontend-URL ein, an die der OAuth-Dienst die OAuth-Autorisierung zurückleitet (im Format https://<zabbix-frontend-url>/zabbix.php?action=oauth.authorize).
Sie wird für einen neuen E-Mail-Medientyp automatisch gesetzt, wenn die Frontend-URL definiert ist.
Client ID Geben Sie die eindeutige Kennung der Client-App ein, die beim OAuth-Autorisierungsserver registriert ist.
Client secret Geben Sie das private Geheimnis der Client-App ein, die beim OAuth-Autorisierungsserver registriert ist.
Authorization endpoint Geben Sie die URL des OAuth-Autorisierungsservers für die Anforderung der Benutzerautorisierung ein.
Authorization parameters Geben Sie die Parameter für den Autorisierungsendpunkt ein.
Authorization code Geben Sie den Autorisierungscode ein:
Automatic - der Code wird automatisch über eine Umleitungsseite abgerufen;
Manual - geben Sie den Code manuell ein, wenn der automatische Abruf fehlschlägt.
Token endpoint Geben Sie die URL des OAuth-Autorisierungsservers ein, um den Autorisierungscode gegen Zugriffs- und Aktualisierungstokens auszutauschen.
Token parameters Geben Sie die Parameter für das Zugriffstoken ein.

Das Abrufen von OAuth-Tokens verfügt über automatisierte Funktionen für die E-Mail-Anbieter Gmail, Gmail relay und Office365. Es müssen nur die Parameterwerte Redirection endpoint, Client ID und Client secret angegeben werden. Zabbix füllt die anderen erforderlichen Werte automatisch aus (siehe OAuth-URL-Standardwerte nach Anbieter).

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.

Testen

Um zu testen, ob ein konfigurierter E-Mail-Medientyp korrekt funktioniert:

  1. Suchen Sie die relevante E-Mail in der Liste der Medientypen.
  2. Klicken Sie in der letzten Spalte der Liste auf Test (ein Testfenster wird geöffnet).
  3. Geben Sie eine Empfängeradresse für Senden an, den Nachrichtentext und optional einen Betreff ein.
  4. Klicken Sie auf Test, um eine Testnachricht zu senden.

Im selben Fenster wird eine Meldung über Erfolg oder Fehler des Tests angezeigt:

Benutzer-Medien

Nachdem der E-Mail-Medientyp konfiguriert wurde, wechseln Sie zum Abschnitt Users > Users und bearbeiten Sie das Benutzerprofil, um dem Benutzer E-Mail-Medien zuzuweisen. Die Schritte zum Einrichten von Benutzer-Medien, die für alle Medientypen gleich sind, werden auf der Seite Medientypen beschrieben.