WebSphere WebSphere Application Server Network Deployment, Version 6.0.x Operating Systems: AIX, HP-UX, Linux, Solaris, Windows

Web service gateway instances settings

A web services gateway allows you to configure specific endpoint listeners and deploy gateway and proxy services to those listeners.

To view this administrative console page, click Service integration > Buses > [Content Pane] bus_name > Web service gateway instances > [Content Pane] instance_name.

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. It also allows you to map multiple target services to a single gateway service, and to configure proxy services.

You create Web services gateway instances to partition the total set of gateway and proxy services into logical groups to allow simpler management. Note that 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.

Related tasks
Creating a new gateway instance
Modifying an existing gateway instance
Related information
Web service gateway instances collection
Administrative console buttons
Administrative console preference settings

Configuration tab

Configuration properties for this object. These property values are preserved even if the run-time environment is stopped then restarted. Changing these property values typically has no effect until the run-time environment is restarted; for example, by stopping then restarting an application server. See the information center task descriptions for information about how to apply configuration changes to the run-time environment.

General properties

Name

The name of the web services gateway instance.

This name must be unique, and it must obey 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: \ / , # $ @ : ; " * ? < > | = + & % '
Required Yes
Data type JSP

Description

An optional description of the web services gateway instance.

Required No
Data type Text area

Gateway namespace

The namespace assigned to this gateway for use in WSDL generation.

This is used as the namespace 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:
  • The name begins with urn:

    See the guidance on Internet standards for the syntax of Uniform Resource Names (URNs) at http://www.ietf.org/rfc/rfc2141.txt.

  • The name is globally unique.
  • The name reflects your company name.
Required Yes
Data type JSP

Default proxy WSDL URL

The URL of the default proxy WSDL description for use with proxy services.

A proxy service has no target services and therefore no WSDL 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.

The supplied template WSDL is located at
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:4080/sibws/proxywsdl/ProxyServiceTemplate.wsdl
Alternatively, you can supply the URL for your own equivalent template.
Note: You can also override the default proxy WSDL, and supply an alternative WSDL, for an individual proxy service using the administrative console option Service integration > Buses > [Content Pane] bus_name > Web service gateway instances > [Content Pane] instance_name > Proxy Services > [Content Pane] service_name.
Required Yes
Data type Text

Endpoint listeners

Manage endpoint listeners for this gateway instance.

Required No
Data type Custom

Additional properties

Gateway services
A gateway service provides the configuration of the web service enablement of a service destination, along with the information that maps to one or more target destinations.
Proxy services
A proxy service provides the configuration of the web service enablement of a service destination that is able to act as a proxy for a variety of providers.

Reference topic

Terms of Use | Feedback

Last updated: 5 Oct 2005
http://publib.boulder.ibm.com/infocenter/ws60help/index.jsp?topic=/com.ibm.websphere.pmc.nd.doc\sibuswsgw\WSGWInstance_DetailForm.html

© Copyright IBM Corporation 2004, 2005. All Rights Reserved.
This information center is powered by Eclipse technology. (http://www.eclipse.org)