This documentation is for WSO2 ESB version 4.5.0. View documentation for the latest release.

Custom Proxy Template

The "Custom Proxy" template launches the Proxy Service Samples creation wizard and allows to create a new Proxy Service from the scratch. Customize each and every aspect of the proxy including sequences, endpoints, transports and other QoS settings. There are 3 steps to create a Proxy Service using Custom Proxy Template.

Step 1|#Step 2

Step 2|#Step 3

Step 3

Step 1

The Proxy Service settings:

  • Proxy Service Name - Allows to define the unique name of the Proxy Service.
  • General Settings
    • Publishing WSDL - Allows to set a publishing WSDL as:
    • Do Not load service on startup - Allows to choose whether or not to load the Service on startup.
    • Pinned servers - Allows to enter pinned servers. The names of the servers must be separated by comma or space.
    • Service Group - Allows to specify the Service Group if it is necessary. See more information about service groups in Managing Service Groups.
  • Transport Settings:
    • http/https - Allows to choose transport to use. Only enabled transports appear in the "Transports" list. See the detailed information in Transports.

Click "Next" to go to the Step 2.

Step 2

In sequence handles the incoming requests to the proxy service before they are dispatched to the target endpoint. A proxy service must contain an in sequence or an endpoint or both.

The following options are to be specified:

  • In Sequence Options:
    • None
    • Define Inline - Allows to use the "Create" link to create and add a sequence. See Adding a Mediation Sequence.
    • Pick from registry - Allows to choose the "In Sequence" path from the Configuration Registry or the Governance Registry. For more information about the Registry Browser, see Namespace.
    • Use Existing Sequence - Allows to choose an existing sequence from the drop-down menu.
  • Endpoint Options:
    • None
    • Define Inline- Allows to use the "Create" link to create and add an endpoint. See Adding an Endpoint.
    • Pick from registry - Allows to choose the "Endpoint" path from the Configuration Registry or the Governance Registry. For more information about the Registry Browser see Namespace.
    • Use Existing Endpoint - Allows to choose an existing endpoint from the drop-down menu.

Click "Next" to go to the Step 3.

Step 3

Out sequence mediates the response messages from the backend service before they are sent back to the client. Fault sequence is invoked in case of any errors while mediating a message through the proxy service. Both out sequence and fault sequence are optional.

The following options are to be specified:

  • Out Sequence Options:
    • None
    • Define Inline - Allows to use the "Create" link to create and add an Out Sequence. See Adding a Mediation Sequence.
    • Pick from registry - Allows to choose the "Out Sequence" path from the Configuration Registry or the Governance Registry. For more information about the Registry Browser see Namespace.
    • Use Existing Sequence - Allows to choose an existing sequence from the drop-down menu.
  • Fault Sequence Options:
    • None
    • Define Inline - Allows to use the "Add" link to create and add a Fault Sequence. See Adding a Mediation Sequence.
    • Pick from registry - Allows to choose the "Fault Sequence" path from the Configuration Registry or the Governance Registry. For more information about the Registry Browser see Namespace.
    • Use Existing Sequence - Allows to choose an existing sequence from the drop-down menu.