Sites und Aliase im Jitterbit App Builder

Übersicht

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

• HTTP-Cookies können auf einen bestimmten Pfad beschränkt werden, zB /App Builder. Der Client-Webbrowser berücksichtigt bei Cookie-Pfaden die Groß- und Kleinschreibung. Der Webserver hingegen nicht.
• Ebenso können externe Authentifizierungsanbieter den Pfad bei der Validierung von Weiterleitungs URLs als Groß-/Kleinschreibung beachten, wie z. B. https://example.com/App Builder/signin-SAML.
• Darüber hinaus erlaubt der Client-Webbrowser dem Anwendungsserver nicht, ein unsicheres Cookie durch ein sicheres Cookie zu überschreiben.

Um diese und andere Probleme zu vermeiden, sollten Administratoren Maßnahmen zur Kanonisierung der URL ergreifen. Dies kann zwar durch Umschreiberegeln des Webservers erreicht werden, App Builder unterstützt die URL -Kanonisierung jedoch über die Funktion „Sites und Aliase“.

Seiten

Eine Site definiert eine kanonische URL. Eine Standardinstallation umfasst eine einzelne Site. Die Site hat keine spezifische URL. Stattdessen wird die URL aus der HTTP-Anfrage abgeleitet.

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

Es kann nur eine Site als Standardsite konfiguriert werden. Die Standardsite wird zur Bestimmung der kanonischen URL verwendet. Siehe „Übereinstimmung“ weiter unten.

Aliase

Eine Site kann keinen oder mehrere Aliase haben. Ein Alias ist eine alternative, nicht kanonische URL, die für den Zugriff auf die App Builder Instanz verwendet werden kann.

Beispielsweise kann die App Builder-Instanz unter der internen Adresse veröffentlicht worden sein https://machinename/App Builderbevor es auf der externen Adresse veröffentlicht wurde https://example.com/App BuilderDie interne Adresse kann als Alias für die externe Adresse konfiguriert werden. Wenn die Option Umleitung aktiviert ist, leitet App Builder Client-Browser automatisch von der internen Adresse zur externen Adresse um.

Konfiguration

Um Sites und Aliase zu verwalten, melden Sie sich zunächst als Administrator bei App Builder an und gehen Sie dann wie folgt vor:

1. Wechseln Sie zur Anwendung App Builder IDE.
2. Klicken Sie im Bereich Verbinden auf die Schaltfläche Mit Ihrem Unternehmen verbinden.
3. Klicken Sie im Menü links auf die Schaltfläche Sicherheitsanbieter.
4. Klicken Sie im Bereich Konfiguration auf die Schaltfläche Sites verwalten.

Sites bestehen aus den folgenden Eigenschaften:

• URL - Vollqualifizierte, kanonische URL. Beispiel: https://example.com/App Builder.
• Standard - Gibt an, ob die Site beim Abgleichen einer HTTP-Anfrage mit einer Site als Standardsite behandelt wird. Siehe Abgleich unten.
• Umleitung - Gibt an, dass App Builder Client-Browser umleiten soll, wenn eine HTTP-Anfrage mit der Site (oder einem ihrer Aliase), aber nicht mit der kanonischen URL übereinstimmt. Siehe „Umleitung“ weiter unten.
• Aliase - Liste alternativer URLs, die mit der Site verknüpft sind. Diese werden verwendet, um eine HTTP-Anfrage einer Site zuzuordnen. Siehe „Zuordnung“ weiter unten.

Um eine Site zur Standardsite zu machen, klicken Sie auf die Schaltfläche Als Standard festlegen. Beachten Sie, dass diese Schaltfläche nur sichtbar ist, wenn die Site nicht bereits die Standardsite ist.

Kanonisierung

Die Kanonisierung erfolgt in zwei Schritten. Zunächst ordnet App Builder die HTTP-Anfrage einer Site zu. Anschließend leitet App Builder den Client-Webbrowser bei Bedarf zur kanonischen URL um.

Passend dazu

