Show TOC

Configuration Options for Service EndpointsLocate this document in the navigation structure

Prerequisites

Context

This procedure explains the runtime settings you can apply for the service endpoint.

Procedure

  • Configure Web service security.

    On the Security tab, specify the relevant options. More information: Recommended WS Security Scenarios .

    HTTP Authentication

    Option

    Description

    User ID/Password

    Authentication with user ID and password in HTTP header.

    X.509 Client Certificate

    Authentication with an X.509 certificate using Secure Sockets Layer (SSL).

    Logon Ticket

    Authentication with SAP authentication assertion ticket in the HTTP header, which authenticates the identity of the user.

    Message Authentication

    Option

    Description

    User ID/Password

    Authentication with WS-Security Username Token in the security header of the SOAP message.

    X.509 Client Certificate

    Authentication with an X.509 certificate using Secure Sockets Layer (SSL).

    SAML Assertion

    Authentication with a signed SAML 1.1 assertion in the message header, which authenticates the identity of the user.

  • Configure an alternative URL for SOAP messages.

    On the Transport Settings area, you can configure the URL address on which SOAP messages directed to the Web service are sent. This alternative URL can be different from the URL on which the Web service is actually available on the provider system.

    Note

    By default, SOAP messages are sent directly to the provider system, on which the Web service is running. This set-up is operational when you call the Web service from within the local network, for example. However, you have to explicitly configure the URL when the Web service you provide is behind a firewall, or a reverse proxy.

    Option

    Description

    Alternative Hostname

    The name of the host to which SOAP messages are sent.

    Alternative Port Number

    The number of the port to which SOAP messages are sent.

    Local transport

    Optimizes the way in which the Web service client communicates with the Web service when both reside on a same system. If the option is selected, the client calls the service directly. The system does not create a dedicated http connection as a communication channel and does not obey any explicitly configured security settings. Instead, to consume the service, the client uses the same credentials and thread, with which you invoked the client.

    Note

    On the client side, you can configure Local transport only for Web service clients, which are created for Local transport enabled Web services.

  • Configure stateful communication.

    If stateful communication is enabled for the service definition at design time, on the StateManagement tab, you can specify the method for session handling. Currently, only HTTP cookies are supported. If stateful communication was not enabled for the service definition at design time, the input fields on the State Management tab are disabled.

  • Configure Web service reliable messaging.

    You configure Web service reliable messaging (WSRM) on the Messaging tab.

    Note

    The Messaging tab is available only if WSRM was enabled for the service definition at design time in SAP NetWeaver Developer Studio. More information about enabling WSRM: Configuring Web Services Reliable Messaging .

    Set the relevant options to configure WS-RM for the service definition. The table below lists the available options and explains their meaning.

    Option

    Description

    RM Protocol

    Sets the protocol for reliable messaging.

    Confirmation Interval

    The interval (in milliseconds) at which the Web service has to send acknowledgments to the Web service client. Currently, the Web service sends acknowledgments to every call from the Web service client.

    Exponential Backoff

    Exponential backoff sets an algorithm used by the client when it resends messages. If you choose this option, the retransmission interval increases exponentially after each unsuccessful transmission.