Show TOC

Procedure documentationConfiguring a Service Provider (Simplified) Locate this document in the navigation structure

 

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

Note Note

To be able to use the full set of configuration options, use Web Service Configuration. Choose   Service Administration   Web Service Configuration  .

End of the note.

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 (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 (Single-Sign-On with SAP logon tickets in non-SAP Systems)

    Note Note

    At least one option needs to be selected for a binding to be created.

    End of the note.

  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.

    Note Note

    With Simplified Web Service Configuration, you can only create one binding for a service definition. To display the full binding information, perform the following steps:

    1. Go to the Service Administration tab.

    2. Choose Web Service Configuration.

    3. Specify the service definition.

    4. Choose Go.

    5. Select the row with the service definition and choose Apply Selection.

    6. Go to the Configurations tab.

    7. Select the row with the creation type Simple consumer related.

    8. Choose Display.

      The authentication options that you set for the simplified Web service are displayed in the Authentication section. Note that a simplified configuration cannot be changed here.

    End of the note.

  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.

    Note Note

    A dialog box is displayed only if a configuration has been saved.

    End of the note.

    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.

    Note Note

    You can also display information about the WSDL documents in the Web Service Configuration section. Note that the URLs displayed the Web Service Configuration section are not the same as those displayed in the Simplified Web Service Configuration section.

    End of the note.

  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.

    Note Note

    The options are the same as for the service definition configuration. These options cannot be overridden by a program that uses the API.

    End of the note.

    Note Note

    If you deselect all the options, a program cannot automatically create a binding.

    End of the note.

  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( )

      Note Note

      Both methods do not raise any exception so you will not be informed whether configuration process has been sucessfully or not.

      End of the note.

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