Re: [OAUTH-WG] I-D Action: draft-ietf-oauth-introspection-04.txt

Thomas Broyer <t.broyer@gmail.com> Wed, 24 December 2014 09:15 UTC

Return-Path: <t.broyer@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 C0AF01AD017 for <oauth@ietfa.amsl.com>; Wed, 24 Dec 2014 01:15:36 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.999
X-Spam-Level:
X-Spam-Status: No, score=-1.999 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, SPF_PASS=-0.001] autolearn=ham
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 IrRzFl1Uvwl5 for <oauth@ietfa.amsl.com>; Wed, 24 Dec 2014 01:15:34 -0800 (PST)
Received: from mail-la0-x22c.google.com (mail-la0-x22c.google.com [IPv6:2a00:1450:4010:c03::22c]) (using TLSv1 with cipher ECDHE-RSA-RC4-SHA (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 63BAA1AD012 for <oauth@ietf.org>; Wed, 24 Dec 2014 01:15:33 -0800 (PST)
Received: by mail-la0-f44.google.com with SMTP id gd6so6775819lab.31 for <oauth@ietf.org>; Wed, 24 Dec 2014 01:15:31 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:references:from:date:message-id:subject:to :content-type; bh=gnuzN4KwL1cvbGcbatoxTxK0gFur8wu6bOmbjK5EGC0=; b=unGI7KNZ+cZ+eq3B5ZArZB4yGbYAB6WBQXMk6RG5lBxNZFt/Hh/mVAoh18Qk8UWTYJ vhR8XHSm/tUG8eKGus30YD4Q05dsAEa6T++ZQr3GToz/sDiiK0StNUXJ/gjyu4r0nR9b N7D0JJUOB0DyPXCwUMyEc85KFhrj1rVr0C5OUGtOJzT4MvG3dGT3yldL7aC07/AC61dI o0DAmwx9BBZHNdmV1ZA/lUIVmk2MS0GhZPHI7lzG3NI9SY1CtBPqGOgIxMNEJwmbnuwL aXz4fn7yreWibIFWMcmmUwFD8Liz6Yck2oIXAumxYLHYEhrM1UTAdEc3WW7CnMnTmSQH yMKw==
X-Received: by 10.112.73.97 with SMTP id k1mr33497670lbv.78.1419412531872; Wed, 24 Dec 2014 01:15:31 -0800 (PST)
MIME-Version: 1.0
References: <20141223175920.640.76803.idtracker@ietfa.amsl.com> <DCE1C662-E785-4068-8547-D6D47BAB7F6A@mitre.org>
From: Thomas Broyer <t.broyer@gmail.com>
Date: Wed, 24 Dec 2014 09:15:31 +0000
Message-ID: <CAEayHEOcFDCwvHdRCrxy63mJ-bmQ3pMZHtp4DbLfZV9qxD2R0Q@mail.gmail.com>
To: "Richer, Justin P." <jricher@mitre.org>, "<oauth@ietf.org>" <oauth@ietf.org>
Content-Type: multipart/alternative; boundary="001a11c3274cc08a8a050af2bb7d"
Archived-At: http://mailarchive.ietf.org/arch/msg/oauth/zRbS_4JGMDn3GBIAYjcni_26HQA
Subject: Re: [OAUTH-WG] I-D Action: draft-ietf-oauth-introspection-04.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: <http://www.ietf.org/mail-archive/web/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, 24 Dec 2014 09:15:37 -0000

Hi,

A couple editorial remarks:

When introducing the first 2 examples, maybe merge the two paragraphs,
starting with "The following non-normative example shows …".

Similarly, you talk about line wraps for display purpose but the examples
don't need/use wrapping.

Other than that, ready to go to the RFC state if you ask me.

Le mar. 23 déc. 2014 19:02, Richer, Justin P. <jricher@mitre.org> a écrit :

> This draft makes two changes:
>
>  - Removal of the "resource_id" input parameter, whose purpose has been
> largely supplanted by requiring authorization to call the introspection
> endpoint. I also don't know of any implementations that make use of this
> parameter. If there's later consensus on defining more context on the way
> in, we can easily have an extension for that.
>
>  - Re-shuffling of the examples out of an appendix and into the sections
> that they represent; it reads better this way.
>
>  -- Justin
>
> On Dec 23, 2014, at 12:59 PM, <internet-drafts@ietf.org> <
> internet-drafts@ietf.org> wrote:
>
> >
> > A New Internet-Draft is available from the on-line Internet-Drafts
> directories.
> > This draft is a work item of the Web Authorization Protocol Working
> Group of the IETF.
> >
> >        Title           : OAuth 2.0 Token Introspection
> >        Author          : Justin Richer
> >       Filename        : draft-ietf-oauth-introspection-04.txt
> >       Pages           : 13
> >       Date            : 2014-12-23
> >
> > Abstract:
> >   This specification defines a method for a protected resource to query
> >   an OAuth 2.0 authorization server to determine the active state of an
> >   OAuth 2.0 token and to determine meta-information about this token.
> >   OAuth 2.0 deployments can use this method to convey information about
> >   the authorization context of the token from the authorization server
> >   to the protected resource.
> >
> >
> >
> > The IETF datatracker status page for this draft is:
> > https://datatracker.ietf.org/doc/draft-ietf-oauth-introspection/
> >
> > There's also a htmlized version available at:
> > http://tools.ietf.org/html/draft-ietf-oauth-introspection-04
> >
> > A diff from the previous version is available at:
> > http://www.ietf.org/rfcdiff?url2=draft-ietf-oauth-introspection-04
> >
> >
> > 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.
> >
> > Internet-Drafts are also available by anonymous FTP at:
> > ftp://ftp.ietf.org/internet-drafts/
> >
> > _______________________________________________
> > OAuth mailing list
> > OAuth@ietf.org
> > https://www.ietf.org/mailman/listinfo/oauth
>
> _______________________________________________
> OAuth mailing list
> OAuth@ietf.org
> https://www.ietf.org/mailman/listinfo/oauth
>