- From: David Orchard via cvs-syncmail <cvsmail@w3.org>
- Date: Wed, 30 Aug 2006 19:14:27 +0000
- To: public-ws-policy-eds@w3.org
Update of /sources/public/2006/ws/policy
In directory hutz:/tmp/cvs-serv9919
Modified Files:
ws-policy-framework.xml ws-policy-framework.html
Log Message:
Completed action item 77 resolution for issue 3604. Removing Goals section, resulted in moving Policy expression definition to 2nd para of intro.
Index: ws-policy-framework.xml
===================================================================
RCS file: /sources/public/2006/ws/policy/ws-policy-framework.xml,v
retrieving revision 1.29
retrieving revision 1.30
diff -u -d -r1.29 -r1.30
--- ws-policy-framework.xml 30 Aug 2006 00:38:11 -0000 1.29
+++ ws-policy-framework.xml 30 Aug 2006 19:14:24 -0000 1.30
@@ -86,7 +86,9 @@
is a collection of <termref def='policy_assertion'>policy assertions</termref>.</termdef>
<termdef id='policy_assertion' term='policy assertion'>A <term>policy assertion</term>
represents an individual requirement, capability, or other property of a behavior.</termdef>
- Some policy assertions
+ <termdef id='policy_expression' term='policy expression'>A <term>policy expression</term>
+ is an XML Infoset representation of a <termref def='policy'>policy</termref>,
+ either in a normal form or in an equivalent compact form.</termdef> Some policy assertions
specify traditional requirements and capabilities that
will ultimately manifest on the wire (e.g., authentication
scheme, transport protocol selection). Other policy
@@ -118,39 +120,10 @@
ref="UDDIAPI20" />, <bibref ref="UDDIDataStructure20"
/>, <bibref ref="UDDI30" />].</p>
- <div2 id="Goals">
- <head>Goals</head>
-
- <p>The goal of &framework.title; is to provide the mechanisms
- needed to enable Web services applications to specify
- policy information. Specifically, this specification
- defines the following:</p>
- <ulist>
- <item>
- <p>
- An XML Infoset called a <termref def="policy_expression">policy
- expression</termref> that contains domain-specific, Web
- Service policy information. <termdef id='policy_expression' term='policy expression'>A <term>policy expression</term>
- is an XML Infoset representation of a <termref def='policy'>policy</termref>,
- either in a normal form or in an equivalent compact form. </termdef></p></item>
-
- <item><p>A core set of constructs to indicate how
- choices and/or combinations of domain-specific policy
- assertions apply in a Web services
- environment.</p></item>
- </ulist>
-
- <p>&framework.title; is designed to work with the
- general Web services framework, including WSDL service
- descriptions [<bibref ref="WSDL11" />, <bibref
- ref="WSDL20" />] and UDDI service registrations [<bibref
- ref="UDDIAPI20" />, <bibref ref="UDDIDataStructure20"
- />, <bibref ref="UDDI30" />].</p>
- </div2>
<div2 id="Example">
<head>Example</head>
- <p>The following example illustrates a security policy using
+ <p>The following example illustrates a security <termref def="policy_expression">policy expression</termref> using
assertions defined in WS-SecurityPolicy [<bibref
ref="WS-SecurityPolicy"/>]:</p>
@@ -1688,6 +1661,16 @@
for issue
<loc href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=3561">3561</loc>: replaced URI with IRI.
</td>
+ </tr>
+ <tr>
+ <td>20060830</td>
+ <td>DBO</td>
+ <td>Completed action item:
+ <loc href="http://www.w3.org/2005/06/tracker/wspolicy/actions/77">resolution</loc>
+ for issue
+ <loc href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=3604">3604</loc>.
+ Removing Goals section, resulted in moving Policy expression definition to 2nd para of intro.
+ </td>
</tr>
</tbody>
</table>
Index: ws-policy-framework.html
===================================================================
RCS file: /sources/public/2006/ws/policy/ws-policy-framework.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -d -r1.25 -r1.26
--- ws-policy-framework.html 30 Aug 2006 00:38:11 -0000 1.25
+++ ws-policy-framework.html 30 Aug 2006 19:14:25 -0000 1.26
@@ -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>
@@ -72,8 +72,8 @@
<h2><a name="status">Status of this Document</a></h2><p><strong>This document is an editors' copy that has
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>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">
+<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 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,15 @@
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.]
- Some policy assertions
+ [<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
will ultimately manifest on the wire (e.g., authentication
scheme, transport protocol selection). Other policy
@@ -101,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. ]
@@ -118,42 +120,15 @@
with arbitrary XML elements [<cite><a href="#XML10">XML 1.0</a></cite>], WSDL artifacts [<cite><a href="#WSDL11">WSDL 1.1</a></cite>, <cite><a href="#WSDL20">WSDL 2.0 Core Language</a></cite>], and UDDI
elements [<cite><a href="#UDDIAPI20">UDDI API 2.0</a></cite>, <cite><a href="#UDDIDataStructure20">UDDI Data Structure 2.0</a></cite>, <cite><a href="#UDDI30">UDDI 3.0</a></cite>].</p>
- <div class="div2">
-
-<h3><a name="Goals"></a>1.1 Goals</h3>
-
- <p>The goal of Web Services Policy 1.5 - Framework is to provide the mechanisms
- needed to enable Web services applications to specify
- policy information. Specifically, this specification
- defines the following:</p>
-
- <ul>
- <li>
- <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 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>
-
- <li><p>A core set of constructs to indicate how
- choices and/or combinations of domain-specific policy
- assertions apply in a Web services
- environment.</p></li>
- </ul>
- <p>Web Services Policy 1.5 - Framework is designed to work with the
- general Web services framework, including WSDL service
- descriptions [<cite><a href="#WSDL11">WSDL 1.1</a></cite>, <cite><a href="#WSDL20">WSDL 2.0 Core Language</a></cite>] and UDDI service registrations [<cite><a href="#UDDIAPI20">UDDI API 2.0</a></cite>, <cite><a href="#UDDIDataStructure20">UDDI Data Structure 2.0</a></cite>, <cite><a href="#UDDI30">UDDI 3.0</a></cite>].</p>
- </div>
<div class="div2">
-<h3><a name="Example"></a>1.2 Example</h3>
- <p>The following example illustrates a security policy using
+<h3><a name="Example"></a>1.1 Example</h3>
+ <p>The following example illustrates a security <a title="policy expression" href="#policy_expression">policy expression</a> using
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"
@@ -378,7 +353,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
@@ -398,7 +373,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
@@ -430,7 +405,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
@@ -1292,7 +1267,6 @@
with sufficient credentials to pass the relying parties' acceptance
criteria.</p>
-
<p>It should be noted that the mechanisms described in this document
could be secured as part of a SOAP message [<cite><a href="#SOAP11">SOAP 1.1</a></cite>, <cite><a href="#SOAP12">SOAP 1.2 Messaging Framework</a></cite>] using WS-Security [<cite><a href="#WS-Security">WS-Security 2004</a></cite>] or embedded within other
objects using object-specific security mechanisms.</p>
@@ -1675,6 +1649,16 @@
for issue
<a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=3561">3561</a>: replaced URI with IRI.
</td>
+ </tr>
+ <tr>
+ <td rowspan="1" colspan="1">20060830</td>
+ <td rowspan="1" colspan="1">DBO</td>
+ <td rowspan="1" colspan="1">Completed action item:
+ <a href="http://www.w3.org/2005/06/tracker/wspolicy/actions/77">resolution</a>
+ for issue
+ <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=3604">3604</a>.
+ Removing Goals section, resulted in moving Policy expression definition to 2nd para of intro.
+ </td>
</tr>
</tbody>
</table><br>
Received on Wednesday, 30 August 2006 19:15:00 UTC