Webvorschauserver konfigurieren

Sie können Ihren Webvorschauserver und die Datei proxy-config.xml konfigurieren.

Vorgehensweise

  1. Klicken Sie in der Ansicht "Server" doppelt auf den Webvorschauserver, um den Servereditor zu öffnen. Sie können die Seiten "Übersicht" und "Sicherheit" verwenden, um Ihren Webvorschauserver zu konfigurieren.
  2. Bearbeiten Sie im Abschnitt Allgemeine Informationen auf der Seite Übersicht den Servernamen, den Hostnamen und die Laufzeitumgebung.
  3. Geben Sie im Abschnitt "Einstellungen für Übertragung" die für den Webvorschauserver zu verwendende Standardportnummer an.
    Anmerkung: Wenn die Standardportnummer bereits im Gebrauch ist, weist der Webvorschauserver automatisch eine andere verfügbare Portnummer zu.
  4. Wählen Sie im Abschnitt "Publizierung" eine der folgenden Einstellungen aus:
    Option Bezeichnung
    Nie automatisch publizieren Die Workbench publiziert nie Dateien auf dem Server.
    Bei Ressourcenänderung automatisch publizieren Die Workbench publiziert, wenn Änderungen an einer dem Server zugeordneten Datei gespeichert werden und das vollständige Zeitintervall aus der Einstellung "Publizierungsintervall" abgelaufen ist. Dies ist die Standardeinstellung.
    Nach Buildereignis automatisch publizieren Die Workbench publiziert, wenn Änderungen an einer Datei, für die ein Build erforderlich ist und die dem Server zugeordnet ist, gespeichert werden und das vollständige Zeitintervall aus der Einstellung "Publizierungsintervall" abgelaufen ist.
    Publizierungsintervall (in Sekunden) Die Anzahl von Sekunden, nach deren Verstreichen die Workbench die Dateien auf dem Server publiziert. Wenn Sie jedoch vor Ablauf dieses Zeitintervalls Änderungen an den Dateien vornehmen, wird die Publizierung verzögert, da der Zeitgeber zurückgesetzt wird. Die Workbench führt nur dann eine Publizierungsaktion auf dem Server aus, wenn das vollständige Zeitintervall abgelaufen ist. Wenn Sie das Publizierungsintervall auf 0 Sekunden setzen, wird eine Datei publiziert, sobald an der Datei vorgenommene Änderungen gespeichert werden.
  5. Legen Sie im Abschnitt "Zeitlimits" die Zeitspanne für das Beenden von Anforderungen fest.
  6. Der Abschnitt "Ajax-Proxy" enthält eine Tabelle, in der die Zugriffs-URLs mit den entsprechenden aufgelösten Ziel-URLs aufgeführt sind. Der Abschnitt "Ajax-Proxy" enthält eine Standard-Proxy-Regel für Platzhalter, die in der Spalte Zugriffs-URL (proxy/http/*) aufgelistet sind. Diese können Sie verwenden, um eine URL weiterzuleiten. Sie können beispielsweise die URL http://localhost:8080/proxy/http/google.com im Web-Browser verwenden, um die Google-Webseite zu laden. Diese Anforderung, die über den Proxy zugeordnet wird, liefert dasselbe Ergebnis wie eine direkt in http://www.google.com abgesetzte Anforderung.
    Tipp: Sie können mit der rechten Maustaste auf eine Zeile der Ajax-Proxy-URL-Tabelle klicken und die Zugriffs-URL kopieren, z. B. proxy/us/en, um sie in Ihren JavaScript-Code einzufügen.
  7. Klicken Sie auf den Link Proxy-URLs konfigurieren, um die Datei proxy-config.xml zu bearbeiten.
  8. Fügen Sie im Konfigurationseditor für Ajax-Proxy Proxy-Regeln für die Zuordnung zu fernen Domänen hinzu. Wählen Sie den Knoten Proxy-Regeln aus und klicken Sie auf Hinzufügen.
  9. Wählen Sie im Fenster Element hinzufügen eines der folgenden Elemente aus und bearbeiten Sie dessen Attribute im Editor:
    Option Bezeichnung
    Zuordnung Ordnet einer Ziel-URL eingehende Anforderungen auf der Basis des zugehörigen Kontextpfads zu.

    Geben Sie ein Attribut Kontextpfad und ein optionales Attribut URL an. Sie könnten beispielsweise einen Kontextpfad /ibmproducts für die URL http://www.ibm.com/products angeben.

    Wenn die eingehende Proxy-URL http://mywebsite.com/ibmproducts/us/en ist, leitet der Proxy die Anforderung an http://www.ibm.com/products/us/en weiter. Der Proxy löst Kontextpfadzuordnungen auf, bevor die entsprechende Zugriffsrichtlinie angewendet wird. Für eine schnelle Prototyperstellung werden zwei Standard-Proxy-Zuordnungen (http/* und us/en) bereitgestellt.

    Metadaten Gibt allgemeine Konfigurationseigenschaften des Proxys an, z. B. HTTP-bezogenen Parameter. Der Proxy-Editor stellt einige allgemeine Metadatenoptionen mit Name/Wert-Standardpaaren bereit:
    forward-http-errors
    Standardmäßig leitet der Ajax-Proxy nur HTTP-Statuscodes größer-gleich 200 oder kleiner als 400 weiter. Statuscodes, die außerhalb dieses Bereichs liegen, führen automatisch zum Fehler des Typs "404 File Not Found". Sie können HTTP-Codes größer-gleich 400 mit einer Nachricht weiterleiten, wenn Sie den Parameter "forward-http-errors" auf "true" setzen.
    unsigned_ssl_certificate_support
    Nicht signierte Zertifikate werden oft für geschützte REST-Services verwendet. Wenn die Option "unsigned_ssl_certificate_support" aktiviert ist, akzeptiert der Ajax-Proxy jedes SSL-Zertifikat. Diese Option ist für Tests und das Debugging nützlich. Verwenden Sie diese Option nicht in einer Produktionsumgebung.
    basic-auth-support
    Setzen Sie diese Option auf "true", wenn der Zielservice Basisauthentifizierung verwendet. Der HTTP-Statuscode "401" (Unauthorized) führt zum HTTP-Code "403" (Forbidden), außer das Attribut "basic-auth-support" ist für diese Anforderung aktiviert.
    maxconnectionsperhost
    maxconnectionperhost ist ein globaler Wert, der die maximale Anzahl der Verbindungen angibt, die für eine Host/Port-Kombination aufrechterhalten werden. Der Wert ist standardmäßig auf 2 gesetzt. Erhöhen Sie den Wert, wenn Ihre Anwendung auf mehr als zwei ferne Sites zugreift, um Inhalte abzurufen.
    maxtotalconnections
    Bei maxtotalconnections handelt es sich um die maximale Gesamtanzahl von Verbindungen, die vom Proxy unterstützt werden. Der Standardwert ist 5. Der Wert, den Sie auswählen, muss hoch genug sein, um die Anzahl der simultanen Verbindungen zu unterstützen, die Sie möglicherweise erhalten. Berücksichtigen Sie in der Praxis die Konfiguration des Web-Containers sowie die Anzahl der vom Container unterstützten simultanen Verbindungen.
    socket-timeout
    socket-timeout definiert das Standardsocketzeitlimit in Millisekunden für das Warten auf Daten nach dem Herstellen einer Verbindung. Der Standardzeitlimitwert ist 0. Dieser Wert wird als unbegrenztes Zeitlimit interpretiert.
    retries
    Der Parameter "retries" definiert die Anzahl der Socketwiederholungen, die der Ajax-Proxy ausführt, bevor das Herstellen einer Verbindung aufgegeben wird. Der Standardwert ist 2.
    connection-timeout
    Das Verbindungszeitlimit definiert den Zeitraum vor dem Herstellen einer Verbindung in Millisekunden. Wird kein Wert angegeben, wird der Standardwert "60000" verwendet. Wenn 0 verwendet wird, wird dieser Wert so interpretiert, dass kein Zeitlimit verwendet wird.
    Richtlinie Definiert eine Zugriffsrichtlinie für ein angegebenes URL-Muster.
    1. Aktivieren bzw. inaktivieren Sie im Feld für den Filter für aktive Inhalte die Filterung aktiver Inhalte. Bei der Filterung aktiver Inhalte werden potenziell bösartige aktive Inhalte aus den Anwendungsinhalten entfernt, die in einem Browser angezeigt werden.
    2. Geben Sie das Muster im Attributfeld URL an. Für jede eingehende Anforderung wendet der Proxy die Richtlinie mit der besten URL-Übereinstimmung an. Falls keine übereinstimmende Richtlinie gefunden wird, weist der Proxy die Anforderung zurück. Wenn eine Richtlinie gefunden wird, werden die Unterelemente des Richtlinienelements angewendet, um zu überprüfen, ob die Anforderung akzeptiert werden sollte.
    3. Aktivieren bzw. inaktivieren Sie die Unterstützung für Basisauthentifizierungabfragen.
    Sie können die folgenden Unterelemente der Richtlinie bearbeiten:
    Aktionsmethoden
    Geben Sie mindestens eine unterstützte HTTP-Methode an. Der Ajax-Proxy unterstützt GET-, POST-, PUT-, HEAD- und DELETE-Anforderungen.
    Cookies
    Definieren Sie eine Liste mit Cookienamen, die die Cookies angeben, die der Proxy an die Zieldomäne weiterleiten soll. Zum Weiterleiten von Cookies filtert der Proxy den Wert des Cookie-Headers anhand der definierten Cookienamen.
    HTTP-Header
    Definieren Sie die Liste mit Headernamen, die der Proxy an die Zieldomäne weiterleiten soll. Die Headernamen können Platzhalterzeichen enthalten.
    Mime-Typen
    Geben Sie die Liste der akzeptierten MIME-Typen an. Die MIME-Typen beziehen sich auf die Antwort, die der Proxy vom Zielserver erhält. Wenn mindestens ein MIME-Typ angegeben wird, akzeptiert der Proxy nur Antworten mit einem Antwortheader des Typs "Content-Type", der mit einem der angegebenen MIME-Typen übereinstimmt. Ist kein MIME-Typ angegeben, werden alle Antworten vom Proxy akzeptiert.
    Benutzer
    Geben Sie eine Liste mit Benutzern oder Benutzergruppen an. Wenn Sie beispielsweise AllAuthenticatedUsers angeben, überprüft der Proxy, ob die Anforderung von einem authentifizierten Benutzer gesendet wurde.
  10. Im Abschnitt "Ajax-Proxy-Keystore" werden Informationen für den vom Ajax-Proxy verwendeten Keystore angezeigt, z. B. der Keystore-Pfad und -Typ. Sie können dem Keystore SSL-Zertifikate hinzufügen oder daraus entfernen, um den Ajax-Proxy zum Abrufen von Informationen über URLs zu verwenden, für die der Zielserver nicht vertrauenswürdige SSL-Zertifikate verwendet. Nach dem Import des SSL-Zertifikats einer URL, die auf einen Server mit einem nicht vertrauenswürdigen Zertifikat verweist, können Sie den Ajax-Proxy verwenden, um auf diese URL zuzugreifen, ohne eine Fehlernachricht zu erhalten.
    1. Optional: Wenn das Keystore-Kennwort mit Software eines anderen Anbieters geändert wurde, aktualisieren Sie das Kennwort im Feld Keystore-Kennwort.
    2. Fügen Sie dem im Feld Keystore-Pfad angegebenen Keystore SSL-Serverzertifikate hinzu bzw. entfernen Sie sie aus diesem Keystore.
      1. Klicken Sie auf Keystore-Einträge verwalten. Das Fenster Keystore verwalten wird mit einer Liste der aktuellen Keystore-Einträge, die mit ihren Aliassen angegeben sind, geöffnet.
      2. Wenn Sie einen Keystore-Eintrag entfernen möchten, wählen Sie den Eintrag in der Liste der Keystore-Einträge aus und klicken Sie dann auf Eintrag entfernen.
      3. Wenn Sie einen Keystore-Eintrag hinzufügen möchten, klicken Sie auf Eintrag hinzufügen. Das Fenster Zertifikat importieren wird geöffnet.
      4. Geben Sie im Feld Eintragsalias ein Alias für den neuen Keystore-Eintrag an.
      5. Geben Sie an, ob Sie SSL-Zertifikate aus einem Server oder einem lokalen System importieren möchten.
        Zertifikate aus einem Server in den Keystore importieren
        Geben Sie die URL des Servers ein, aus dem Sie die SSL-Zertifikate importieren möchten.
        Lokales Zertifikat in den Keystore importieren
        Klicken Sie auf Nach Zertifikaten durchsuchen, um das zu importierende SSL-Zertifikat auf Ihrem lokalen System zu suchen.
      6. Klicken Sie auf OK, um die Änderungen zu speichern, und schließen Sie das Fenster Zertifikat importieren. Klicken Sie im Fenster Keystore verwalten auf OK, um alle am Keystore vorgenommenen Änderungen zu speichern.
  11. Konfigurieren Sie auf der Seite Sicherheit die folgenden Einstellungen:
    Abschnitt Beschreibung
    Allgemein Sicherheit für Webanwendungen aktivieren bzw. inaktivieren. Aktuelle im Webvorschauserver implementierte Projekte überprüfen.
    Anmerkung: Sie müssen die Sicherheit für Webanwendungen aktivieren, die im Webvorschauserver implementiert sind. Sie können die Sicherheit in der Datei WebContent/WEB-INF/web.xml konfigurieren, die in dem Webprojekt enthalten ist, das Sie im Server implementieren möchten.
    Benutzer und Gruppen Benutzer und Gruppen verwalten, die im Webvorschauserver registriert sind.
    • Neue Benutzer im Server registrieren.
    • Benutzer vom Server entfernen.
    • Neue Gruppen im Server registrieren.
    • Benutzer registrierten Gruppen hinzufügen bzw. aus registrierten Gruppen entfernen.
    • Gruppen vom Server entfernen.
    Sicherheitsrollen Im Webvorschauserver registrierte Sicherheitsrollen verwalten.
    • Sicherheitsrollen im Server registrieren.
    • Sicherheitsrollen vom Server entfernen.
    • Benutzern Sicherheitsrollen zuordnen.
    • Zuordnung von Sicherheitsrollen zu Benutzern aufheben.
    • Gruppen Sicherheitsrollen zuordnen.
    • Zuordnung von Sicherheitsrollen zu Gruppen aufheben.
  12. Speichern Sie die Änderungen.
Symbol das den Typ des Artikels anzeigt. Taskartikel
Nutzungsbedingungen für Information Center | Feedback

Symbol für Zeitmarke Letzte Aktualisierung: 29.04.2014

Dateiname: tconfigajaxtestserver.html