Within each service integration bus you can create multiple
gateway instances. You create Web services gateway instances to partition
the total set of gateway and proxy services into logical groups to allow simpler management.
The gateway provides you with a single point of control, access and
validation of Web service requests, and allows you to control which
Web services are available to different groups of Web service users.
About this task
Bus destinations are already partitioned by the service
integration bus, so each gateway instance is limited to gateway and
proxy services within the same bus. However, gateway services can
then map to target services that are available on other buses.
To
create a new gateway instance, complete the following steps:
Procedure
- Start the administrative console.
- In the navigation pane, click bus_name.
The gateway instances
collection form is displayed.
- Click New. The gateway instances
settings form is displayed.
- Type the following general properties:
- Name
- Type the name by which the gateway instance is known. This name
must be unique, and it must follow the following syntax rules:
- It must not start with "." (a period).
- It must not start or end with a space.
- It must not contain any of the following characters: \
/ , # $ @ : ; " * ? < > | = + & % '
- Description
- Type the (optional) description of the gateway instance.
- Gateway namespace
- Type the namespace that you want to use for the gateway services
in exported WSDL documents. There is no fixed syntax for the gateway
namespace, but whatever name you choose is likely to be more effective
if it observes the following guidelines:
- Default proxy WSDL URL
Type the location (Web address) of the
default proxy WSDL file.
A gateway service that runs in proxy mode
has no actual target services and therefore no WSDL document that
the gateway can use to configure the service invocation. A generic
template WSDL file is used to configure the basic parameters for the
invocation call. For more information, see JAX-RPC handlers and proxy operation.
The supplied template WSDL file is located here:
http://host_name:port_number/SIBWS/proxywsdl/ProxyServiceTemplate.wsdl
where
host_name and
port_number are
the host name and port number for this application server. For example
http://your.server.name:9080/SIBWS/proxywsdl/ProxyServiceTemplate.wsdl
Alternatively,
you can supply the Web address of your own equivalent template WSDL
file.
- Click OK.
Results
If the processing completes successfully, the list of gateway
instances is updated to include the new gateway instance. Otherwise,
an error message is displayed.