Websites und Aliase in Jitterbit App Builder

Übersicht

Bei einer Standardinstallation akzeptiert und beantwortet App Builder HTTP-Anfragen unabhängig von der URL. Das ist praktisch für den Anfang, kann aber später zu Problemen führen. Probleme entstehen durch unterschiedliche Behandlung von URLs.

HTTP-Cookies können auf einen bestimmten Pfad beschränkt werden, z. B. /Vinyl. Der Client-Webbrowser behandelt Cookie-Pfade als Groß-/Kleinschreibung-sensitiv, der Webserver möglicherweise nicht.
Ähnlich können externe Authentifizierungsanbieter den Pfad als Groß-/Kleinschreibung-sensitiv behandeln, wenn sie Redirect-URLs wie https://example.com/Vinyl/signin-SAML validieren.
Außerdem verhindert der Client-Webbrowser, dass der Anwendungsserver ein unsicheres Cookie mit einem sicheren Cookie überschreibt.

Um diese und weitere Probleme zu vermeiden, sollten Administratoren Schritte zur Kanonisierung der URL unternehmen. Obwohl dies durch Rewrite-Regeln des Webservers erreicht werden kann, bietet App Builder Unterstützung für die URL-Kanonisierung durch die Funktion „Websites und Aliase".

Websites

Eine Website definiert eine kanonische URL. Eine Standardinstallation enthält eine einzelne Website. Die Website hat keine spezifische URL. Stattdessen wird die URL aus der HTTP-Anfrage abgeleitet.

Es ist möglich, mehrere Websites und somit mehrere kanonische URLs zu definieren. Dies kann beispielsweise beim Framing einer App Builder-Anwendung nützlich sein. Siehe Framing unten.

Nur eine Website kann als „Standard"-Website konfiguriert werden. Die Standard-Website wird verwendet, um die kanonische URL zu bestimmen. Siehe Matching unten.

Aliase

Eine Website kann null oder mehr Aliase haben. Ein Alias ist eine alternative, nicht-kanonische URL, über die auf die App Builder-Instanz zugegriffen werden kann.

Beispielsweise könnte die App Builder-Instanz zunächst unter der internen Adresse https://machinename/Vinyl veröffentlicht worden sein, bevor sie unter der externen Adresse https://example.com/Vinyl veröffentlicht wurde. Die interne Adresse kann als Alias für die externe Adresse konfiguriert werden. Wenn die Option Weiterleitung aktiviert ist, leitet App Builder Client-Browser automatisch von der internen Adresse zur externen Adresse weiter.

Konfiguration

Um Websites und Aliase zu verwalten, melden Sie sich zunächst als Administrator bei App Builder an:

Wechseln Sie zur Anwendung App Builder IDE.
Klicken Sie im Bereich Connect auf die Schaltfläche Security Providers.
Klicken Sie im Bereich Configuration auf More und wählen Sie Sites.

Websites bestehen aus den folgenden Eigenschaften:

URL - Vollständig qualifizierte, kanonische URL. Beispiel: https://example.com/Vinyl.
Default - Gibt an, ob die Website beim Abgleich einer HTTP-Anfrage mit einer Website als Standard-Website behandelt wird. Siehe Matching unten.
Redirect - Gibt an, dass App Builder Client-Browser weiterleiten soll, wenn eine HTTP-Anfrage mit der Website (oder einem der Aliase der Website) übereinstimmt, aber nicht mit der kanonischen URL übereinstimmt. Siehe Weiterleitung unten.
Aliases - Liste der alternativen URLs, die mit der Website verknüpft sind. Diese werden verwendet, um eine HTTP-Anfrage einer Website zuzuordnen. Siehe Matching unten.

Um eine Website zur „Standard"-Website zu machen, klicken Sie auf die Schaltfläche Make Default. Beachten Sie, dass diese Schaltfläche nur sichtbar ist, wenn die Website nicht bereits die Standard-Website ist.

Kanonisierung

Die Kanonisierung besteht aus zwei Schritten. Zuerst ordnet App Builder die HTTP-Anfrage einer Website zu. Dann leitet App Builder den Client-Webbrowser zur kanonischen URL weiter, falls erforderlich.

Matching

Wenn App Builder eine HTTP-Anfrage empfängt, versucht es, die URL einer Website oder einem Alias zuzuordnen. App Builder beginnt mit einem „lockeren" Abgleich. Ein lockerer Abgleich berücksichtigt die folgenden Kriterien:

