HTTPInput-Knoten

Verwenden Sie den HTTPInput-Knoten, um eine HTTP-Nachricht von einem HTTP-Client für die Verarbeitung durch einen Nachrichtenfluss zu empfangen.

Dieses Thema ist in folgende Abschnitte eingeteilt:

Zweck

Bei der Verwendung des HTTPInput-Knotens mit dem HTTPReply- und HTTPRequest-Knoten kann der Broker als Zwischenstation für Web-Services fungieren, und Web-Service-Anforderungen können auf die gleiche Weise umgewandelt und weitergeleitet werden wie andere von WebSphere Nachrichtenbroker unterstützte Nachrichtenformate. Web-Service-Anforderungen können im HTTP-Standardformat (1.0 oder 1.1) oder im HTTP over SSL-Format (HTTPS) empfangen werden. Sie können die Eigenschaft HTTPS verwenden so festlegen, dass Sie die Verarbeitung von HTTP- oder HTTPS-Anfragen auswählen können.

Wenn Ihre Nachrichtenflüsse SOAP-Nachrichten verarbeiten, bevorzugen Sie den SOAP-Knoten gegenüber dem HTTPInput-Knoten, um die erweiterten Funktionen einschließlich WS-Adressierung und WS-Sicherheit zu nutzen.

Wenn Sie den HTTPInputsknoten in einen Nachrichtenfluss einfügen, müssen Sie entweder einen HTTPReplyknoten in demselben Fluss einfügen oder die Nachricht an einen anderen Fluss übergeben, der einen HTTPReplyknoten enthält (beispielsweise über einen MQOutputknoten an einen zweiten Fluss, der mit einem MQInputsknoten beginnt). Im zweiten Fall (der Anforderung von und Antwort an) werden die Clients von der Anforderungs-ID koordiniert, die in der lokalen Umgebung gespeichert ist.

Der HTTPInputsknoten bearbeitet Nachrichten in den folgenden Nachrichtendomänen:

  • MRM
  • XMLNSC
  • XMLNS
  • JMSMap
  • JMSStream
  • MIME
  • BLOB
  • IDOC (diese Domäne ist veraltet; verwenden Sie MRM)
  • XML (diese Domäne ist veraltet; verwenden Sie XMLNSC)

Wenn der HTTPInput-Knoten eine Nachricht von einem Web-Service-Client erhält, startet er die entsprechenden Parser, um die Header und den Hauptteil der Nachricht zu interpretieren und die Nachrichtenbaumstruktur zu erzeugen, die intern vom Nachrichtenfluss verwendet wird. Der Knoten erstellt eine eindeutige Kennung für die Eingabenachricht und speichert diese unter LocalEnvironment.Destination.HTTP.RequestIdentifer als binären Bereich mit 24 Bytes in der Baumstruktur 'LocalEnvironment'. Dieser Wert wird vom HTTPReplyknoten verwendet und darf auf keine Weise geändert werden.

HTTP-Nachrichten sind niemals permanent und haben keine bestimmte Reihenfolge.

HTTP-Nachrichten sind nicht transaktionsorientiert. Wenn der Nachrichtenfluss jedoch mit einer Datenbank oder einer anderen externen Ressource, z. B. einer WebSphere MQ-Warteschlange, interagiert, werden diese Interaktionen in einer Transaktion ausgeführt. Der HTTPInputsknoten bietet eine COMMIT-Operation (Festschreiben) oder ROLLBACK-Operation (Zurücksetzen) an. Dies ist abhängig davon, wie der Nachrichtenfluss beendet wurde, und wie er für die Fehlerbehandlung konfiguriert ist (z. B. wie die Fehlerterminals verbunden sind). Wenn der Nachrichtenfluss von diesem Knoten zurückgesetzt wird, wird eine Fehlernachricht generiert und an den Client ausgegeben. Das Format des Fehlers wird in der Eigenschaft Falsches Format definiert.

