1 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

So konfigurieren Sie E-Mail als Medientyp:

  1. Gehen Sie zu Benachrichtigungen > 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 erforderlichen Eingabefelder sind mit einem roten Sternchen markiert.

Das Passwort wird beim Exportieren der E-Mail-Medientyp-Konfiguration im Klartext exportiert.

Die folgenden Parameter sind spezifisch für den E-Mail-Medientyp:

Parameter Beschreibung
E-Mail-Anbieter 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 Verbindungssicherheit werden von Zabbix automatisch ausgefüllt. Siehe auch: Automatisierte Gmail-/Office365-Medientypen.
SMTP-Server Legen Sie einen SMTP-Server für die Verarbeitung ausgehender Nachrichten fest.
Dieses Feld ist verfügbar, wenn Generic SMTP als E-Mail-Anbieter ausgewählt ist.
SMTP-Server-Port Legen Sie den Port des SMTP-Servers für die Verarbeitung ausgehender Nachrichten fest.
Dieses Feld ist verfügbar, wenn Generic SMTP als E-Mail-Anbieter ausgewählt ist.
E-Mail Die hier eingegebene Adresse wird als Von-Adresse für die gesendeten Nachrichten verwendet.
Das Hinzufügen eines Anzeigenamens des Absenders (wie „Zabbix_info“ in Zabbix_info zabbix\@company.com im Screenshot oben) zusammen mit der eigentlichen E-Mail-Adresse wird unterstützt.
Für Anzeigenamen in Zabbix-E-Mails gelten im Vergleich zu den durch RFC 5322 erlaubten Werten einige Einschränkungen, wie die folgenden Beispiele zeigen:
Gültige Beispiele:
zabbix\@company.com (nur E-Mail-Adresse, spitze Klammern sind nicht erforderlich)
Zabbix_info zabbix\@company.com (Anzeigename und E-Mail-Adresse in spitzen Klammern)
∑Ω-monitoring zabbix\@company.com (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\@\<H(comment)Q\>" zabbix\@company.com (obwohl gemäß RFC 5322 gültig, werden maskierte Zeichenpaare und Kommentare in Zabbix-E-Mails nicht unterstützt)
SMTP helo Legen Sie einen korrekten SMTP-helo-Wert fest, normalerweise einen Domainnamen.
Wenn leer, wird der Domainname der E-Mail gesendet (d. h. der Teil nach @ im Feld E-Mail). Wenn der Domainname nicht ermittelt werden kann, wird eine Warnung auf Debug-Ebene protokolliert und der Hostname des Servers wird als Domain für den HELO-Befehl gesendet.
Dieses Feld ist verfügbar, wenn Generic SMTP als E-Mail-Anbieter ausgewählt ist.
Verbindungssicherheit Wählen Sie die Stufe der Verbindungssicherheit aus:
Keine - die Option CURLOPT_USE_SSL wird nicht verwendet
STARTTLS - die Option CURLOPT_USE_SSL wird mit dem Wert CURLUSESSL_ALL verwendet
SSL/TLS - die Verwendung von CURLOPT_USE_SSL ist optional
SSL Peer verifizieren Aktivieren Sie das Kontrollkästchen, um das SSL-Zertifikat des SMTP-Servers zu verifizieren.
Der Wert der Server-Konfigurationsdirektive "SSLCALocation" sollte zur Zertifikatsvalidierung in CURLOPT_CAPATH eingetragen werden.
Dies setzt die cURL-Option CURLOPT_SSL_VERIFYPEER.
SSL Host verifizieren Aktivieren Sie das Kontrollkästchen, um zu verifizieren, dass das Feld Common Name oder das Feld Subject Alternate Name des SMTP-Serverzertifikats übereinstimmt.
Dies setzt die cURL-Option CURLOPT_SSL_VERIFYHOST.
Authentifizierung Wählen Sie die Stufe der Authentifizierung aus:
Keine - es werden keine cURL-Optionen gesetzt
Benutzername und Passwort - impliziert "AUTH=*" und überlässt die Wahl des Authentifizierungsmechanismus cURL
OAuth - OAuth-Authentifizierung
OAuth-Authentifizierung wird für den E-Mail-Anbieter Office365 relay nicht unterstützt.
Benutzername Benutzername für die Authentifizierung.
Dies setzt den Wert von CURLOPT_USERNAME.
Benutzermakros werden unterstützt.
Passwort Passwort für die Authentifizierung.
Dies setzt den Wert von CURLOPT_PASSWORD.
Benutzermakros werden unterstützt.
Der hier eingegebene Wert wird beim Exportieren der Medientyp-Konfiguration unverändert exportiert. Um zu vermeiden, dass vertrauliche Zugangsdaten in exportierten Dateien offengelegt werden, verwenden Sie statt eines Klartext-Passworts ein Benutzermakro (zum Beispiel {$EMAIL_SMTP_PASSWORD}) — beim Export wird dann der Makroverweis exportiert, während der geheime Wert auf dem Zielsystem (erneut) konfiguriert werden sollte.
OAuth-Tokens Klicken Sie auf Konfigurieren, um Parameter zum Abrufen von OAuth-Tokens in einem neuen Fenster einzurichten.
Dieses Feld ist nur verfügbar, wenn im Feld Authentifizierung „OAuth“ ausgewählt ist.
Nachrichtenformat Wählen Sie das Nachrichtenformat aus:
HTML - als HTML senden
Klartext - als Klartext senden

Um SMTP-Authentifizierung zu aktivieren, muss der Zabbix Server mit der Kompilierungs-Option --with-libcurl kompiliert werden, die libcurl erfordert (Versionsdetails finden Sie in den Anforderungen für server).

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

OAuth-Token

Die folgenden Parameter sind zum Abrufen von OAuth-Token erforderlich:

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-frontend-url>/zabbix.php?action=oauth.authorize).
Bei einem neuen E-Mail-Medientyp wird dieser automatisch gesetzt, wenn die Frontend-URL 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.

Das Abrufen von OAuth-Token verfügt für die E-Mail-Anbieter Gmail, Gmail relay und Office365 über automatisierte Funktionen. 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).

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

So testen Sie, ob ein konfigurierter E-Mail-Medientyp korrekt funktioniert:

  1. Suchen Sie die entsprechende 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 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:

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 beschrieben.