Show TOC

Dokumentation zur VorgehensweiseSOAP-Empfänger-Adapter konfigurieren Dieses Dokument in der Navigationsstruktur finden

 

Um Informationen vom Integration Server oder der AEX an Remote Clients oder Web-Services-Server zu versenden, konfigurieren Sie einen SOAP-Empfänger-Adapter.

Vorgehensweise

  1. Wählen Sie das Transport-Protokoll.

    • HTTP (einschließlich HTTPS)

    • SMTP (einschließlich SMTPS)

      Über dieses Transport-Protokoll verschickt der Adapter SOAP-Messages als E-Mails.

  2. Wenn Sie Informationen von einem Integration Server oder einer AEX zu Remote Clients oder Web-Servers senden möchten, wählen Sie das Message-Protokoll SOAP 1.1. Wenn Sie eine XI-Message an ein Legacy-System oder eine Advanced Adapter Engine schicken möchten, wählen Sie das Message-Protokoll XI 3.0.

    Mit dem Message-Protokoll XI 3.0 können Sie zum Beispiel die Kommunikation zwischen der Advanced Adapter Engine und im Backend-System generierten ABAP-Proxys konfigurieren. Diese Option ist jedoch mit Einschränkungen verbunden. Weitere Informationen finden Sie im SAP-Hinweis 1247043.

  3. Wählen Sie die Adapter Engine auf dem Integration Server aus oder wählen Sie eine dezentral installierte Adapter Engine aus.

1. Verbindungsparameter definieren

  1. Geben Sie unter Ziel-URL die vollständige Adresse (URL) des Web-Service-Provider ein, an den die Message geschickt werden soll.

  2. Benötigt der Server eine Benutzer-Authentifizierung, wählen Sie Benutzer-Authentifizierung konfigurieren und machen Sie folgende Angaben:

    • Für Transport-Protokoll SMTP/SMTPS wählen Sie die Authentifizierungsmethode:

      • Plain

      • CRAM-MD5

    • Benutzer

    • Kennwort mit Bestätigung

      Hinweis Hinweis

      Die Option Benutzerauthentifizierung konfigurieren ist nur verfügbar, wenn Sie das Message-Protokoll SOAP 1.1 auswählen.

      Ende des Hinweises.

  3. Fordert der Server ein Zertifikat vom Client an, wählen Sie Zertifikatsauthentifizierung konfigurieren.

    Machen Sie folgende Angaben:

    • Schlüsselspeichereintrag

    • Schlüsselspeichersicht

      Hinweis Hinweis

      Die Option Zertifikatsauthentifizierung konfigurieren ist unter Authentifizierungsdaten verfügbar, wenn Sie das Message-Protokoll XI 3.0 auswählen.

      Ende des Hinweises.

  4. Für Transport-Protokoll HTTP/HTTPS machen Sie Angaben zum HTTP-Proxy-Server:

    Ist der Web-Service-Provider nicht direkt, sondern über einen HTTP-Proxy-Server zu erreichen, dann setzen Sie das Kennzeichen Proxy konfigurieren und machen Sie folgende Angaben:

    • Host

    • Port, unter dem der Proxy HTTP-Requests annimmt

    • Benötigt das Proxy eine Benutzer-Authentifizierung, wählen Sie Proxy-Benutzer Authentifizierung konfigurieren.

      Geben Sie den Benutzer und das Kennwort mit Bestätigung an.

      Hinweis Hinweis

      Die Option Proxy konfigurieren ist unter Proxy-Einstellungen verfügbar, wenn Sie das Message-Protokoll XI 3.0 auswählen.

      Ende des Hinweises.
2. Authentifizierungsdaten für das Message-Protokoll XI 3.0 definieren

Wählen Sie den Authentifizierungsmodus:

  • Anmeldedaten für das SAP-System

    Wenn Sie Messages mit einem ABAP-basierten Empfänger austauschen wollen, dann geben sie an:

    • Benutzername

    • Kennwort des Benutzers

    • Anmeldesprache

    • Anmeldemandant

      Ist die Ziel-URL eine HTTPS-URL und erfordert somit eine Client-Authentifizierung, kann das Zertifikat wie folgt konfiguriert werden:

    • Geben Sie den Zertifikatnamen an.

    • Geben Sie den Schlüsselspeicher an.

  • Anmeldedaten für nicht-SAP-System verwenden

    Wenn Sie Messages mit einem nicht-ABAP-basierten Empfänger austauschen wollen, dann geben Sie an:

    • Benutzername

    • Kennwort des Benutzers

  • Anonyme Anmeldung

    Wenn der Empfänger keine Autentifizierung durchführt, dann wählen Sie diese Option.

3. Paketierung für Message-Protokoll XI 3.0 definieren

Wenn Sie asynchrone Messages zu einem Paket gruppieren und dann dieses Paket als eine SOAP-Message verarbeiten möchten, wählen Sie Paketierung verwenden und geben Sie einen Wert für die folgenden Parameter an, um das Paket anzulegen.

  • Geben Sie die Wartezeit (Sek.) ein, um die maximale Wartezeit bis zur Verarbeitung der Queue festzulegen.

  • Geben Sie die Anzahl ein, um die maximale Anzahl der Messages pro Paket festzulegen.

  • Geben Sie die Paketgröße (KB) ein, um die maximale Gesamtgröße in KB aller Messages in einem Paket festzulegen.

