Im generischen Service-Client enthalten Serviceaufrufe den Inhalt und die Transportinformationen für den Aufruf.
Der Inhalt besteht aus der SOAP-Rahmenanweisung. Die Transportinformationen beziehen sich auf die Informationen, die je nach ausgewähltem Protokoll zum Senden, Empfangen und Beantworten erforderlich sind.
Nachricht
Auf dieser Seite werden die XML-Inhalte der Anforderung dargestellt und kann auf die Datenkorrelation zugegriffen werden. Die gleichen Inhalte werden auf drei verschiedene Arten dargestellt.
- Formular
- Diese Sicht bietet eine vereinfachte Sicht der Nachricht, in der die Werte für den XML-Inhalt bearbeitet werden können.
- Baum
Diese Sicht bietet eine Detailsicht der XML-Struktur, einschließlich Elementen, Namensbereichen und zugeordneten Werten. Mithilfe von Hinzufügen, Einfügen, Entfernen, Nach oben und Nach unten können Sie die XML-Elemente und Namensbereiche im Baum bearbeiten.
Klicken Sie auf Filter, um Namensbereichs-, Attribut- oder Textknoten je nach Ihren Anforderungen aus- oder einzublenden.
Klicken Sie auf Nur gültige Änderungen zulassen, um das intelligente Bearbeiten auf Basis eines XML-Schemadokuments (XSD) zu aktivieren. Klicken Sie mit der rechten Maustaste auf das Projekt und wählen Sie Eigenschaften und Schemakatalog aus, um verschiedene XSD-Dokumente für die Workbench anzugeben. Inaktivieren Sie Nur gültige Änderungen zulassen, wenn Sie über kein XSD-Dokument verfügen oder wenn Sie das Schema umgehen möchten.
Sie können mit der rechten Maustaste
auf ein XML-Element klicken, um es in ein XML-Fragment zu konvertieren. Auf diese Weise können Sie eine Datenkorrelation (Datenpools verwenden und Referenzen erstellen) für das gesamte XML-Fragment anstatt nur für den Wert ausführen.
- Quelle
- In dieser Sicht wird der XML-Quelleninhalt der Nachricht oder einfacher Textinhalt angezeigt.
Wichtig: In der Sicht "Quelle" dürfen die mit SoaTag beginnenden Tags nicht bearbeitet werden. Ein Löschen oder Ändern dieser Tags führt zu einer Beschädigung von Verweisen und Ersetzungen im Test. Diese Tags können nach dem Löschen nicht erneut erstellt werden.
Anhänge
Auf dieser Seite werden die MIME-Anhänge aufgelistet, die der Anforderung zugeordnet sind. Die Inhalte dieser Sicht entsprechen der MIME-Spezifikation (Multipurpose Internet Mail Extensions). Mithilfe dieser Seite können Workbench-Ressourcen als MIME-Anhänge hinzugefügt und Eigenschaften geändert werden.
Anmerkung: Wenn Sie Web-Service-Anhänge verwenden möchten, müssen Sie eine Reihe von Java™-Bibliotheken zu der Java Runtime Environment (JRE) hinzufügen, die von der Workbench verwendet wird. Weitere Informationen finden Sie in
Umgebung zur Handhabung von Dateianhängen konfigurieren.
Die
Inhalts-ID ist die Kennung, die von der Anforderung für den Verweis auf die Anhänge verwendet wird. Das Verfahren zur Verwendung dieser Kennung hängt von Ihren Servervoraussetzungen ab.
- MTOM-Übertragungsmechanismus verwenden
- Von der Anforderung wird standardmäßig SwA (SOAP Messages with Attachments) zur Handhabung von Anhängen verwendet. Wählen Sie diese Option aus, wenn Anhänge mithilfe des SOAP-Übertragungsmechanismus MTOM (Message Transmission Optimization Mechanism) gehandhabt werden sollen.
Transport
Auf dieser Seite werden die Transporteinstellungen konfiguriert, die zum Senden der Anforderung verwendet werden. Die Transportprotokolleinstellungen beziehen sich auf eine Transportkonfiguration, bei der es sich um
ein HTTP-, JMS- (Java Message Service) oder WebSphere MQ-Protokoll handeln kann. Sie können mehrere Konfigurationen für jedes Protokoll erstellen und auf diese Weise ohne großen Aufwand zwischen Protokollen oder Protokollvarianten wechseln.
- HTTP
- Wählen Sie HTTP aus, um den HTTP-Transport für die Anforderung zu verwenden. Auf der Anforderungsebene können Sie eine URL- oder SOAP-Aktion sowie den Verweis auf die globale Konfiguration eines Tests aktualisieren.
- Protokollkonfiguration
- Klicken Sie auf Ändern, um eine vordefinierte Transportkonfiguration anzugeben oder eine Konfiguration zu erstellen. HTTP- Transportkonfigurationen enthalten wiederverwendbare Proxy- und Authentifizierungseinstellungen.
- Methode und Version
- Hier geben Sie die HTTP-Methode und -version an, die zum Aufrufen der Serviceanforderung verwendet werden sollen.
- URL
- Hier geben Sie den URL-Endpunkt der Serviceanforderung an.
- Header
- Hier geben Sie die Namen und Werte der angepassten HTTP-Header an, die vom Service benötigt werden. Klicken Sie auf Hinzufügen, Bearbeiten oder Entfernen, um die
Headerliste zu ändern.
- Cookies
- Hier geben Sie die Namen und Werte der Cookies an, die vom Service benötigt werden. Klicken Sie auf Hinzufügen, Bearbeiten oder Entfernen, um die
Cookieliste zu ändern.
- JMS
Wählen Sie JMS aus, um den JMS-Transport (Java Messaging
Service) für die Anforderung zu verwenden. Über diese Seite können Sie Zeichenfolgeneigenschaften hinzufügen, die der Anforderung für eine JMS-Konfiguration zugeordnet sind. Diese werden über JMS als Nachrichteneigenschaften gesendet.
- Protokollkonfiguration
- Klicken Sie auf Ändern, um eine vordefinierte Transportkonfiguration anzugeben oder eine Konfiguration zu erstellen. JMS-Transportkonfigurationen enthalten Einstellungen für den generischen Endpunkt, den Empfangspunkt und Adapter, die wiederverwendet werden können.
- Eigenschaften
- Hier geben Sie die Namen und Werte aller Zeichenfolgeeigenschaften an, die für die Anforderung für die aktuelle JMS-Transportkonfiguration erforderlich sind. Diese Eigenschaften werden über JMS als Nachrichteneigenschaften gesendet. Klicken Sie auf Hinzufügen, Bearbeiten oder Entfernen, um die Liste der Eigenschaften zu ändern.
- WebSphere MQ
- Wählen Sie MQ aus, wenn für die Anforderung der IBM® WebSphere MQ-Transport verwendet werden soll. Über diese Seite können Sie die SOAP-Aktion angeben und die Einstellungen für die WebSphere MQ-Konfiguration auf der Teststufe außer Kraft setzen.
- Protokollkonfiguration
- Klicken Sie auf Ändern, um eine vordefinierte Transportkonfiguration anzugeben oder eine Konfiguration zu erstellen.
MQ-Transportkonfigurationen enthalten Einstellungen für die generische Warteschlange, den Header und SSL, die wiederverwendet werden können.
- SOAP-Aktion
- Gibt die SOAP-Aktion an, die zum Aufrufen der MQ-Anforderung verwendet werden soll.
- Werte der MQ-Protokollkonfiguration überschreiben
- Wählen Sie diese Option aus, um die Felder der MQ-Nachricht zu konfigurieren. Sie können eine Untergruppe eines MQ-Nachrichtendeskriptors für die Verwendung mit anderen Servertypen durch ein benutzerdefiniertes Format ersetzen, insbesondere bei Verwendung einer XML-Aktivierungsanforderung. Weitere Informationen zu Nachrichtendeskriptoren finden Sie in der WebSphere MQ-Dokumentation.
Diese Einstellungen ersetzen den Nachrichtendeskriptor und die Headereinstellungen in der MQ-Protokollkonfiguration.
- Angepassten Header verwenden
- Wählen Sie diese Option aus, um angepasste Header für das in WebSphere MQ enthaltene Feature "Transport für SOAP über MQ" anzugeben. Diese Funktion verwendet ein vorgegebenes MQ-Nachrichtenformat (RFH2), daher sind bei Auswahl dieser Funktion andere Optionen von Nachrichtendeskriptor inaktiviert.
Sicherheit für Anforderung
Auf dieser Seite können Sie die Sicherheitsalgorithmusstacks bearbeiten, die vom Sicherheitsprotokoll auf Serviceanforderungen angewendet werden, bevor diese gesendet werden. Sicherheitsstacks bestehen aus einer Reihe von Algorithmen, die in einer vorgegebenen Reihenfolge ausgeführt werden.
- Einstellungen des WSDL Security Editor überschreiben
- Standardmäßig bearbeiten Sie den einer bestimmten WSDL-Datei zugeordneten Sicherheitsalgorithmusstapel im WSDL Security Editor. Wählen Sie diese Option aus, um einen anderen Sicherheitsalgorithmusstapel nur für die aktuelle Serviceanforderung festzulegen.
- Details zu Sicherheitsalgorithmen
- Klicken Sie auf Hinzufügen, Einfügen oder Entfernen, um Sicherheitsalgorithmen zum Stack hinzuzufügen oder aus diesen zu entfernen. Klicken Sie auf Nach oben und Nach unten, um die Reihenfolge der ausgewählten Algorithmen im Sicherheitsstack zu ändern. Die folgenden Sicherheitsalgorithmen können zum Sicherheitsstack hinzugefügt werden:
- Zeitmarke
- Der Sicherheitsalgorithmus "Zeitmarke" fügt dem XML-Dokument in der Antwort Zeitmarkeninformationen hinzu. Weitere Informationen zu Sicherheitsalgorithmen finden Sie in der Spezifikation zur Web-Service-Sicherheit.
- Actor-/Rollenname
- Geben Sie bei Bedarf den Namen des Actors an.
- Verständnis muss vorliegen
- Wählen Sie aus, ob der Sicherheitsalgorithmus verstanden werden muss.
- Zeitmarke
- Geben Sie die Verzögerung vor dem Hinzufügen der Zeitmarke an.
- Benutzernamenstoken
- Mit dem Sicherheitsalgorithmus "Benutzernamenstoken" wird dem XML-Dokument in der Antwort ein Benutzernamenstoken hinzugefügt. Weitere Informationen zu Sicherheitsalgorithmen finden Sie in der Spezifikation zur Web-Service-Sicherheit.
- Actor-/Rollenname
- Geben Sie bei Bedarf den Namen des Actors an.
- Verständnis muss vorliegen
- Wählen Sie aus, ob der Sicherheitsalgorithmus verstanden werden muss.
- Name
- Geben Sie den Namen des Benutzers ein.
- Kennwort
- Geben Sie das Kennwort des Benutzers ein.
- Kennworttyp
- Geben Sie den Kennworttyp für den Sicherheitsalgorithmus an.
- XML-Verschlüsselung
- Der Sicherheitsalgorithmus "XML-Verschlüsselung" gibt an, wie das XML-Dokument verschlüsselt wird. Weitere Informationen zu Sicherheitsalgorithmen finden Sie in der Spezifikation zur Web-Service-Sicherheit.
- Actor-/Rollenname
- Geben Sie bei Bedarf den Namen des Actors an.
- Verständnis muss vorliegen
- Wählen Sie aus, ob der Sicherheitsalgorithmus verstanden werden muss.
- Kennungstyp
- Wählen Sie den Typ der gewünschten Schlüsselkennung für die Verschlüsselung aus:
- ISSUER_SERIAL
- BST_DIRECT_REFERENCE
- X509_KEY_IDENTIFIER
- SKI_KEY_IDENTIFIER
- EMBEDDED_KEYNAME
- THUMBPRINT_IDENTIFIER
- Benutzerauswahl des XPath-Teils
- Mithilfe dieser Option können Sie eine XPath-Abfrage angeben, die Teile des XML-Dokuments beschreibt, die Thema des Algorithmus sein können. Standardmäßig ist der Hauptteil das Thema.
- Schlüssel
- Wählen Sie den für die Verschlüsselung verwendeten Schlüssel aus. Die Details der jeweiligen Schlüssel können sich ändern.
- X509-Schlüssel: Gibt den Namen und das Kennwort des X509-Schlüssels sowie den Keystore an, in dem sich dieser befindet.
- Unaufbereiteter Schlüssel: Gibt den Namen und den Bytewert des Schlüssels in hexadezimaler Form an.
- Schlüssel für Benutzernamenstoken: Gibt einen Benutzernamen und ein Kennwort für den Token an.
- Verschlüsselter Schlüssel: Gibt einen verschlüsselten Schlüssel an, der zuvor im Sicherheitsstack definiert wurde. Klicken Sie auf Neuen verschlüsselten Schlüssel einfügen, wenn Sie einen neuen Block für die Definition eines verschlüsselten Schlüssels erstellen möchten.
- Verschlüsselungsalgorithmus für Schlüssel
- Geben Sie den Standardalgorithmus für ein Verschlüsseln des Transportschlüssels an.
- XML-Signatur
- Der Sicherheitsalgorithmus "XML-Signatur" gibt an, wie das XML-Dokument signiert wird. Weitere Informationen zu Sicherheitsalgorithmen finden Sie in der Spezifikation zur Web-Service-Sicherheit.
- Actor-/Rollenname
- Geben Sie bei Bedarf den Namen des Actors an.
- Verständnis muss vorliegen
- Wählen Sie aus, ob der Sicherheitsalgorithmus verstanden werden muss.
- Kennungstyp
- Wählen Sie den Typ der gewünschten Schlüsselkennung für die Verschlüsselung aus:
- ISSUER_SERIAL
- BST_DIRECT_REFERENCE
- X509_KEY_IDENTIFIER
- SKI_KEY_IDENTIFIER
- EMBEDDED_KEYNAME
- KEY_VALUE
- USER_NAME_TOKEN
- CUSTOM_SYMM_SIGNATURE
- Benutzerauswahl des XPath-Teils
- Geben Sie eine XPath-Abfrage an, die Teile des XML-Dokuments beschreibt, die Thema des Algorithmus sein können. Standardmäßig ist der Hauptteil das Thema.
- Schlüssel
- Wählen Sie den für die Verschlüsselung verwendeten Schlüssel aus. Die Details der jeweiligen Schlüssel können sich ändern.
- X509-Schlüssel: Gibt den Namen und das Kennwort des X509-Schlüssels sowie den Keystore an, in dem sich dieser befindet.
- Unaufbereiteter Schlüssel: Gibt den Namen und den Bytewert des Schlüssels in hexadezimaler Form an.
- Schlüssel für Benutzernamenstoken: Gibt einen Benutzernamen und ein Kennwort für den Token an.
- Verschlüsselter Schlüssel: Gibt einen verschlüsselten Schlüssel an, der zuvor im Sicherheitsstack definiert wurde. Klicken Sie auf Neuen verschlüsselten Schlüssel einfügen, wenn Sie einen neuen Block für die Definition eines verschlüsselten Schlüssels erstellen möchten.
- Name des Signaturalgorithmus
- Geben Sie den Standardalgorithmus an, der für die Signatur verwendet werden soll.
- Kanonisierung
- Geben Sie den gewünschten Algorithmus für Kanonisierung an.
- Verschlüsselter Schlüssel
- In diesem Block wird ein verschlüsselter Schlüssel definiert, der in einem XML-Signatur- oder XML-Verschlüsselungsblock verwendet werden kann. Der Block mit dem verschlüsselten Schlüssel muss sich vor einem Block befinden, in dem der verschlüsselte Schlüssel verwendet wird.
- Actor-/Rollenname
- Geben Sie bei Bedarf den Namen des Actors an.
- Verständnis muss vorliegen
- Wählen Sie aus, ob der Sicherheitsalgorithmus verstanden werden muss.
- Schlüsselname
- Geben Sie den Namen des verschlüsselten Schlüssels ein.
- Kennungstyp
- Wählen Sie den Typ der gewünschten Schlüsselkennung für die Verschlüsselung aus:
- ISSUER_SERIAL
- BST_DIRECT_REFERENCE
- X509_KEY_IDENTIFIER
- EMBEDDED_KEYNAME
- THUMBPRINT_IDENTIFIER
- SKI_KEY_IDENTIFIER
- Schlüsselgröße
- Geben Sie die Größe des Schlüssels in Bit an.
- Verschlüsselungsalgorithmus für Schlüssel
- Geben Sie den Algorithmus an, der zum Verschlüsseln des Schlüssels verwendet werden soll.
- Keystore
- Wählen Sie einen Keystore (Schlüsselspeicher) aus oder klicken Sie auf Sicherheitskeystore bearbeiten, wenn Sie einen neuen Keystore definieren oder die vorhandenen Keystores verwalten möchten.
- Name
- Wählen Sie einen Schlüssel aus, der im angegebenen Keystore enthalten ist.
- Kennwort
- Geben Sie das Kennwort für den ausgewählten Schlüsselnamen ein.
- Angepasster Sicherheitsalgorithmus
- Wenn Sie eine Java-Klasse als angepassten Sicherheitsalgorithmus implementiert haben, können Sie den angepassten Algorithmus mithilfe dieses Stapelelements auf den Service anwenden.
- Name
- Geben Sie den Namen des angepassten Sicherheitsalgorithmus an.
- Implementierungsklasse
- Geben Sie den Namen der Klasse an, mit der der angepasste Sicherheitsalgorithmus implementiert wird. Klicken Sie auf Durchsuchen, um eine Java-Klasse aus dem Arbeitsbereich auszuwählen.
- Eigenschaften
- Über diese Tabelle können Sie bestimmte Eigenschaften und die zugeordneten Werte an den angepassten Sicherheitsalgorithmus senden.
- WS-Addressing
- Fügen Sie diesen Stapel hinzu, wenn Ihr Service den Standard "WS-Addressing 2004/08" oder "WS-Addressing 1.0 Core" verwendet.
- Namensbereich
- Geben Sie den Namensbereich für "WS-Addressing 2004/08" oder "WS-Addressing 1.0 Core" an.
- Aktion, wenn Anforderung WS-Adressierung verwendet
- Wählen Sie die Aktion aus, die ausgeführt werden soll, wenn sich WS-Addressing (WS-Adressierung) bereits in der Anforderung befindet.
- Anonyme Adresse in ReplyTo ersetzen durch
- Wählen Sie diese Option aus, wenn im Reply-to-Header anstelle einer anonymen Adresse die angegebene Adresse generiert werden soll.
- WS-Adressierung aus Antwort entfernen
- Wählen Sie diese Option aus, um alle WS-Adressierungs-Header aus der Antwort zu entfernen.
Sicherheit für Antwort
Auf dieser Seite können Sie die Sicherheitsalgorithmusstacks bearbeiten, die vom Sicherheitsprotokoll auf Antworten angewendet werden, nachdem diese empfangen wurden. Sicherheitsstacks bestehen aus einer Reihe von Algorithmen, die in einer vorgegebenen Reihenfolge ausgeführt werden.
- Einstellungen des WSDL Security Editor überschreiben
- Standardmäßig bearbeiten Sie den einer bestimmten WSDL-Datei zugeordneten Sicherheitsalgorithmusstapel im WSDL Security Editor. Wählen Sie diese Option aus, um einen anderen Sicherheitsalgorithmusstapel nur für die aktuelle Antwort festzulegen.
- Details zu Sicherheitsalgorithmen
- Klicken Sie auf Hinzufügen, Einfügen oder Entfernen, um Sicherheitsalgorithmen zum Stack hinzuzufügen oder aus diesen zu entfernen. Klicken Sie auf Nach oben und Nach unten, um die Reihenfolge der ausgewählten Algorithmen im Sicherheitsstack zu ändern. Die folgenden Sicherheitsalgorithmen können zum Sicherheitsstack hinzugefügt werden:
- XML-Verschlüsselung
- Der Sicherheitsalgorithmus "XML-Verschlüsselung" gibt an, wie das XML-Dokument verschlüsselt wird. Weitere Informationen zu Sicherheitsalgorithmen finden Sie in der Spezifikation zur Web-Service-Sicherheit.
- Actor-/Rollenname
- Geben Sie bei Bedarf den Namen des Actors an.
- Verständnis muss vorliegen
- Wählen Sie aus, ob der Sicherheitsalgorithmus verstanden werden muss.
- Kennungstyp
- Wählen Sie den Typ der gewünschten Schlüsselkennung für die Verschlüsselung aus:
- ISSUER_SERIAL
- BST_DIRECT_REFERENCE
- X509_KEY_IDENTIFIER
- SKI_KEY_IDENTIFIER
- EMBEDDED_KEYNAME
- THUMBPRINT_IDENTIFIER
- Benutzerauswahl des XPath-Teils
- Mithilfe dieser Option können Sie eine XPath-Abfrage angeben, die Teile des XML-Dokuments beschreibt, die Thema des Algorithmus sein können. Standardmäßig ist der Hauptteil das Thema.
- Schlüssel
- Wählen Sie den für die Verschlüsselung verwendeten Schlüssel aus. Die Details der jeweiligen Schlüssel können sich ändern.
- X509-Schlüssel: Gibt den Namen und das Kennwort des X509-Schlüssels sowie den Keystore an, in dem sich dieser Schlüssel befindet.
- Unaufbereiteter Schlüssel: Gibt den Namen und den Bytewert des Schlüssels in hexadezimaler Form an.
- Schlüssel für Benutzernamenstoken: Gibt einen Benutzernamen und ein Kennwort für den Token an.
- Verschlüsselter Schlüssel: Gibt einen verschlüsselten Schlüssel an, der zuvor im Sicherheitsstack definiert wurde. Klicken Sie auf Neuen verschlüsselten Schlüssel einfügen, wenn Sie einen neuen Block für die Definition eines verschlüsselten Schlüssels erstellen möchten.
- Verschlüsselungsalgorithmus für Schlüssel
- Geben Sie den Standardalgorithmus für ein Verschlüsseln des Transportschlüssels an.
- Verschlüsselter Schlüssel
- In diesem Block wird ein verschlüsselter Schlüssel definiert, der in einem XML-Signatur- oder XML-Verschlüsselungsblock verwendet werden kann. Der Block mit dem verschlüsselten Schlüssel muss sich vor einem Block befinden, in dem der verschlüsselte Schlüssel verwendet wird.
- Actor-/Rollenname
- Geben Sie bei Bedarf den Namen des Actors an.
- Verständnis muss vorliegen
- Wählen Sie aus, ob der Sicherheitsalgorithmus verstanden werden muss.
- Schlüsselname
- Geben Sie den Namen des verschlüsselten Schlüssels ein.
- Kennungstyp
- Wählen Sie den Typ der gewünschten Schlüsselkennung für die Verschlüsselung aus:
- ISSUER_SERIAL
- BST_DIRECT_REFERENCE
- X509_KEY_IDENTIFIER
- EMBEDDED_KEYNAME
- THUMBPRINT_IDENTIFIER
- SKI_KEY_IDENTIFIER
- Schlüsselgröße
- Geben Sie die Größe des Schlüssels in Bit an.
- Verschlüsselungsalgorithmus für Schlüssel
- Geben Sie den Algorithmus an, der zum Verschlüsseln des Schlüssels verwendet werden soll.
- Keystore
- Wählen Sie einen Keystore (Schlüsselspeicher) aus oder klicken Sie auf Sicherheitskeystore bearbeiten, wenn Sie einen neuen Keystore definieren oder die vorhandenen Keystores verwalten möchten.
- Name
- Wählen Sie einen Schlüssel aus, der im angegebenen Keystore enthalten ist.
- Kennwort
- Geben Sie das Kennwort für den ausgewählten Schlüsselnamen ein.
- Angepasster Sicherheitsalgorithmus
- Wenn Sie eine Java-Klasse als angepassten Sicherheitsalgorithmus implementiert haben, können Sie den angepassten Algorithmus mithilfe dieses Stapelelements auf den Service anwenden.
- Name
- Geben Sie den Namen des angepassten Sicherheitsalgorithmus an.
- Implementierungsklasse
- Geben Sie den Namen der Klasse an, mit der der angepasste Sicherheitsalgorithmus implementiert wird. Klicken Sie auf Durchsuchen, um eine Java-Klasse aus dem Arbeitsbereich auszuwählen.
- Eigenschaften
- Über diese Tabelle können Sie bestimmte Eigenschaften und die zugeordneten Werte an den angepassten Sicherheitsalgorithmus senden.