C Schema Reference for Policy Sets

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

This chapter contains the following sections:

C.1 Graphical Representation

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

Figure C-1 Element Hierarchy of the Policy Set

Description of Figure C-1 follows
Description of "Figure C-1 Element Hierarchy of the Policy Set"

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

C.2 Element Descriptions

This section describes the policy set elements.

C.2.1 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 Figure C-1.

C.2.1.1 Attributes

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

Table C-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.

constraint

Supported expression identifying the run-time context to which the policy set applies. If this attribute is not specified, the policy set applies to all run-time contexts.


C.2.2 wsp:policyReference

Element used to associate a policy set with one or more policies. This element contains the following subelement:

C.2.2.1 Attributes

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

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

Attribute Description

URI

OWSM 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.


C.2.2.2 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 C-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>

C.2.3 orawsp:OverrideProperty

The <orawsp:OverrideProperty> element is used to specify a configuration override associated with a policy attachment in a policy set.

C.2.3.1 Example

<orawsp:OverrideProperty name="csf-key" value="orakey" />