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:

Login-Fehler “Zugang nicht gestattet” im Relution-Browser-Login

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:

  1. 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/12 und 192.168.0.0/16, außerdem 100.64.0.0/10, 169.254.0.0/16 und 127.0.0.0/8 (localhost) sowie die IPv6-Bereiche fc00::/7, fe80::/10 und ::1.
  2. Der Header X-Forwarded-Proto muss vom Reverse-Proxy mit dem Wert https gesendet 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.

Alternativ zum Eintrag in der 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.

Alternativ kann dem Relution-Server auch eine lokale/private IPv4-Adresse zugewiesen werden, über die die Kommunikation mit dem Reverse-Proxy intern erfolgt. Ohne eigenen Eintrag 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.

Der Eintrag 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 gestattet ist 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 der ERROR-Eintrag TLS required erscheint.
  • Siehe auch: Abschnitt Optional zu nginx in Docker (empfohlen) →

Wie hilfreich war dieser Artikel?