W3C home > Mailing lists > Public > public-ws-resource-access@w3.org > November 2009

RE: [Bug 6463] New: Attaching Policy to WS-Mex GetMetadata

From: Asir Vedamuthu <asirveda@microsoft.com>
Date: Fri, 6 Nov 2009 16:32:56 +0000
To: Asir Vedamuthu <asirveda@microsoft.com>, Katy Warr <katy_warr@uk.ibm.com>
CC: "public-ws-resource-access@w3.org" <public-ws-resource-access@w3.org>
Message-ID: <4F4942E980BD7147AE7F7D3DCB9CBA9F044084C4@TK5EX14MBXC132.redmond.corp.microsoft.com>
As promised, the following is an example that illustrates how to embed a bootstrap binding in an EPR and how to attach a policy expression to the bootstrap binding ...

<wsa:EndpointReference
    xmlns:wsa='http://www.w3.org/2005/08/addressing'>
  <wsa:Address>http://services.example.org/stockquote</wsa:Address>
  <wsa:Metadata>
    <mex:Metadata xmlns:mex='http://www.w3.org/2009/09/ws-mex'>
      <mex:MetadataSection Dialect='http://schemas.xmlsoap.org/wsdl/'>

<!-- BEGIN: Metadata of GetMetadata () -->

<wsdl:definitions name='StockQuoteMetadata'
    targetNamespace='http://services.example.org/stockquote/metadata'
    xmlns:wsdl='http://schemas.xmlsoap.org/wsdl/'
    xmlns:mex='http://www.w3.org/2009/09/ws-mex'
    xmlns:wsp='http://www.w3.org/ns/ws-policy'
    xmlns:wsoap12='http://schemas.xmlsoap.org/wsdl/soap12/'>

  <wsdl:import namespace='http://www.w3.org/2009/09/ws-mex'
      location='http://www.w3.org/2009/09/ws-mex/metadataexchange.wsdl' />

  <wsdl:binding name='GetMetadataBinding' type='mex:MetadataExchange'>
     <wsp:PolicyReference 
         URI='http://services.example.org/stockquote/GetMetadataPolicy' />
     <wsoap12:binding transport='http://schemas.xmlsoap.org/soap/http' />
     ...
  </wsdl:binding>
  ...
</wsdl:definitions>

<!-- END: Metadata of GetMetadata() -->

      </mex:MetadataSection>
    </mex:Metadata>
  </wsa:Metadata>
</wsa:EndpointReference>

Regards,

Asir S Vedamuthu
Microsoft Corporation




From: public-ws-resource-access-request@w3.org [mailto:public-ws-resource-access-request@w3.org] On Behalf Of Asir Vedamuthu
Sent: Tuesday, November 03, 2009 9:54 AM
To: Katy Warr
Cc: public-ws-resource-access@w3.org
Subject: RE: [Bug 6463] New: Attaching Policy to WS-Mex GetMetadata

Okay to add an example to Section 8. We suggest adding a simpler example. We will provide a sample or example later.

Regards,

Asir S Vedamuthu
Microsoft Corporation

From: Katy Warr [mailto:katy_warr@uk.ibm.com] 
Sent: Monday, November 02, 2009 2:09 AM
To: Asir Vedamuthu
Cc: public-ws-resource-access@w3.org
Subject: RE: [Bug 6463] New: Attaching Policy to WS-Mex GetMetadata


Asir 

Yes, I agree that we could close with no action, but it would be beneficial to have an example.  I also think that this provides us with an opportunity to make the spec easier for readers in this area. 

I suggest: 
1) Add an example for GetMetadata in section 8 "Bootstrapping Metadata Retrieval". 
2) Example 7.2 illustrates how the WS-T Get might be bootstrapped.  Move example 7.2 to section 8 so that the 2 examples are same relevant section 
3) Example 7.2 could be improved.  I can raise a separate issue for this or we could fix it here. 

