Using the Operational Aggregate Policy

Learn how to group Operational Policies together into an Operational Aggregate Policy.

About Policies Managing Policies About Operational Policies

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

Table of Contents

  1. Introduction
  2. Creating an Aggregate Policy
  3. Configuring an Aggregate Policy
  4. Attaching the policy

Introduction

An Aggregate Policy is a collection of policies that are gathered together to form a policy group. Policies included in an Aggregate policy are defined to achieve a specific purpose relative to governing Policy Manager objects (Organizations, Services, and so on).

Some examples of scenarios where you might want to define an Aggregate Policy:

  • Basic Authentication: requires the HTTP Security policy and an Authentication policy.
  • Client Certificate: requires the HTTP Security policy and an Authentication policy.
  • A use case such as Using Binary Security Token with WS-Security Policy, where you're using an Authentication policy and a WS-Security Transport Binding policy.
  • Any scenario where you're using a WS-Security policy: requires an Authentication policy as well as the WS-Security policy.

back to top

Creating an Aggregate 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 an Aggregate Policy

An Aggregate Policy is a containment policy that allows you to create a logical grouping of Policy Manager policies. Essentially, you first create the aggregate policy, and then you add and configure each policy that you want to include in the aggregate policy.

Notes
  • Each policy must be configured as a separate entity.
  • Policies can be directly added to an Aggregate policy, and exist inside the logical grouping.
  • You can reference policies that have already been defined, from within the aggregate policy. In this scenario, the policies still display in their original location within Policy Manager but also display as part of the Aggregate policy.
  • An Aggregate policy can include both newly defined and existing (referenced) policies.
  • If you change a policy that's referenced by one or more Aggregate policies, the change applies to all instances of the policy—the original instance and every occurrence within an Aggregate policy.
  • You can attach the Aggregate Policy to objects such as services in the same way that you'd attach any other policy.
To define new policies in an Aggregate 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 click to go to the Details page for the policy.
  3. In the second panel, in the Policies section, click Add to add the first new policy.
  4. In the Select Policy Creation Option page, choose the policy type that you're adding and then click Next.
  5. Specify the policy name and then click Finish, then click Close.
  6. At the Details page for the policy you just added, click Modify. Configure the policy details as you normally would. The configuration options are different for each policy. For a full list of policies, with links to policy documentation details, see About Policies.
  7. In the left pane, click the Aggregate Policy. In the center pane, click Add to add a second policy. Repeat steps 4 through 7 as needed to add all the policies you need in your Aggregate policy.
To reference existing policies in an Aggregate 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 click to go to the Details page for the policy.
  3. In the second panel, in the Policy References section, click Modify to reference the first existing policy.
  4. In the Organization Tree that opens, check the boxes for one or more existing policies, and then click Apply. The policies are added to the Aggregate Policy.

back to top

Attaching the Policy

To use the Aggregate Policy, go to the Policies folder in the Root Organization and attach the policy to a web service, binding, or binding operation.

Back to top