Web Services Policy 1.5 - Attachment
This version:
Latest version:
Previous version:
http://www.w3.org/TR/2006/WD-ws-policy-attach-20061117
Editors:
Asir S Vedamuthu, Microsoft Corporation
David Orchard, BEA Systems, Inc.
Frederick Hirsch, Nokia
Maryann Hondo, IBM Corporation
Prasad Yendluri, webMethods, Inc.
Toufic Boubez, Layer 7 Technologies
Ümit Yalçinalp, SAP AG.
Copyright © @@@@ W3C® (MIT, ERCIM, Keio), All Rights Reserved. W3C liability, trademark and document use rules apply.
This specification, Web Services Policy 1.5 - Attachment, defines two general-purpose mechanisms for associating policies, as defined in Web Services Policy 1.5 - Framework, with the subjects to which they apply. This specification also defines how these general-purpose mechanisms may be used to associate policies with WSDL and UDDI descriptions.
1. Introduction
2. Notations and
Terminology
2.1 Notational Conventions
2.2 XML
Namespaces
2.3 Terminology
2.4 Example
3. Policy
Attachment
3.1 Effective Policy
3.2 Policy Attachment Mechanisms
3.3 XML Element Attachment
3.4 External Policy Attachment
3.4.1 URI Domain
Expression
3.5 Use of IRIs in Policy Attachment
4. Attaching
Policies Using WSDL 1.1
4.1 Calculating Effective Policy in WSDL 1.1
4.1.1 Service Policy
Subject
4.1.2 Endpoint Policy
Subject
4.1.3 Operation Policy
Subject
4.1.4 Message Policy
Subject
4.1.5 Example
5. WS-Policy
Attachment for WSDL 2.0
5.1 Example
5.2 Attaching Policy Expressions
5.3 Extension to WSDL Component Model
5.4 Effective Policy
5.4.1 Service Policy
Subject
5.4.2 Endpoint Policy
Subject
5.4.3 Operation
Policy Subject
5.4.4 Message
Policy Subject (input message)
5.4.5 Message
Policy Subject (output message)
5.4.6 Message
Policy Subject (input fault message)
5.4.7 Message
Policy Subject (output fault message)
6. Attaching
Policies Using UDDI
6.1 Calculating Effective Policy and Element Policy in
UDDI
6.1.1 Service
Provider Policy Subject
6.1.2 Service Policy
Subject
6.1.3 Endpoint
Policy Subject
6.2 Referencing Remote Policy Expressions
6.3 Registering Reusable Policy Expressions
6.4 Registering Policies in UDDI Version 3
7. Security
Considerations
8. Conformance
8.1 External
Policy Attachment Conformance
8.2 WSDL
1.1 Attachment Conformance
8.3 WSDL
2.0 Attachment Conformance
A. References
A.1 Normative References
A.2 Other References
B. UDDI tModel Definitions
B.1 Remote Policy Reference Category System
B.1.1 Design Goals
B.1.2 tModel Definition
B.1.3 tModel Structure
B.2 Web Services Policy Types Category System
B.2.1 Design Goals
B.2.2 tModel Definition
B.2.3 tModel Structure
B.3 Local Policy Reference Category System
B.3.1 Design Goals
B.3.2 tModel Definition
B.3.3 tModel Structure
C. Acknowledgements
(Non-Normative)
The Web Services Policy 1.5 - Framework [Web Services Policy Framework] specification defines an abstract model and an XML-based language for expressing policies of entities in a Web services-based system. This specification, Web Services Policy 1.5 - Attachment, defines two general-purpose mechanisms for associating policies with the subjects to which they apply; the policies may be defined as part of existing metadata about the subject or the policies may be defined independently and associated through an external binding to the subject.
To enable Web Services Policy to be used with existing Web service technologies, this specification describes the use of these general-purpose mechanisms with WSDL [WSDL 1.1, WSDL 2.0 Core Language] definitions and UDDI [UDDI API 2.0, UDDI Data Structure 2.0, UDDI 3.0].
This section specifies the notations, namespaces, and terminology used in this specification.
This section defines two general-purpose mechanisms for associating policies with one or more policy subjects.
The following UDDI element is considered as the service provider policy subject:
The following UDDI element is considered as the service policy subject:
(01) <businessService serviceKey="…" >
(03) <description>…</description>
(04) <bindingTemplates>…</bindingTemplates>
(07) keyName="Policy Expression for example's Web services"
(08) keyValue="http://www.example.com/myservice/policy"
(09)
tModelKey="uuid:c89e98b4-868c-3abf-a683-89071af807c6uuid:a27078e4-fd38-320a-806f-6749e84f8005"
/>
(01) <bindingTemplate bindingKey="…" >
(02) <accessPoint>…</accessPoint>
(05)
tModelKey="uuid:c89e98b4-868c-3abf-a683-89071af807c6uuid:a27078e4-fd38-320a-806f-6749e84f8005"
>
(01) <tModel tModelKey="uuid:04cfa…">
(03) <description xml:lang="EN">
(04) Policy Expression for example's Web services
(07) <description xml:lang="EN">Web Services Policy Expression</description>
(08) <overviewURL>http://www.example.com/myservice/policy</overviewURL>
(12) keyName="Reusable policy Expression"
(14)
tModelKey="uuid:78003262-1ea8-3ae5-95cb-67cc900b6b59uuid:fa1d77dc-edf0-3a84-a99a-5972e434e993"
/>
(16) keyName="Policy Expression for example's Web services"
(17) keyValue="http://www.example.com/myservice/policy"
(18)
tModelKey="uuid:c89e98b4-868c-3abf-a683-89071af807c6uuid:a27078e4-fd38-320a-806f-6749e84f8005"
/>
· exist in the same UDDI registry
·
and
are categorized as "policy"
using the Web Services Policy Types category system.
(01) <businessService serviceKey="…" >
(03) <description>…</description>
(04) <bindingTemplates>…</bindingTemplates>
(07) keyName="Policy Expression for example's Web services"
(09)
tModelKey="uuid:9e9bfbe9-2212-3c9c-a170-381e702a9946uuid:a27f7d45-ec90-31f7-a655-efe91433527c"
/>
(01) <bindingTemplate bindingKey="…" >
(02) <accessPoint>…</accessPoint>
(05)
tModelKey="uuid:9e9bfbe9-2212-3c9c-a170-381e702a9946uuid:a27f7d45-ec90-31f7-a655-efe91433527c"
>
(01) <bindingTemplate bindingKey="…" >
(02) <accessPoint>…</accessPoint>
(03) <tModelInstanceDetails>…</tModelInstanceDetails>
(06) keyName="Policy Expression for example's Web services"
(07) keyValue="http://www.example.com/myservice/policy"
(08)
tModelKey="uddi:w3c.org:ws-policy:v1.5:attachment:remotepolicyreference uddi:schemas.xmlsoap.org:remotepolicyreference:2003_03"
(04) keyValue="http://www.example.com/"
(05)
tModelKey="uddi:w3c.org:ws-policy:v1.5:attachment:remotepolicyreference uddi:schemas.xmlsoap.org:remotepolicyreference:2003_03"
This tModel is used to attach a policy to a UDDI entity by referencing the policy's IRI.
|
|
(03) <description xml:lang="EN">Category system used for UDDI entities to point to an external
(04) Web Services Policy Attachment policy expression that describes their characteristics.
(05) See Web Services Policy 1.5 - Attachment specification for further details.</description>
(08) keyName="uddi-org:types:categorization"
(09) keyValue="categorization"
(10) tModelKey="uuid:c1acf26d-9672-4404-9d70-39b756e62ab4" />
(03) <description xml:lang="EN">Web Services Policy Types category system used for UDDI tModels
(04) to characterize them as Web Services Policy – based policy expressions.</description>
(07) keyName="uddi-org:types:categorization"
(08) keyValue="categorization"
(09) tModelKey="uuid:c1acf26d-9672-4404-9d70-39b756e62ab4" />
(02) <name>http://schemas.xmlsoap.org/ws/2003/03/localpolicyreference</name>
(03) <description xml:lang="en">Category system used for UDDI entities to point to a
(04) Web Services Policy policy expression tModel that describes their characteristics.
(05) See Web Services Policy 1.5 - Attachment specification for further details.</description>
(08) keyName="uddi-org:types:categorization"
(09) keyValue="categorization"
(10) tModelKey="uuid:c1acf26d-9672-4404-9d70-39b756e62aB4" />
(12) keyName="uddi-org:types:checked"
(14) tModelKey="uuid:c1acf26d-9672-4404-9d70-39b756e62aB4" />
(16) keyName="uddi-org:entityKeyValues"
(18) tModelKey="uuid:916b87bf-0756-3919-8eae-97dfa325e5a4" />