Detailed proposal is attached below.  Note that for (1), I used external policy attachments.  This is  because we already have examples with embedded metadata and a variety of examples is always helpful to readers.  However, embedded wsdl would work in the example too.  Similarly, I used MetadataLocation in (3) for variety. 

Many thanks 
Katy 

Draft Proposal  for 6463: 
========================= 

1) Add the following to WS-Mex section 8 Bootstrapping-Metadata-Retrieval: 
-------------------------------------------------------------------------- 

For example, metadata for the WS-MetadataExchange GetMetadata operation MAY be passed within an Endpoint Reference as illustrated in example 8.1.   

Example 8.1: Passing Policy of the GetMetadata request within an EPR 

(01)  <wsa:EndpointReference
(02)      xmlns:wsa='http://www.w3.org/2005/08/addressing'>
(03)    <wsa:Address>http://services.example.org/stockquote</wsa:Address> 

       <wsa:Metadata> 

(08)      <mex:Metadata xmlns:mex='http://www.w3.org/2009/09/ws-mex'>
(09)        <mex:MetadataSection
               Dialect='http://www.w3.org/TR/ws-policy-attach'>                 
                <wsp:PolicyAttachment>
                  <wsp:AppliesTo>                       
                      <!-- Following according to: http://www.w3.org/TR/ws-policy-attach/#uri-domain-expression --> 
                      <!-- with URI syntax from: http://www.w3.org/TR/wsdl11elementidentifiers/                 -->
                     <wsp:URI> 
                          http://www.w3.org/2009/09/ws-mex#wsdl1.PortTypeOperation(GetMetadata) 
                  </wsp:URI>
                  </wsp:AppliesTo> 
                   <wsp:Policy> ... </wsp:Policy>  
               </wsp:PolicyAttachment>            
(22)        </mex:MetadataSection>
(23)      </mex:Metadata>
(24)    </wsa:Metadata>
(25)  </wsa:EndpointReference> 

Example 8.1 shows an EPR that supports WS-MetadataExchange.  Lines [09] to [22] specify a metadata section that defines required policy for the WS-MetadataExchange GetMetadata operation using the WS-PolicyAttachments [WS-PolicyAttachments] dialect.  Note that it would be valid to pass the WS-MetadataExchange WSDL with policy in-lined instead of the WS-PolicyAttachment. 

2) Move example 7.2 to section 8 
-------------------------------- 

because this example is specific to bootstrapping metadata retrieval and fits nicely with the example above with additional text something like: 

"Similarly, metadata for the WS-Transfer Get operation may be passed within an Endpoint Reference as illustrated in example 7.2." 

3) Finally, I suggest that we improve example 7.2 within the context of this issue 
---------------------------------------------------------------------------------- 

Make the following updates to example 7.2: 

  a) Add "Identifier='http://www.w3.org/2009/09/ws-tra'> " line 16 below 
  b) Replace:   
  (16)                  <!-- Reference to WS-Transfer WSDL wst:Resource portType
 (17)                     plus binding --> 
  with: 
                        <mex:MetadataLocation> 
                           <!-- Reference to WS-Transfer WSDL at the Metadata Endpoint --> 
  (17)                        http://services.example.org/stockquote/metadata/TransferWSDL 
                        </mex:MetadataLocation> 

The resulting example is: 

Example 7-2: Endpoint reference with embedded metadata about the Metadata Reference 
(01)  <wsa:EndpointReference
(02)      xmlns:wsa='http://www.w3.org/2005/08/addressing'>
(03)    <wsa:Address>http://services.example.org/stockquote</wsa:Address>
(04)    <wsa:Metadata>
(05)      <mex:Metadata xmlns:mex='http://www.w3.org/2009/09/ws-mex'> 

