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.
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.
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.
...
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.
...
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.
● 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.
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.
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. |
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.