W3C home > Mailing lists > Public > public-ws-policy-eds@w3.org > September 2006

2006/ws/policy ws-policy-framework.xml,1.39,1.40 ws-policy-framework.html,1.34,1.35

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
Message-Id: <E1GNcyS-0007Nr-QF@lionel-hutz.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) &lt;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>&nbsp;&nbsp;&nbsp;&nbsp;1.1 <a href="#Example">Example</a><br>2. <a href="#Notation_Terminilogy">Notations and Terminology</a><br>&nbsp;&nbsp;&nbsp;&nbsp;2.1 <a href="#Notational_Conventions">Notational Conventions</a><br>&nbsp;&nbsp;&nbsp;&nbsp;2.2 <a href="#Extensibility">Extensibility</a><br>&nbsp;&nbsp;&nbsp;&nbsp;2.3 <a href="#XML_Namespaces">XML Namespaces</a><br>&nbsp;&nbsp;&nbsp;&nbsp;2.4 <a href="#Terminology">Terminology</a><br>3. <a href="#Policy_Model">Policy Model</a><br>&nbsp;&nbsp;&nbsp;&nbsp;3.1 <a href="#rPolicy_Assertion">Policy Assertion</a><br>&nbsp;&nbsp;&nbsp;&nbsp;3.2 <a href="#rPolicy_Alternative">Policy Alternative</a><br>&nbsp;&nbsp;&nbsp;&nbsp;3.3 <a href="#rPolicy">Policy</a><br>&nbsp;&nbsp;&nbsp;&nbsp;3.4 <a href="#Web_services">Web services</a><br>4. <a href="#rPolicy_Expression">Policy Expression</a><br>&nbsp;&nbsp;&nbsp;&nbsp;4.1 <a href="#Normal_Form_Policy_Expression"Normal Form Policy Expression</a><br>&nbsp;&nbsp;&nbsp;&nbsp;4.2 <a href="#Policy_Identification">Policy Identification</a><br>&nbsp;&nbsp;&nbsp;&nbsp;4.3 <a href="#Compact_Policy_Expression">Compact Policy Expression</a><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;4.3.1 <a href="#Optional_Policy_Assertions">Optional Policy Assertions</a><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;4.3.2 <a href="#Policy_Assertion_Nesting">Policy Assertion Nesting</a><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;4.3.3 <a href="#Policy_Operators">Policy Operators</a><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;4.3.4 <a href="#Policy_Inclusion">Policy Inclusion</a><br>&nbsp;&nbsp;&nbsp;&nbsp;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>&nbsp;&nbsp;&nbsp;&nbsp;A.1 <a href="#Normative-References">Normative References</a><br>&nbsp;&nbsp;&nbsp;&nbsp;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>&nbsp;&nbsp;&nbsp;&nbsp;A.1 <a href="#Normative-References">Normative References</a><br>&nbsp;&nbsp;&nbsp;&nbsp;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) &lt;wsp:Policy
 &nbsp; &nbsp; &nbsp; &nbsp; 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) &lt;wsp:Policy
 &nbsp; &nbsp; &nbsp; &nbsp; xmlns:sp="http://schemas.xmlsoap.org/ws/2005/07/securitypolicy"
 &nbsp; &nbsp; &nbsp; &nbsp; xmlns:wsp="http://www.w3.org/@@@@/@@/ws-policy" &gt;
@@ -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>&lt;<em>Assertion</em> &hellip;&gt;
@@ -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

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 20:27:49 UTC