Proxy und Verbindungen

Proxy

Dieser Abschnitt beinhaltet die Proxy-Konfiguration mittels Umgebungsvariablen. Alternativ ist die Proxy-Konfiguration auch über die Zammad-Benutzeroberfläche möglich. Weitere Informationen dazu finden Sie im Netzwerk-Abschnitt der Admin-Dokumentation.

	GUI Konfiguration	Umgebungsvariable
Zugriff auf Host-OS erforderlich	Nein	Ja
Automatische Ausnahme von Loopback-Adressen	Ja	Nein
Konfigurationsprüfung	Ja	Manuell per Test-Skript
Ausnahmen	Ja	Nein

Die folgenden Umgebungsvariablen können zur Konfiguration der Proxy-Einstellungen verwendet werden. Passen Sie die Werte entsprechend Ihrer Umgebung an.

HTTP_PROXY

Variable für HTTP-Verkehr. Setzen Sie sie auf die Adresse Ihres Proxy-Servers, einschließlich des Ports. Funktioniert nicht im Docker-Kontext. Beispiel:

export HTTP_PROXY="http://127.0.0.1:8080"

HTTPS_PROXY

Variable für HTTPS-Verkehr. Setzen Sie sie auf die Adresse Ihres Proxy-Servers, einschließlich des Ports. Funktioniert nicht im Docker-Kontext. Beispiel:

export HTTPS_PROXY="http://127.0.0.1:8080"

NO_PROXY

Variable für Adressen, auf die direkt und ohne Proxy zugegriffen werden soll. Erwartet eine kommagetrennte Liste von Adressen und unterstützt Wildcards. Verwenden Sie einen führenden . als Platzhalter für Subdomains. Das Beispiel .example.com schließt example.com und alle seine Subdomains ein. Achten Sie darauf, dass Sie Loopback-Adressen einschließen, damit sie nicht über den Proxy geleitet werden. Beispiel:

export NO_PROXY="localhost,127.0.0.1,.example.com"

ES_JAVA_OPTS

Variable für die Einstellung eines Proxys für Elasticsearch. Standardmäßig kommuniziert Elasticsearch nicht mit externen Systemen während des Betriebs. Es kann jedoch Fälle geben, in denen dies erforderlich ist. Beispiel:

export ES_JAVA_OPTS="-Dhttp.proxyHost=127.0.0.1 -Dhttp.proxyPort=8080 -Dhttps.proxyHost=127.0.0.1 -Dhttps.proxyPort=8080"

TIP

Je nach Ihrer Umgebung benötigen Sie vielleicht auch die klein geschriebene Variante der Variablen. Im Zweifelsfall setzen Sie beide Varianten, indem Sie sie zusätzlich mit den Werten der großgeschriebenen Varianten angeben:

export http_proxy=$HTTP_PROXY

Externe Verbindungen

Während der Installation und des Betriebs von Zammad sind einige Verbindungen zu Online-Diensten erforderlich. Abhängig von Ihrer Installationsmethode und der Konfiguration von Zammad wird eine Verbindung zu den folgenden Diensten hergestellt (vielleicht auch hilfreich für die Firewall-Konfiguration):

Addresse	Kommentar
dl.packager.io	Download des OS-Pakets (Paketinstallation)
go.packager.io	Wie oben; neuer Paket-Hosting-Dienst
geo.zammad.com	Wird für Geodaten verwendet
google.com	Download von Feiertagen für den Kalender
index.rubygems.org	Download von Gems für Ruby
registry.npmjs.org	Download von JS-Abhängigkeiten

Sie können ein Skript verwenden, um den Verbindungsstatus Ihres Systems zu überprüfen. Es versucht, eine Verbindung zu den oben genannten Diensten herzustellen und zeigt das Ergebnis an. Wenn alle Verbindungen erfolgreich waren, zeigt es für jeden kontaktierten Dienst ein Häkchen an. Führen Sie es aus, indem Sie es entweder aus der Paketquelle von Zammad abrufen oder die lokale Version auf Ihrem Zammad-Server ausführen.

Skript online abrufen:

curl -fsSL https://raw.githubusercontent.com/zammad/zammad/refs/heads/stable/contrib/packager.io/test_download_dependencies_connection.sh | sh

Lokales Skript verwenden:

/opt/zammad/contrib/packager.io/test_download_dependencies_connection.sh

Web-Push-Benachrichtigungen

Zammad kann Agenten über ihre Tickets auf mobilen Geräten benachrichtigen. Diese Benachrichtigungen werden als Web-Push-Nachrichten über den Browser des Geräts übermittelt. Auf Android können sowohl ein kompatibler Browser als auch die installierte Ansicht diese empfangen. Auf iPhone und iPad muss die Mobilansicht zuerst zum Startbildschirm hinzugefügt werden. Wie man sie auf einem Gerät einrichtet, wird in der Mobilansicht-Dokumentation beschrieben.

Die Nachrichten werden über HTTPS (Port 443) vom Hintergrundprozess von Zammad an den Push-Dienst des Browseranbieters gesendet. Eine Firewall, die ausgehenden Datenverkehr beschränkt, muss die folgenden Adressen, einschließlich ihrer Subdomains, zulassen:

Addresse	Kommentar
fcm.googleapis.com	Web Push für Chrome und andere Chromium-basierte Browser
jmt17.google.com	Alternative Adresse des Google Push-Service
notify.windows.com	Web Push für Microsoft Edge
push.services.mozilla.com	Web Push für Mozilla Firefox
web.push.apple.com	Web Push für Safari auf iPhone, iPad und Mac

Die obige Proxy-Konfiguration gilt auch für diese Verbindungen, einschließlich der No-Proxy-Liste in der GUI-Konfiguration und der NO_PROXY-Umgebungsvariable.

Zammad akzeptiert nur Geräteabonnements der oben aufgelisteten Push-Dienste. Ein Browser, der einen anderen Push-Dienst verwendet, kann Push-Benachrichtigungen nicht aktivieren.

In Zammad müssen keine Einstellungen vorgenommen werden. Das Schlüsselpaar, das zur Signierung der Nachrichten verwendet wird (VAPID), wird einmalig pro Installation generiert und sollte nicht geändert werden: Alle bestehenden Geräteabonnements werden ungültig, sobald die Schlüssel geändert werden.

Der Push-Dienst des Browser-Anbieters übermittelt die Nachrichten, nicht Zammad. Je nach Gerät kann die Zustellung eine Weile dauern, beispielsweise auf Android-Geräten durch die Akkuoptimierung. Eine Nachricht, die nicht sofort zugestellt werden kann, wird vom Push-Dienst bis zu einem Tag lang gespeichert. Auf dem iPhone und dem iPad bleiben mehrere Nachrichten zum selben Ticket als separate Benachrichtigungen bestehen, während andere Plattformen die vorherige Benachrichtigung ersetzen.