- From: Asir Vedamuthu via cvs-syncmail <cvsmail@w3.org>
- Date: Sat, 19 Aug 2006 01:15:49 +0000
- To: public-ws-policy-eds@w3.org
Update of /sources/public/2006/ws/policy In directory hutz:/tmp/cvs-serv10876 Modified Files: ws-policy.xsd ws-policy-framework.xml ws-policy-framework.html ws-policy-attachment.html ws-policy-attachment.xml Log Message: Framework: Implemented the resolution for issue 3560. XML Schema Document: Added xml:id. Attachment: Fixed a typo. Index: ws-policy-framework.xml =================================================================== RCS file: /sources/public/2006/ws/policy/ws-policy-framework.xml,v retrieving revision 1.23 retrieving revision 1.24 diff -u -d -r1.23 -r1.24 --- ws-policy-framework.xml 14 Aug 2006 00:10:44 -0000 1.23 +++ ws-policy-framework.xml 19 Aug 2006 01:15:46 -0000 1.24 @@ -611,7 +611,7 @@ for attributes to associate a URI is as follows:</p> <eg xml:space="preserve"><wsp:Policy ( Name="<emph>xs:anyURI</emph>" )? - ( wsu:Id="<emph>xs:ID</emph>" )? + ( wsu:Id="<emph>xs:ID</emph>" | xml:id="<emph>xs:ID</emph>" )? … > … </wsp:Policy></eg> @@ -626,12 +626,18 @@ ref="WS-PolicyAttachment"/>]. </p></def> </gitem> <gitem> -<label><att>/wsp:Policy/@wsu:Id</att></label> +<label><att>/wsp:Policy/{@wsu:Id | @xml:id}</att></label> <def><p>The identity of the policy expression as an <code>ID</code> within the enclosing XML document. If omitted, there is no implied value. To refer to this policy expression, a URI-reference <rfc2119>MAY</rfc2119> be formed using this value per Section 4.2 of -WS-Security [<bibref ref="WS-Security" />].</p></def> + WS-Security [<bibref ref="WS-Security" />] when @wsu:Id is used.</p> + <p>The use of <code>xml:id</code> attribute in conjunction with Canonical XML 1.0 is + inappropriate as described in Appendix C of xml:id Version 1.0 [<bibref ref="XMLID" />] + and thus this combination must be avoided (see [<bibref ref="C14NNOTE"/>]). For example, + a policy expression identified using <code>xml:id</code> attribute should not be signed + using XML Digital Signature when Canonical XML 1.0 is being used as + the canonicalization method.</p></def> </gitem> </glist> @@ -1310,6 +1316,16 @@ href="http://www.w3.org/TR/REC-xml/">latest version of XML 1.0</loc> is available at http://www.w3.org/TR/REC-xml. </bibl> + <bibl id='XMLID' key='XML ID' href='http://www.w3.org/TR/2005/REC-xml-id-20050909/'> + <titleref>xml:id Version 1.0</titleref>, + J. Marsh, D. Veillard and N. Walsh, Editors. World Wide Web Consortium, + 9 September 2005. This version of + the xml:id Version 1.0 Recommendation is + http://www.w3.org/TR/2005/REC-xml-id-20050909/. The + <loc href='http://www.w3.org/TR/xml-id/'>latest + version of xml:id Version 1.0</loc> is available at + http://www.w3.org/TR/xml-id/. + </bibl> <bibl id='XMLInfoset' key='XML Information Set' href='http://www.w3.org/TR/2004/REC-xml-infoset-20040204/'> <titleref>XML Information Set (Second Edition)</titleref>, J. Cowan and R. Tobin, Editors. World Wide Web Consortium, @@ -1359,6 +1375,13 @@ <div2 id='Informative-References'> <head>Other References</head> <blist> + <bibl id="C14NNOTE" key="C14N 1.0 Note" + href="http://www.w3.org/2006/04/c14n-note/c14n-note.html"> + <titleref>Known Issues with Canonical XML 1.0 (C14N/1.0)</titleref>, + J. Kahan and K. Lanz, Editors. World Wide Web + Consortium, 17 August 2006. + Available at http://www.w3.org/2006/04/c14n-note/c14n-note.html. + </bibl> <bibl id="SOAP11" key="SOAP 1.1" href="http://www.w3.org/TR/2000/NOTE-SOAP-20000508/"> <titleref>Simple Object Access Protocol (SOAP) @@ -1565,7 +1588,16 @@ <td>Added a new Section <specref ref="change-description"/> (that provides a list of substantive chanages since the previous publication). </td> - </tr> + </tr> + <tr> + <td>20060818</td> + <td>ASV</td> + <td>Implemented the + <loc href="http://www.w3.org/2006/08/16-ws-policy-minutes.html#action10">resolution</loc> + for issue + <loc href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=3560">3560</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.20 retrieving revision 1.21 diff -u -d -r1.20 -r1.21 --- ws-policy-framework.html 16 Aug 2006 18:21:13 -0000 1.20 +++ ws-policy-framework.html 19 Aug 2006 01:15:46 -0000 1.21 @@ -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 rel="stylesheet" type="text/css" href="http://www.w3.org/StyleSheets/TR/base.css"><link rel="contents" href="#contents"></head><body> +</style><link type="text/css" rel="stylesheet" href="http://www.w3.org/StyleSheets/TR/base.css"><link href="#contents" rel="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="#Goals">Goals</a><br> 1.2 <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> &nbs; 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></p> -<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"> +<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"> <div class="div1"> <h2><a name="tocRange"></a>1. Introduction</h2> @@ -85,11 +85,11 @@ model for the expression of these properties as policies.</p> - <p>[<a name="policy" title="policy">Definition</a>: A <b>policy</b> is a collection of + <p>[<a title="policy" name="policy">Definition</a>: A <b>policy</b> is a collection of <a title="policy alternative" href="#policy_alternative">policy alternatives</a>, ] - where [<a name="policy_alternative" title="policy alternative">Definition</a>: a <b>policy alternative</b> + where [<a title="policy alternative" name="policy_alternative">Definition</a>: a <b>policy alternative</b> is a collection of <a title="policy assertion" href="#policy_assertion">policy assertions</a>.] - [<a name="policy_assertion" title="policy assertion">Definition</a>: A <b>policy assertion</b> + [<a title="policy assertion" name="policy_assertion">Definition</a>: A <b>policy assertion</b> represents an individual requirement, capability, or other property of a behavior.] 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 name="policy_attachment" title="policy attachment">Definition</a>: A + [<a title="policy attachment" name="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 name="policy_scope" title="policy scope">Definition</a>: A <b>policy scope</b> is a collection of + [<a title="policy scope" name="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 name="policy_subject" title="policy subject">Definition</a>: A <b>policy subject</b> is an entity + [<a title="policy subject" name="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. ] @@ -134,7 +134,7 @@ <p> An XML Infoset called a <a title="policy expression" href="#policy_expression">policy expression</a> that contains domain-specific, Web - Service policy information. [<a name="policy_expression" title="policy expression">Definition</a>: A <b>policy expression</b> + Service policy information. [<a title="policy expression" name="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. ]</p></li> @@ -155,7 +155,7 @@ assertions defined in WS-SecurityPolicy [<cite><a href="#WS-SecurityPolicy">WS-SecurityPolicy</a></cite>]:</p> <div class="exampleOuter"> - <p style="text-align: left" class="exampleHead"><i><span>Example 1-1. </span>Use of Web Services Policy with security policy assertions.</i></p> + <p class="exampleHead" style="text-align: left"><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" @@ -365,7 +365,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 name="policy_assertion_type" title="policy assertion type">Definition</a>: A <b>policy assertion type</b> + [<a title="policy assertion type" name="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 @@ -385,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 name="policy_assertion_parameter" title="policy assertion parameter">Definition</a>: A <b>policy assertion parameter</b> + [<a title="policy assertion parameter" name="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 @@ -417,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 name="policy_vocabulary" title="policy vocabulary">Definition</a>: A <b>policy vocabulary</b> is the set of all + [<a title="policy vocabulary" name="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 @@ -597,7 +597,7 @@ for attributes to associate a URI is as follows:</p> <div class="exampleInner"><pre><wsp:Policy ( Name="<em>xs:anyURI</em>" )? - ( wsu:Id="<em>xs:ID</em>" )? + ( wsu:Id="<em>xs:ID</em>" | xml:id="<em>xs:ID</em>" )? … > … </wsp:Policy></pre></div> @@ -610,12 +610,18 @@ those defined in WS-PolicyAttachment [<cite><a href="#WS-PolicyAttachment">Web Services Policy Attachment</a></cite>]. </p></dd> -<dt class="label"><code class="attr">/wsp:Policy/@wsu:Id</code> </dt> +<dt class="label"><code class="attr">/wsp:Policy/{@wsu:Id | @xml:id}</code> </dt> <dd><p>The identity of the policy expression as an <code>ID</code> within the enclosing XML document. If omitted, there is no implied value. To refer to this policy expression, a URI-reference <span class="rfc2119">MAY</span> be formed using this value per Section 4.2 of -WS-Security [<cite><a href="#WS-Security">WS-Security 2004</a></cite>].</p></dd> + WS-Security [<cite><a href="#WS-Security">WS-Security 2004</a></cite>] when @wsu:Id is used.</p> + <p>The use of <code>xml:id</code> attribute in conjunction with Canonical XML 1.0 is + inappropriate as described in Appendix C of xml:id Version 1.0 [<cite><a href="#XMLID">XML ID</a></cite>] + and thus this combination must be avoided (see [<cite><a href="#C14NNOTE">C14N 1.0 Note</a></cite>]). For example, + a policy expression identified using <code>xml:id</code> attribute should not be signed + using XML Digital Signature when Canonical XML 1.0 is being used as + the canonicalization method.</p></dd> </dl> @@ -1289,6 +1295,16 @@ http://www.w3.org/TR/2004/REC-xml-20040204. The <a href="http://www.w3.org/TR/REC-xml/">latest version of XML 1.0</a> is available at http://www.w3.org/TR/REC-xml. </dd> + <dt class="label"><a name="XMLID"></a>[XML ID] </dt><dd> + <cite><a href="http://www.w3.org/TR/2005/REC-xml-id-20050909/">xml:id Version 1.0</a></cite>, + J. Marsh, D. Veillard and N. Walsh, Editors. World Wide Web Consortium, + 9 September 2005. This version of + the xml:id Version 1.0 Recommendation is + http://www.w3.org/TR/2005/REC-xml-id-20050909/. The + <a href="http://www.w3.org/TR/xml-id/">latest + version of xml:id Version 1.0</a> is available at + http://www.w3.org/TR/xml-id/. + </dd> <dt class="label"><a name="XMLInfoset"></a>[XML Information Set] </dt><dd> <cite><a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204/">XML Information Set (Second Edition)</a></cite>, J. Cowan and R. Tobin, Editors. World Wide Web Consortium, @@ -1335,6 +1351,12 @@ <h3><a name="Informative-References"></a>A.2 Other References</h3> <dl> + <dt class="label"><a name="C14NNOTE"></a>[C14N 1.0 Note] </dt><dd> + <cite><a href="http://www.w3.org/2006/04/c14n-note/c14n-note.html">Known Issues with Canonical XML 1.0 (C14N/1.0)</a></cite>, + J. Kahan and K. Lanz, Editors. World Wide Web + Consortium, 17 August 2006. + Available at http://www.w3.org/2006/04/c14n-note/c14n-note.html. + </dd> <dt class="label"><a name="SOAP11"></a>[SOAP 1.1] </dt><dd> <cite><a href="http://www.w3.org/TR/2000/NOTE-SOAP-20000508/">Simple Object Access Protocol (SOAP) 1.1</a></cite>, D. Box, et al, Editors. World Wide Web @@ -1551,7 +1573,16 @@ <td rowspan="1" colspan="1">Added a new Section <a href="#change-description"><b>C. Changes in this Version of the Document</b></a> (that provides a list of substantive chanages since the previous publication). </td> - </tr> + </tr> + <tr> + <td rowspan="1" colspan="1">20060818</td> + <td rowspan="1" colspan="1">ASV</td> + <td rowspan="1" colspan="1">Implemented the + <a href="http://www.w3.org/2006/08/16-ws-policy-minutes.html#action10">resolution</a> + for issue + <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=3560">3560</a>. + </td> + </tr> </tbody> </table><br> </div> Index: ws-policy-attachment.xml =================================================================== RCS file: /sources/public/2006/ws/policy/ws-policy-attachment.xml,v retrieving revision 1.25 retrieving revision 1.26 diff -u -d -r1.25 -r1.26 --- ws-policy-attachment.xml 14 Aug 2006 00:10:44 -0000 1.25 +++ ws-policy-attachment.xml 19 Aug 2006 01:15:46 -0000 1.26 @@ -726,7 +726,7 @@ <p>(This graphic is also available in SVG format <loc href="effective-policy-scope.svg">here</loc>.)</p> <p>When attaching policies at different levels of the WSDL hierarchy, care must be taken. -A message <rfc2119>MAY</rfc2119> be described by the +A message exchange with a deployed endpoint <rfc2119>MAY</rfc2119> be described by the <termref def='effective_policy'>effective policies</termref> in all four subject types simultaneously.</p> Index: ws-policy-attachment.html =================================================================== RCS file: /sources/public/2006/ws/policy/ws-policy-attachment.html,v retrieving revision 1.30 retrieving revision 1.31 diff -u -d -r1.30 -r1.31 --- ws-policy-attachment.html 16 Aug 2006 18:21:13 -0000 1.30 +++ ws-policy-attachment.html 19 Aug 2006 01:15:46 -0000 1.31 @@ -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 - Attachment</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 rel="stylesheet" type="text/css" href="http://www.w3.org/StyleSheets/TR/base.css"><link rel="contents" href="#contents"></head><body> +</style><link type="text/css" rel="stylesheet" href="http://www.w3.org/StyleSheets/TR/base.css"><link href="#contents" rel="contents"></head><body> <div class="head"> <h1>Web Services Policy 1.5 - Attachment</h1> <h2>Editors' copy $Date$ @@ @@@@ @@@@</h2><dl><dt>This version:</dt><dd> @@ -75,7 +75,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>2. <a href="#NotationsTerminology">Notations and Terminology</a><br> 2.1 <a href="#NotationalConventions">Notational Conventions</a><br> 2.2 <a href="#XMLNamespaces">XML Namespaces</a><br> 2.3 <a href="#Glossary">Terminology</a><br> 2.4 <a href="#Example">Example</a><br>3. <a href="#rPolicyAttachment">Policy Attachment</a><br> 3.1 <a href="#rEffectivePolicy">Effective Policy</a><br> 3.2 <a href="#PolicyAttachmentMechanisms">Policy Attachment Mechanisms</a><br> 3.3 <a href="#XMLElementAttachement">XML Element Attachment</a><br> 3.4 <a href="#ExternalPolicyAttachment">External Policy Attachment</a><br>4. <a href="#AttachingPolicyUsingWSDL1.1">Attaching Policies Using WSDL 1.1</a><br> 4.1 <a href="#CaculatingEffectivyPolicywithWSDL1.1">Calculating Effective Policy in WSDL 1.1</a><br> 4.1.1 <a href="#ServicePolicySubject">Service Policy Subject</a><br> 4.1.2 <a href="#EndpointPolicySubject">Endpoint Policy Subject</a><br> 4.1.3 <a href="#OperationPolicySubject">Operation Policy Subject</a><br> 4.1.4 <a href="#MessagePolicySubject">Message Policy Subject</a><br> 4.1.5 <a href="#Example2">Example</a><br>5. <a href="#AttachingPoliciesUsingUDDI">Attaching Policies Using UDDI</a><br> 5.1 <a href="#CalculatingEffectivePolicyElementPolicyUDDI">Calculating Effective Policy and Element Policy in UDDI</a><br> 5.1.1 <a href="#ServiceProviderPolicySubjectUDDI">Service Provider Policy Subject</a><br> nbsp; 5.1.2 <a href="#ServicePolicySubjectUDDI">Service Policy Subject</a><br> 5.1.3 <a href="#EndpointPolicySubjectUDDI">Endpoint Policy Subject</a><br> 5.2 <a href="#ReferencingRemotePolicyExpressions">Referencing Remote Policy Expressions</a><br> 5.3 <a href="#RegisteringReusablePolicyExpressions">Registering Reusable Policy Expressions</a><br> 5.4 <a href="#RegisteringPoliciesUDDIVersion3">Registering Policies in UDDI Version 3</a><br>6. <a href="#SecurityConsiderations">Security Considerations</a><br></p> -<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="#AppendixA">UDDI tModel Definitions</a><br> B.1 <a href="#RemotePolicyReferenceCategorySystem">Remote Policy Reference Category System</a><br> B.1.1 <a href="#DesigGoals1">Design Goals</a><br> B.1.2 <a href="#tModelDefinition1">tModel Definition</a><br> B.1.3 <a href="#ModelStructure1">tModel Structure</a><br> B.2 <a href="#WS-PolicyTypesCategorySystem">Web Services Policy Types Category System</a><br> B.2.1 <a href="#DesignGoals2">Design Goals</a><br> &bsp; B.2.2 <a href="#tModelDefinition2">tModel Definition</a><br> B.2.3 <a href="#ModelStructure2">tModel Structure</a><br> B.3 <a href="#LocalPolicyReferenceCategorySystem">Local Policy Reference Category System</a><br> B.3.1 <a href="#DesignGoals3">Design Goals</a><br> B.3.2 <a href="#tModelDefinition3">tModel Definition</a><br> B.3.3 <a href="#ModelStructure3">tModel Structure</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 - Attachment Change Log</a> (Non-Normative)<br></p></div><hr><div class="body"> +<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="#AppendixA">UDDI tModel Definitions</a><br> B.1 <a href="#RemotePolicyReferenceCategorySystem">Remote Policy Reference Category System</a><br> B.1.1 <a href="#DesigGoals1">Design Goals</a><br> B.1.2 <a href="#tModelDefinition1">tModel Definition</a><br> B.1.3 <a href="#ModelStructure1">tModel Structure</a><br> B.2 <a href="#WS-PolicyTypesCategorySystem">Web Services Policy Types Category System</a><br> B.2.1 <a href="#DesignGoals2">Design Goals</a><br> &bsp; B.2.2 <a href="#tModelDefinition2">tModel Definition</a><br> B.2.3 <a href="#ModelStructure2">tModel Structure</a><br> B.3 <a href="#LocalPolicyReferenceCategorySystem">Local Policy Reference Category System</a><br> B.3.1 <a href="#DesignGoals3">Design Goals</a><br> B.3.2 <a href="#tModelDefinition3">tModel Definition</a><br> B.3.3 <a href="#ModelStructure3">tModel Structure</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 - Attachment Change Log</a> (Non-Normative)<br></p></div><hr><div class="body"> <div class="div1"> <h2><a name="tocRange"></a>1. Introduction</h2> @@ -272,32 +272,32 @@ <p>We introduce the following terms that are used throughout this document:</p> <p>EdNote: script will insert termdefs here</p> -<p>[<a name="policy" title="policy">Definition</a>: A <b>policy</b> is a +<p>[<a title="policy" name="policy">Definition</a>: A <b>policy</b> is a collection of <a title="policy alternative" href="#policy_alternative">policy alternatives</a>. ]</p> -<p>[<a name="policy_alternative" title="policy alternative">Definition</a>: A +<p>[<a title="policy alternative" name="policy_alternative">Definition</a>: A <b>policy alternative</b> is a collection of <a title="policy assertion" href="#policy_assertion">policy assertions</a>.]</p> -<p>[<a name="policy_assertion" title="policy assertion">Definition</a>: A +<p>[<a title="policy assertion" name="policy_assertion">Definition</a>: A <b>policy assertion</b> represents an individual requirement, capability, or other property of a behavior.]</p> -<p>[<a name="policy_expression" title="policy expression">Definition</a>: A +<p>[<a title="policy expression" name="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. ]</p> -<p>[<a name="policy_subject" title="policy subject">Definition</a>: A <b>policy +<p>[<a title="policy subject" name="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. ]</p> -<p>[<a name="policy_scope" title="policy scope">Definition</a>: A <b>policy +<p>[<a title="policy scope" name="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.]</p> -<p>[<a name="policy_attachment" title="policy attachment">Definition</a>: A +<p>[<a title="policy attachment" name="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>.]</p> </div> @@ -315,7 +315,7 @@ [<cite><a href="#WS-SecurityPolicy">WS-SecurityPolicy</a></cite>].</p> <div class="exampleOuter"> - <p style="text-align: left" class="exampleHead"><a name="Table2"></a><i><span>Example 2-1. </span>Example RM Policy Expression.</i></p> + <p class="exampleHead" style="text-align: left"><a name="Table2"></a><i><span>Example 2-1. </span>Example RM Policy Expression.</i></p> <div class="exampleInner"><pre>(01) <wsp:Policy xmlns:rmp="http://docs.oasis-open.org/ws-rx/wsrmp/200602" xmlns:wsp="http://www.w3.org/@@@@/@@/policy" @@ -330,7 +330,7 @@ (08) </wsp:Policy></pre></div> </div> <div class="exampleOuter"> - <p style="text-align: left" class="exampleHead"><a name="Table3"></a><i><span>Example 2-2. </span>Example X509 Security Policy Expression.</i></p> + <p class="exampleHead" style="text-align: left"><a name="Table3"></a><i><span>Example 2-2. </span>Example X509 Security Policy Expression.</i></p> <div class="exampleInner"><pre>(01) <wsp:Policy xmlns:sp="http://schemas.xmlsoap.org/ws/2005/07/securitypolicy" xmlns:wsp="http://www.w3.org/@@@@/@@/policy" @@ -410,13 +410,13 @@ subject, and other attachments may be made by UDDI and other mechanisms.</p> - <p>When multiple attachments are made, [<a name="effective_policy" title="effective policy">Definition</a>: the + <p>When multiple attachments are made, [<a title="effective policy" name="effective_policy">Definition</a>: the <b>effective policy</b>, for a given <a title="policy subject" href="#policy_subject">policy subject</a>, is the combination of relevant policies. The relevant policies are those attached to <a title="policy scope" href="#policy_scope">policy scopes</a> that contain the <a title="policy subject" href="#policy_subject">policy subject</a>.] </p> - <p>This combination can be achieved by: [<a name="merge" title="merge">Definition</a>: a <b>merge</b> + <p>This combination can be achieved by: [<a title="merge" name="merge">Definition</a>: a <b>merge</b> consists of serializing each policy as a <a title="policy expression" href="#policy_expression">policy expression</a>, replacing their <code class="elt">wsp:Policy</code> element with a @@ -472,7 +472,7 @@ to form a single element <a title="policy expression" href="#policy_expression">policy expression</a>. The resultant <a title="policy" href="#policy">policy</a> is then associated with the element information item's <a title="element policy" href="#element_policy">element policy</a> -property. [<a name="element_policy" title="element policy">Definition</a>: The +property. [<a title="element policy" name="element_policy">Definition</a>: The <b>element policy</b> is the <a title="policy" href="#policy">policy</a> attached to the <a title="policy subject" href="#policy_subject">policy subjects</a> associated with the element information item that contains it.]</p> @@ -492,7 +492,7 @@ it would result in an <a title="element policy" href="#element_policy">element policy</a> whose XML 1.0 representation is listed in <a href="#Table4">Example 3-1</a>:</p> <div class="exampleOuter"> - <p style="text-align: left" class="exampleHead"><a name="Table4"></a><i><span>Example 3-1. </span>Example Merged Policy Expression.</i></p> + <p class="exampleHead" style="text-align: left"><a name="Table4"></a><i><span>Example 3-1. </span>Example Merged Policy Expression.</i></p> <div class="exampleInner"><pre>(01) <wsp:Policy xmlns:rmp="http://docs.oasis-open.org/ws-rx/wsrmp/200602" xmlns:sp="http://schemas.xmlsoap.org/ws/2005/07/securitypolicy" @@ -712,11 +712,11 @@ or ports) are only considered in the <a title="effective policy" href="#effective_policy">effective policy</a> of that deployed resource itself.</p> -<div class="figure" style="text-align: center"><a name="Figure1"></a><br><img src="effective-policy-scope.png" alt="Effective Policy and Policy Scopes in WSDL"><p style="text-align:left"><i><span>Figure 4-1. </span>Effective Policy and Policy Scopes in WSDL</i></p><br></div> +<div style="text-align: center" class="figure"><a name="Figure1"></a><br><img src="effective-policy-scope.png" alt="Effective Policy and Policy Scopes in WSDL"><p style="text-align:left"><i><span>Figure 4-1. </span>Effective Policy and Policy Scopes in WSDL</i></p><br></div> <p>(This graphic is also available in SVG format <a href="effective-policy-scope.svg">here</a>.)</p> <p>When attaching policies at different levels of the WSDL hierarchy, care must be taken. -A message <span class="rfc2119">MAY</span> be described by the +A message exchange with a deployed endpoint <span class="rfc2119">MAY</span> be described by the <a title="effective policy" href="#effective_policy">effective policies</a> in all four subject types simultaneously.</p> @@ -881,7 +881,7 @@ <a href="#Table5">Example 4-1</a> that references policies. </p> <div class="exampleOuter"> -<p style="text-align: left" class="exampleHead"><a name="Table5"></a><i><span>Example 4-1. </span>Example Policy Attached to WSDL.</i></p> +<p class="exampleHead" style="text-align: left"><a name="Table5"></a><i><span>Example 4-1. </span>Example Policy Attached to WSDL.</i></p> <div class="exampleInner"><pre>(01) <wsdl11:definitions name="StockQuote" targetNamespace="http://www.example.com/stock/binding" xmlns:tns="http://www.example.com/stock/binding" @@ -948,7 +948,7 @@ whose XML 1.0 representation is listed in <a href="#Table6">Example 4-2</a>.</p> <div class="exampleOuter"> -<p style="text-align: left" class="exampleHead"><a name="Table6"></a><i><span>Example 4-2. </span>Example Message Security Policy Expression.</i></p> +<p class="exampleHead" style="text-align: left"><a name="Table6"></a><i><span>Example 4-2. </span>Example Message Security Policy Expression.</i></p> <div class="exampleInner"><pre>(01) <wsp:Policy xmlns:sp="http://schemas.xmlsoap.org/ws/2005/07/securitypolicy" xmlns:wsp="http://www.w3.org/@@@@/@@/policy" Index: ws-policy.xsd =================================================================== RCS file: /sources/public/2006/ws/policy/ws-policy.xsd,v retrieving revision 1.1 retrieving revision 1.2 diff -u -d -r1.1 -r1.2 --- ws-policy.xsd 31 May 2006 17:20:37 -0000 1.1 +++ ws-policy.xsd 19 Aug 2006 01:15:46 -0000 1.2 @@ -36,7 +36,11 @@ <xs:import namespace="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" schemaLocation="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" /> - + + <xs:import + namespace="http://www.w3.org/XML/1998/namespace" + schemaLocation="http://www.w3.org/2001/xml.xsd" /> + <!-- Constructs from the Web Services Policy 1.5 Framework --> <xs:element name="Policy" > @@ -46,6 +50,7 @@ <xs:extension base="tns:OperatorContentType" > <xs:attribute name="Name" type="xs:anyURI" /> <xs:attribute ref="wsu:Id" /> + <xs:attribute ref="xml:id" /> <xs:anyAttribute namespace="##any" processContents="lax" /> </xs:extension> </xs:complexContent>
Received on Saturday, 19 August 2006 01:16:03 UTC