- From: Toufic Boubez via cvs-syncmail <cvsmail@w3.org>
- Date: Mon, 25 Sep 2006 04:41:51 +0000
- To: public-ws-policy-eds@w3.org
Update of /sources/public/2006/ws/policy In directory hutz:/tmp/cvs-serv21308 Modified Files: ws-policy-primer.html ws-policy-primer.xml Log Message: Implemented editorial action http://www.w3.org/2005/06/tracker/wspolicyeds/actions/36 to insert a reference to the Security Considerations section from the Framework document. Index: ws-policy-primer.html =================================================================== RCS file: /sources/public/2006/ws/policy/ws-policy-primer.html,v retrieving revision 1.11 retrieving revision 1.12 diff -u -d -r1.11 -r1.12 --- ws-policy-primer.html 25 Sep 2006 04:14:03 -0000 1.11 +++ ws-policy-primer.html 25 Sep 2006 04:41:48 -0000 1.12 @@ -72,7 +72,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="#introduction">Introduction</a><br>2. <a href="#basic-concepts-policy-expression">Basic Concepts: Policy Expression</a><br> 2.1 <a href="#web-services-policy">Web Services Policy</a><br> 2.2 <a href="#simple-message">Simple Message</a><br> 2.3 <a href="#secure-message">Secure Message</a><br> 2.4 <a href="#other-assertions">Other Assertions</a><br> 2.5 <a href="#combining-policy-assertions">Combining Policy Assertions</a><br> 2.6 <a href="#optional-policy-assertion">Optional Policy Assertion</a><br> 2.7 <a href="#nested-policy-expressions">Nested Policy Expressions</a><br> 2.8 <a href="#Referencing_Policy_Expressions">Referencing Policy Expressions</a><br> 2.9 <a href="#attaching-policy-expressions-to-wsdl">Attaching Policy Expresions to WSDL</a><br> 2.10 <a href="#policy-automates-web-services-interaction">Policy Automates Web Services Interaction</a><br>3. <a href="#advanced-concepts-1-policy-expression">Advanced Concepts I: Policy Expression</a><br> 3.1 <a href="#policy-expression">Policy Expression</a><br> 3.2 <a href="#normal-form-for-policy-expressions">Normal Form for Policy Expressions</a><br> 3.3 <a href="#policy-data-model">Policy Data Model</a><br> 3.4 <a href="#compatible-policies">Compatible Policies</a><br> 3.5 <a href="#attaching-policy-expressions-to-wsdl2">Attaching Policy Expressions to WSDL</a><br> 3.6 <a href="#combine-policies">Combine Policies</a><br> 3.7 <a href="#extensibility-and-versioning">Extensibility and Versioning</a><br>4. <a href="#advanced-concepts-2-policy-assertion-design">Advanced Concepts II: Policy Assertion Desin</a><br> 4.1 <a href="#role-of-policy-assertions">Role of Policy Assertions</a><br> 4.2 <a href="#parts-of-a-policy-assertion">Parts of a Policy Assertion</a><br> 4.3 <a href="#when-to-design-policy-assertions">When to design policy assertions?</a><br> 4.3.1 <a href="#opt-in-behavior">Opt-in behavior</a><br> 4.3.2 <a href="#shared-behavior">Shared behavior</a><br> 4.3.3 <a href="#visible-behavior">Visible behavior</a><br> 4.4 <a href="#guidelines-for-designing-assertions">Guidelines for Designing Assertions</a><br> 4.4.1 <a href="#optional-behaviors">Optional Behaviors</a><br> 4.4.2 <a href="#assertion-vs-assertion-parameter">Assertion vs. assertion parameter</a><br> &bsp; 4.4.3 <a href="#leveraging-nested-policy">Leveraging Nested Policy</a><br> 4.4.4 <a href="#minimal-approach">Minimal approach</a><br> 4.4.5 <a href="#QName_and_XML_Information_Set_representation">QName and XML Information Set representation</a><br> 4.4.6 <a href="#Policy_subject_and_attachment_points">Policy subject and attachment points</a><br> 4.4.7 <a href="#versioning-behaviors">Versioning behaviors</a><br> 4.4.8 <a href="#N67888">Versioning Policy Language</a><br> 4.4.8.1 <a href="#N67920">Policy Framework</a><br> 4.4.8.2 <a href="#N68042">Policy Attachment</a><br> 4.5 <a href="#desribing-policy-assertions">Describing Policy Assertions</a><br>5. <a href="#conclusion">Conclusion</a><br></p> -<h3><a name="appendix" id="appendix">Appendices</a></h3><p class="toc">A. <a href="#xml-namespaces">XML Namespaces</a><br>B. <a href="#references">References</a><br>C. <a href="#acknowledgments">Acknowledgements</a> (Non-Normative)<br>D. <a href="#change-description">Changes in this Version of the Document</a> (Non-Normative)<br>E. <a href="#change-log">Web Services Policy 1.5 - Primer 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="#security-considerations">Security Considerations</a><br>B. <a href="#xml-namespaces">XML Namespaces</a><br>C. <a href="#references">References</a><br>D. <a href="#acknowledgments">Acknowledgements</a> (Non-Normative)<br>E. <a href="#change-description">Changes in this Version of the Document</a> (Non-Normative)<br>F. <a href="#change-log">Web Services Policy 1.5 - Primer Change Log</a> (Non-Normative)<br></p></div><hr><div class="body"> <div class="div1"> <h2><a name="introduction"></a>1. Introduction</h2> @@ -113,7 +113,7 @@ policy assertions, outlines guidelines for designing policy assertions and enumerates the minimum requirements for describing policy assertions in specifications.</p> <p>This is a non-normative document and does not provide a definitive specification of the Web - Services Policy language. <a href="#xml-namespaces"><b>A. XML Namespaces</b></a> lists all the that are used in + Services Policy language. <a href="#xml-namespaces"><b>B. XML Namespaces</b></a> lists all the that are used in this document. (XML elements without a namespace prefix are from the Web Services Policy XML Namespace.)</p> </div> @@ -179,7 +179,7 @@ <p>This message uses message addressing headers. The <code>wsa:To</code> and<code>wsa:Action</code> header blocks identify the destination and the semantics implied by this message respectively. (The prefix <code>wsa</code> is used here to denote - the Web Services Addressing XML Namespace. <a href="#xml-namespaces"><b>A. XML Namespaces</b></a> lists all the + the Web Services Addressing XML Namespace. <a href="#xml-namespaces"><b>B. XML Namespaces</b></a> lists all the and prefixes that are used in this document.)</p> <p>Let us look at a fictitious scenario used in this document to illustrate the features of the policy language. Tony is a Web service developer. He is building a client application @@ -1857,11 +1857,16 @@ <div class="back"> <div class="div1"> -<h2><a name="xml-namespaces"></a>A. XML Namespaces</h2> +<h2><a name="security-considerations"></a>A. Security Considerations</h2> + <p>Security considerations are discussed in the <cite><a href="#WS-Policy">Web Services Policy Framework</a></cite> document.</p> + </div> + <div class="div1"> + +<h2><a name="xml-namespaces"></a>B. XML Namespaces</h2> <p>The table below lists XML Namespaces that are used in this document. The choice of any namespace prefix is arbitrary and not semantically significant.</p> <a name="nsprefix"></a><table summary="Prefixes and XML Namespaces used in this specification" border="1" cellspacing="0" cellpadding="5"> - <caption>Table A-1. Prefixes and XML Namespaces used in this specification.</caption> + <caption>Table B-1. Prefixes and XML Namespaces used in this specification.</caption> <thead> <tr> <th rowspan="1" colspan="1">Prefix</th> @@ -1974,7 +1979,7 @@ </div> <div class="div1"> -<h2><a name="references"></a>B. References</h2> +<h2><a name="references"></a>C. References</h2> <dl> <dt class="label"><a name="MTOM"></a>[MTOM] </dt><dd> <cite><a href="http://www.w3.org/TR/2005/REC-soap12-mtom-20050125/">SOAP Message Transmission Optimization Mechanism</a></cite>, M. Gudgin, N. @@ -2058,7 +2063,7 @@ </div> <div class="div1"> -<h2><a name="acknowledgments"></a>C. Acknowledgements (Non-Normative)</h2> +<h2><a name="acknowledgments"></a>D. Acknowledgements (Non-Normative)</h2> <p>This document is the work of the <a href="http://www.w3.org/2002/ws/policy/">W3C Web Services Policy Working Group</a>.</p> @@ -2077,7 +2082,7 @@ </div> <div class="div1"> -<h2><a name="change-description"></a>D. Changes in this Version of the Document (Non-Normative)</h2> +<h2><a name="change-description"></a>E. Changes in this Version of the Document (Non-Normative)</h2> <p>A list of substantive changes since the previous publication is below:</p> <ul> <li><p>Replaced URI with IRI.</p></li> @@ -2085,7 +2090,7 @@ </div> <div class="div1"> -<h2><a name="change-log"></a>E. Web Services Policy 1.5 - Primer Change Log (Non-Normative)</h2> +<h2><a name="change-log"></a>F. Web Services Policy 1.5 - Primer Change Log (Non-Normative)</h2> <a name="ws-policy-primer-changelog-table"></a><table border="1"> <tbody> <tr> @@ -2125,6 +2130,14 @@ to move the Security Considerations section to the Framework document. </td> </tr> + <tr> + <td rowspan="1" colspan="1">20060924</td> + <td rowspan="1" colspan="1">TIB</td> + <td rowspan="1" colspan="1">Implemented the + <a href="http://www.w3.org/2005/06/tracker/wspolicyeds/actions/36">editorial action 36</a> + to insert a reference to the Security Considerations section from the Framework document. + </td> + </tr> </tbody> </table><br> Index: ws-policy-primer.xml =================================================================== RCS file: /sources/public/2006/ws/policy/ws-policy-primer.xml,v retrieving revision 1.8 retrieving revision 1.9 diff -u -d -r1.8 -r1.9 --- ws-policy-primer.xml 25 Sep 2006 04:14:03 -0000 1.8 +++ ws-policy-primer.xml 25 Sep 2006 04:41:48 -0000 1.9 @@ -1818,6 +1818,10 @@ </div1> </body> <back> + <div1 id="security-considerations"> + <head>Security Considerations</head> + <p>Security considerations are discussed in the <bibref ref="WS-Policy"/> document.</p> + </div1> <div1 id="xml-namespaces"> <head>XML Namespaces</head> <p>The table below lists XML Namespaces that are used in this document. The choice of any @@ -2092,6 +2096,14 @@ to move the Security Considerations section to the Framework document. </td> </tr> + <tr> + <td>20060924</td> + <td>TIB</td> + <td>Implemented the + <loc href="http://www.w3.org/2005/06/tracker/wspolicyeds/actions/36">editorial action 36</loc> + to insert a reference to the Security Considerations section from the Framework document. + </td> + </tr> </tbody> </table>
Received on Monday, 25 September 2006 04:42:00 UTC