Wenn App Builder eine HTTP-Anfrage empfängt, versucht er, die URL einer Site oder einem Alias zuzuordnen. App Builder führt zunächst einen „losen“ Abgleich durch. Ein „loser“ Abgleich berücksichtigt die folgenden Kriterien:

• Host - HTTP- Host. Beispiel: example.com
• Port - HTTP Port. Beispiel: 80, 443
• Pfad - URL -Pfadkomponente. Groß-/Kleinschreibung wird nicht berücksichtigt. Beispiel: /App Builder.

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

Für die Zwecke einer groben Übereinstimmung werden die folgenden URLs als gleichwertig betrachtet:

• http://example.com/vinyl- HTTP-Schema, Pfad in Kleinbuchstaben.
• https://example.com/App Builder - HTTPS-Schema, Pfad in Groß- und Kleinschreibung.

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

• https://example.com/App Builder- https://example.com/App Builder/App Builder2

App Builder wählt die beste Übereinstimmung mit der folgenden Priorität aus:

1. Wenn die URL mit einer Site übereinstimmt, wird die Site ausgewählt.
2. Wenn die URL mit einem Alias übereinstimmt, wird die Site des Alias ausgewählt.
3. Andernfalls wird die Standardsite ausgewählt.

Umleitung

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

• Wenn die Option Umleitung deaktiviert ist, kann die Anfrage fortgesetzt werden.
• Wenn die Option Umleitung aktiviert ist und die Anforderungs-URL nicht mit der Site URL übereinstimmt, bricht App Builder die Anforderung ab und antwortet mit einer HTTP-Umleitung.

In dieser Phase führt App Builder einen strengen Abgleich durch. Ein strenger Abgleich unterscheidet sich vom losen Abgleich wie folgt:

• Beim Pfad wird zwischen Groß- und Kleinschreibung unterschieden.
• Das Schema wird berücksichtigt.

Für die Zwecke einer strikten Übereinstimmung werden die folgenden URLs nicht als gleichwertig betrachtet:

• http://example.com/vinyl- HTTP-Schema, Pfad in Kleinbuchstaben.
• https://example.com/App Builder - HTTPS-Schema, Pfad in Groß- und Kleinschreibung.

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

Reverse-Proxys und Load Balancer

App Builder unterstützt Reverse-Proxys und Load Balancer, die die SSL-Verbindung vor dem Webserver beenden. Diese Umgebungen erfordern zusätzliche Konfiguration. Siehe Reverse-Proxys für weitere Informationen.

Anwendungsfälle

HTTPS erforderlich

Jede Instanz von App Builder MUSS mit HTTPS gesichert werden. Die sichere Verbindung kann am Webserver oder einem Reverse-Proxy beendet werden. Unabhängig davon wird Administratoren dringend empfohlen, nach der Konfiguration für alle Clients eine HTTPS-Verbindung zu verlangen.

Dies kann mit Sites und Aliasen erreicht werden. Stellen Sie die Site URL so ein, dass sie mit der sicheren URL übereinstimmt, z. B. https://example.com/App Builderund aktivieren Sie die Option Weiterleitung.

Lesen Sie die Informationen zu Reverse-Proxys und Load Balancern bei Verwendung von HTTPS.

Rahmung

App Builder verwendet HTTP-Cookies. Webbrowser blockieren Cookies von Drittpartei in der Regel. Dies kann beim Rendern von App Builder in einem HTML-Frame zu Problemen führen.

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

https://registration.example.com/

Und App Builder wird auf einer anderen Domäne veröffentlicht:

https://vinyl.example.net/

Der Webbrowser behandelt alle von App Builder gesetzten Cookies als Drittpartei-Cookies und blockiert sie entsprechend. Um dieses Problem zu umgehen, veröffentlichen Sie App Builder auf einer Subdomäne der Domäne der Framing-Site.

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

Erstellen Sie im App Builder eine Site mit dieser URL. Machen Sie sie nicht zur Standardsite. Aktivieren Sie die Option Umleitung, um HTTPS anzufordern.