Login: Zugang nicht gestattet
Mit Relution 26.4.0 wurde der interne Anwendungsserver von Undertow auf Tomcat umgestellt. Läuft der Reverse-Proxy (z.B. nginx oder Traefik) auf einem anderen Server als Relution selbst, kann es dadurch beim Login zu folgendem Fehler kommen:

Im Server-Log von Relution erscheint dazu ein entsprechender ERROR-Eintrag mit dem Hinweis TLS required.
Ursache
Damit eine Anmeldung möglich ist, muss die Verbindung zwischen Reverse-Proxy und Relution zwei Bedingungen gleichzeitig erfüllen:
- Der Reverse-Proxy muss von einer als intern eingestuften IP-Adresse mit Relution kommunizieren. Als intern gelten dabei standardmäßig die privaten IPv4-Bereiche
10.0.0.0/8,172.16.0.0/12und192.168.0.0/16, außerdem100.64.0.0/10,169.254.0.0/16und127.0.0.0/8(localhost) sowie die IPv6-Bereichefc00::/7,fe80::/10und::1. - Der Header
X-Forwarded-Protomuss vom Reverse-Proxy mit dem Werthttpsgesendet werden.
Nur wenn beide Bedingungen erfüllt sind, stuft Tomcat die eingehende Verbindung als TLS-gesichert ein. Läuft der Reverse-Proxy auf einem separaten Server mit eigener (externer) IP-Adresse, ist bereits die erste Bedingung nicht erfüllt. Fehlt zusätzlich oder stattdessen der X-Forwarded-Proto-Header, wird die Verbindung ebenfalls nicht als sicher erkannt. In beiden Fällen bricht Relution den Login mit TLS required im Server-Log ab, im Browser erscheint dazu die Meldung Zugang nicht gestattet.
Fehler bestätigen (optional)
Um die Ursache zu bestätigen, kann das DEBUG-Logging der zuständigen Tomcat-Komponente aktiviert werden. Dazu folgenden Eintrag auf oberster Ebene in die application.yml einfügen:
logging:
level:
org.apache.catalina.valves.RemoteIpValve: DEBUG
Anschließend einen erneuten Login-Versuch durchführen. Erscheint im Log danach ein Eintrag wie folgt, ist die IP des Reverse-Proxys die Ursache: Die Anfrage wird nicht als vertrauenswürdig eingestuft.
DEBUG ... ina.valves.RemoteIpValve: Skip RemoteIpValve for request /api/device/v1/currentDevice/actions/next with originalRemoteAddr '<externe-IP-des-Proxys>' []
Erscheint dieser Eintrag nicht, die Fehlermeldung aber weiterhin auftritt, liegt es stattdessen am fehlenden bzw. falschen X-Forwarded-Proto-Header, siehe Lösung →. Wird die Anfrage als vertrauenswürdig eingestuft, protokolliert Tomcat eine Zeile, die mit Incoming request beginnt. Enthält sie newSecure=[false], fehlt der Header X-Forwarded-Proto oder hat nicht den Wert https.
application.yml (welcher einen Neustart erfordert) kann das Log-Level für org.apache.catalina.valves.RemoteIpValve auch im laufenden Betrieb ohne Neustart über die Web API auf DEBUG gesetzt werden. Über das System-Portal ist das nur möglich, wenn es aktiviert und der Actuator-Endpoint loggers freigeschaltet ist. Nach Abschluss der Analyse ist das Log-Level wieder auf INFO zurückzusetzen, siehe Loglevel einstellen →.Lösung
Je nachdem, welche der beiden Bedingungen aus dem Abschnitt Ursache nicht erfüllt ist, ist eine der beiden folgenden Anpassungen nötig — bei Bedarf auch beide.
IP des Reverse-Proxys als vertrauenswürdig hinterlegen
Damit Relution die Anfragen des Reverse-Proxys akzeptiert, muss dessen IP-Adresse explizit als vertrauenswürdiger interner Proxy bekannt gemacht werden. Dazu folgenden Eintrag auf oberster Ebene in die application.yml eintragen:
server:
tomcat:
remoteip:
internal-proxies: '<Proxy-IP>/32, 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16, 169.254.0.0/16, 100.64.0.0/10, 127.0.0.0/8, fc00::/7, fe80::/10, ::1/128'
<Proxy-IP> wird dabei durch die tatsächliche IP-Adresse des Reverse-Proxys ersetzt, z. B. 194.95.62.71/32 (IPv6 mit /128). Statt einer einzelnen Adresse kann auch ein Netz angegeben werden. Weitere Proxy-Server werden kommagetrennt ergänzt.
Der eigene Wert ersetzt die Standardliste vollständig. Deshalb sind die Standardbereiche im Beispiel mit aufgeführt; nicht benötigte Bereiche können entfernt werden. Enthält der Wert einen /, liest Tomcat ihn als Liste von Netzen in CIDR-Schreibweise. Die ältere Schreibweise als regulärer Ausdruck (z. B. 194\.95\.62\.71|127\.\d{1,3}\.\d{1,3}\.\d{1,3}) funktioniert weiterhin, lässt sich aber nicht mit der CIDR-Schreibweise mischen.
Die application.yml enthält in der Regel bereits weitere Einträge, etwa für den Systemadministrator, die externe URL oder die Datenbankverbindung. Der neue Eintrag server steht dabei als eigener, oberster Schlüssel neben dem bestehenden relution-Block, nicht als dessen Unterpunkt — auch wenn unterhalb von relution ebenfalls ein Abschnitt namens server existiert (dort z. B. mit externalURL). Das folgende Beispiel zeigt die Struktur mit beiden Blöcken; bestehende Einträge bleiben unverändert:
server:
tomcat:
remoteip:
internal-proxies: '<Proxy-IP>/32, 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16, 169.254.0.0/16, 100.64.0.0/10, 127.0.0.0/8, fc00::/7, fe80::/10, ::1/128'
relution:
# bestehende Einträge (system, database ...) unverändert lassen
server:
externalURL: %EXT_HOSTNAME_URL%
Je nach Installationsart enthält die Datei weitere oberste Schlüssel. Auch diese bleiben unverändert.
internal-proxies ist in diesem Fall keine zusätzliche Konfiguration notwendig, da private IPv4-Bereiche standardmäßig als intern akzeptiert werden.X-Forwarded-Proto Header setzen
Zusätzlich muss der Reverse-Proxy den Header X-Forwarded-Proto mit dem Wert https an Relution weiterleiten. Im location /-Block der nginx-Konfiguration muss dazu folgende Zeile gesetzt sein:
proxy_set_header X-Forwarded-Proto $scheme;
Diese Zeile ist im Standard-Template relution-nginx.conf bereits enthalten. Bei einer eigenen bzw. angepassten Reverse-Proxy-Konfiguration, oder wenn sich ein weiterer Proxy davor befindet, ist zu prüfen, ob der Header korrekt gesetzt und nicht durch einen vorgelagerten Proxy überschrieben wird.
Nach dem Anpassen der application.yml bzw. der Reverse-Proxy-Konfiguration muss der Relution-Dienst bzw. Container (und ggf. der Reverse-Proxy) neu gestartet werden, damit die Änderung wirksam wird.
relution.server.jwt-secure-flag-enabled: false in der application.yml ist kein Workaround für diesen Fehler. Er unterdrückt nur die Meldung TLS required: Das Sitzungscookie wird dann ohne Secure-Attribut ausgegeben und vom Browser auch über unverschlüsselte Verbindungen gesendet. Ab Relution 26.5.7 wird bei jedem Start eine Warnung ins Server-Log geschrieben, solange der Eintrag gesetzt ist. Ist er vorhanden, wird er entfernt (Standardwert true) und die Ursache stattdessen wie oben beschrieben über server.tomcat.remoteip.internal-proxies und den Header X-Forwarded-Proto: https behoben.Weitere Hinweise
- Dieses Problem betrifft in erster Linie Installationen, bei denen der Reverse-Proxy nicht auf demselben Host wie Relution läuft.
- Betroffen sind Relution-Installationen ab Version 26.4.0.
- Die Meldung
Zugang nicht gestattetist eine allgemeine Fehlermeldung, die im Portal für verschiedenste, vom Server abgelehnte Anfragen angezeigt wird. Die in diesem Artikel beschriebene Lösung ist nur dann zutreffend, wenn im Server-Log zusätzlich derERROR-EintragTLS requirederscheint. - Siehe auch: Abschnitt Optional zu nginx in Docker (empfohlen) →