Postausgang
Damit KIX E-Mails versenden kann, müssen Sie einen SMTP-Mailserver für den Postausgang einrichten. Alle ausgehenden E-Mails werden über diesen Server versendet.
Die Einrichtung erfolgt entweder bereits im 
Postausgang oder im Menü . Sie können den Mailserver jederzeit ändern, beispielsweise nach einem Wechsel des Hosting-Dienstleisters.
Sie benötigen die Systemrechte READ und UPDATE auf /system/config, um den Postausgangsserver einzurichten.
Die Absende/Antwort-Adresse einer ausgehenden E-Mail ist stets die Adresse, die am dem Team hinterlegt ist, von dem die E-Mail gesendet wurde.
Abb.: Beispiel Postausgang über Gmail
Für die Einrichtung des Postausgangs benötigen Sie die Anmeldeinformationen für den Postausgangsserver. Halten Sie folgende Informationen bereit:
Host des SMTP-Servers
das verwendete Übertragungsprotokoll inklusive des verwendeten Ports
Benutzerdaten und Passwort für den SMTP-Server
Wenn Sie den Mailserver eines Dienstleisters (Gmail, IONOS, Strato etc.) verwenden, erhalten Sie von diesem die erforderlichen Anmeldeinformationen. Wenn Sie einen eigenen Mailserver nutzen, sollten Ihnen die Anmeldeinformationen bekannt sein.
Navigieren Sie zum Menü .
Es wird ein Dialog geöffnet, in dem Sie den Postausgangsserver konfigurieren können.
Tragen Sie die Serverinformationen in die entsprechenden Eingabefelder ein (s.Konfigurationsparameter)
Klicken Sie abschließend auf .
Der Postausgangsserver ist nun konfiguriert, sodass KIX darüber E-Mails versenden kann.
Sie können den Postausgangsserver optional über die Konfigurationsschlüssel im Menü SysConfig konfigurieren. Diese Möglichkeit bietet sich an, wenn Sie über die Ersteinrichtung hinaus gehende Servereigenschaften konfigurieren möchten, oder wenn Sie über einen eigenen Mailserver verfügen und direkten Einfluss auf die Konfiguration nehmen wollen.
Konfigurationsschlüssel | *sendmail* |
Navigieren Sie zum Menü .
Suchen Sie nach dem Schlüssel . Geben Sie dabei die * mit an.
Es werden Ihnen mehrere Schlüssel für die Mailserverkonfiguration angezeigt.
Ausgegraute Schlüssel sind "ungültig" und können bei Bedarf auf "gültig" gesetzt werden.
Mit einem Schloss-Icon versehene Schlüssel sind für die Bearbeitung gesperrt.
Orange gekennzeichnete Schlüssel sind auf "gültig" gesetzte sicherheitsrelevante Schlüssel.
Klicken Sie auf den zu konfigurierenden Schlüssel.
Es wird ein Formular-Dialog geöffnet, in dem Sie den Wert des Schlüssels bearbeiten können.
Die konkreten Einstellungen hängen vom verwendeten Mailserver ab.
Ändern Sie den Wert des Schlüssels nach Erfordernis.
Wenn Sie einen JSON-Editor verwenden, achten Sie darauf, dass vor dem Speichern alle Leerzeichen und Zeilenumbrüche entfernt sind.
Klicken Sie abschließend auf .
Der Schlüssel ist nun geändert.
Nachfolgend aufgeführte Schlüssel werden für die Konfiguration des E-Mail-Versands benötigt. Weitere Sendmail-Schlüssel können optional verwendet werden.
Konfigurationsschlüssel | Beschreibung |
|---|---|
Modul für den E-Mail-Versand | |
Passwort für den Mailserver | |
Benutzer für Login am Mailserver | |
Host des Mailservers | |
Port des Mailservers | |
Optionaler "Briefumschlag" für ausgehende E-Mails |
KIX benötigt für den Postausgang mindestens eine gültige E-Mail-Adresse, welche als Standardadresse für den Postausgang dient. Über diese werden alle E-Mails versendet, wenn keine weiteren E-Mail-Adressen angelegt sind oder wenn der Versand von einer E-Mail-Adresse nicht möglich ist, z. B. weil sie auf "ungültig" gesetzt ist.
Die initiale Standard-E-Mail-Adresse für den Postausgang ist kix@localhost. Sie müssen diese durch eine eigene E-Mail-Adresse (Systemadresse) ersetzen. Dies kann direkt nach der Installation im Postausgang erfolgen.
Alternativ können Sie wie folgt vorgehen:
Abb.: Standardadresse im Menü E-Mail-Adressen ändern
Navigieren Sie im Explorer zu .
Klicken Sie auf die Adresse kix@localhost.
Klicken Sie in der sich öffnenden Detailansicht auf .
Ersetzen Sie im sich öffnenden Dialog die im Feld E-Mail- Adresse angegebene Adresse durch Ihre eigene Standard-Adresse.
Beachten Sie, dass die E-Mail-Adresse zu einem in KIX bekannten E-Mail-Konto passen muss (s. Posteingang )
Tipp
Sie können einen Platzhalter für den Domainnamen in der Standardadresse verwenden, dann wird die Domain automatisch vom System gezogen.
Zum Beispiel: info@<KIX_CONFIG_FQDN> oder mycompany@<KIX_CONFIG_FQDN_Frontend>
Voraussetzung: Im SysConfig-Schlüssel FQDN muss der vollständige Domainname zum Frontend angegeben sein.
Nachfolgend finden Sie Lösungsmöglichkeiten zu bekannten Problemen beim E-Mail-Versand:
Problem | Ursache | Lösung |
|---|---|---|
Die versendete E-Mail enthält in der MessageID den FQDN des KIX 18 Systems. (Per Default ist dies "yourhost.example.com") | Ausgehende E-Mails von der Appliance Hornet-Security wurden blockiert: "Reporting-MTA:dns; moutb-203.mailbox.org X-Postfix-Queue-ID:4CqzHG1CwVzQljX X-Postfix-Sender:rfc822; Arrival-Date: Tue, 8 Dec 2020 12:59:06 +0100 (CET) Final-Recipient:rfc822; Original-Recipient: rfc822; Action: failed Status: 5.6.1 Remote-MTA: dns; mx14a.antispameurope.com Diagnostic-Code: smtp; 554 5.6.1 Yourmailheader contains SPAM. To unblock visit http://antispameurope.com/unblock?a=0812& b=&d=1&e=195.10.208.52-mxgate64-hz1" | Nach der Anpassung des FQDN werden die E-Mails problemlos versendet (SysConfig- Schlüssel: ) |
| Im Log steht folgende Fehlermeldung: "[Error] [Kernel::System::Email::SMTP::Send] [152] Can't send to 'empfaenger@company.de': 5535.7.1 <absender@company.de>:Sender address rejected: not owned by user company@kix.cloud" | Absender E-Mail in den Teameinstellungen (z. B.: Team "Service Desk") prüfen und anpassen:
|
Ticketbenachrichtigungen gehen nicht raus |
| Anpassung der Absenderadresse für Benachrichtigungen erforderlich: SysConfig-Schlüssel: |