Show TOC

Configuring Web Service ConnectivityLocate this document in the navigation structure

Use

You use Web service connectivity (WS connectivity) to establish a connection to provider systems based on a SOAP protocol. In the provider systems that use WS connectivity, you provide SOAP specific settings. You use communication profiles that are WS connectivity-enabled to set a secure communication between the consumer and provider systems over the SOAP protocol.

Prerequisites
  • You have started creating a new provider system connection or editing an existing one. For more information, see Creating a Connection and Editing a Connection .

  • To create WSIL based connections to remote provider systems, you must have credentials to access the WSIL document, and your user has to be assigned to the WSILSecurityRole action. For more information about the actions and security roles, see User Management of the Application Server Java .

Procedure

WS Connectivity when Using Local Transport

If you have a scenario where the provider and the consumer are on the same system and use local transport, make sure you follow the rules listed below when configuring the WS connectivity:

  • In basic mode, enter only the host name of the system without using the domain name. You should not enter the IP address of the system instead of the host name.

  • In advanced mode, when entering the URL of the WSIL or WSDL, use only the host name of the system without using the domain name. You should not enter the IP address of the system instead of the host name.

  • In advanced mode, when setting the communication profile, choose a communication profile that allows local transport.

    For more information about the transport options, see Configuring Web Service Connectivity to Communication Profiles .

Configuring WS Connectivity Details (Basic Mode)

  1. In the Connection Settings area, add the following data:

    1. In the Host Name field, enter the host name of the system.

    2. In the Protocol set, choose the protocol you want to use.

    3. In the Port field, enter the port of the system.

    Caution

    For systems with type Other , in the URL field, enter the URL to the provider system.

  2. In the Runtime Authentication Settings area, in the Authentication Method set, choose one of the following options:

    • Use SSO or No Authentication

    • Technical User

      To create and assign a user account to the system, enter the required data in the User Name and Password fields.

      Note

      This user account is used to download WSIL files and WSDL files. In case the user account does not have permissions, a window for a new user account opens.

Configuring WS Connectivity Details (Advanced Mode)

  1. In the Services Source set, specify the method you use to discover Web services on the provider system.

    • To discover groups of Web services, proceed as follows and choose the source of the Web services:

      • If the provider system is the Services Registry, choose the Services Registry option.

      • If you discover Web services on a provider system by using a WSIL document, choose the WSIL option, and then enter the URL to the WSIL document.

        You can discover service definitions on the remote provider system by using the WSIL documents of these systems. To access the WSIL document on a remote provider system, you must have a metadata user with the necessary permissions to the source. In addition to the metadata user availability, the following restrictions apply depending on the type of provider system:

        • For systems that are listed in the Services Registry, metadata user is needed only if the WSDL documents on the system are protected.

        • For AS JAVA systems, your metadata user has to be assigned to a UME role that has the WSILSecurityRole action.

        • For AS ABAP systems, your metadata user has to be assigned to a UME role that includes the authentication object S_SRT_ADM.

    • To discover single Web services, proceed as follows:

      1. Choose the WSDL option.

      2. In the URL field, enter the URL to the WSDL document of the Web service.

  2. In the Socket Timeout field, enter the interval in milliseconds for which the client system waits for a response from the provider system while processing the WSDL or WSIL source.

  3. In the Communication Profile field, specify a communication profile that you want to assign. The framework assigns the latest active version of the profile to the connection and displays the version number and description of the profile.

    Note

    You can browse communication profiles in the wizard that opens by choosing the button next to the Communication Profile field.

  4. In the Runtime Authentication Setting area, in the Authentication Method set, choose one of the following options:

    • Use SSO or No Authentication

    • Technical User

      To create and assign a user account to the system, enter the required data in the User Name and Password fields.

    • Existing User Account

      In the User Account field, specify a user account that you want to use for authentication at runtime.

      Note

      You can browse user accounts in the wizard that opens by choosing the button next to the User Account field.

  5. In the User to download WSIL and/or WSDL files area, enter credentials to access the WSDL or WSIL sources that are located on the provider system.

  6. In the Service Call Metering area, specify the service metering settings for the connection to the provider system. More information: Service Metering

    • In the Data transfer scope screen area, choose the amount of service metering data that is transferred through the connection:

      • Choose Minimal Data Transfer if you want the provider system to receive only Calling Application Type.

      • Choose Basic Data Transfer if you want the provider system to receive Calling Application Type, Calling Component, and Calling Application ID.

      • Choose Enhanced Data Transfer if you want the provider system to receive all caller information attributes.

      Caution

      Increasing the service metering level may lead to a security risk. When choosing the amount of service metering data, you should consider the trustworthiness of the Web service provider:

      • If you do not have any information about where and how the Web service is provided, you should choose the Minimal Data Transfer level.

      • If you are sure that the Web service is provided by a trustworthy party, you can increase the service metering level. For example, you can do this for provider systems residing in your internal network.

    • In the Transfer Protocol screen area, choose the protocol you want to use for the transfer of service metering data.

Result

The system stores the WS connectivity details you have provided. Modify other details of the provider system connection as necessary and save it.