- From: Felix Sasaki via cvs-syncmail <cvsmail@w3.org>
- Date: Mon, 18 Dec 2006 03:49:00 +0000
- To: public-ws-policy-eds@w3.org
Update of /sources/public/2006/ws/policy
In directory hutz:/tmp/cvs-serv20654/ws/policy
Modified Files:
ws-policy-guidelines.xml
Log Message:
Example formatting in sec. 4.2 and sec. 8, updated change log accordingly.
Index: ws-policy-guidelines.xml
===================================================================
RCS file: /sources/public/2006/ws/policy/ws-policy-guidelines.xml,v
retrieving revision 1.19
retrieving revision 1.20
diff -u -d -r1.19 -r1.20
--- ws-policy-guidelines.xml 30 Nov 2006 06:03:53 -0000 1.19
+++ ws-policy-guidelines.xml 18 Dec 2006 03:48:58 -0000 1.20
@@ -495,8 +495,9 @@
recursively nested policy operators, and a policy reference/inclusion mechanism.
</p>
<example>
- <eg xml:space="preserve"><wsp:Policy xmlns:wsp='&nsuri;' xmlns:sp='http://schemas.xmlsoap.org/ws/2005/07/securitypolicy'
- xmlns:wsrmp='http://docs.oasis-open.org/ws-rx/wsrmp/200608'>
+ <eg xml:space="preserve"><wsp:Policy xmlns:wsp='&nsuri;'
+ xmlns:sp='http://schemas.xmlsoap.org/ws/2005/07/securitypolicy'
+ xmlns:wsrmp='http://docs.oasis-open.org/ws-rx/wsrmp/200608'>
<wsrmp:RMAssertion wsp:Optional="true"/>
<wsp:ExactlyOne>
<wsp:All>
@@ -519,11 +520,12 @@
<example>
- <eg xml:space="preserve"><wsp:Policy xmlns:wsp='&nsuri;' xmlns:sp='http://schemas.xmlsoap.org/ws/2005/07/securitypolicy'
+ <eg xml:space="preserve"><wsp:Policy xmlns:wsp='&nsuri;'
+ xmlns:sp='http://schemas.xmlsoap.org/ws/2005/07/securitypolicy'
xmlns:wsrmp='http://docs.oasis-open.org/ws-rx/wsrmp/200608'>
<wsp:ExactlyOne>
- <wsp:All>
+ <wsp:All>
<wsrmp:RMAssertion>
<sp:TransportBinding>
<wsp:Policy>
@@ -532,8 +534,7 @@
<sp:HttpsToken RequireClientCertificate='true' />
</wsp:Policy>
</sp:TransportToken>
-
- </wsp:Policy>
+ </wsp:Policy>
</sp:TransportBinding>
</wsp:All>
@@ -548,6 +549,7 @@
</wsp:Policy>
</sp:TransportBinding>
</wsp:All>
+
</wsp:ExactlyOne>
</wsp:Policy></eg>
</example>
@@ -1334,16 +1336,16 @@
<head>Message with Security Headers</head>
<eg xml:space="preserve"><soap:Envelope>
<soap:Header>
- <wss:Security soap:mustUnderstand ="1">
- <wsu:Timestamp u:Id=_0">
- <wsu:Created> 20006-01-19T02:49:53.914Z </u:Created>
- <wsu:Expires> 20006-01-19T02:54:53.914Z </u:Expires>
- </wsu:Timestamp>
+ <wss:Security soap:mustUnderstand ="1">
+ <wsu:Timestamp u:Id=_0">
+ <wsu:Created> 20006-01-19T02:49:53.914Z </u:Created>
+ <wsu:Expires> 20006-01-19T02:54:53.914Z </u:Expires>
+ </wsu:Timestamp>
</wss:Security>
- <wsa:To> http://CompanyA/quote <wsa:To>
- <wsa:Action> http://CompanyA/GetRealQuote</wsa:Action>
-</soap:Header>
-<soap:Body>
+ <wsa:To> http://CompanyA/quote <wsa:To>
+ <wsa:Action> http://CompanyA/GetRealQuote</wsa:Action>
+ </soap:Header>
+ <soap:Body> ...
</soap:Envelope></eg>
</example>
<p>The SOAP message in the example above includes security
@@ -1393,11 +1395,13 @@
after it is processed by the transport. The additional security
processing is not required by all Company A web services. </p>
<example> <head>CompanyA-ProfileB (not expanded)</head> <eg
- xml:space="preserve"> <Policy wsu:Id="CompanyA-ProfileB">
- <wsa:UsingAddressing /> <ExactlyOne>
- <sp:TransportBinding></sp:TransportBinding>
- <sp:AsymmetricBinding></sp:AssymetricBinding>
- </ExactlyOne> </Policy> </eg> </example>
+ xml:space="preserve"><Policy wsu:Id="CompanyA-ProfileB">
+ <wsa:UsingAddressing/>
+ <ExactlyOne>
+ <sp:TransportBinding></sp:TransportBinding>
+ <sp:AsymmetricBinding></sp:AssymetricBinding>
+ </ExactlyOne>
+</Policy></eg> </example>
<p>We have shown above that Company A offered a
second profile that included two security options. The details of
the Bindings, requires a more detailed exploration of some of the
@@ -1421,27 +1425,26 @@
<code>sp:TransportBinding</code> policy assertion. </p>
<example>
<head>CompanyA-ProfileB (fully expanded)</head>
- <eg xml:space="preserve">
-<Policy wsu:Id="CompanyA-ProfileB">
- <wsa:UsingAddressing />
- <ExactlyOne>
- <sp:TransportBinding>
- <Policy>
- <sp:TransportToken>
- <Policy>
- <sp:HttpsToken RequireClienCertificate="false" />
- </Policy>
- </sp:TransportToken>
- <sp:AlgorithmSuite>
- <Policy>
- <sp:Basic256Rsa15 />
- </Policy>
- </sp:AlgorithmSuite>
- </Policy>
- </sp:TransportBinding>
- <sp:AsymmetricBinding>
+ <eg xml:space="preserve"><Policy wsu:Id="CompanyA-ProfileB">
+ <wsa:UsingAddressing/>
+ <ExactlyOne>
+ <sp:TransportBinding>
+ <Policy>
+ <sp:TransportToken>
+ <Policy>
+ <sp:HttpsToken RequireClienCertificate="false" />
+ </Policy>
+ </sp:TransportToken>
+ <sp:AlgorithmSuite>
+ <Policy>
+ <sp:Basic256Rsa15 />
+ </Policy>
+ </sp:AlgorithmSuite>
+ </Policy>
+ </sp:TransportBinding>
+ <sp:AsymmetricBinding>
</sp:AssymetricBinding>
- </ExactlyOne>
+ </ExactlyOne>
</Policy></eg>
</example>
<p>
@@ -1477,12 +1480,10 @@
in the wsdl binding for each web service. </p>
<example>
<head/>
- <eg xml:space="preserve">
-<wsdl:binding name="CompanyADefaultBinding" type="tns:CompanyADefault">
- <wsp:PolicyReference URI="http://www.CompanyA.com/WebServicesProfileA.xml">
-
-<wsdl:operation name="GetQuote"> </wsdl:operation>
-</wsdl:binding> </eg>
+ <eg xml:space="preserve"><wsdl:binding name="CompanyADefaultBinding" type="tns:CompanyADefault">
+ <wsp:PolicyReference URI="http://www.CompanyA.com/WebServicesProfileA.xml">
+ <wsdl:operation name="GetQuote"> </wsdl:operation>
+</wsdl:binding></eg>
</example>
<p>The partner specified policy is included in the beginning of
the WSDL 1.1 document and referenced by the binding for the service
@@ -1515,10 +1516,9 @@
</wsp:Policy>
<wsdl:binding name="CompanyADefaultBinding" type="tns:CompanyADefault">
- <wsp:PolicyReference id=#CompanyA-ProfileB>
- <wsdl:operation name="GetQuote"> </wsdl:operation>
-
-</wsdl:binding> </eg>
+ <wsp:PolicyReference id=#CompanyA-ProfileB>
+ <wsdl:operation name="GetQuote"> </wsdl:operation>
+</wsdl:binding></eg>
</example>
<p>In some cases, companies may chose to implement their own
assertions. When companies chose to become policy authors they need
@@ -1850,6 +1850,12 @@
<td>ASV</td>
<td>Formatted examples in <specref ref="extending-assertions"/>.
</td>
+ </tr>
+ <tr>
+ <td>20061218</td>
+ <td>FS</td>
+ <td>Formatted examples in <specref ref="compact-full"/> and <specref ref="scenario"/>.
+ </td>
</tr>
</tbody>
</table>
Received on Monday, 18 December 2006 03:49:23 UTC