Create a reference (a pointer) to a UDDI registry for use with
service integration bus-enabled web services.
About this task
A UDDI reference is a pointer to a UDDI registry. This registry
can be a private UDDI registry such as the
IBM® WebSphere® UDDI Registry
, or a public UDDI
registry. The service integration technologies interact with UDDI registries
in two ways:
- When you configure an inbound service, you can create entries for the
web service in one or more UDDI registries.
- When you configure an outbound service, you specify the location of the
target WSDL file that describes the web service. This WSDL file can be located
at a URL or through a UDDI registry.
In the UDDI model, web services are owned by businesses, and businesses
are owned by Authorized Names. Each UDDI reference gives access to the Web
services that are owned by a single Authorized Name in a single UDDI registry.
For more information about how the service integration technologies work with
UDDI registries, see UDDI registries: Web service directories that can be referenced by bus-enabled web services and Publishing
a web service to a UDDI registry. For more general information about
UDDI and UDDI registries, see the UDDI community at uddi.org.
To create a new
UDDI reference, complete the following steps:
Procedure
-
Start the administrative console.
-
In the navigation pane, click
.
The UDDI
references collection form is displayed.
-
Click New.
The UDDI
references settings form is displayed.
-
Type the following general properties:
- Name
- Type the name by which the UDDI reference 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: \ / , # $
@ : ; " * ? < > | = + & % '
You might need more than one UDDI reference for a given UDDI registry. For more information, see UDDI registries: Web service directories that can be referenced by bus-enabled web services.
- Description
- Type the (optional) description of the UDDI reference.
- Inquiry URL
- Type the web address that provides access to this registry for the SOAP inquiry API.
- Publish URL
- Type the web address that provides access to this registry for the SOAP
publish API.
- Authentication alias
-
Type the J2C authentication alias for the user ID and password of an "Authorized
Name" that has update access to this registry.
The alias you enter
here must match the user ID of the owner of the corresponding business in
the UDDI registry. You can see the owning user ID in UDDI by looking at the
business details under the "Authorized Name" field. If the alias you
enter here does not match the "Authorized Name" value for the business
that owns the service, then the service is not published or found.
If
the business has more than one "Authorized Name", you might want to set
up multiple UDDI references (each with a different authentication alias) to
the same UDDI registry.
-
Click OK.
Results
If the processing completes successfully, the list of UDDI references
is updated to include the new UDDI reference. Otherwise, an error message
is displayed.
What to do next
To use this UDDI reference, select it when
Making an internally-hosted service available as a web service or
Making an externally-hosted web service available internally.
-
Modifying an existing UDDI reference
Modify the configuration details for a UDDI reference that has
been configured for use with service integration bus-enabled web services.
-
Deleting UDDI references
delete UDDI references that are configured for use with service
integration bus-deployed web services.
-
Publishing a web service to a UDDI registry
When you configure an inbound or outbound service, you enable UDDI
interaction by associating the service with a UDDI reference, and (depending
upon what you are trying to do) either or both of the following pieces of
information: The business key that identifies the UDDI business
category under which you want your service to appear in the UDDI registry,
and the service-specific part of the service key that the UDDI
registry assigns to your service. To help you understand what UDDI business
keys and service keys are, and where you find them in a UDDI registry, here
is a description of how to publish a web service to a UDDI registry.