Falls in diesem Nachrichtenfluss eine Ausnahmebedingung eintritt und diese nicht abgefangen, sondern an diesen Knoten zurückgegeben wird, erstellt der Knoten eine Fehlerantwort an den Client. Dieser Fehler wird von der Ausnahmebedingung abgeleitet, und das Format des Fehlers wird durch die Eigenschaft Falsches Format definiert.

Wenn Sie einen Sendeknoten in einen Nachrichtenfluss einschließen, der mit einem HTTPInputsknoten beginnt, können Sie einen beliebigen unterstützten Sendeknoten (einschließlich benutzerdefinierter Sendeknoten) verwenden. Sie können einen Nachrichtenfluss erstellen, der Nachrichten von Web-Service-Clients empfängt und Nachrichten für Clients generiert, die alle unterstützten Transportmethoden zur Verbindung mit dem Broker verwenden. Sie können den Nachrichtenfluss so konfigurieren, dass der Broker auf Anforderung alle erforderlichen Konvertierungen bereitstellt.

Wenn Sie einen Nachrichtenfluss erstellen, der als untergeordneter Nachrichtenfluss eingesetzt werden soll, können Sie keinen Standardempfangsknoten verwenden. Sie müssen eine Instanz des Inputsknotens als ersten Knoten verwenden, um ein Eingangsterminal für den untergeordneten Nachrichtenfluss zu erstellen.

Empfängt Ihr Nachrichtenfluss keine Web-Service-Anforderungen, können Sie einen der anderen Empfangsknoten verwenden.

Der HTTPInput-Knoten befindet sich im HTTP-Fach der Palette und wird in Workbench durch folgendes Symbol dargestellt:

Symbol für HTTPEmpfangsknoten

HTTPInput- und HTTPReply-Knoten als Web-Server verwenden

