2.2 XML Namespaces
This specification uses a number of namespace prefixes throughout; they
are listed in Table 2-1. Note that the choice of any
namespace prefix is arbitrary and not semantically significant (see [XML
Namespaces]).
Table 2-1. Prefixes and Namespaces used in this specification
| Prefix |
XML Namespace |
Specification |
mtom |
http://schemas.xmlsoap.org/ws/2004/09/policy/optimizedmimeserialization
|
[WS-MTOMPolicy] |
rmp |
http://docs.oasis-open.org/ws-rx/wsrmp/200602
http://docs.oasis-open.org/ws-rx/wsrmp/200702 |
[WS-RM Policy] |
sp |
http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702
|
[WS-SecurityPolicy] |
wsa |
http://www.w3.org/2005/08/addressing |
[WS-Addressing Core] |
wsam |
http://www.w3.org/2007/05/addressing/metadata |
[WS-Addressing Metadata] |
wsdl11 |
http://schemas.xmlsoap.org/wsdl/ |
[WSDL 1.1] |
wsdl20 |
http://www.w3.org/ns/wsdl |
[WSDL 2.0 Core Language] |
wsoap12 |
http://schemas.xmlsoap.org/wsdl/soap12/ |
[WSDL 1.1 Binding for
SOAP 1.2] |
(none), wsp |
http://www.w3.org/ns/ws-policy |
This specification |
wsse |
http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd
|
[WS-Security 2004] |
wsu |
http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd
|
[WS-Security 2004] |
xs |
http://www.w3.org/2001/XMLSchema |
[XML Schema Structures] |
All information items defined by this specification are identified by the
XML namespace URI [XML Namespaces]
http://www.w3.org/ns/ws-policy. A
normative XML Schema [XML
Schema Structures, XML Schema
Datatypes] document can be obtained indirectly by dereferencing
the namespace document at the WS-Policy 1.5 namespace URI.
In this document reference is made to the wsu:Id attribute
in a utility schema (http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd).
The wsu:Id attribute was added to the utility schema with the
intent that other specifications requiring such an Id could reference it (as
is done here).
It is the intent of the W3C Web Services Policy Working Group that the
Web Services Policy 1.5 - Framework and Web Services Policy 1.5 - Attachment
XML namespace URI will not change arbitrarily with each subsequent revision
of the corresponding XML Schema documents as the specifications transition
through Candidate Recommendation, Proposed Recommendation and Recommendation
status. However, should the specifications revert to Working Draft status,
and a subsequent revision, published as a WD, CR or PR draft, results in
non-backwardly compatible changes from a previously published WD, CR or PR
draft of the specification, the namespace URI will be changed accordingly.
Under this policy, the following are examples of backwards compatible
changes that would not result in assignment of a new XML namespace URI:
-
Addition of new global element, attribute, complexType and simpleType
definitions.
-
Addition of new elements or attributes in locations covered by a
previously specified wildcard.
-
Modifications to the pattern facet of a type definition for which the
value-space of the previous definition remains valid or for which the
value-space of the preponderance of instance would remain valid.
-
Modifications to the cardinality of elements for which the
value-space of possible instance documents conformant to the previous
revision of the schema would still be valid with regards to the revised
cardinality rule.
...
2.4 Example
This specification defines several mechanisms for associating policies (Web
Services Policy 1.5 - Framework, [Web Services Policy
Framework]) with various XML Web service entities. For brevity, we
define two sample policy expressions
that the remainder of this document references.
Example 2-1 indicates a
policy for reliable messaging [WS-RM Policy].
Example 2-2 is a policy for securing messages using X509
certificates [WS-SecurityPolicy].
Example
2-1. Example RM Policy Expression.
(01) <wsp:Policy
xmlns:rmp="http://docs.oasis-open.org/ws-rx/wsrmp/200602 http://docs.oasis-open.org/ws-rx/wsrmp/200702"
xmlns:wsp="http://www.w3.org/ns/ws-policy"
xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"
wsu:Id="RmPolicy" >
(02) <rmp:RMAssertion>
(03) <rmp:InactivityTimeout Milliseconds="600000" />
(04) <rmp:BaseRetransmissionInterval Milliseconds="3000" />
(05) <rmp:ExponentialBackoff />
(06) <rmp:AcknowledgementInterval Milliseconds="200" />
(03) <wsp:Policy/>
(074) </rmp:RMAssertion>
(085) </wsp:Policy>
...
3.3 XML Element Attachment
It is often desirable to associate policies
with Web services policy subjects
represented as XML elements (i.e., WSDL 1.1 elements - Section
4. Attaching Policies Using WSDL 1.1
for the specific details of WSDL attachment).
Since policy assertions are strongly
typed by the authors, the precise semantics of how element policy is to be
processed once discovered is domain-specific; however, implementations are
likely to follow the precedent specified in the section below on WSDL [WSDL
1.1] and Policy.
This specification defines a global attribute that allows
policy expressions to be attached to
an arbitrary XML element. The following is the schema definition for the
wsp:PolicyURIs attribute:
(01) <xs:schema>
(02) <xs:attribute name="PolicyURIs">
(03) <xs:simpleType>
(04) <xs:list itemType="xs:anyURI" />
(05) </xs:simpleType>
(06) </xs:attribute>
(07) </xs:schema>
The namespace URI [XML Namespaces] for
this attribute is http://www.w3.org/ns/ws-policy.
The wsp:PolicyURIs attribute contains a white space-separated
list of one or more IRIs [IETF RFC 3987].
When this attribute is used, each of the values identifies a
policy expression as defined by [Web
Services Policy Framework]. If more than one IRI is specified, the
individual referenced policies need to be
merged together to form a single element
policy expression. The resultant
policy is then associated with the element
information item's element
policy property. [Definition:
The element policy is the policy attached
to the policy subjects associated with
the element information item that contains it.]
An example of element policy
through the use of this global attribute is given below using the sample
policies stated in Section 2.4 Example.
If the policies referenced by the following
XML element
(01) <MyElement wsp:PolicyURIs="
(02) http://www.example.com/policies#RmPolicy
(03) http://www.example.com/policies#X509EndpointPolicy" />
have been processed and merged, it would
result in an element policy
whose XML 1.0 representation is listed in Example 3-1:
Example
3-1. Example Merged Policy Expression.
(01) <wsp:Policy
xmlns:rmp="http://docs.oasis-open.org/ws-rx/wsrmp/200602 http://docs.oasis-open.org/ws-rx/wsrmp/200702"
xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"
xmlns:wsp="http://www.w3.org/ns/ws-policy" >
(02) <wsp:All>
(03) <rmp:RMAssertion>
(04) <rmp:InactivityTimeout Milliseconds="600000" />
(05) <rmp:BaseRetransmissionInterval Milliseconds="3000" />
(06) <rmp:ExponentialBackoff />
(07) <rmp:AcknowledgementInterval Milliseconds="200" />
(04) <wsp:Policy/>
(085) </rmp:RMAssertion>
(096) </wsp:All>
(1007) <wsp:All>
(1108) <sp:AsymmetricBinding>
(1209) <wsp:Policy>
(1310) <!-- Details omitted for readability -->
(1411) <sp:IncludeTimestamp />
(1512) <sp:OnlySignEntireHeadersAndBody />
(1613) </wsp:Policy>
(1714) </sp:AsymmetricBinding>
(1815) </wsp:All>
(1916) </wsp:Policy>
Note that this element
policy has no meaningful IRI.
...
4.1.5 Example
As an example of the combination of these
policy subjects and
effective policy calculation, consider the WSDL type definition in
Example 4-1 that references policies.
Example
4-1. Example Policy Attached to WSDL.
(01) <wsdl11:definitions name="StockQuote"
targetNamespace="http://www.example.com/stock/binding"
xmlns:tns="http://www.example.com/stock/binding"
xmlns:fab="http://www.example.com/stock"
xmlns:rmp="http://docs.oasis-open.org/ws-rx/wsrmp/200602 http://docs.oasis-open.org/ws-rx/wsrmp/200702"
xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
xmlns:wsoap12="http://schemas.xmlsoap.org/wsdl/soap12/"
xmlns:wsp="http://www.w3.org/ns/ws-policy"
xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" >
(02) <wsp:Policy wsu:Id="RmPolicy" >
(03) <rmp:RMAssertion>
(04) <rmp:InactivityTimeout Milliseconds="600000" />
(05) <rmp:BaseRetransmissionInterval Milliseconds="3000" />
(06) <rmp:ExponentialBackoff />
(07) <rmp:AcknowledgementInterval Milliseconds="200" />
(04) <wsp:Policy/>
(085) </rmp:RMAssertion>
(096) </wsp:Policy>
...
A. References
A.1
Normative References
- [BP 1.1]
-
Basic Profile Version 1.1
Basic Profile Version 1.1, K. Ballinger, et al, Editors. The
Web Services-Interoperability Organization, 10 June
April 2006. This version
of the Basic Profile Version 1.1 is
http://www.ws-i.org/Profiles/BasicProfile-1.1-2006-04-10.html. The
latest
version of the Basic Profile Version 1.1 is available at
http://www.ws-i.org/Profiles/BasicProfile-1.1.html
- [IETF RFC 3023]
- IETF "RFC 3023: XML Media Types", M. Murata, S. St. Laurent, D.
Kohn, July 1998
January 2001. (See
http://www.ietf.org/rfc/rfc3023.txt.)
- [IETF RFC 2119]
- Key words for
use in RFCs to Indicate Requirement Levels, S. Bradner,
Author. Internet Engineering Task Force, June 1999
March 1997. Available at
http://www.ietf.org/rfc/rfc2119.txt.
- [IETF RFC 3986]
- Uniform Resource
Identifier (URI): Generic Syntax , T. Berners-Lee, R.
Fielding and L. Masinter, Authors. Network Working Group, January 2005.
Available at http://www.ietf.org/rfc/rfc3986.txt.
- [IETF RFC 3987]
-
Internationalized Resource Identifiers (IRIs) , M. Duerst and
M. Suignard, Authors. Internet Engineering Task Force, January 2005.
Available at http://www.ietf.org/rfc/rfc3987.txt.
- [UDDI API 2.0]
-
UDDI Version 2.04 API, T. Bellwood, Editor. Organization for
the Advancement of Structured Information Standards, 19 July 2002. This
version of UDDI Version 2.0 API is
http://uddi.org/pubs/ProgrammersAPI-V2.04-Published-20020719.htm. The
latest version of
the UDDI 2.0 API is available at
http://uddi.org/pubs/ProgrammersAPI_v2.htm.
- [UDDI Data Structure
2.0]
-
UDDI Version 2.03 Data Structure Reference, C. von Riegen,
Editor. Organization for the Advancement of Structured Information
Standards, 19 July 2002. This version of UDDI Version 2.0 Data
Structures is
http://uddi.org/pubs/DataStructure-V2.03-Published-20020719.htm. The
latest version of
the UDDI 2.0 Data Structures is available at
http://uddi.org/pubs/DataStructure_v2.htm.
- [UDDI 3.0]
-
UDDI Version 3.0.2, L. Clément, et al, Editors. Organization
for the Advancement of Structured Information Standards, 19 October
2004. This version of the UDDI 3.0 specification is
http://www.oasis-open.org/committees/uddi-spec/doc/spec/v3/uddi-v3.0.2-20041019.htm.
The
latest version of the UDDI 3.0 specification is available at
http://www.oasis-open.org/committees/uddi-spec/doc/spec/v3/uddi_v3.htm.
- [Web Services Policy
Framework]
-
Web Services Policy 1.5 - Framework, A. S. Vedamuthu, D.
Orchard, F. Hirsch, M. Hondo, P. Yendluri, T. Boubez and Ü. Yalçinalp,
Editors. World Wide Web Consortium, @@, @@@@ @@@@. This version of the
specification of the Web Services Policy 1.5 - Framework specification
is ws-policy-framework.html. The
latest version of Web
Services Policy 1.5 - Framework is available at
http://www.w3.org/TR/ws-policy-framework.
- [WS-Addressing Core]
-
Web
Services Addressing 1.0 - Core, M. Gudgin, M. Hadley, and T.
Rogers, Editors. World Wide Web Consortium, 9 May 2006. This version of
the Web Services Addressing 1.0 - Core Recommendation is
http://www.w3.org/TR/2006/REC-ws-addr-core-20060509/. The
latest version of Web
Services Addressing 1.0 - Core is available at
http://www.w3.org/TR/ws-addr-core.
- [WSDL 1.1]
- Web
Services Description Language (WSDL) 1.1, E. Christensen, et
al, Authors. World Wide Web Consortium, March 2001. Available at
http://www.w3.org/TR/2001/NOTE-wsdl-20010315.
- [WSDL 2.0 Core Language]
- Web
Services Description Language (WSDL) Version 2.0 Part 1: Core Language
Web
Services Description Language (WSDL) Version 2.0 Part 1: Core Language,
R. Chinnici, J. J. Moreau, A. Ryman, S. Weerawarana, Editors. World Wide
Web Consortium, 26 June 2007. This version of the WSDL 2.0 specification
is http://www.w3.org/TR/2007/REC-wsdl20-20070626/. The
latest version of WSDL 2.0 is
available at http://www.w3.org/TR/wsdl20/.
- [WS-Security 2004]
-
Web Services Security: SOAP Message Security 1.0 (WS-Security 2004),
A. Nadalin, C. Kaler, P. Hallam-Baker, and R. Monzillo, Editors.
Organization for the Advancement of Structured Information Standards,
March 2004. Available at
http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-soap-message-security-1.0.pdf.
- [XML BASE]
- XML
Base, Jonathan Marsh, Editor. World Wide Web Consortium, 27
June 2001. This version of the XML Base Recommendation is
http://www.w3.org/TR/2001/REC-xmlbase-20010627/. The
latest version of XML Base
is available at http://www.w3.org/TR/xmlbase/.
- [XML Information Set]
-
XML Information Set (Second Edition), J. Cowan and R. Tobin,
Editors. World Wide Web Consortium, 24 October 2001, revised 4 February
2004. This version of the XML Information Set Recommendation is
http://www.w3.org/TR/2004/REC-xml-infoset-20040204. The
latest version of XML
Information Set is available at http://www.w3.org/TR/xml-infoset.
- [XML Namespaces]
-
Namespaces in XML 1.0 (Second Edition), T. Bray, D.
Hollander, A. Layman, and R. Tobin, Editors. World Wide Web Consortium,
14 January 1999, revised 16 August 2006. This version of the XML
Information Set Recommendation is
http://www.w3.org/TR/2006/REC-xml-names-20060816/. The
latest version of
Namespaces in XML is available at
http://www.w3.org/TR/REC-xml-names.
- [XML Schema Datatypes]
-
XML Schema Part 2: Datatypes Second Edition, P. Byron and A.
Malhotra, Editors. World Wide Web Consortium, 2 May 2001, revised 28
October 2004. This version of the XML Schema Part 2 Recommendation is
http://www.w3.org/TR/2004/REC-xmlschema-2-20041028. The
latest version of XML Schema
Part 2 is available at http://www.w3.org/TR/xmlschema-2.
- [XML Schema Structures]
-
XML Schema Part 1: Structures Second Edition, H. Thompson, D.
Beech, M. Maloney, and N. Mendelsohn, Editors. World Wide Web
Consortium, 2 May 2001, revised 28 October 2004. This version of the XML
Schema Part 1 Recommendation is
http://www.w3.org/TR/2004/REC-xmlschema-1-20041028. The
latest version of XML Schema
Part 1 is available at http://www.w3.org/TR/xmlschema-1.
A.2
Other References
- [IETF RFC 2246]
- IETF "RFC 2246: The TLS Protocol", T. Dierks, C. Allen, January
1999. (See
http://www.ietf.org/rfc/rfc2246.txt.)
- [WSDL11 ElementIds]
-
WSDL 1.1 Element Identifiers D. Orchard, A. S. Vedamuthu, F.
Hirsch, M. Hondo, P. Yendluri, T. Boubez, Ü. Yalçinalp, Editors. World
Wide Web Consortium, 20 July 2007. This version of the WSDL 1.1 Element
Identifiers Working Group Note is
http://www.w3.org/TR/2007/NOTE-wsdl11elementidentifiers-20070720/. The
latest version
of WSDL 1.1 Element Identifiers is available at
http://www.w3.org/TR/wsdl11elementidentifiers/.
- [MTOM]
-
SOAP Message Transmission Optimization Mechanism, M. Gudgin,
N. Mendelsohn, M. Nottingham and H. Ruellan, Editors. World Wide Web
Consortium, 25 January 2005. This version of the SOAP Message
Transmission Optimization Mechanism Recommendation is
http://www.w3.org/TR/2005/REC-soap12-mtom-20050125/. The
latest version of SOAP
Message Transmission Optimization Mechanism is available at
http://www.w3.org/TR/soap12-mtom/.
- [WS-MTOMPolicy]
-
MTOM Serialization Policy Assertion (WS-MTOMPolicy), C.
Ferris, et al, Authors. International Business Machines Corporation and
Microsoft Corporation, Inc., September 2006. Available at
http://schemas.xmlsoap.org/ws/2004/09/policy/optimizedmimeserialization/
- [SCC14N]
-
Schema Centric XML Canonicalization Version 1.0, S. Aissi, A.
Hately, and M. Hondo, Editors. Organization for the Advancement of
Structured Information Standards, 23 May 2005. This version of the
Schema Centric XML Canonicalization Version 1.0 is
http://uddi.org/pubs/SchemaCentricCanonicalization-20050523.htm. The
latest
version of Schema Centric XML Canonicalization Version 1.0 is
available at http://uddi.org/pubs/SchemaCentricCanonicalization.htm.
- [WS-Addressing
Metadata]
-
Web
Services Addressing 1.0 - Metadata
Web
Services Addressing 1.0 - Metadata, M. Gudgin, M. Hadley, T.
Rogers and Ü. Yalçinalp, Editors. World Wide Web Consortium,
16 May
2007 31 July 2007. This version of the Web Services Addressing 1.0 - Metadata is
http://www.w3.org/TR/2007/WD-ws-addr-metadata-20070516/
http://www.w3.org/TR/2007/PR-ws-addr-metadata-20070731/. The
latest version of Web
Services Addressing 1.0 - Metadata is available at
http://www.w3.org/TR/ws-addr-metadata.
-
Note: need to create a tickler editorial action
for Felix to sync up the Attachment with the WS-A Metadata Recommendation.
-
[WS-MetadataExchange]
- Web
Services Metadata Exchange (WS-MetadataExchange), K.
Ballinger, et al, Authors. BEA Systems Inc., Computer Associates
International, Inc., International Business Machines Corporation,
Microsoft Corporation, Inc., SAP AG, Sun Microsystems, and webMethods,
August 2006. Available at http://schemas.xmlsoap.org/ws/2004/09/mex/
- [WS-RM Policy]
-
Web Services Reliable Messaging Policy Assertion (WS-RM Policy)
Web Services Reliable Messaging Policy Assertion (WS-RM Policy),
D. David, A. Kamarkar, G. Pilz, and Ü. Yalçinalp, Editors. Organization
for the Advancement of Structured Information Standards,
24 April 2006 14
June 2007.
Available at http://docs.oasis-open.org/ws-rx/wsrmp/200608/wsrmp-1.1-rddl-200608.html
http://docs.oasis-open.org/ws-rx/wsrmp/200702.
Note: need to update (as outlined above) examples
2-1, 3-1 and 4-1to use the RM Policy assertion from the 14 June 2007 version
of the WS-RM Policy specification.
-
- [WS-SecurityPolicy]
/dt>
-
WS-SecurityPolicy v1.2, A. Nadalin, M. Goodner M. Gudgin, A.
Barbir, and H. Granqvist, Editors. Organization for the Advancement of
Structured Information Standards, 1 July 2007. Available at
http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/ws-securitypolicy-1.2-spec-os.pdf.
Namespace document available at http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702.
- [WSDL 1.1 Binding
for SOAP 1.2]
-
WSDL 1.1 Binding for SOAP 1.2, D. Angelov, et al, Authors.
World Wide Web Consortium, 5 April 2006. Available at
http://www.w3.org/Submission/2006/SUBM-wsdl11soap12-20060405/.
- [XML-Signature]
-
XML-Signature Syntax and Processing, D. Eastlake, J. Reagle,
and D. Solo, Editors. The Internet Society & World Wide Web Consortium,
12 February 2002. This version of the XML-Signature Syntax and
Processing Recommendation is
http://www.w3.org/TR/2002/REC-xmldsig-core-20020212/. The
latest version of
XML-Signature Syntax and Processing is available at
http://www.w3.org/TR/xmldsig-core/.
- [XOP]
-
XML-binary Optimized Packaging, M. Gudgin, N. Mendelsohn, M.
Nottingham and H. Ruellan, Editors. World Wide Web Consortium, 25
January 2005. This version of the XML-binary Optimized Packaging
Recommendation is http://www.w3.org/TR/2005/REC-xop10-20050125/. The
latest version of XML-binary
Optimized Packaging is available at http://www.w3.org/TR/xop10/.
- [XPointer Framework]
-
XPointer Framework, Paul Grosso, Eve Maler, Jonathan Marsh,
Norman Walsh, Editors. World Wide Web Consortium, 22 November 2002
25 March 2003. This
version of the XPointer Framework Proposed Recommendation is
http://www.w3.org/TR/2003/REC-xptr-framework-20030325/ The
latest version of
XPointer Framework is available at
http://www.w3.org/TR/xptr-framework/.