E Schema Reference for Policy Sets

This appendix provides the XML schema for reference when creating a policy set file. Sections include:

• Graphical Representation

• Element Descriptions

• Example

Graphical Representation

The following graphic describes the element hierarchy of the policy set document.

Figure E-1 Element Hierarchy of the Policy Set

Description of "Figure E-1 Element Hierarchy of the Policy Set"

The following sections describe each element and their attributes in more detail.

Element Descriptions

This section describes the policy set elements.

policySet

A policy set is used to define a set of concrete policies that apply to some binding type or implementation type. Physically, a policy set is expressed as an XML element using the pseudo-schema shown in Example E-1.

Attributes

The following section summarizes the policy set attributes, including the Oracle extensions.

Table E-1 Attributes of Policy Set Element

Attribute	Description
name	Name of the policy set.
appliesTo	Supported expression identifying an element to which the policy set applies. This attribute must contain a value to be considered valid.
attachTo	Supported expression identifying an element to which the policy set is attached. This attribute must contain a value to be considered valid.
description	Description for the policy set. This name is used when the policy set is displayed in a user interface.
status	Indicates if a policy set is available for use. When set to enabled (the default), the policy set is processed normally. When set to disabled, the policy set is ignored during processing. This attribute is automatically set to disabled if the policy set fails validation when written to the repository.

wsp:policyReference

Element used to associate a policy set with one or more policies.

Attributes

The following table summarizes the attributes of the <wsp:policyReference> element.

Table E-2 Attributes of <wsp:policyReference> Element

Attribute	Description
URI	Oracle WSM policy URI to be associated with the policy set.
category	Category of the policy. Valid values include: security, mtom, wsrm, addressing, and management.
status	Status of the policy reference. Valid values include: enabled and disabled.

Example

The following example illustrates a sample policy set that attaches a username token policy to all non-SCA web services in an application whose name begins with the text "CRM" in a domain named "base_domain".

Example E-1 Sample policySet Element

<policySet name="non_sca_web_service_policyset"
           appliesTo="WS_Service()"
           attachTo="Domain('base_domain') and Application('CRM*')"
           orawsp:description="Default policy for a non-SCA web service"
           orawsp:status="enabled"
           xmlns="http://docs.oasis-open.org/ns/opensca/sca/200903"
           xmlns:orawsp="http://schemas.oracle.com/ws/2006/01/policy"
           xmlns:wsp="http://www.w3.org/ns/ws-policy">
    <wsp:PolicyReference
        wsp:URI="oracle/wss_username_token_service_policy"
        orawsp:category="security"
        orawsp:status="enabled" />
</policySet>