Services: Attaching existing mediation policies to services

Use the Mediation Policy Administration widget to attach existing mediation policies to service endpoints. Using mediation policies, you can control service interactions, using contextual information.

Before you begin

  1. Use IBM Integration Designer to create a module containing a Policy Resolution mediation primitive.
  2. Deploy the module to Process Server.
  3. Ensure that Process Server has a definition for the WSRR that you want to use.
  4. In WSRR, load the enterprise archive (EAR) file containing your module. Also, load the WSDL documents for the services that you want to attach mediation policies to.
  5. Create a business space that contains the administration widgets you need, including the Service Browser and Mediation Policy Administration widgets.

About this task

You can control service requests dynamically by using mediation policies to override module properties at run time. Such mediation policies are stored in WSRR. You can define one or more mediation policies for services used by your module, and each mediation policy can override one or more module properties. Optionally, you can create one or more gate conditions on each policy attachment. When service requests are processed, gate conditions are compared to the condition values in the message. All the gate conditions must be met before an associated mediation policy can be used.

Procedure

  1. Log in to your business space and navigate to the space that you created for administering services.
  2. From the Service Browser widget, if the correct WSRR definition is not displayed select the correct WSRR definition. If your application server has definitions for more than one instance of WSRR, you can display the services that are defined on each WSRR. The list of services is refreshed.
  3. Select the level at which you want to attach a mediation policy. You can attach a mediation policy at the level of the service, endpoint, or operation. The Mediation Policy Administration widget is refreshed. The following information is displayed:
    • The name of the service, endpoint, or operation that you selected.
    • The WSRR definition that you selected.
    • Any policy attachments that exist for the service, endpoint, or operation that you selected.
  4. Enter the name of the New policy attachment. Policy attachments associate a mediation policy with a target service. In WSRR, the mediation policy and the policy attachment are separate objects.
  5. Click Create The Mediation Policy Administration widget is refreshed. You can now specify the group of properties you want to work with, and the name of an existing mediation policy for that group.
  6. Select a Group name. Each group contains module properties. Select the group whose property values you want to override.
  7. Click Use existing.
  8. Select a mediation policy from the Select a policy menu. The mediation policies displayed depend on the group you selected. Because a target service might be called from different modules, the mediation policy associated with the target service might not affect the service request. A mediation policy can only affect a service request if the service, endpoint, or operation that you selected is called by an appropriate module. An appropriate module is one that has properties that the mediation policy can override.
  9. Click Next The Mediation Policy Administration widget is refreshed. You can now add gate conditions.
    Note: You cannot edit mediation policy assertions in a business space after you create a mediation policy. However, because gate conditions exist on the mediation policy attachment, you can add gate conditions when you create a new policy attachment.
  10. Optional: Define one or more gate conditions. Gate conditions must be met before the policy can be used. In WSRR, gate conditions are user properties on the policy attachment object.
    1. Enter a gate condition name in the Gate condition name field. The name of a gate condition is always prefixed with the string medGate_.
    2. Enter a gate condition value in the Value field. The gate condition value is made up of the following parts: policy condition name, operation and gate value.
      • The policy condition name you enter must map to a Policy condition name in the module.
      • The operation can be: = , != , > , < , <= or >= .
      • The gate value is the value being compared, for example, country = France.
    3. Click Add Gate Condition.
  11. Click Save.

Results

In WSRR, a policy attachment is created that associates the selected mediation policy with the selected service, endpoint, or operation.

The Mediation Policy Administration widget is refreshed, and the new policy attachment is added to the list of policy attachments.