URL-Sicherheitsanbieter im Jitterbit App Builder umschreiben

Die Webclients und Server des App Builders müssen sich über die URL der App Builder-Anwendung einig sein. Dies ist notwendig für die Handhabung von Cookies und clientseitigen Weiterleitungen, wie sie während des Authentifizierungsprozesses stattfinden. Reverse Proxys können die Anforderungs-URL während der Übertragung ändern. Der URL-Umschreibungsanbieter kann verwendet werden, um eine von einem Reverse Proxy umgeschriebene URL wiederherzustellen.

Der URL-Umschreibungsanbieter vergleicht die folgenden Komponenten der Anforderungs-URL:

Schema - HTTP oder HTTPS
Host - example.com
Port - 80, 443

Übereinstimmende URLs werden umgeschrieben. Beachten Sie, dass nur das Schema, der Hostname und die Portkomponenten umgeschrieben werden können: Der Pfad kann nicht umgeschrieben werden. Da Pfade groß- und kleinschreibungsempfindlich sind, können sie nicht zuverlässig wiederhergestellt werden.

Konfiguration

Der URL-Umschreibungsanbieter muss manuell registriert werden. Der URL-Umschreibungsanbieter sollte vor allen anderen Anbietern registriert werden.

Parameter

Parameter	Standardwert	Beschreibung
MatchUrl		Die URL-Spezifikation, gegen die die Anfrage getestet wird. Nur das Schema, der Host und der Port werden berücksichtigt.
RewriteUrl		Die URL, auf die die Anfrage umgeschrieben wird. Nur das Schema, der Host und der Port werden geändert.
DetectReverseProxy	Falsch	Wenn aktiviert, wird der App Builder die Anfrage überprüfen, um festzustellen, ob ein Reverse Proxy die URL möglicherweise geändert hat. Derzeit sucht der App Builder nach dem Vorhandensein des X-Forwarded-For-Headers. Setzen Sie diese Eigenschaft auf Wahr, wenn Benutzer auf die App Builder-Anwendung über die MatchUrl zugreifen können, ohne den Reverse Proxy zu durchlaufen. Dies deutet normalerweise auf eine Split-DNS-Konfiguration hin.

OAuth-Umleitungs-URI hinter einem Reverse-Proxy

Wenn App Builder 4.58 oder früher hinter einem Reverse-Proxy gehostet wird, der HTTPS-Verkehr über Port 443 weiterleitet, kann der OAuth-Sicherheitsanbieter den expliziten Port in der Umleitungs-URI enthalten (zum Beispiel https://example.com:443/Vinyl/signin-OAuth). Dies kann dazu führen, dass OAuth-Anbieter die Umleitungs-URI als ungültig ablehnen.

Um den Port zu entfernen, konfigurieren Sie einen Rewrite URL-Anbieter mit:

MatchUrl: https://example.com:443
RewriteUrl: https://example.com

Dieses Problem ist in App Builder 4.59 behoben, und der Workaround ist in dieser Version oder später nicht mehr erforderlich.

Fehlersuche

Um herauszufinden, warum eine URL möglicherweise nicht umgeschrieben wird, setzen Sie die Protokollierungsebene von App Builder auf Trace. Führen Sie eine HTTP-Anfrage an App Builder aus (normalerweise eine, die durch den Reverse-Proxy geht). Überprüfen Sie dann die Protokolle. Sie sollten Protokolleinträge in folgender Form sehen:

HTTP request URL components: scheme=http, host=example.com, port=80
Rewritten HTTP request URL components: scheme=https, host=example.com, port=443