This site contains the documentation that is relevant to older WSO2 product versions and offerings.
For the latest WSO2 documentation, visit https://wso2.com/documentation/.

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Current »

A Proxy Service defines virtual services hosted on the ESB that can accept requests, mediate them, and deliver them to an actual service. Proxy Services could perform transport or interface switching and expose different semantics than the actual service, i.e. WSDL, policies, and QoS aspects like WS-RM, WS-Security, etc. It can mediate the messages before they are delivered to the actual endpoint, and the responses before they reach the client. It is possible to list a combination of tasks to be performed on the messages received for the Proxy Service, and terminate the flow or send a message back to the client even without sending it to the actual service.

Follow the instructions below to add a new Proxy Service.

1. Sign in. Enter your user name and password to log on to the ESB Management Console.

2. From the left navigation menu, select "Proxy Service."

3. The "Create Proxy Service from Template" page appears.

4. Select a template that suits your mediation requirements.

Tip

If you are looking to create an advanced Proxy Service or if none of the available templates matches your requirements, select the Custom Proxy option at the end of the templates list. This will launch the Proxy Service creation wizard, which enables you to customize all aspects of the proxy service including the sequences, endpoints, transport settings, WSDL options and other QoS settings.

The "Create Proxy Service from Template" page provides you the following set of built-in templates for creating and setting up Proxy Services:

  • Pass Through Proxy - Allows to create a simple Proxy Service on a specified endpoint. The Proxy Service does not perform any processing on the messages that pass through the Proxy.
  • Secure Proxy - Allows to create a Proxy Service with WS-Security engaged. The service will process WS-Security on incoming requests and forward them to an unsecured backend service.
  • WSDL Based Proxy - Allows to create a Proxy Service out of a WSDL of an existing Web Service. Endpoint information is extracted from a remotely hosted WSDL of an actual service.
  • Log and Forward Proxy - Allows to create a Proxy Service which logs all the incoming requests and forwards them to a given endpoint. If necessary responses coming back from the backend service can be logged before routing them to the client.
  • Transformer Proxy - Allows to create a Proxy Service, which transforms all the incoming requests using XSLT and then forwards them to a given endpoints. If required responses coming back from the backend service can be transformed as well.
  • Custom Proxy - Launches the Proxy Service creation wizard and creates a new Proxy Service from the scratch. Customize each and every aspect of the proxy including sequences, endpoints, transport and other QoS settings.

For example, if you wish to expose an existing service with WS-Security, you can choose the "Secure Proxy" option to create a Proxy Service with WS-Security enabled with a specified security policy. If you implement a scenario, where an existing service is exposed over a different schema (message format), you can make use of the "Transformer Proxy" option to setup easily a Proxy Service, which can transform requests and responses based on specified XSLT configurations.

Tip

Each template will show a limited set of controls, which allows the user to setup a Proxy Service easily. On successfully creating a Proxy Service, the user will be directed to the "Deployed Services" page.

5. Specify the options of a selected template. For the detailed information about specific options of Proxy Services see:

6. Specify common for all Proxy Service templates options. They are:

Publish WSDL Options

1. Select one of the "Publishing WSDL" options:

Specify in-line

If this option was chosen, you need to enter "Inline WSDL Definition."

Specify Source URL

If this option was chosen you need to specify the source URI. URI consists of URL and URN. URL defines host address of network resource (can be omitted if resources are not network homed) and URN defines the resource name in local "namespaces." For example: URI = ftp://ftp.dlink.ru/pub/ADSL/where:
URL = ftp://ftp.dlink.ru/URN = pub/ADSL/

Tip

You can test the URI using the "Test URI" button.

If the URI was tested successfully, click "OK" in the "WSO2 Carbon" window to continue.

Pick From Registry

If this option was chosen, you need to choose a "Reference Key" from the Governance Registry or the Configuration Registry. For more information about the Registry Browser see Registry Browser and Namespace.

2. Enter "Location" of the source and "Key" of a WSDL Resource. "Key" can be chosen from the Configuration Registry or the Governance Registry. For more information about the Registry Browser see Registry Browser and Namespace.

2.1. To add a WSDL Resource, click on the "Add Resource" link and the Resource appears in the list below.

2.2. You can delete a WSDL Resource using the "Delete" button in the "Action" column.

Transports

The "Transports" panel allows to select transports for a Proxy Service to use.

Note

Only enabled transports appear in the "Transports" list. For the detailed information see Transports.

See also WSO2 Carbon Transports.

7. Click on the "Create" button at the bottom of the page to create a new Proxy Service for all build-in templates.

Or click "Finish" to create a new custom Proxy Service.

8. A new Proxy Service appears in the "Proxy Service" list on the "Deployed Services" screen.

  • No labels