Re: [OAUTH-WG] Fwd: New Version Notification for draft-sakimura-oauth-meta-07.txt

Nat Sakimura <sakimura@gmail.com> Wed, 17 February 2016 00:55 UTC

Return-Path: <sakimura@gmail.com>
X-Original-To: oauth@ietfa.amsl.com
Delivered-To: oauth@ietfa.amsl.com
Received: from localhost (ietfa.amsl.com [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id B90391B2C49 for <oauth@ietfa.amsl.com>; Tue, 16 Feb 2016 16:55:19 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: 1.112
X-Spam-Level: *
X-Spam-Status: No, score=1.112 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, FREEMAIL_FROM=0.001, HTML_MESSAGE=0.001, HTTPS_HTTP_MISMATCH=1.989, SPF_PASS=-0.001, URI_HEX=1.122] autolearn=no
Received: from mail.ietf.org ([4.31.198.44]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 6i1jtQrKqhHH for <oauth@ietfa.amsl.com>; Tue, 16 Feb 2016 16:55:17 -0800 (PST)
Received: from mail-qk0-x22d.google.com (mail-qk0-x22d.google.com [IPv6:2607:f8b0:400d:c09::22d]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 55CB91B2C47 for <oauth@ietf.org>; Tue, 16 Feb 2016 16:55:17 -0800 (PST)
Received: by mail-qk0-x22d.google.com with SMTP id s5so572233qkd.0 for <oauth@ietf.org>; Tue, 16 Feb 2016 16:55:17 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :content-type; bh=JNYoPKHqhA3YZBAMVLp1QzL0pScVmhhtKGX9dNbZML8=; b=DyooUwJR7DAyOyQLgFAoB2CfxPbcVaxbV0LE0u/RpDBjVsGBVJGJzB3IF5LOylpjbr y04VGB7tO5YDPJWE3ibfwvP4OvW6yZKl4e68X/CkaAOReLH9aI5EFfzqlfeSIaYbMvh5 l/WspUv3YXmEjCgdyobUwZBKuQ21EGSdXHSgBuBaLsDZ1y7JUECcsNrCX8gn8zl6SvVQ fK6T4N2Ly5BsuZno8wQGhUe3ym5KVEzQnswqjYd8LjR/zT/aI8ko/aDgpgn5gxkhXYXE ilZ6RYXam8RzQOLkJua64/OlsCLjIM7MkJjV2zVBK+e6pJYXSlzxnEMufTEiQopXd4hA 94Sw==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:content-type; bh=JNYoPKHqhA3YZBAMVLp1QzL0pScVmhhtKGX9dNbZML8=; b=c3GMozZIK8XXL7q3YWA46A+gPQCRpi3/vMiTMQ4RDU2JhvJ03cwU4f+1jdaXtkAIZh ArjjJbAsfZrgTV9ws6xNATViVKboY+3jvK1OJ5p6FnTvS4hF4kckO7BSRccu9bgdOTtG QMbl+PzsWGe9Nh/Txlcmh31sV1Tfb94zkOgSLFEqDBv8x5zlms9i8RwJcIbIfpEG8o8P RHLzI5U1ck41OWyjIXUwvyj8ZVMoPMODeuvIH1QaQCz+HY9fjUNgwtgwIA5LMrcacbAV zROdGQECtdJk8J2+sa8bSiTGfkBrJOQ93HwU9x3KgH6LwgdXjsG7QvgkH8pQKZ4u8FQP wfrA==
X-Gm-Message-State: AG10YOSvXHT6EaVEX970g1zKz0G5QizicI7wzK1Cr5i5Xj8w4kRcW2N2sK8U2MnpSOC5kgGsihoOSd6wlD+E4g==
X-Received: by 10.55.71.135 with SMTP id u129mr31711273qka.26.1455670516486; Tue, 16 Feb 2016 16:55:16 -0800 (PST)
MIME-Version: 1.0
References: <20160212094043.13011.44662.idtracker@ietfa.amsl.com> <CABzCy2CP0LZGePZedXYfWfsKOauCnnZeGiConUiEG2GmEP+vdg@mail.gmail.com> <BN3PR0301MB123433D1ED9BF9B1118BC751A6AD0@BN3PR0301MB1234.namprd03.prod.outlook.com>
In-Reply-To: <BN3PR0301MB123433D1ED9BF9B1118BC751A6AD0@BN3PR0301MB1234.namprd03.prod.outlook.com>
From: Nat Sakimura <sakimura@gmail.com>
Date: Wed, 17 Feb 2016 00:55:05 +0000
Message-ID: <CABzCy2CCSkmSoZhs2WkJVGW_1tAWjPJHqLbatYaHfaowj59g9A@mail.gmail.com>
To: Anthony Nadalin <tonynad@microsoft.com>, oauth <oauth@ietf.org>
Content-Type: multipart/alternative; boundary=001a114a7d200b988a052becb42c
Archived-At: <http://mailarchive.ietf.org/arch/msg/oauth/5FH0cym8Oj6IbgKWmZFaLoaE9G4>
Subject: Re: [OAUTH-WG] Fwd: New Version Notification for draft-sakimura-oauth-meta-07.txt
X-BeenThere: oauth@ietf.org
X-Mailman-Version: 2.1.15
Precedence: list
List-Id: OAUTH WG <oauth.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/oauth>, <mailto:oauth-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/oauth/>
List-Post: <mailto:oauth@ietf.org>
List-Help: <mailto:oauth-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/oauth>, <mailto:oauth-request@ietf.org?subject=subscribe>
X-List-Received-Date: Wed, 17 Feb 2016 00:55:19 -0000

Link relation is not at all XML. It is a step forward to RESTfulness.
In the older version of the draft, I was using JSONized version of it as
well, but I splitted it out for the sake of brevity.
It is all about dynamic metadata about the response.
Once we do it with RFC5988, we could easily create a parallel to it with
JSON meta object of your flavour.
(Currently, JSON schema seems to be in fashion, though I personally prefer
HAL.)
Good things about using JSONized version is that it will be usable outside
the HTTP and the fact that it can be stored in a single JSON object
together with the data.
Bad thing about it is that we have to start from the syntax for it, which
we can avoid by using RFC5988.
If people want the JSON version of this, I could do it as well.
However, since we are processing HTTP response headers anyways, there is
not much compelling reason for that as long as we stick with HTTP.
That's why I am just sticking with RFC5988.

Nat.


2016年2月17日(水) 8:50 Anthony Nadalin <tonynad@microsoft.com>om>:

> I really think that this is a step backwards relative to technology and
> what the developers would accept. The Link Relations takes us back to the
> XML days, I thought we have all moved on from that and at least trying to
> move Oauth to JSON. I think if this were adopted we might be splitting the
> developers into folks that are already going down the current JSON path
> with Oauth and those that want to go back to XML.
>
>
>
> This just seems a very odd draft to adopt this technology.
>
>
>
> *From:* OAuth [mailto:oauth-bounces@ietf.org] *On Behalf Of *Nat Sakimura
> *Sent:* Monday, February 15, 2016 3:59 PM
> *To:* oauth <oauth@ietf.org>
> *Subject:* [OAUTH-WG] Fwd: New Version Notification for
> draft-sakimura-oauth-meta-07.txt
>
>
>
> It now shows how to return multiple endpoints in web linking.
>
> Also, added Resource Endpoint response header.
>
>
>
> Best,
>
>
>
> nat
>
>
>
> ---------- Forwarded message ---------
> From: <internet-drafts@ietf.org>
> Date: 2016年2月12日(金) 18:40
> Subject: New Version Notification for draft-sakimura-oauth-meta-07.txt
> To: Nov Matake <nov@matake.jp>jp>, Nat Sakimura <sakimura@gmail.com>om>, Sascha
> Preibisch <Sascha.Preibisch@gmail.com>om>, Sascha Preibisch <
> sascha.preibisch@gmail.com>
>
>
>
>
> A new version of I-D, draft-sakimura-oauth-meta-07.txt
> has been successfully submitted by Nat Sakimura and posted to the
> IETF repository.
>
> Name:           draft-sakimura-oauth-meta
> Revision:       07
> Title:          OAuth Response Metadata
> Document date:  2016-02-12
> Group:          Individual Submission
> Pages:          10
> URL:
> https://www.ietf.org/internet-drafts/draft-sakimura-oauth-meta-07.txt
> <https://na01.safelinks.protection.outlook.com/?url=https%3a%2f%2fwww.ietf.org%2finternet-drafts%2fdraft-sakimura-oauth-meta-07.txt&data=01%7c01%7ctonynad%40microsoft.com%7c3a992d5ff4a2428804f208d336641292%7c72f988bf86f141af91ab2d7cd011db47%7c1&sdata=6M10Q9X4cq%2b%2fRroR%2fHYQ9IN3P1HO06JnbuzY6P3oWtc%3d>
> Status:
> https://datatracker.ietf.org/doc/draft-sakimura-oauth-meta/
> <https://na01.safelinks.protection.outlook.com/?url=https%3a%2f%2fdatatracker.ietf.org%2fdoc%2fdraft-sakimura-oauth-meta%2f&data=01%7c01%7ctonynad%40microsoft.com%7c3a992d5ff4a2428804f208d336641292%7c72f988bf86f141af91ab2d7cd011db47%7c1&sdata=7twEM0FztSaswtFiYslvJuadTyWbWRSDWQ6uT%2bevKwM%3d>
> Htmlized:       https://tools.ietf.org/html/draft-sakimura-oauth-meta-07
> <https://na01.safelinks.protection.outlook.com/?url=https%3a%2f%2ftools.ietf.org%2fhtml%2fdraft-sakimura-oauth-meta-07&data=01%7c01%7ctonynad%40microsoft.com%7c3a992d5ff4a2428804f208d336641292%7c72f988bf86f141af91ab2d7cd011db47%7c1&sdata=kh2nH4IyNm3OAA5nkrSFzZN16Xic%2b2EDUOfr%2fG6CjVY%3d>
> Diff:
> https://www.ietf.org/rfcdiff?url2=draft-sakimura-oauth-meta-07
> <https://na01.safelinks.protection.outlook.com/?url=https%3a%2f%2fwww.ietf.org%2frfcdiff%3furl2%3ddraft-sakimura-oauth-meta-07&data=01%7c01%7ctonynad%40microsoft.com%7c3a992d5ff4a2428804f208d336641292%7c72f988bf86f141af91ab2d7cd011db47%7c1&sdata=ICtk5U1e6kBPFI8ov0n06TAcqDX3HurgFTydXKD73Yo%3d>
>
> Abstract:
>    This specification defines an extensible metadata that may be
>    inserted into the OAuth 2.0 responses to assist the clients to
>    process those responses.  It is expressed either as a link header, or
>    query parameters.  It will allow the client to learn where the
>    members in the response could be used, what is the characteristics of
>    the payload is, how it should be processed, and so on.  Since they
>    are just additional response header/query parameters, any client that
>    does not understand this extension should not break and work normally
>    while supporting clients can utilize the metadata to take the
>    advantage of the extension.
>
>
>
>
> Please note that it may take a couple of minutes from the time of
> submission
> until the htmlized version and diff are available at tools.ietf.org
> <https://na01.safelinks.protection.outlook.com/?url=http%3a%2f%2ftools.ietf.org&data=01%7c01%7ctonynad%40microsoft.com%7c3a992d5ff4a2428804f208d336641292%7c72f988bf86f141af91ab2d7cd011db47%7c1&sdata=aijC6rAn01n04mDyB5lpV7tQitxIyf0drdheleR955A%3d>
> .
>
> The IETF Secretariat
>