Configuring a Service Provider (Simplified)

Use

SOA Manager offers an accelerated method to configure service definitions with a reduced set of configuration options. So-called simplified Web service configuration (Simple Consumer Support Provider SCSP) is only available for provider systems. It is intended to support simple Web Service consumers that are not able to parse WSDL documents.

The following constraints apply to simplified Web service configuration:

Bindings

  • All configuration details can be displayed, but the binding cannot be edited.

  • The WSDL document for a binding cannot be displayed.

    You can display a WSDL document for a binding using Web Service Configuration.

  • Simplified Bindings cannot be deleted using Web Service Configuration.

    In Simplified Web Service configuration, the binding is automatically deleted if you deselect all the configuration options and then save.

Authentication methods

The following authentication methods are supported:

  • User Name / Password

  • X.509 Client Certificate

  • Single Sign-On using SAP Logon Tickets

    SCSP uses only transport level authentication.

APIs

  • Public APIs are available

  • Default values for API access are supported

Prerequisites

You may need the following roles to work with simplified Web service configuration:

  • SAP_BC_WEBSERVICE_ADMIN_TEC

  • SAP_BC_WEBSERVICE_CONFIGURATOR

  • SAP_BC_WEBSERVICE_OBSERVER

  • SAP_BC_WEBSERVICE_ADMIN_BIZ

More information: SAP Note 1318883 Information published on SAP site (Introduction of new authorizations in Web Service)

Procedure

To manually configure a provider using simplified Web service configuration, perform the following steps:

  1. Start SOA Manager.

    Use the transaction code SOAMANAGER.

  2. Go to the Service Administration tab.

  3. Choose Simplified Web Service Configuration.

    The search screen is displayed.

  4. Search for or specify a service definition.

  5. Choose Go.

    The service definition is displayed with the configuration options.

  6. Make your changes.

    You can choose the following settings:

    Setting

    Description

    User Name / Password (Basic)

    This option can be set without the need for any additional configuration.

    X.509 Client Certificate

    Additional configuration of certificates is needed.

    SAP Logon Ticket

    Single Sign-On using SAP Assertion Tickets

    Additional configuration is needed.

    More information: See SAP Note 304450 Information published on SAP site (Single-Sign-On with SAP logon tickets in non-SAP Systems)

  7. Choose Save.

    When the configuration is saved, a binding is created, assigned a name, and activated. A message confirms that the configuration has been saved. Changes are logged and displayed in the Recent Changes section.

  8. To display a detailed summary of the provider configuration, select the row with the service and choose Show Details.

    A dialog box is displayed.

    URLs are displayed for the WSDL document both with WS Policy Information and without WS Policy Information. Except for the WS Policy information, the two WSDL documents are identical. The Access URL field displays the address to which the SOAP request is sent. This URL is contained in the WSDL document. The URL remains the same even if the configuration is changed.

  9. Choose OK to close the dialog box.

  10. To display changes made to a service definition, select the row and choose Show Changes.

    An overview of changes to the configuration is displayed.

    The Recent Changes section displays confirmation that the configuration was activated, and the name of the binding that was automatically created. If multiple service definitions are displayed in the overview, the Recent Changes section displays the information for the selected service definition.

Creating Program Code to Configure Providers

To use program code to configure providers using simplified Web service configuration, perform the following steps:

  1. To set the default authentication values for the Simple Client Provider API, go to the API Settings tab.

    Here, you can decide whether to allow programs to automatically create bindings, and which authentication options to apply.

  2. Select the settings you want to be the defaults for the API.

  3. Choose Save.

    The following are the APIs for configuring provider programs using simplified Web service configuration:

    • Enable Service: ;CL_SRT_PUBLIC_SDEF_DEPLOYMENT->IF_SRT_PUBLIC_SDEF_DEPLOYMENT~ENABLE_SERVICE_DEFINITION_SC( )

    • Disable Service: CL_SRT_PUBLIC_SDEF_DEPLOYMENT->IF_SRT_PUBLIC_SDEF_DEPLOYMENT~DISABLE_SERVICE_DEFINITION_SC( )

      An instance of CL_SRT_PUBLIC_SDEF_DEPLOYMENT can be created with public factory CL_SRT_PUBLIC_FACTORY=>GET_SERVICE_DEFINITION_HANDLER( ).

Example

Enable Web service using program code:

data l_sdef_name type srt_wsp_dt_obj_name.

data lr_sdef_deploy type ref to if_srt_public_sdef_deployment.

lr_sdef_deploy ?=cl_srt_public_factory=>get_service_definition_handler().

l_sdef_name = |SRT_TEST_PROVIDER|.

\ enable configuration for service definition

lr_sdef_deploy->enable_service_definition_sc( l_sdef_name ).

Disable Web service using program code:

data l_sdef_name type srt_wsp_dt_obj_name.

data lr_sdef_deploy type ref to if_srt_public_sdef_deployment.

lr_sdef_deploy ?=cl_srt_public_factory=>get_service_definition_handler().

l_sdef_name = |SRT_TEST_PROVIDER|.

\ disable configuration for service definition

lr_sdef_deploy->disable_service_definition_sc( l_sdef_name ).