- From: David Orchard via cvs-syncmail <cvsmail@w3.org>
- Date: Thu, 12 Oct 2006 23:06:42 +0000
- To: public-ws-policy-eds@w3.org
Update of /sources/public/2006/ws/policy
In directory hutz:/tmp/cvs-serv13305
Modified Files:
ws-policy-framework.html
Log Message:
bug 3722, define terms where used.
Index: ws-policy-framework.html
===================================================================
RCS file: /sources/public/2006/ws/policy/ws-policy-framework.html,v
retrieving revision 1.53
retrieving revision 1.54
diff -u -d -r1.53 -r1.54
--- ws-policy-framework.html 12 Oct 2006 20:22:05 -0000 1.53
+++ ws-policy-framework.html 12 Oct 2006 23:06:40 -0000 1.54
@@ -65,15 +65,11 @@
<h2><a name="tocRange"></a>1. Introduction</h2><p>Web Services Policy 1.5 - Framework defines a framework and a model for expressing policies that
refer to domain-specific capabilities, requirements, and general characteristics of
entities in a Web services-based system.
- </p><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 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 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 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
+ </p><p>A policy is a collection of policy alternatives,
+ where a policy alternative is a collection of policy assertions.
+ A policy assertion represents an individual requirement, capability, or other property of a behavior. A policy expression
+ is an XML Infoset representation of a policy,
+ 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
@@ -82,17 +78,11 @@
QoS characteristics). Web Services Policy 1.5 - Framework provides a single policy
language to allow both kinds of assertions to be expressed and evaluated
in a consistent manner.</p><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
- <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 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
+ policy attachments. A policy attachment is a mechanism for associating
+ policy with one or more policy scopes, where a policy scope is a collection of
+ policy subjects to which a policy may apply. A policy subject is an entity
(e.g., an endpoint, message, resource, interaction) with which a
- <a title="policy" href="#policy">policy</a> can be associated. ]
-
- Other specifications are
+ policy can be associated. Other specifications are
free to define technology-specific mechanisms for
associating policy with various entities and
resources. Web Services Policy 1.5 - Attachment [<cite><a href="#WS-PolicyAttachment">Web Services Policy Attachment</a></cite>]
@@ -187,11 +177,16 @@
<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">
+ </dt><dd><p>A <b>policy</b> is a potentially empty 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">
+ </dt><dd><p>A <b>policy alternative</b>
+ is a potentially empty collection of <a title="policy assertion" href="#policy_assertion">policy assertions</a>.</p></dd><dt class="label">
+ <a href="#policy_alternative_vocabulary">policy alternative vocabulary</a>
+ </dt><dd><p>A <b>policy alternative vocabulary</b> is the set of
+ all <a title="policy assertion type" href="#policy_assertion_type">policy assertion
+ types</a> within the <a title="policy alternative" href="#policy_alternative">policy
+ alternative</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">
@@ -221,20 +216,19 @@
</dt><dd><p>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.</p></dd></dl></div></div><div class="div1">
<h2><a name="Policy_Model"></a>3. Policy Model</h2><p>This section defines an abstract model for policies and for operations upon policies.</p><p>The descriptions below use XML Infoset terminology for convenience of description. However, this abstract model itself is independent of how it is represented as an XML Infoset. </p><div class="div2">
-<h3><a name="rPolicy_Assertion"></a>3.1 Policy Assertion</h3><p>A <a title="policy assertion" href="#policy_assertion">policy
+<h3><a name="rPolicy_Assertion"></a>3.1 Policy Assertion</h3><p>[<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 <a title="policy assertion" href="#policy_assertion">policy
assertion</a> identifies a behavior that is a
requirement or capability of a <a title="policy subject" href="#policy_subject">policy
- subject</a>. Assertions indicate domain-specific (e.g.,
+ subject</a>. Assertions indicate domain-specific (e.g.,
security, transactions) semantics and are expected to be
defined in separate, domain-specific specifications.</p><p>Assertions are typed by the authors
- that define them. The <a title="policy assertion type" href="#policy_assertion_type">policy assertion
+ that define them. [<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.] The <a title="policy assertion type" href="#policy_assertion_type">policy assertion
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>
- 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
+ Information Item representing the assertion. Assertions of
a given type <span class="rfc2119">MUST</span> be consistently
interpreted independent of their <a title="policy subject" href="#policy_subject">policy subjects</a>.</p><p>Authors <span class="rfc2119">MAY</span> define that an assertion contains a
<a title="policy expression" href="#policy_expression">policy
@@ -260,18 +254,17 @@
to consider when the identity of the root Element
Information Item alone is enough to convey the requirement
or capability.</p></div><div class="div2">
-<h3><a name="rPolicy_Alternative"></a>3.2 Policy Alternative</h3><p>A <a title="policy alternative" href="#policy_alternative">policy
- alternative</a> is a logical construct which
- represents a potentially empty collection of <a title="policy assertion" href="#policy_assertion">policy assertions</a>. An
+<h3><a name="rPolicy_Alternative"></a>3.2 Policy Alternative</h3><p>[<a name="policy_alternative" title="policy alternative">Definition</a>: A <b>policy alternative</b>
+ is a potentially empty collection of <a title="policy assertion" href="#policy_assertion">policy assertions</a>.] An
alternative with zero assertions indicates no
behaviors. An alternative with one or more assertions
indicates behaviors implied by those, and only those
- assertions. </p><p> [<a name="policy_vocabulary" title="policy vocabulary">Definition</a>: A <b>policy vocabulary</b> is the set of all
+ assertions. [<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.]
[<a name="policy_alternative_vocabulary" title="policy alternative vocabulary">Definition</a>: A <b>policy alternative vocabulary</b> is the set of
all <a title="policy assertion type" href="#policy_assertion_type">policy assertion
types</a> within the <a title="policy alternative" href="#policy_alternative">policy
- alternative</a>].
+ alternative</a>.]
When an assertion whose type is part of the policy's vocabulary is not included
in a policy alternative, the policy alternative without the assertion type
indicates that the assertion will not be applied in the context of the attached
@@ -285,9 +278,8 @@
Post-Schema-Validation Infoset (PSVI) (See XML Schema Part 1 [<cite><a href="#XMLSchemaPart1">XML Schema Structures</a></cite>]) content, if any) are
specific to the assertion type and are outside the scope
of this document.</p></div><div class="div2">
-<h3><a name="rPolicy"></a>3.3 Policy</h3><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
+<h3><a name="rPolicy"></a>3.3 Policy</h3><p>[<a name="policy" title="policy">Definition</a>: A <b>policy</b> 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
alternatives indicates choice in requirements or
capabilities within the policy. </p><p>Alternatives are not ordered, and thus aspects such as
@@ -301,7 +293,9 @@
specification.</p></div><div class="div2">
<h3><a name="Web_services"></a>3.4 Policies of Entities in a Web Services Based System</h3><p>Applied in the Web services based system, <a title="policy" href="#policy">policy</a> is used to convey conditions
on an interaction between entities (requester application,
- provider service, Web infrastructure component, etc). Any entity in a
+ provider service, Web infrastructure component, etc). [<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. ] Any entity in a
Web services based system may expose a policy to convey conditions under
which it functions. Satisfying assertions in the policy usually results
in behavior that reflects these conditions. For example, if two entities
@@ -334,9 +328,9 @@
to continue to use old alternatives in a
backward-compatible manner.</p></div></div><div class="div1">
<h2><a name="rPolicy_Expression"></a>4. Policy Expression</h2><p>This section describes how to convey policy in an interoperable form,
- using the XML Infoset representation of a policy. This XML Infoset representation
- of a policy is known as a <a title="policy expression" href="#policy_expression">policy
- expression</a>. Other subsections below describe
+ using the XML Infoset representation of a policy. [<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.] Other subsections below describe
several important aspects related to policy expression, namely
(i) Normal form of a policy expression (ii) Compact form of a policy expression
(iii) Identification of policy expressions and (iv) Policy intersection.
@@ -399,7 +393,12 @@
(05) </wsp:Policy></pre></div><p>The following describes the Attribute Information Items listed and defined in the schema outline above:</p><dl><dt class="label"><code class="attr">/wsp:Policy/@Name</code> </dt><dd><p>The identity of the policy expression as an absolute IRI [<cite><a href="#RFC3987">IETF RFC 3987</a></cite>]. If
omitted, there is no implied value. This IRI <span class="rfc2119">MAY</span> be
used to refer to a policy from other XML documents using a <a title="policy attachment" href="#policy_attachment">policy attachment</a> mechanism such as
-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 | @xml:id)</code> </dt><dd><p>The identity of the policy expression as an <code>ID</code> within the
+those defined in WS-PolicyAttachment [<cite><a href="#WS-PolicyAttachment">Web Services Policy Attachment</a></cite>]. [<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 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.]
+ </p></dd><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.
The constraints of the XML 1.0 [<cite><a href="#XML10">XML 1.0</a></cite>] ID type MUST be met.
To refer to this policy expression, an IRI-reference
@@ -1232,4 +1231,7 @@
</td></tr><tr><td rowspan="1" colspan="1">20061008</td><td rowspan="1" colspan="1">MH</td><td rowspan="1" colspan="1">Completed action item:
<a href="http://www.w3.org/2005/06/tracker/wspolicyeds/actions/45">45</a> Replace security policy example 1.1. as per issue 3753.
</td></tr><tr><td rowspan="1" colspan="1">20061011</td><td rowspan="1" colspan="1">PY</td><td rowspan="1" colspan="1">Updated "Changes in this Version" section (Appendix C)
- </td></tr></tbody></table><br></div></div></body></html>
\ No newline at end of file
+ </td></tr><tr><td rowspan="1" colspan="1">20061012</td><td rowspan="1" colspan="1">DBO</td><td rowspan="1" colspan="1">Revisited action items: <a href="http://www.w3.org/2006/07/12-ws-policy-minutes.html#action15">15</a>
+ as early as possible in the doc, use the definition that are defined in the doc. Opened as Bug
+ <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=3720">3720</a>
+ </td></tr></tbody></table><br></div></div></body></html>
\ No newline at end of file
Received on Thursday, 12 October 2006 23:06:53 UTC