Weitergabe des Benutzerkontexts an externe Anwendungen

Ist bei einer externen Anwendung, einem Werkzeug oder einem Modul Benutzerkennung übergeben aktiviert, ruft WebOffice 10.9 R5 die Adresse über den WebOffice-Server auf und übergibt dabei Login, Gruppen, Rollen und Sitzungskennungen.

Regeln für die Weitergabe

•Der Benutzerkontext wird nur an Adressen übergeben, die im Projekt als externe Anwendung, Werkzeug oder Modul mit Benutzerkennung übergeben konfiguriert sind (gleiches Schema, gleicher Host, gleicher Port, gleicher Pfad oder darunter), sowie an Seiten der eigenen WebOffice-Instanz.

•Antwortet die Anwendung mit einer Weiterleitung, folgt WebOffice 10.9 R5 ihr mit Benutzerkontext nur innerhalb der konfigurierten Adresse bzw. im Verzeichnis der konfigurierten Seite. Weiterleitungen auf andere Adressen erfolgen ohne Benutzerkontext. Weiterleitungen von Seiten der eigenen WebOffice-Instanz führt der Browser aus, ebenfalls ohne Benutzerkontext.

•Verwenden Sie für Anwendungen mit Benutzerkontext eine https-Adresse.

•Konfigurieren Sie Weiterleitungsseiten (z.B. die Beispielseiten unter pub/custom_pages) nicht mit Benutzerkennung übergeben.

Meldungen in der WebOffice-Logdatei (Kategorie CONTROLLER)

Jede Meldung nennt das Projekt und – sofern vom Client übermittelt – die Herkunft (Layer, externe Anwendung, Werkzeug oder Modul). Adressen werden ohne Query ausgegeben.

Meldung (Beginn)

Stufe

Bedeutung

Abhilfe

User context not passed to …

INFO

Die Adresse ist nicht als externe Anwendung oder Modul mit Benutzerkennung übergeben konfiguriert; der Aufruf erfolgt ohne Benutzerkontext.

Adresse im Projekt als externe Anwendung oder Modul mit Benutzerkennung übergeben konfigurieren.

User context (login, groups, session ids) is sent unencrypted via http to …

WARN

Benutzerkontext wird unverschlüsselt übertragen.

https-Adresse verwenden.

Redirect from … to … not followed by the server …

WARN

Eine Seite der eigenen WebOffice-Instanz leitet weiter; der Browser folgt ohne Benutzerkontext.

Meist eine Weiterleitungsseite: das eigentliche Ziel direkt als externe Anwendung konfigurieren.

Redirect from … to … followed by the server without user context …

WARN

Die Anwendung leitet auf eine nicht konfigurierte Adresse weiter; WebOffice 10.9 R5 folgt ohne Benutzerkontext.

Ziel als externe Anwendung oder Modul konfigurieren; Weiterleitungsseiten nicht mit Benutzerkennung übergeben konfigurieren.

Redirect from … to … refused …

WARN

Weiterleitung abgelehnt, der Browser erhält HTTP 502. Gründe: Sitzungskennung in der Zieladresse, POST-Weiterleitung (307/308) an eine nicht konfigurierte Adresse, Wechsel von https auf http, mehr als 5 Weiterleitungen.

Konfiguration der Anwendung prüfen; bei Bedarf Hersteller der Anwendung einbeziehen.

Hinweis im Browser

In den Fällen oben setzt WebOffice 10.9 R5 den Response-Header X-WebOffice-Notice mit einem allgemeinen Text (sichtbar im Netzwerk-Tab der Entwicklertools). Adressen, Projekt und Herkunft stehen nur in der Logdatei.

Reverse Proxy

Läuft WebOffice 10.9 R5 hinter einem Reverse Proxy, der die Adresse umschreibt (siehe Apache Reverse Proxy, Header syn_urlmap), vergleicht WebOffice 10.9 R5 die von außen sichtbare Adresse. Konfigurieren Sie externe Anwendungen, Werkzeuge und Module deshalb mit dem Schema, Host und Port, unter dem sie von außen erreichbar sind, nicht mit einer internen Adresse.

Läuft eine eingebundene Fachanwendung auf einem eigenen Server bzw. einer eigenen Tomcat-Instanz hinter demselben vorgeschalteten Webserver, muss die konfigurierte Adresse ebenfalls dem von außen sichtbaren Schema, Host und Port entsprechen.

 

icon_cross-reference

•Die Prüfung der Weiterleitungs- und Abrufziele (Open Redirects) ist eine eigene, unabhängige Einstellung: siehe Weiterleitung und Abruf externer Inhalte einschränken.

•Weitere Sicherheitseinstellungen der Anwendungskonfiguration: siehe Sicherheitseinstellungen.