<html xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="Generator" content="Microsoft Word 15 (filtered medium)">
<style><!--
/* Font Definitions */
@font-face
        {font-family:Courier;
        panose-1:2 7 4 9 2 2 5 2 4 4;}
@font-face
        {font-family:"Cambria Math";
        panose-1:2 4 5 3 5 4 6 3 2 4;}
@font-face
        {font-family:Calibri;
        panose-1:2 15 5 2 2 2 4 3 2 4;}
@font-face
        {font-family:Consolas;
        panose-1:2 11 6 9 2 2 4 3 2 4;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
        {margin:0in;
        margin-bottom:.0001pt;
        font-size:12.0pt;
        font-family:"Times New Roman","serif";}
a:link, span.MsoHyperlink
        {mso-style-priority:99;
        color:blue;
        text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
        {mso-style-priority:99;
        color:purple;
        text-decoration:underline;}
pre
        {mso-style-priority:99;
        mso-style-link:"HTML Preformatted Char";
        margin:0in;
        margin-bottom:.0001pt;
        font-size:10.0pt;
        font-family:"Courier New";}
span.HTMLPreformattedChar
        {mso-style-name:"HTML Preformatted Char";
        mso-style-priority:99;
        mso-style-link:"HTML Preformatted";
        font-family:Consolas;}
span.EmailStyle19
        {mso-style-type:personal-reply;
        font-family:"Calibri","sans-serif";
        color:#1F497D;}
.MsoChpDefault
        {mso-style-type:export-only;
        font-size:10.0pt;}
@page WordSection1
        {size:8.5in 11.0in;
        margin:1.0in 1.0in 1.0in 1.0in;}
div.WordSection1
        {page:WordSection1;}
--></style><!--[if gte mso 9]><xml>
<o:shapedefaults v:ext="edit" spidmax="1026" />
</xml><![endif]--><!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1" />
</o:shapelayout></xml><![endif]-->
</head>
<body lang="EN-US" link="blue" vlink="purple">
<div class="WordSection1">
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:&quot;Calibri&quot;,&quot;sans-serif&quot;;color:#1F497D">Sure, couldn’t agree more! I was just trying to make sense of why the status field was added there in the first place.<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:&quot;Calibri&quot;,&quot;sans-serif&quot;;color:#1F497D"><o:p>&nbsp;</o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:&quot;Calibri&quot;,&quot;sans-serif&quot;;color:#1F497D">I had not paid attention to the “_rev” field… that’s also a bit weird: for an HTTP client, it should typically be enough with the “ETag” header for caching
 purposes (the client should store the ETag next to the actual resource representation for future update operations). Putting the Etag value as a “revision” field on the body also goes a bit against RESTful guidelines (although I also understand this as a potential
 attempt to circumvent certain client-side limitations… but I’m not sure)<o:p></o:p></span></p>
<p class="MsoNormal"><a name="_MailEndCompose"></a><span style="font-size:11.0pt;font-family:&quot;Calibri&quot;,&quot;sans-serif&quot;;color:#1F497D"><o:p>&nbsp;</o:p></span></p>
<div style="border:none;border-left:solid blue 1.5pt;padding:0in 0in 0in 4.0pt">
<div>
<div style="border:none;border-top:solid #E1E1E1 1.0pt;padding:3.0pt 0in 0in 0in">
<p class="MsoNormal"><b><span style="font-size:11.0pt;font-family:&quot;Calibri&quot;,&quot;sans-serif&quot;">From:</span></b><span style="font-size:11.0pt;font-family:&quot;Calibri&quot;,&quot;sans-serif&quot;"> Maciej Machulak [mailto:maciej.machulak@gmail.com]
<br>
<b>Sent:</b> Wednesday, August 27, 2014 12:43 PM<br>
<b>To:</b> Da Cruz Pinto, Marcelo<br>
<b>Cc:</b> Eve Maler; UMA WG WG<br>
<b>Subject:</b> Re: [WG-UMA] Unnecessary &quot;status&quot; parameter for resource reg<o:p></o:p></span></p>
</div>
</div>
<p class="MsoNormal"><o:p>&nbsp;</o:p></p>
<div>
<p class="MsoNormal">Hi Marcelo,<o:p></o:p></p>
<div>
<p class="MsoNormal"><o:p>&nbsp;</o:p></p>
</div>
<div>
<p class="MsoNormal">Thanks for your comments. The scenario on page 16, however, does not match the spec text; hence my suggestion that the &quot;status&quot; parameter is removed. I think there is some text that should be clarified. See Section 2.3.3:<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p>&nbsp;</o:p></p>
</div>
<div>
<pre><span style="font-size:12.0pt;color:black">&nbsp;&nbsp; Updates a previously registered resource set description using the<o:p></o:p></span></pre>
<pre><span style="font-size:12.0pt;color:black">&nbsp;&nbsp; PUT method.&nbsp; If the request is successful, the authorization server<o:p></o:p></span></pre>
<pre><span style="font-size:12.0pt;color:black">&nbsp;&nbsp; MUST respond with a status message that includes an ETag header and<o:p></o:p></span></pre>
<pre><span style="font-size:12.0pt;color:black">&nbsp;&nbsp; _id and _rev properties for managing resource set description<o:p></o:p></span></pre>
<pre><span style="font-size:12.0pt;color:black">&nbsp;&nbsp; versioning.<o:p></o:p></span></pre>
<pre><span style="font-size:12.0pt;color:black"><o:p>&nbsp;</o:p></span></pre>
<pre><span style="font-size:12.0pt;color:black">&nbsp;&nbsp; Form of an &quot;update resource set description&quot; HTTP request:<o:p></o:p></span></pre>
<pre><span style="font-size:12.0pt;color:black"><o:p>&nbsp;</o:p></span></pre>
<pre><span style="font-size:12.0pt;color:black">&nbsp;&nbsp; PUT /resource_set/{rsid} HTTP/1.1<o:p></o:p></span></pre>
<pre><span style="font-size:12.0pt;color:black">&nbsp;&nbsp; Content-Type: application/json<o:p></o:p></span></pre>
<pre><span style="font-size:12.0pt;color:black">&nbsp;&nbsp; If-Match: (entity tag of resource)<o:p></o:p></span></pre>
<pre><span style="font-size:12.0pt;color:black">&nbsp;&nbsp; ...<o:p></o:p></span></pre>
<pre><span style="font-size:12.0pt;color:black"><o:p>&nbsp;</o:p></span></pre>
<pre><span style="font-size:12.0pt;color:black">&nbsp;&nbsp; (body contains JSON resource set description to be updated)<o:p></o:p></span></pre>
<pre><span style="font-size:12.0pt;color:black"><o:p>&nbsp;</o:p></span></pre>
<pre><span style="font-size:12.0pt;color:black">&nbsp;&nbsp; Form of a successful HTTP response:<o:p></o:p></span></pre>
<pre><span style="font-size:12.0pt;color:black"><o:p>&nbsp;</o:p></span></pre>
<pre><span style="font-size:12.0pt;color:black">&nbsp;&nbsp; HTTP/1.1 204 No Content<o:p></o:p></span></pre>
<pre><span style="font-size:12.0pt;color:black">&nbsp;&nbsp; ETag: &quot;2&quot;<o:p></o:p></span></pre>
<pre><span style="font-size:12.0pt;color:black">&nbsp;&nbsp; ...<o:p></o:p></span></pre>
</div>
<div>
<p class="MsoNormal"><o:p>&nbsp;</o:p></p>
</div>
<div>
<p class="MsoNormal">The text requires _id and _rev in the response but the success HTTP response uses 204, which is probably the preferred one (although 200 is fine, too). The text and the scenario should be unified then.<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p>&nbsp;</o:p></p>
</div>
<div>
<p class="MsoNormal">Cheers,<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal">Maciej<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p>&nbsp;</o:p></p>
<div>
<p class="MsoNormal">On 27 August 2014 20:25, Da Cruz Pinto, Marcelo &lt;<a href="mailto:marcelo.da.cruz.pinto@intel.com" target="_blank">marcelo.da.cruz.pinto@intel.com</a>&gt; wrote:<o:p></o:p></p>
<blockquote style="border:none;border-left:solid #CCCCCC 1.0pt;padding:0in 0in 0in 6.0pt;margin-left:4.8pt;margin-top:5.0pt;margin-right:0in;margin-bottom:5.0pt">
<div>
<div>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto"><span style="font-size:11.0pt;font-family:&quot;Calibri&quot;,&quot;sans-serif&quot;;color:#1F497D">On page 16 there is a scenario where a resource is being updated, and hence the status field is “updated”
 instead of “created”. There is no status code for “updated” in the HTTP standard (this might have been the reason why the status field has originally added). Now, that said, I think that by just returning a plain 200 as a result of an HTTP PUT is ok.</span><o:p></o:p></p>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto"><span style="font-size:11.0pt;font-family:&quot;Calibri&quot;,&quot;sans-serif&quot;;color:#1F497D">&nbsp;</span><o:p></o:p></p>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto"><span style="font-size:11.0pt;font-family:&quot;Calibri&quot;,&quot;sans-serif&quot;;color:#1F497D">Another argument against status (or other control) fields in RESTful responses is that they actually
 break the RESTfull tenets, in particular, the that the resource representation needs to be cacheable: If I perform an HTTP PUT on the resource, I need to get a representation of the resource that is the same (in structure) as if I had just created it using
 HTTP POST. To provide a better example, if I perform an idempotent HTTP PUT operation on the resource, and I get a status of “updated” this will break those guidelines because the original resource representation had a status value of “created” (but nothing
 really changed…)</span><o:p></o:p></p>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto"><span style="font-size:11.0pt;font-family:&quot;Calibri&quot;,&quot;sans-serif&quot;;color:#1F497D">&nbsp;</span><o:p></o:p></p>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto"><a name="14818ee909af8a86__MailEndCompose"><span style="font-size:11.0pt;font-family:&quot;Calibri&quot;,&quot;sans-serif&quot;;color:#1F497D">&nbsp;</span></a><o:p></o:p></p>
<div style="border:none;border-left:solid blue 1.5pt;padding:0in 0in 0in 4.0pt">
<div>
<div style="border:none;border-top:solid #E1E1E1 1.0pt;padding:3.0pt 0in 0in 0in">
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto"><b><span style="font-size:11.0pt;font-family:&quot;Calibri&quot;,&quot;sans-serif&quot;">From:</span></b><span style="font-size:11.0pt;font-family:&quot;Calibri&quot;,&quot;sans-serif&quot;">
<a href="mailto:wg-uma-bounces@kantarainitiative.org" target="_blank">wg-uma-bounces@kantarainitiative.org</a> [mailto:<a href="mailto:wg-uma-bounces@kantarainitiative.org" target="_blank">wg-uma-bounces@kantarainitiative.org</a>]
<b>On Behalf Of </b>Eve Maler<br>
<b>Sent:</b> Wednesday, August 27, 2014 7:19 AM<br>
<b>To:</b> Maciej Machulak<br>
<b>Cc:</b> UMA WG WG<br>
<b>Subject:</b> Re: [WG-UMA] Unnecessary &quot;status&quot; parameter for resource reg</span><o:p></o:p></p>
</div>
</div>
<div>
<div>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto">&nbsp;<o:p></o:p></p>
<div>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto">I'll create a new issue for this. Unless anyone wants to disagree, I think this is worth fielding in the run-up to V1.0.<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto">&nbsp;<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto">Can anyone think of a reason why the UMA-specific field adds value to the HTTP-level return code?<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto">&nbsp;<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Eve<o:p></o:p></p>
</div>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto">&nbsp;<o:p></o:p></p>
<div>
<div>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto">On 26 Aug 2014, at 3:18 PM, Maciej Machulak &lt;<a href="mailto:maciej.machulak@gmail.com" target="_blank">maciej.machulak@gmail.com</a>&gt; wrote:<o:p></o:p></p>
</div>
<p class="MsoNormal" style="mso-margin-top-alt:auto;margin-bottom:12.0pt"><o:p>&nbsp;</o:p></p>
<blockquote style="margin-top:5.0pt;margin-bottom:5.0pt">
<div>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto">In resource registration spec [1], we use the field &quot;status&quot; to inform the RS that a resource set is created on AS. This duplicates information that the RS obtains through HTTP
 return codes. Maybe this field should be removed?<o:p></o:p></p>
<div>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto">&nbsp;<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto">Cheers, Maciej<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto">&nbsp;<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto">[1]&nbsp;<a href="http://tools.ietf.org/html/draft-hardjono-oauth-resource-reg-03" target="_blank">http://tools.ietf.org/html/draft-hardjono-oauth-resource-reg-03</a><br clear="all">
<o:p></o:p></p>
<div>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto">&nbsp;<o:p></o:p></p>
</div>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto">--
<br>
Maciej Machulak<br>
email: <a href="mailto:maciej.machulak@gmail.com" target="_blank">maciej.machulak@gmail.com</a><br>
mobile: <a href="tel:%2B44%207999%20606%20767" target="_blank">&#43;44 7999 606 767</a> (UK)<br>
mobile: &#43;48 602 45 31 66 (PL) <o:p></o:p></p>
</div>
</div>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto">_______________________________________________<br>
WG-UMA mailing list<br>
<a href="mailto:WG-UMA@kantarainitiative.org" target="_blank">WG-UMA@kantarainitiative.org</a><br>
<a href="http://kantarainitiative.org/mailman/listinfo/wg-uma" target="_blank">http://kantarainitiative.org/mailman/listinfo/wg-uma</a><o:p></o:p></p>
</blockquote>
</div>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto">&nbsp;<o:p></o:p></p>
<div>
<div>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto"><span style="font-family:Courier;color:black"><br>
Eve Maler &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;<a href="http://www.xmlgrrl.com/blog" target="_blank">http://www.xmlgrrl.com/blog</a><br>
<a href="tel:%2B1%20425%20345%206756" target="_blank">&#43;1 425 345 6756</a> &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp;<a href="http://www.twitter.com/xmlgrrl" target="_blank">http://www.twitter.com/xmlgrrl</a></span><o:p></o:p></p>
</div>
</div>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto">&nbsp;<o:p></o:p></p>
</div>
</div>
</div>
</div>
</div>
</blockquote>
</div>
<p class="MsoNormal"><br>
<br clear="all">
<o:p></o:p></p>
<div>
<p class="MsoNormal"><o:p>&nbsp;</o:p></p>
</div>
<p class="MsoNormal">-- <br>
Maciej Machulak<br>
email: <a href="mailto:maciej.machulak@gmail.com" target="_blank">maciej.machulak@gmail.com</a><br>
mobile: &#43;44 7999 606 767 (UK)<br>
mobile: &#43;48 602 45 31 66 (PL) <o:p></o:p></p>
</div>
</div>
</div>
</div>
</body>
</html>