(06)        <mex:MetadataSection
(07)            Dialect='http://www.w3.org/2009/09/ws-mex'> 
(08)          <mex:MetadataReference>
(09)            <wsa:Address>
(10)              http://services.example.org/stockquote/metadata
(11)            </wsa:Address>
(12)            <wsa:Metadata>
(13)              <mex:Metadata>
(14)                <mex:MetadataSection
(15)                  Dialect='http://schemas.xmlsoap.org/wsdl/' 
(16)                    Identifier='http://www.w3.org/2009/09/ws-tra'> 
                      <mex:MetadataLocation> 
                         <!-- Reference to WS-Transfer WSDL at the Metadata Endpoint --> 
(17)                        http://services.example.org/stockquote/metadata/TransferWSDL 
                      </mex:MetadataLocation>
(18)                </mex:MetadataSection>
(19)              </mex:Metadata>
(20)            </wsa:Metadata>
(21)          </mex:MetadataReference>
(22)        </mex:Metadata> 
          </wsa:Metadata> 
        </EndpointReference> 


From: 
Asir Vedamuthu <asirveda@microsoft.com> 
To: 
"public-ws-resource-access@w3.org" <public-ws-resource-access@w3.org> 
Date: 
02/11/2009 01:38 
Subject: 
RE: [Bug 6463] New: Attaching Policy to WS-Mex GetMetadata

________________________________________



There is a simple, natural solution - embed a WSDL (using MEX in an EPR) that specifies binding/port information for the MetadataExchange portType at http://www.w3.org/2009/09/ws-mex/metadataexchange.wsdl and attach policy expressions to bindings, as appropriate. This is specifically covered by some prose in the current version of WS-MetadataExchange draft [1]:

"In particular, the mechanisms described in 7 Metadata in Endpoint References allow issuers of endpoint references to include sufficient protocol binding information to allow requesters to issue a Get request against a metadata resource, or a Get Metadata request against a service endpoint, in order to retrieve all the information needed to use the service."

Proposal: close issue 6463 without any action!

[1] http://www.w3.org/TR/2009/WD-ws-metadata-exchange-20090924/#Bootstrapping-Metadata-Retrieval 

Regards,

Asir S Vedamuthu
Microsoft Corporation

-----Original Message-----
From: public-ws-resource-access-notifications-request@w3.org [mailto:public-ws-resource-access-notifications-request@w3.org] On Behalf Of bugzilla@wiggum.w3.org
Sent: Wednesday, January 21, 2009 6:45 AM
To: public-ws-resource-access-notifications@w3.org
Subject: [Bug 6463] New: Attaching Policy to WS-Mex GetMetadata


http://www.w3.org/Bugs/Public/show_bug.cgi?id=6463

          Summary: Attaching Policy to WS-Mex GetMetadata
          Product: WS-Resource Access
          Version: PR
         Platform: PC
       OS/Version: Windows XP
           Status: NEW
         Severity: normal
         Priority: P2
        Component: MetadataExchange
       AssignedTo: public-ws-resource-access-notifications@w3.org
       ReportedBy: katy_warr@uk.ibm.com


We should consider clarifying or recommending how policy should be associated
with a WS-MetadataExchange GetMetadata request.  ('Policy' might be existing
policies such as WS-SecurityPolicy or potential new assertions, as described in
issue 6406 here: http://www.w3.org/Bugs/Public/show_bug.cgi?id=6406).

A GetMetadata operation's policy cannot be attached within the Web service
endpoint's WSDL because:
In order for a client to establish the WS-Mex GetMetadata policy, it would need
to issue a GetMetadata(WSDL) request at the web service endpoint...but in order
to issue a GetMetadata request at the endpoint it would need to establish the
WS-Mex GetMetadata policy...

The issue here is: what is the correct way to bootstrap the bootstrap (without
entering an infinite loop)?


--
Configure bugmail: http://www.w3.org/Bugs/Public/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.






________________________________________

Unless stated otherwise above:
IBM United Kingdom Limited - Registered in England and Wales with number 741598. 
Registered office: PO Box 41, North Harbour, Portsmouth, Hampshire PO6 3AU 
Received on Friday, 6 November 2009 16:33:38 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Saturday, 18 December 2010 18:18:15 GMT