Ein Broker kann mehrere HTTPInputsknoten unterstützen. Im HTTPInputsknoten müssen die Anforderungen, für die er empfangsbereit sein soll, festgelegt werden. Wenn der Broker für die Adresse http://localhost:7080 empfangsbereit ist, entfernt das HTTP-Empfangsprogramm aus der Anforderung http://localhost:7080/Joe/Mary die HTTP-Adresse und lässt nur die Anforderung selbst (Joe/Mary) übrig. Anschließend gleicht das Empfangsprogramm die Anforderung mit den Informationen im URL-Selektor des HTTPInputsknotens ab. Dieser Abgleich beginnt mit den spezifischsten Daten und endet mit den generischsten Daten. Beispiel: Wenn die folgenden Werte in HTTPInputsknoten festgelegt wurden:
/Joe /Joe/Mary /Joe/* /*
wird bei diesem Format die Nachricht empfangen, wenn keiner der anderen Knoten mit dieser Anforderung übereinstimmt. Mit der Anforderung http://localhost:777/Joe/Mary stimmt also Joe/* überein. Wenn die Anforderung mit keinem URL-Selektor übereinstimmt und kein Empfangsknoten mit /* festgelegt wurde, wird vom HTTPInputsknoten eine Antwort an den Sender geschickt. Beispiel:
<html>  
<head>
	<title>WebSphere MQ Integrator error report
	</title>
</head>
	<body>
		<h1>HTTP Status 404 - Resource Not Found</h1>
		URI /soap does not map to any message flow in broker VCP1BRK
		<p>
	<h3>WebSphere MQ Integrator 500</h3>
	</body>
</html>

Sie können eine URL der Form /* verwenden, um alle Anforderungen abzufangen, die nicht mit den URLs in den HTTPInputsknoten übereinstimmen. Dies ermöglicht Ihnen, eine Antwort zu senden und andere geeignete Maßnahmen zu ergreifen.

Der Broker muss zur Verwendung eines Ports konfiguriert werden (der Standardport lautet 7080). Das HTTP-Empfangsprogramm wird in der Verwaltungstask gestartet und ist an diesem Port empfangsbereit. Bei Eingang einer Anforderung sendet der Listener diese über eine WebSphere MQ-Nachricht an den HTTPInput-Knoten.

Mit dem Befehl mqsichangetrace können Sie Traceinformationen für das HTTP-Empfangsprogramm sammeln.

Verwenden Sie zur Verarbeitung des Protokolls den Befehl mqsireadlog mit httplistener als Wert für qualifier.

Diesen Knoten in einem Nachrichtenfluss verwenden

Sie können den HTTPInput-Knoten in jedem Nachrichtenfluss verwenden, der HTTP- oder HTTPS-Nachrichten annimmt. Das häufigste Beispiel ist ein Nachrichtenfluss, durch den ein Web-Service implementiert wird. Der Abschnitt Web-Service-Anwendungen enthält weitere Informationen hierzu.

Der HTTPInputsknoten unterstützt HTTP POST und HTTP GET. Weitere Informationen zum Aktivieren von HTTP GET finden Sie unter HTTPRequest-Knoten.

Den HTTPInputsknoten konfigurieren

Nachdem Sie eine Instanz des HTTPInputknotens in einen Nachrichtenfluss eingereiht haben, können Sie den Knoten konfigurieren; siehe Nachrichtenflussknoten konfigurieren. Die Knoteneigenschaften werden in der Eigenschaftenansicht angezeigt.

Alle obligatorischen Eigenschaften, für die Sie einen Wert eingeben müssen (d. h. Eigenschaften ohne definierten Standardwert), sind mit einem Sternchen gekennzeichnet.

  1. Optional: Geben Sie auf der Registerkarte Beschreibung eine Kurzbeschreibung, eine ausführliche Beschreibung oder beides ein. Sie können den Knoten dort auch umbenennen.
  2. Auf der Registerkarte Grundeinstellungen:
    1. Geben Sie für Pfadsuffix für URL den Pfadbestandteil der URL ein, von dem dieser Knoten Web-Service-Anforderungen erhält. Geben Sie nicht die vollständige URL ein. Geben Sie beispielsweise nur /path/to/service an, wobei die vollständige URL http://server/path/to/service lautet.
    2. Wenn der Knoten sicheres HTTP akzeptieren soll, aktivieren Sie HTTPS verwenden.
  3. Legen Sie auf der Registerkarte Syntaxanalyse der Eingabenachricht Werte für die Eigenschaften zur Beschreibung der Nachrichtendomäne, der Nachrichtengruppe, des Nachrichtentyps und des Nachrichtenformats fest, auf deren Basis der Knoten die Vorgehensweise bei der Syntaxanalyse der eingehenden Nachricht bestimmt:
    1. Wählen Sie aus der Liste unter Nachrichtendomäne den Namen des von Ihnen verwendeten Parsers aus. Wenn das Feld leer ist, ist der Standardwert BLOB. Sie können eine der folgenden Optionen auswählen:
      • MRM
      • XMLNSC
      • XMLNS
      • JMSMap
      • JMSStream
      • MIME
      • BLOB
      • IDOC (diese Domäne ist veraltet; verwenden Sie MRM)
      • XML (diese Domäne ist veraltet; verwenden Sie XMLNSC)
    2. Wenn Sie den MRM- oder IDOC-Parser oder den XMLNSC-Parser im Prüfungsmodus verwenden, wählen Sie die Nachrichtengruppe aus, die verwendet werden soll. Diese Liste wird mit verfügbaren Nachrichtengruppen gefüllt, wenn Sie MRM, XMLNSC oder IDOC als Domäne auswählen.
    3. Wenn Sie den MRM-Parser verwenden, wählen Sie aus der Liste unter Nachrichtentyp den Nachrichtentyp aus. Diese Liste wird mit Nachrichten aufgefüllt, die in der von Ihnen ausgewählten Nachrichtengruppe definiert sind.
    4. Wenn Sie den MRM- oder IDOC-Parser verwenden, wählen Sie aus der Liste unter Nachrichtenformat das gewünschte Format aus. Diese Liste enthält alle physischen Formate, die Sie für diese Nachrichtengruppe definiert haben.
  4. Auf der untergeordneten Registerkarte Parser-Optionen:
    1. Die Option Zeitpunkt für Syntaxanalyse ist standardmäßig auf Bei Bedarf gesetzt, d. h., die Analyse der Nachricht wird verschoben. Der Abschnitt Bedarfsgerechte Syntaxanalyse enthält Informationen zur sofortigen Analyse von Nachrichten.
    2. Wenn Sie den XMLNSC-Parser verwenden, legen Sie die Werte für die Eigenschaften fest, die bestimmen, wie der XMLNSC-Parser vorgeht. Der Abschnitt Nachrichten in der XMLNSC-Domäne bearbeiten enthält weitere Informationen hierzu.
  5. Auf der Registerkarte Fehlerbehandlung:
    1. Geben Sie das Zeitlimitintervall in Sekunden für Maximale Wartezeit für Client an. Diese Eigenschaft gibt die Zeit an, die ein TCP/IP-Empfangsprogramm, das die Eingabenachricht vom Web-Service-Client empfangen hat, auf eine Antwort vom HTTPReplyknoten innerhalb des Nachrichtenflusses wartet. Wenn innerhalb dieser Zeit eine Antwort eingeht, übergibt das Empfangsprogramm die Antwort an den Client. Wenn in dieser Zeit keine Antwort eingeht, sendet das Empfangsprogramm eine SOAP-Fehlernachricht an den Client, in der darauf hingewiesen wird, dass sein Zeitlimit abgelaufen ist.
    2. Setzen Sie das Fehlerformat auf SOAP 1.1, SOAP 1.2 oder HTML.
  6. Legen Sie auf der Registerkarte Auswertung die Auswertungseigenschaften fest, damit der Parser den Hauptteil von Nachrichten anhand der Nachrichtengruppe überprüft. (Wenn eine Nachricht an das Fehlerterminal des Knotens übergeben wird, wird sie nicht ausgewertet.)

    Sie finden weitere Informationen hierzu in den Abschnitten Nachrichten überprüfen und Auswertungseigenschaften.

  7. Optional: Geben Sie auf der Registerkarte Sicherheit die Werte für die Eigenschaften an, die die Extraktion einer Identität aus einer Nachricht steuern, wenn dem Knoten ein Sicherheitsprofil zugeordnet ist.
    • Optional: Wählen Sie eine Option in der Liste Identitätstokentyp aus, um den Identitätstyp in der eingehenden Nachricht anzugeben. Wenn Sie für diese Option den Standardwert angeben, wird die Identität aus den Transport-Headern abgerufen, und der Typ wird auf Benutzername + Kennwort gesetzt.
    • Optional: Geben Sie in Position des Identitätstokens den Standort in der Nachricht an, an dem die Identität angegeben wird. Wenn Sie diese Option leer lassen, wird die Identität aus den Berechtigungs-Transport-Headern abgerufen.
    • Optional: Geben Sie in Position des Identitätstokens den Standort in der Nachricht an, an dem das Kennwort angegeben wird. Diese Option kann nur festgelegt werden, wenn der Identitätstokentyp auf Benutzername + Kennwort gesetzt ist. Wenn Sie diese Option leer lassen, wird das Kennwort aus den Berechtigungs-Transport-Headern abgerufen.
    • Optional: Geben Sie in Identität-issuedBy-Position eine Zeichenfolge oder einen Pfadausdruck an, um zu zeigen, wo (in der Nachricht) Informationen zum Aussteller der Identität zu finden sind. Wenn Sie diese Option leer lassen, wird der Wert aus dem Benutzeragent-Header oder die Zeichenfolge HTTP verwendet.
    • Optional: Wählen Sie Sicherheitsausnahmen als normale Ausnahmebedingungen behandeln aus (wenn Sicherheitsausnahmebedingungen (wie z. B. 'Zugiff verweigert') als normale Ausnahmebedingungen behandelt werden sollen.

    Sie finden weitere Informationen hierzu in den Abschnitten Nachrichtenflusssicherheit und Nachrichtenflusssicherheit einrichten.

Verbindungen zu Terminals herstellen

Der HTTPInput-Knoten leitet jede Nachricht, die er erfolgreich empfängt, an das Ausgangsterminal weiter. Schlägt die Nachrichtenauswertung fehl, wird die Nachricht an das Fehlerterminal weitergeleitet. Sie können Knoten mit diesem Terminal verbinden, um diese Situation zu handhaben. Wenn keine Verbindung zum Fehlerterminal besteht, wird die Nachricht gelöscht, die maximale Wartezeit für den Client läuft ab, und das TCP/IP-Empfangsprogramm meldet dem Client einen Fehler. Es gibt keine anderen Situationen, in denen die Nachricht an das Fehlerterminal weitergeleitet wird.

Wenn die Nachricht von diesem Knoten abgefangen wird, nachdem eine Ausnahmebedingung weiter vorne im Nachrichtenfluss ausgelöst wurde, wird die Nachricht an das Catch-Terminal weitergeleitet. Wenn keine Verbindung zum Catch-Terminal besteht, wird die Nachricht gelöscht, die maximale Wartezeit für den Client läuft ab, und das TCP/IP-Empfangsprogramm meldet dem Client einen Fehler.

Terminals und Eigenschaften

In der folgenden Tabelle werden die Terminals des HTTPInputsknotens beschrieben:

Terminal Beschreibung
Fehlerterminal Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn ein Fehler auftritt.
Ausgabeterminal Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn sie erfolgreich abgerufen wurde.
Catch-Terminal Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn nachgeschaltet eine Ausnahmebedingung ausgegeben und von diesem Knoten abgefangen wurde.

In den folgenden Tabellen werden die Knoteneigenschaften beschrieben. Die Spalte M zeigt an, ob die Eigenschaft obligatorisch ist (markiert mit einem Sternchen, wenn ein Wert eingegeben werden muss, weil kein Standardwert definiert ist). Die Spalte C zeigt an, ob die Eigenschaft konfigurierbar ist (Wert kann geändert werden, wenn der Nachrichtenfluss zur BAR-Datei hinzugefügt wird, um ihn einzusetzen).

In der folgenden Tabelle werden die Beschreibungseigenschaften des HTTPInputsknotens beschrieben.

Eigenschaft M C Standardwert Beschreibung
Knotenname Nein Nein Knotentyp, z. B. HTTPInput Der Name des Knotens.
Kurzbeschreibung Nein Nein   Kurze Beschreibung des Knotens
Ausführliche Beschreibung Nein Nein   Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt

In der folgenden Tabelle werden die grundlegenden Eigenschaften des HTTPInputsknotens beschrieben.

Eigenschaft M C Standardwert Beschreibung
Pfadsuffix für URL Ja Ja   Diese Eigenschaft gibt den Standort an, von dem Web-Service-Anforderungen abgerufen werden. Wenn die gewünschte URL http://<Hostname>[:<Port>]/[<Pfad>] ist, müssen Sie entweder /<Pfad> oder /<Pfadfragment>/* angeben; dabei ist * ein Platzhalterzeichen, das für jedes Zeichen stehen kann.
HTTPS verwenden Nein Ja Gelöscht Diese Eigenschaft gibt an, ob der Knoten sicheres HTTP akzeptiert.

In der folgenden Tabelle werden die Eigenschaften von 'Syntaxanalyse der Eingabenachricht' des HTTPInputsknotens beschrieben.

Eigenschaft M C Standardwert Beschreibung
Nachrichtendomäne Nein Nein BLOB Die Domäne für die Syntaxanalyse der ankommenden Nachricht. Wenn das Feld leer ist, ist der Standardwert BLOB.
Nachrichtengruppe Nein Nein   Der Name oder die ID der Nachrichtengruppe, in der die ankommende Nachricht definiert ist. Alle verfügbaren Nachrichtengruppen stehen in der Liste.
Nachrichtentyp Nein Nein   Der Name der ankommenden Nachricht.
Nachrichtenformat Nein Nein   Der Name des physischen Formats der ankommenden Nachricht.

In der folgenden Tabelle werden die Eigenschaften der Parser-Optionen für den HTTPInput-Knoten beschrieben.

Eigenschaft M C Standardwert Beschreibung
Zeitpunkt für Syntaxanalyse Nein Nein Bei Bedarf Durch diese Eigenschaft wird gesteuert, zu welchem Zeitpunkt eine Eingabenachricht syntaktisch analysiert wird. Gültige Werte sind Bei Bedarf, Sofort und Vollständig.

Eine vollständige Beschreibung dieser Eigenschaft finden Sie unter Bedarfsgerechte Syntaxanalyse.

Baumstruktur unter Verwendung von XML-Schemadatentypen erstellen Nein Nein Gelöscht Durch diese Eigenschaft wird gesteuert, ob der XMLNSC-Parser Syntaxelemente in der Nachrichtenbaumstruktur mit Datentypen erstellt, die vom XML-Schema genommen wurden. Diese Eigenschaft kann nur ausgewählt werden, wenn die Eigenschaft Auswerten in der Registerkarte Auswerten auf Inhalt oder Inhalt und Wert gesetzt wird.
XMLNSC-Kompaktparser für XMLNS-Domäne verwenden Nein Nein Gelöscht Durch diese Eigenschaft wird gesteuert, ob der XMLNSC-Kompaktparser für Nachrichten in der XMLNS-Domäne verwendet wird. Wenn Sie diese Eigenschaft festlegen, werden die Nachrichtendaten unter XMLNSC in Knoten, die mit dem Ausgabeterminal verbunden sind, angezeigt, wenn XMLNS die Nachrichtendomäne des MQRFH2-Eingabeheaders oder der Eigenschaften von 'Syntaxanalyse der Eingabenachricht' ist.
Zugriff auf gemischten Inhalt Nein Nein Gelöscht Durch diese Eigenschaft wird gesteuert, ob der XMLNSC-Parser beim Erkennen von gemischtem Text in einer Eingabenachricht Elemente in der Nachrichtenbaumstruktur erstellt. Wenn Sie das Kontrollkästchen aktivieren, werden Elemente für gemischten Text erstellt. Andernfalls wird gemischter Text ignoriert, und es werden keine Elemente erstellt.
Kommentare beibehalten Nein Nein Gelöscht Durch diese Eigenschaft wird gesteuert, ob der XMLNSC-Parser beim Erkennen von Kommentaren in einer Eingabenachricht Elemente in der Nachrichtenbaumstruktur erstellt. Wenn Sie das Kontrollkästchen aktivieren, werden Elemente für Kommentare erstellt. Andernfalls werden Kommentare ignoriert, und es werden keine Elemente erstellt.
Verarbeitungsanweisung beibehalten Nein Nein Gelöscht Durch diese Eigenschaft wird gesteuert, ob der XMLNSC-Parser beim Erkennen von Verarbeitungsanweisungen in einer Eingabenachricht Elemente in der Nachrichtenbaumstruktur erstellt. Wenn Sie das Kontrollkästchen aktivieren, werden Elemente für Verarbeitungsanweisungen erstellt. Andernfalls werden Verarbeitungsanweisungen ignoriert, und es werden keine Elemente erstellt.
Nicht transparente Elemente Nein Nein   Mit dieser Eigenschaft wird eine Liste mit Elementen in der Eingabenachricht angegeben, die vom XMLNSC-Parser auf nicht transparente Weise analysiert werden sollen.

In der folgenden Tabelle werden die Fehlerhandhabungseigenschaften des HTTPInputsknotens beschrieben:

Eigenschaft M C Standardwert Beschreibung
Maximale Client-Wartezeit(Sekunden) Ja Nein 180 Die Zeit in Sekunden, die das Empfangsprogramm wartet, bevor es eine Fehlernachricht an den Client zurücksendet. Der gültige Bereich liegt zwischen null (unendliche Wartezeit) und (231)-1.
Fehlerformat Nein Ja SOAP 1.1 Das Format von beliebigen HTTP-Fehlern, die an den Client zurückgegeben werden. Gültige Werte sind SOAP 1.1, SOAP 1.2 und HTML.

In der folgenden Tabelle werden die Auswertungseigenschaften des HTTPInputsknotens beschrieben:

Eine umfassende Beschreibung dieser Eigenschaften finden Sie unter Auswertungseigenschaften.

Eigenschaft M C Standardwert Beschreibung
Auswerten Nein Ja None Durch diese Eigenschaft wird gesteuert, ob eine Auswertung stattfindet. Gültige Werte sind Keine, Inhalt und Wert und Inhalt.
Fehlerbehebungsmaßnahme Nein Nein Ausnahme Durch diese Eigenschaft wird gesteuert, was beim Fehlschlagen der Auswertung geschieht. Sie können diese Eigenschaft nur angeben, wenn Sie Auswerten auf Inhalt oder Inhalt und Wert gesetzt haben. Gültige Werte sind Benutzertrace, Lokales Fehlerprotokoll, Ausnahmebedingung und Ausnahmeliste.

In der folgenden Tabelle werden die Eigenschaften für die Sicherheit des HTTPInput-Knotens beschrieben. Weitere Informationen zu diesen Eigenschaften finden Sie unter Identität und Identitätsauszug konfigurieren.

Eigenschaft M C Standardwert Beschreibung
Identitätstokentyp Nein Nein None Diese Eigenschaft gibt den Typ des Identitätstokens an, das in der eingehenden Nachricht vorhanden ist. Gültige Werte sind: Transportstandardwert, Benutzername, Benutzername + Kennwort und X.509-Zertifikat. Wird diese Eigenschaft nicht angegeben, wird die Identität aus den Transport-Headern abgerufen, und der Typ wird auf usernameAndPassword gesetzt.
Identitätstokenstandort Nein Nein None Diese Eigenschaft gibt an, wo in der Nachricht sich die Identität befindet. Der Standort wird als ESQL-Feldreferenz oder XPath angegeben. Wird diese Eigenschaft nicht angegeben, wird die Identität aus den Berechtigungsübertragungs-Headern abgerufen.
Identitätskennwortstandort Nein Nein None Diese Eigenschaft gibt an, wo in der Nachricht sich das Kennwort befindet. Der Standort wird als ESQL-Feldreferenz oder XPath angegeben. Wird sie nicht angegeben, wird das Kennwort aus den Berechtigungsübertragungs-Headern abgerufen. Diese Eigenschaft kann nur festgelegt werden, wenn der Identitätstyp auf usernameAndPassword gesetzt ist.
Identität-issuedBy-Position Nein Nein None Diese Eigenschaft gibt eine Zeichenfolge oder einen Pfadausdruck an und beschreibt den Aussteller der Identität. Der Standort wird als ESQL-Feldreferenz oder XPath angegeben. Dieser ist für die Verwendung in einer Ientitätszuordnungsfunktion. Wird diese Eigenschaft nicht angegeben, ist der Standardwert der Name des Benutzeragenten oder (falls sie nicht angegeben wird) die Zeichenfolge HTTP.
Sicherheitsausnahmen als normale Ausnahmen behandeln Nein Nein False (falsch) Diese Eigenschaft gibt an, ob Sicherheitsausnahmen (wie z. B. 'Zugriff verweigert') als normale Ausnahmebedingungen behandelt werden sollen, und leitet sie zum Fehlerterminal (falls verbunden) weiter. Standardmäßig ist dies inaktiviert; somit wird sichergestellt, dass Sicherheitsausnahmen veranlassen, dass die Nachricht zurückgesetzt wird, selbst wenn das Fehlerterminal angeschlossen ist.
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
ac04565_