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 .
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.
Definiert das Modul zum Versenden von E-Mails. Legt somit fest, welches Übertragungsprotokoll genutzt werden soll (z. B. SMTP | SMTPS | TLS)
"Sendmail" verwendet direkt das Sendmail-Binary Ihres Betriebssystems. Jeder der SMTP-Mechanismen verwendet einen angegebenen (externen) Mailserver.
"DoNotSendEmail" sendet keine E-Mails und ist für Testsysteme nützlich.
Beispiel: Kernel::System::Email::SMTP
Wenn einer der SMTP-Mechanismen als SendmailModule ausgewählt wurde und eine Authentifizierung gegenüber dem Mailserver erforderlich ist, muss hier ein Passwort hinterlegt werden.
Beispiel: My1stMa!lservErPassW0rd
Hinterlegen Sie hier den Benutzernamen für den Login am Mailserver. Dieser entspricht häufig dem Namen des E-Mail-Kontos.
Wenn einer der SMTP-Mechanismen als SendmailModule ausgewählt wurde und eine Authentifizierung gegenüber dem Mailserver erforderlich ist, muss ein Benutzername angegeben werden.
Beispiel: email@example.com
Tragen Sie die Adresse des Mailservers ein.
Wenn einer der SMTP-Mechanismen als SendmailModule ausgewählt wurde, muss der Host des Mailservers angegeben werden, der die E-Mails versendet.
Beispiel: smtp.hoster.com
Tragen Sie den Port des Mailservers ein. Der Port ist vom gewählten Übertragungsprotokoll abhängig.
Wenn einer der SMTP-Mechanismen als SendmailModule ausgewählt wurde, muss der Port angegeben werden, an dem Ihr Mailserver auf eingehende Verbindungen wartet.
Häufige Ports sind: für SMTP: 465 für TLS: 587
Optional können Sie Ihre ausgehenden E-Mails in eine Art "Briefumschlag" stecken. Für den Mailtransport ist dann nur das erkennbar, was auf dem "Briefumschlag" steht. Die Konfiguration für den Briefumschlag erfolgt im Konfigurationsschlüssel:
Sie können Ihre ausgehenden E-Mails in eine Art "Briefumschlag" (Envelope) stecken. Für den Mailtransport ist dann nur erkennbar, was auf dem "Briefumschlag" steht.
In diesem Konfigurationsschlüssel ist die E-Mail-Adresse hinterlegt, welche als Absender auf dem "Briefumschlag" stehen soll, z.B. absender@example.de oder mbox/RFC 5321 . Diese Adresse wird in ausgehenden Nachrichten als Absender für Umschläge verwendet.
Ist keine Absender-Adresse angegeben, wird die E-Mail-Adresse des Teams als Absender verwendet
Alternativ können Sie die Adresse auch im Setup Assistent hinterlegen (Konfiguration Postausgang).
Diese Einstellung gilt nicht für Ticket-Benachrichtigungen.
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_Frondend>
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: |