Hinweis Hinweis

  • Trifft einer der obigen Parameter zu, werden die Messages als Paket verarbeitet.

  • Ist einer der Parameter nicht angegeben oder ist sein Wert negativ, werden die folgenden Standardwerte verwendet:

    • Wartezeit = 60 Sekunden

    • Anzahl = 5 Messages

    • Paketgröße = 5120 KB (5 MB)

Ende des Hinweises.

Achtung Achtung

Beim SOAP-Adapter können Sie entweder die Message-Paketierung verwenden oder die Weiterleitung von Benutzeridentitäten, die bei der Konfiguration der Empfängervereinbarung definiert wurde, nicht beides.

Weitere Informationen: Empfängervereinbarung definieren

Ende der Warnung.
4. Mail-Attribute für Transport-Protokoll SMTP/S definieren

Für das Transport-Protokoll SMTP/S geben Sie folgende Mail-Attribute an:

  • Von: E-Mail-Addresse, von der die Message gesendet wird

  • An: E-Mail-Addresse, an die die Message gesendet wird

    Wenn Sie mehrere Adressen angeben, trennen Sie die Adressen durch ein Semikolon.

  • Cc: E-Mail-Adressen, an die die E-Mail ebenfalls gesendet werden soll.

    Die hier angegebenen Adressen sind für den Empfänger sichtbar.

  • Bcc: E-Mail-Adressen, an die die E-Mail ebenfalls gesendet werden soll.

    Die hier angegebenen Adressen sind für den Empfänger nicht sichtbar.

  • Geben Sie den Betreff der E-Mail-Nachricht an.

5. Sicherheitsparameter definieren

  1. Wenn Sie in der zugehörigen Empfängervereinbarung auf dem Integration Server oder der AEX zusätzliche Einstellungen zur Sicherheit vornehmen möchten, wählen Sie Sicherheitsprofil wählen.

    Weitere Informationen finden Sie in der SAP-NetWeaver-Bibliothek unter   Funktionsorientierte Sicht   Process Integration   Integration Directory   Empfängervereinbarung definieren   Sicherheitseinstellungen für SOAP-Empfänger-Adapter  .

  2. Wählen Sie das Sicherheitsprofil Web-Services-Sicherheit oder S/MIME aus.

  3. Geben Sie die Aufbewahrungszeit für die Messages in Tagen, Stunden, Minuten und Sekunden an.

Hinweis Hinweis

Sicherheitsparameter sind nur verfügbar, wenn Sie das Message-Protokoll SOAP 1.1 auswählen.

Ende des Hinweises.
6. Konvertierungsparameter definieren

  1. Soll die Payload der Message ohne SOAP-Umschlag verschickt werden, wählen Sie Keinen SOAP-Umschlag verwenden.

  2. Soll der Header der XI-Message in die Web-Services-Message übernommen werden, wählen Sie Header behalten.

  3. Sollen Anlagen (Attachments) der XI-Message in die Web-Services-Message übernommen werden, wählen Sie Attachments behalten.

  4. Sollen die Header der XI-Message kodiert werden, wählen Sie Kodierte Header verwenden.

  5. Soll ein Query-String angegeben werden, wählen Sie Query-String verwenden.

  6. Geben Sie die SOAP-Aktion an.

    Die Aktion gibt den Wert für die SOAPAction in Web-Service-Messages an.

Hinweis Hinweis

Konvertierungsparameter sind nur verfügbar, wenn Sie das Message-Protokoll SOAP 1.1 auswählen.

Ende des Hinweises.
7. Adapterspezifische Message-Eigenschaften definieren

  1. Wählen Sie die Registerkarte Erweitert.

  2. Um adapterspezifische Attribute im Message-Header der XI-Message zu verarbeiten, wählen Sie Adapterspezifische Message-Attribute verwenden und außerdem Variable Transportanbindung.

    Folgenden Attribute werden im XI-Message-Header ausgewertet:

    • Server-URL (technischer Name: TServerLocation)

      Hier kann die komplette URL gesetzt werden.

    • Authentifizierungsschlüssel (technischer Name: TAuthKey)

    • Proxy-URL (technischer Name: TProxyLocation)

    • Proxy-Authentifizierungsschlüssel (technischer Name: TProxyAuthKey)

    • SOAP Aktion: (technischer Name: THeaderSOAPACTION)

  3. Wollen Sie Header-Felder übernehmen, wählen Sie Variabler Header.

    Die technischen Namen der Felder sind XHeaderName1, XHeaderName2, XHeaderName3.

    Unter diesen hier eingegebenen Bezeichnungen werden die Parameter in den HTTP Request übernommen.

Der Attributnamensraum für den Adapter ist: http://sap.com/xi/XI/System/SOAP.

8. Authentifizierungsschlüssel eingeben und anzeigen

Wird für das Empfängersystem eine Authentifizierung verlangt, können Sie hier für den jeweiligen Schlüsselwert ein Kennwort mit Bestätigung hinterlegen.

Auf diese Weise ist es nicht nötig, Kennwörter in den erweiterten Message-Header zu schreiben.

  • Möchten Sie den jeweiligen Authentifizierungsschlüssel eingeben oder anzeigen, wählen Sie Berechtigungsschlüssel anzeigen.

  • Sie können zum Wert des Authentifizierungsschlüssels (TAuthKey oder TProyxAuthKey) ein Kennwort mit Bestätigung eingeben.

9. Adapterstatus definieren

Setzen Sie den Adapter auf Aktiv, um ihn für den Message-Austausch einzusetzen.

Hinweis Hinweis

Der Adapterstatus ist nur verfügbar, wenn Sie das Message-Protokoll SOAP 1.1 auswählen.

Ende des Hinweises.