Using the WS-Addressing Policy

Learn about the WS-Addressing Policy and policy configuration options.

For information about using policies in the context of the developer portal, see Business Policies.

Table of Contents

  1. About the WS-Addressing policy
  2. Creating a WS-Addressing policy
  3. Configuring a WS-Addressing policy
  4. WS-Addressing policy options
  5. Activating a policy
  6. Attaching a policy

About the WS-Addressing policy

The WS-Addressing Policy allows you to configure the type of SOAP response endpoints required for message processing. Two message types are supported: Anonymous and Non-Anonymous.

back to top

Creating a WS-Addressing policy

The first step in creating a policy is to define the basic policy information.

To add an operational policy

  1. Go to Workbench > Browse > Organization, and select Policies > Operational Policies. The Policies Summary is displayed.
  2. Click Add Policy.
  3. Choose the policy type and click Next.
  4. Specify a name (required) and description (optional) and click Finish. At the Completion Summary, click Close. The Add Policy Wizard creates a draft policy instance that you can then configure on the Policy Details page.

For more information, see Add Policy.

back to top

Configuring a WS-Addressing policy

Once you've created the policy, you can configure the policy options.

To configure a WS-addressing policy

  1. Go to Workbench > Browse > Organization and select the Policies > Operational Policies folder. The Policies Summary is displayed.
  2. Find the policy on the list and double-click to go to the Details page for the policy. An example is shown below.

  3. In the second section, click Modify to open the Modify wizard, as shown below.

  4. Specify values for the policy as needed. For information on the individual options, see WS-Addressing Policy Options below.
  5. Save the policy definition.

That completes the policy configuration. You can now assign the policy to a service.

back to top

WS-Addressing policy options

The Modify WS-Addressing Policy wizard has only one page, Specify WS-Addressing Policy Options. It includes the options listed below.

Support Anonymous Messages
This option allows anonymous endpoints to initiate message exchanges and receive replies. It is used by endpoints that cannot have a stable, resolvable URI. Therefore, a Response cannot be sent separately to a response endpoint and must be returned synchronously in the body of the response to the input message.
Support Non-Anonymous Messages
This option allows non-anonymous endpoints to initiate Message Exchanges and receive Replies. It is used by endpoints that have strict URI requirements based on selected WS-Addressing specifications. Response messages for IN-OUT exchanges will be sent to the specified endpoint. There will be no Body Content in the synchronous Response to the Input Message.
Supported Versions
Radio button options that allow you to select WS-Addressing specifications that are supported for the current WS-Addressing policy. Options include All and a list box that allows you to select specific WS-Addressing specifications.

back to top

Activating a policy

When you create and configure a policy, the policy is in Draft state. When the policy configuration is complete, activate the policy: click Activate Policy and then confirm. See Activate a Policy.

A policy in Draft state is not available for general use. Once you activate the policy, it is in Active state and is available for use.

Back to top

Attaching a policy

To use the policy, go to the Policies folder in the respective organization and attach the policy to a web service, binding, or binding operation.

Back to top