Configuring the Receiver WS Adapter

Configuring the receiver WS adapter to send information from the Integration Server to a Web service provider.

1. Define the connection parameters.

   Enter the complete address of the Web service provider you want to send the message to in the Target URL field.

   You can configure timeouts for establishing a connection and receiving a response on the Advanced tab. The available options for both Establish Connection Timeout and Receive Response Timeout are:

   • Never
   • System Default
   • Custom Value (You can enter the time to wait in seconds.)
2. Define transport-level security.

   If the server requires user authentication, activate HTTP Basic Authentication and specify User Name and Password.

   For TLS/SSL-enabled endpoints, you can configure authentication using X.509 certificates:

   If the server requests a certificate from the client, activate Use TLS Client Certificate and specify the name of the keystore in Keystore View and the certificate alias in Keystore Entry.

   If the client requests server authentication, you can activate Validate Remote TLS Certificate and specify the store of trusted authorities in CA Store View.

3. Set up reliable messaging.

   If you want messages to be reliably delivered using the WS-Reliable Messaging standard, select Enable WS-RM. Select the Protocol version and customize the related configuration options.

   The Sequence Length specifies the maximum number of messages in a sequence. The default value is 1 and should not be changed if the receiver is an SAP system. We recommend that you always restrict the sequence length, although it is possible to specify it as unlimited by setting the value to 0.

   To specify that the retransmission interval will be adjusted using the exponential backoff algorithm, activate Use Exponential Backoff Strategy.

4. Set up addressing.

   Select Enable WS Addressing if an addressing header is to be used in the outgoing message.

   Note WS-RM without WS-A is not supported, so if WS-RM is enabled, this setting is implicitly set to ON.

   If WS-A is enabled (either explicitly or implicitly):

   • Select the Addressing version. The option Default (matching WS-RM version) advises the adapter to select a version based on the WS-RM settings:
     • WS-RM is OFF: latest version
     • WS-RM is ON: version specified as default for the selected WS-RM version
   • Optional: In Fully Qualified Decoupled Endpoint Address, specify an endpoint address to which the response is to be sent. If the receiver is an SAP system, you must set it to http://www.w3.org/2005/08/addressing/anonymous.
5. Select the SOAP protocol version.

   Specify which SOAP version is to be used. In an integration flow this should be the same as in the sender channel (if applicable).

6. Define message-level security.

   On the WS-Security tab, specify which level of security has to be enforced on the outgoing message. The features are defined in the WS-Security specification.

   Select Add Timestamp to add a timestamp to the message.

   If the message is to be digitally signed, select Add Signature and choose whether a body signature is also required by selecting Add Signature to Body Element. Specify the signature to use in Signature Keystore View and Signature Keystore Entry. To specify how key information will be referenced, select an option from the Signature Key Reference list:

   • Subject Key Identifier
   • Direct Reference
   • Issuer Name and Serial Number

   If an SAML Assertion is needed, select Add Signed SAML 1.1 Assertion (SSO). Specify the signature to use in SAML Signature Keystore View and SAML Signature Keystore Entry. To specify how key information will be referenced, select an option from the SAML Signature Key Reference list:

   • Subject Key Identifier
   • Direct Reference
   • Issuer Name and Serial Number

   Specify the Issuer Name of the trust relationship from the certificate. If you want to use the Override User Name option, provide the name to be used in the outgoing message.

   Note If the receiver is an SAP system, only Subject Key Identifier is supported as the Key Reference.

   Note For SAML Authentication (SSO) to work, all the above features need to be activated.

   If the message complies with the Web Services Interoperability Organization (WS-I) Basic Security Profile, activate BSP 1.0 Compliant. This option needs to be OFF if the receiver is an SAP system and, if applicable, the same as in the sender channel in the integration flow.

7. Configure the proxy server.

   If the Web service provider can be reached by using an HTTP proxy server, you can configure it on the Advanced tab.

   Note This feature is not supported for TLS/SSL-enabled endpoints.

   Activate Use HTTP Proxy and enter the Host Name and the port that the proxy uses to receive HTTP requests in the Service Name/Port field.

   If the proxy requires user authentication, enter User Name and Password.

8. Define message ID processing.

   On the Advanced tab you can specify how message IDs are processed in the receiver adapter.

   Activate Enable Message ID Mapping if you want to customize message ID processing.

   Select the External Message ID Location, which can be either the WS-Addressing MessageID (if present), a SOAP header element or an HTTP header field. In all but the WS-A case you also need to enter the name of the element/field.

9. Define additional parameters.
   Note SAP currently uses this option for testing and debug purposes only.

   Activate Set Additional Parameters on the Advanced tab and enter the names and values for the additional parameters in the table.