- From: Toufic Boubez via cvs-syncmail <cvsmail@w3.org>
- Date: Wed, 13 Sep 2006 22:12:52 +0000
- To: public-ws-policy-eds@w3.org
Update of /sources/public/2006/ws/policy
In directory hutz:/tmp/cvs-serv28324
Modified Files:
ws-policy-framework.xml ws-policy-framework.html
Log Message:
http://www.w3.org/2005/06/tracker/wspolicyeds/actions/31
Index: ws-policy-framework.xml
===================================================================
RCS file: /sources/public/2006/ws/policy/ws-policy-framework.xml,v
retrieving revision 1.39
retrieving revision 1.40
diff -u -d -r1.39 -r1.40
--- ws-policy-framework.xml 13 Sep 2006 17:30:03 -0000 1.39
+++ ws-policy-framework.xml 13 Sep 2006 22:12:49 -0000 1.40
@@ -422,7 +422,8 @@
<p>Assertions within an alternative are not ordered, and
thus aspects such as the order in which behaviors
(indicated by assertions) are applied to a <termref def='policy_subject'>subject</termref> are
- beyond the scope of this specification. </p>
+ beyond the scope of this specification.
+ However, domain authors can write assertions that control the order in which behaviours are applied.</p>
<p>A policy alternative <rfc2119>MAY</rfc2119> contain multiple assertions of
the same type. Mechanisms for determining the aggregate
@@ -573,7 +574,7 @@
contain at most one policy alternative (see <specref ref='Policy_Assertion_Nesting' />).</p>
<p>To simplify processing and improve interoperability, the normal
-form of a policy expression should be used where practical.</p>
+ form of a policy expression <rfc2119>SHOULD</rfc2119> be used where practical.</p>
<p>For example, the following is the normal form of the policy expression example introduced earlier (see <specref ref='Example' />).</p>
<eg xml:space="preserve">(01) <wsp:Policy
@@ -1705,6 +1706,13 @@
<loc href="http://www.w3.org/2005/06/tracker/wspolicyeds/actions/8">8</loc>.
</td>
</tr>
+ <tr>
+ <td>20060913</td>
+ <td>TIB</td>
+ <td>Completed action item:
+ <loc href="http://www.w3.org/2005/06/tracker/wspolicyeds/actions/31">31</loc>.
+ </td>
+ </tr>
</tbody>
</table>
</inform-div1>
Index: ws-policy-framework.html
===================================================================
RCS file: /sources/public/2006/ws/policy/ws-policy-framework.html,v
retrieving revision 1.34
retrieving revision 1.35
diff -u -d -r1.34 -r1.35
--- ws-policy-framework.html 12 Sep 2006 22:14:03 -0000 1.34
+++ ws-policy-framework.html 13 Sep 2006 22:12:49 -0000 1.35
@@ -1,4 +1,4 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
<html lang="en-US"><head><META http-equiv="Content-Type" content="text/html; charset=utf-8"><title>Web Services Policy 1.5 - Framework</title><style type="text/css">
code { font-family: monospace; }
@@ -47,7 +47,7 @@
div.exampleWrapper { margin: 4px }
div.exampleHeader { font-weight: bold;
margin: 4px}
-</style><link type="text/css" rel="stylesheet" href="http://www.w3.org/StyleSheets/TR/base.css"><link href="#contents" rel="contents"></head><body>
+</style><link rel="stylesheet" type="text/css" href="http://www.w3.org/StyleSheets/TR/base.css"><link rel="contents" href="#contents"></head><body>
<div class="head">
<h1>Web Services Policy 1.5 - Framework</h1>
<h2>Editors' copy $Date$ @@ @@@@ @@@@</h2><dl><dt>This version:</dt><dd>
@@ -73,7 +73,7 @@
no official standing.</strong></p><p></p></div>
<hr><div class="toc">
<h2><a name="contents">Table of Contents</a></h2><p class="toc">1. <a href="#tocRange">Introduction</a><br> 1.1 <a href="#Example">Example</a><br>2. <a href="#Notation_Terminilogy">Notations and Terminology</a><br> 2.1 <a href="#Notational_Conventions">Notational Conventions</a><br> 2.2 <a href="#Extensibility">Extensibility</a><br> 2.3 <a href="#XML_Namespaces">XML Namespaces</a><br> 2.4 <a href="#Terminology">Terminology</a><br>3. <a href="#Policy_Model">Policy Model</a><br> 3.1 <a href="#rPolicy_Assertion">Policy Assertion</a><br> 3.2 <a href="#rPolicy_Alternative">Policy Alternative</a><br> 3.3 <a href="#rPolicy">Policy</a><br> 3.4 <a href="#Web_services">Web services</a><br>4. <a href="#rPolicy_Expression">Policy Expression</a><br> 4.1 <a href="#Normal_Form_Policy_Expression"Normal Form Policy Expression</a><br> 4.2 <a href="#Policy_Identification">Policy Identification</a><br> 4.3 <a href="#Compact_Policy_Expression">Compact Policy Expression</a><br> 4.3.1 <a href="#Optional_Policy_Assertions">Optional Policy Assertions</a><br> 4.3.2 <a href="#Policy_Assertion_Nesting">Policy Assertion Nesting</a><br> 4.3.3 <a href="#Policy_Operators">Policy Operators</a><br> 4.3.4 <a href="#Policy_Inclusion">Policy Inclusion</a><br> 4.4 <a href="#Policy_Intersection">Policy Intersection</a><br>5. <a href="#Security_Considerations">Security Considerations</a><br>6. <a href="#Conformance">Conformance</a><br></p>
-<h3><a id="appendix" name="appendix">Appendices</a></h3><p class="toc">A. <a href="#References">References</a><br> A.1 <a href="#Normative-References">Normative References</a><br> A.2 <a href="#Informative-References">Other References</a><br>B. <a href="#acknowledgments">Acknowledgements</a> (Non-Normative)<br>C. <a href="#change-description">Changes in this Version of the Document</a> (Non-Normative)<br>D. <a href="#change-log">Web Services Policy 1.5 - Framework Change Log</a> (Non-Normative)<br></p></div><hr><div class="body">
+<h3><a name="appendix" id="appendix">Appendices</a></h3><p class="toc">A. <a href="#References">References</a><br> A.1 <a href="#Normative-References">Normative References</a><br> A.2 <a href="#Informative-References">Other References</a><br>B. <a href="#acknowledgments">Acknowledgements</a> (Non-Normative)<br>C. <a href="#change-description">Changes in this Version of the Document</a> (Non-Normative)<br>D. <a href="#change-log">Web Services Policy 1.5 - Framework Change Log</a> (Non-Normative)<br></p></div><hr><div class="body">
<div class="div1">
<h2><a name="tocRange"></a>1. Introduction</h2>
@@ -83,13 +83,13 @@
entities in a Web services-based system.
</p>
- <p>[<a title="policy" name="policy">Definition</a>: A <b>policy</b> is a collection of
+ <p>[<a name="policy" title="policy">Definition</a>: A <b>policy</b> is a collection of
<a title="policy alternative" href="#policy_alternative">policy alternatives</a>, ]
- where [<a title="policy alternative" name="policy_alternative">Definition</a>: a <b>policy alternative</b>
+ where [<a name="policy_alternative" title="policy alternative">Definition</a>: a <b>policy alternative</b>
is a collection of <a title="policy assertion" href="#policy_assertion">policy assertions</a>.]
- [<a title="policy assertion" name="policy_assertion">Definition</a>: A <b>policy assertion</b>
+ [<a name="policy_assertion" title="policy assertion">Definition</a>: A <b>policy assertion</b>
represents an individual requirement, capability, or other property of a behavior.]
- [<a title="policy expression" name="policy_expression">Definition</a>: A <b>policy expression</b>
+ [<a name="policy_expression" title="policy expression">Definition</a>: A <b>policy expression</b>
is an XML Infoset representation of a <a title="policy" href="#policy">policy</a>,
either in a normal form or in an equivalent compact form.] Some policy assertions
specify traditional requirements and capabilities that
@@ -103,12 +103,12 @@
<p>Web Services Policy 1.5 - Framework does not specify policy discovery or
<a title="policy attachment" href="#policy_attachment">policy attachment</a>.
- [<a title="policy attachment" name="policy_attachment">Definition</a>: A
+ [<a name="policy_attachment" title="policy attachment">Definition</a>: A
<b>policy attachment</b> is a mechanism for associating
<a title="policy" href="#policy">policy</a> with one or more <a title="policy scope" href="#policy_scope">policy scopes</a>.]
- [<a title="policy scope" name="policy_scope">Definition</a>: A <b>policy scope</b> is a collection of
+ [<a name="policy_scope" title="policy scope">Definition</a>: A <b>policy scope</b> is a collection of
<a title="policy subject" href="#policy_subject">policy subjects</a> to which a policy may apply.]
- [<a title="policy subject" name="policy_subject">Definition</a>: A <b>policy subject</b> is an entity
+ [<a name="policy_subject" title="policy subject">Definition</a>: A <b>policy subject</b> is an entity
(e.g., an endpoint, message, resource, interaction) with which a
<a title="policy" href="#policy">policy</a> can be associated. ]
@@ -128,7 +128,7 @@
assertions defined in WS-SecurityPolicy [<cite><a href="#WS-SecurityPolicy">WS-SecurityPolicy</a></cite>]:</p>
<div class="exampleOuter">
- <p class="exampleHead" style="text-align: left"><i><span>Example 1-1. </span>Use of Web Services Policy with security policy assertions.</i></p>
+ <p style="text-align: left" class="exampleHead"><i><span>Example 1-1. </span>Use of Web Services Policy with security policy assertions.</i></p>
<div class="exampleInner"><pre>
(01) <wsp:Policy
xmlns:sp="http://schemas.xmlsoap.org/ws/2005/07/securitypolicy"
@@ -327,8 +327,7 @@
</p>
<p>We introduce the following terms that are used throughout this document:</p>
-
-<dl><dt class="label"><a href="#nested_policy_expression">nested policy expression</a></dt><dd><p>A <b>nested policy expression</b> is a <a title="policy expression" href="#policy_expression">policy expression</a> that is an Element Information Item in the <strong>[children]</strong> property of a <a title="policy assertion" href="#policy_assertion">policy assertion</a>.</p></dd><dt class="label"><a href="#policy">policy</a></dt><dd><p>A <b>policy</b> is a collection of
+ <dl><dt class="label"><a href="#nested_policy_expression">nested policy expression</a></dt><dd><p>A <b>nested policy expression</b> is a <a title="policy expression" href="#policy_expression">policy expression</a> that is an Element Information Item in the <strong>[children]</strong> property of a <a title="policy assertion" href="#policy_assertion">policy assertion</a>.</p></dd><dt class="label"><a href="#policy">policy</a></dt><dd><p>A <b>policy</b> is a collection of
<a title="policy alternative" href="#policy_alternative">policy alternatives</a>, </p></dd><dt class="label"><a href="#policy_alternative">policy alternative</a></dt><dd><p>a <b>policy alternative</b>
is a collection of <a title="policy assertion" href="#policy_assertion">policy assertions</a>.</p></dd><dt class="label"><a href="#policy_assertion">policy assertion</a></dt><dd><p>A <b>policy assertion</b>
represents an individual requirement, capability, or other property of a behavior.</p></dd><dt class="label"><a href="#policy_assertion_parameter">policy assertion parameter</a></dt><dd><p>A <b>policy assertion parameter</b>
@@ -367,7 +366,7 @@
type</a> is identified only by the XML Infoset <strong>[namespace name]</strong> and <strong>[local name]</strong> properties (that
is, the qualified name or QName) of the root Element
Information Item representing the assertion.
- [<a title="policy assertion type" name="policy_assertion_type">Definition</a>: A <b>policy assertion type</b>
+ [<a name="policy_assertion_type" title="policy assertion type">Definition</a>: A <b>policy assertion type</b>
represents a class of <a title="policy assertion" href="#policy_assertion">policy assertions</a> and implies a
schema for the assertion and assertion-specific semantics.]
Assertions of
@@ -386,7 +385,7 @@
<p>The XML Infoset of a <a title="policy assertion" href="#policy_assertion">policy assertion</a> <span class="rfc2119">MAY</span> contain a non-empty <strong>[attributes]</strong> property and/or a non-empty <strong>[children]</strong>
property. Such content <span class="rfc2119">MAY</span> be used to parameterize the
behavior indicated by the assertion.
- [<a title="policy assertion parameter" name="policy_assertion_parameter">Definition</a>: A <b>policy assertion parameter</b>
+ [<a name="policy_assertion_parameter" title="policy assertion parameter">Definition</a>: A <b>policy assertion parameter</b>
qualifies the behavior indicated by a <a title="policy assertion" href="#policy_assertion">policy assertion</a>.]
For example, an
assertion identifying support for a specific reliable
@@ -418,7 +417,7 @@
<p>The vocabulary of a policy alternative is the set of
all <a title="policy assertion type" href="#policy_assertion_type">policy assertion
types</a> within the alternative.
- [<a title="policy vocabulary" name="policy_vocabulary">Definition</a>: A <b>policy vocabulary</b> is the set of all
+ [<a name="policy_vocabulary" title="policy vocabulary">Definition</a>: A <b>policy vocabulary</b> is the set of all
<a title="policy assertion type" href="#policy_assertion_type">policy assertion types</a> used in a policy.]
An assertion whose type
is part of the policy's vocabulary but is not included in
@@ -428,7 +427,8 @@
<p>Assertions within an alternative are not ordered, and
thus aspects such as the order in which behaviors
(indicated by assertions) are applied to a <a title="policy subject" href="#policy_subject">subject</a> are
- beyond the scope of this specification. </p>
+ beyond the scope of this specification.
+ However, domain authors can write assertions that control the order in which behaviours are applied.</p>
<p>A policy alternative <span class="rfc2119">MAY</span> contain multiple assertions of
the same type. Mechanisms for determining the aggregate
@@ -442,7 +442,7 @@
<h3><a name="rPolicy"></a>3.3 Policy</h3>
- <p>At the abstract level a <a title="policy" href="#policy">policy</a> is a potentially empty
+ <p>A <a title="policy" href="#policy">policy</a> is a potentially empty
collection of <a title="policy alternative" href="#policy_alternative">policy
alternatives</a>. A policy with zero alternatives
contains no choices; a policy with one or more
@@ -572,12 +572,12 @@
<p>If an <a title="policy assertion" href="#policy_assertion">assertion</a> in the
normal form of a policy expression contains a <a title="nested policy expression" href="#nested_policy_expression">nested policy
expression</a>, the nested policy expression <span class="rfc2119">MUST</span>
-contain at most one policy alternative.</p>
+ contain at most one policy alternative (see <a href="#Policy_Assertion_Nesting"><b>4.3.2 Policy Assertion Nesting</b></a>).</p>
<p>To simplify processing and improve interoperability, the normal
-form of a policy expression should be used where practical.</p>
+ form of a policy expression <span class="rfc2119">SHOULD</span> be used where practical.</p>
-<p>For example, the following is the normal form of the policy expression example introduced earlier.</p>
+ <p>For example, the following is the normal form of the policy expression example introduced earlier (see <a href="#Example"><b>1.1 Example</b></a>).</p>
<div class="exampleInner"><pre>(01) <wsp:Policy
xmlns:sp="http://schemas.xmlsoap.org/ws/2005/07/securitypolicy"
xmlns:wsp="http://www.w3.org/@@@@/@@/ws-policy" >
@@ -759,7 +759,7 @@
<h4><a name="Policy_Assertion_Nesting"></a>4.3.2 Policy Assertion Nesting</h4>
<p>Any <a title="policy assertion" href="#policy_assertion">policy assertion</a>
-<span class="rfc2119">MAY</span> contain a <a title="policy expression" href="#policy_expression">policy expression</a>. [<a title="nested policy expression" name="nested_policy_expression">Definition</a>: A <b>nested policy expression</b> is a <a title="policy expression" href="#policy_expression">policy expression</a> that is an Element Information Item in the <strong>[children]</strong> property of a <a title="policy assertion" href="#policy_assertion">policy assertion</a>.] The schema
+<span class="rfc2119">MAY</span> contain a <a title="policy expression" href="#policy_expression">policy expression</a>. [<a name="nested_policy_expression" title="nested policy expression">Definition</a>: A <b>nested policy expression</b> is a <a title="policy expression" href="#policy_expression">policy expression</a> that is an Element Information Item in the <strong>[children]</strong> property of a <a title="policy assertion" href="#policy_assertion">policy assertion</a>.] The schema
outline for a <a title="nested policy expression" href="#nested_policy_expression">nested policy expression</a> is:</p>
<div class="exampleInner"><pre><<em>Assertion</em> …>
@@ -800,9 +800,9 @@
normalized recursively. The nesting of a policy expression (and a
<code class="elt">wsp:Policy</code> child) is retained in the normal form, but in
the normal form, each nested policy expression contains at most one
-policy alternative. If an assertion A contains a nested policy
-expression E, and if E contains more than one policy alternative, A is
-duplicated such that there are as many instances of A as choices in E,
+policy alternative. If an assertion A contains a nested policy
+expression E, and if E contains more than one policy alternative,
+A is duplicated such that there are as many instances of A as choices in E,
and the nested policy expression of a duplicate A contains a single
choice. This process is applied recursively to the assertions within
those choices and to their nested policy expression, if
@@ -1700,6 +1700,20 @@
<a href="http://www.w3.org/2005/06/tracker/wspolicyeds/actions/6">6</a>.
</td>
</tr>
+ <tr>
+ <td rowspan="1" colspan="1">20060913</td>
+ <td rowspan="1" colspan="1">TIB</td>
+ <td rowspan="1" colspan="1">Completed action item:
+ <a href="http://www.w3.org/2005/06/tracker/wspolicyeds/actions/8">8</a>.
+ </td>
+ </tr>
+ <tr>
+ <td rowspan="1" colspan="1">20060913</td>
+ <td rowspan="1" colspan="1">TIB</td>
+ <td rowspan="1" colspan="1">Completed action item:
+ <a href="http://www.w3.org/2005/06/tracker/wspolicyeds/actions/31">31</a>.
+ </td>
+ </tr>
</tbody>
</table><br>
</div>
Received on Wednesday, 13 September 2006 22:13:05 UTC