Host - HTTP-Hostname. Beispiel: example.com
Port - HTTP-Portnummer. Beispiel: 80, 443
Path - URL-Pfadkomponente. Groß-/Kleinschreibung-insensitiv. Beispiel: /Vinyl.

Beachten Sie, dass App Builder das Schema in dieser Phase nicht berücksichtigt.

Für einen lockeren Abgleich werden die folgenden URLs als gleichwertig betrachtet:

http://example.com/vinyl - HTTP-Schema, Pfad in Kleinbuchstaben.
https://example.com/Vinyl - HTTPS-Schema, gemischte Pfadschreibweise.

Beachten Sie, dass dieser Algorithmus nicht zulässt, dass eine App Builder-Website innerhalb einer anderen existiert. Folgendes wird nicht unterstützt:

https://example.com/Vinyl
https://example.com/Vinyl/Vinyl2

App Builder wählt die beste Übereinstimmung nach folgender Priorität:

Wenn die URL einer Site entspricht, wird die Site ausgewählt.
Wenn die URL einem Alias entspricht, wird die Site des Alias ausgewählt.
Andernfalls wird die Standard-Site ausgewählt.

Redirect

Nachdem die Site ausgewählt wurde, bestimmt App Builder, ob die Anfrage fortgesetzt werden soll oder ob stattdessen eine Umleitung erfolgen soll.

Wenn die Option Redirect deaktiviert ist, wird die Anfrage fortgesetzt.
Wenn die Option Redirect aktiviert ist und die Anfrage-URL nicht mit der Site-URL übereinstimmt, bricht App Builder die Anfrage ab und antwortet mit einer HTTP-Umleitung.

In dieser Phase führt App Builder eine „strikte" Übereinstimmung durch. Eine strikte Übereinstimmung unterscheidet sich von einer lockeren Übereinstimmung dadurch, dass:

Der Pfad als Groß-/Kleinschreibung-sensitiv behandelt wird.
Das Schema berücksichtigt wird.

Für eine strikte Übereinstimmung gelten die folgenden URLs nicht als gleichwertig:

http://example.com/vinyl - HTTP-Schema, Pfad in Kleinbuchstaben.
https://example.com/Vinyl - HTTPS-Schema, Pfad in gemischter Schreibweise.

Wenn die HTTP-Anfrage-URL nicht mit der Site-URL übereinstimmt, antwortet App Builder mit einer Umleitung.

Reverse Proxies und Load Balancer

App Builder unterstützt Reverse Proxies und Load Balancer, die die SSL-Verbindung vor dem Webserver beenden. Diese Umgebungen erfordern zusätzliche Konfiguration. Weitere Informationen finden Sie unter Reverse Proxies.

Anwendungsfälle

HTTPS erforderlich

Jede Instanz von App Builder MUSS mit HTTPS gesichert werden. Die sichere Verbindung kann auf dem Webserver oder einem Reverse Proxy beendet werden. Unabhängig davon werden Administratoren dringend empfohlen, nach der Konfiguration alle Clients zu verpflichten, sich mit HTTPS zu verbinden.

Dies lässt sich durch Sites und Aliases erreichen. Stellen Sie die Site-URL so ein, dass sie der sicheren URL entspricht, z. B. https://example.com/Vinyl, und aktivieren Sie die Option Redirect.

Überprüfen Sie Informationen zu Reverse Proxies und Load Balancern bei Verwendung von HTTPS

Framing

App Builder nutzt HTTP-Cookies. Webbrowser blockieren normalerweise Cookies von Drittanbietern. Dies kann Probleme verursachen, wenn App Builder in einem HTML-Frame dargestellt wird.

Wenn die Framing-Site beispielsweise unter folgender URL veröffentlicht wird:

https://registration.example.com/

Und App Builder wird auf einer anderen Domain veröffentlicht:

https://vinyl.example.net/

Der Webbrowser behandelt alle von App Builder gesetzten Cookies als Cookies von Drittanbietern und blockiert sie entsprechend. Um dieses Problem zu beheben, veröffentlichen Sie App Builder auf einer Subdomain der Domain der Framing-Site.

https://vinyl.registration.example.com/

Erstellen Sie eine Site in App Builder mit dieser URL. Machen Sie sie nicht zur Standard-Site. Aktivieren Sie die Option Redirect, um HTTPS zu erzwingen.