Show TOC Start of Content Area

Procedure documentation Configuring Individual Web Services  Locate the document in its SAP Library structure

Use

This procedure enables you to configure a service definition by creating a service endpoint for it. 

More information about the underlying concepts: Configuration of Individual Web Services and Web Service Clients.

You can also configure a service definition by editing the service endpoints that are already available for the service definition in the SAP NetWeaver Administrator.

Depending on the configuration settings applied to a service definition (Web service) at design time in the SAP NetWeaver Developer Studio, the system has the following behavior when that service definition is deployed:

      When you deploy a service definition that has no configuration settings applied through annotations in the Developer Studio, the system creates a service endpoint with default runtime settings. In the SAP NetWeaver Administrator, you can edit the settings of this service endpoint to apply your custom configuration settings, or explicitly create one with new settings.

      When you deploy a service definition that has configuration settings only for properties of design time features in the Developer Studio, such as authentication level, or enablement of Web service reliable messaging, the system does not create a service endpoint. In the SAP NetWeaver Administrator, you have to explicitly create a service endpoint to apply runtime configuration settings.

Note

When you configure the authentication level of a service endpoint in the SAP NetWeaver Administrator, you can only increase the authentication level which was already set in the Developer Studio. For example, if the authentication level of a Web service was set to BASIC in the Developer Studio, you cannot decrease it to NONE in the SAP NetWeaver Administrator when you configure a service endpoint for the respective service definition.

More information about configuring Java Web services by using annotations in the Developer Studio: Configuring Web Services at Design Time.

You cannot edit the service endpoint created for a service definition as a result of mass configuration. More information about the underlying concepts of mass configuration: Configuration of Groups of Web Services. More information about configuring Web services through mass configuration: Configuring Groups of Web Services.

Procedure

       1.      Log on to the SAP NetWeaver Administrator.

       2.      Choose SOA Management Business Administration Web Services Administration. Alternatively, you can use the quick link /WSAdmin as follows:

http://<host>:<port>/nwa/WSAdmin

The Web Services Administration screen opens.

       3.      Find the service definitions which you want to configure. Proceed as follows:

                            a.      In the Search by field, make sure that Service Definition Name is selected.

                            b.      In the Value field, enter the name of the service definition. Choose Go. You can use the wildcard search symbols (?) and (*).

The system lists all available service definitions which match your search criteria.

       4.      Select the service definition you want to configure, and then choose the Configuration tab.

You can create and configure a new service endpoint, or edit the configuration settings of an existing one.

Creating a Service Endpoint

...

       1.      Choose Create Endpoint.

       2.      Enter a name for the service endpoint.

       3.      You can create the endpoint in an existing service or a new one. The table below outlines the possible options and their meaning.

Option

Meaning

Settings

In New Service

The system creates the service endpoint in a new service corresponding to the service definition. The system generates a new WSDL document for the service which contains the service endpoint URL for the endpoint.

Enter a name for the service.

In Existing Service

The system creates the service endpoint in the specified service which is already available for the service definition. The system adds the information about the service endpoint to the existing WSDL document of the service.

Choose an existing service.

       4.      On the tabs that appear, apply the necessary configuration options.

The Configuration Options for Service Endpoints section below explains the runtime settings you can apply for the service endpoint.

Editing a Service Endpoint

...

       1.      From the Service Endpoints table, choose a service endpoint.

       2.      Choose Edit.

       3.      On the tabs that appear, apply the necessary configuration options.

The Configuration Options for Service Endpoints section below explains the runtime settings you can apply for the service endpoint.

Configuration Options for Service Endpoints

      Configuring 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

More Information: HTTP Transport Level Authentication

X.509 Client Certificate

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

More Information: HTTP Transport Level Authentication

Logon Ticket

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

More Information: HTTP Transport Level Authentication

Message Authentication

Option

Description

User ID/Password

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

More Information: WS-Security UsernameToken

X.509 Client Certificate

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

More Information: HTTP Transport Level Authentication

SAML Assertion

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

More Information: SAML Token Profile

 

      Configure an alternative URL for SOAP messages

On the Transport Settings tab, 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.

      Configure stateful communication

If stateful communication is enabled for the service definition at design time, on the State Management 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 the SAP NetWeaver Developer Studio. More information about enabling WSRM: Configuring Web Services Reliable Messaging

Set the relevant options to configure WSRM 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 acknowledgements to the Web service client. Currently, the Web service sends acknowledgements to every call from the Web service client.

ExponentialBackoff

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.

Result

The service endpoint is created. Optionally, you can test the service endpoint by using the Web Service Navigator. More information: Testing Web Services in the Web Services Navigator.

As a next step, you can configure the Web service client. More information: Configuring Individual Web Service Clients.

 

 

End of Content Area