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

William Denniss <wdenniss@google.com> Sun, 12 March 2017 01:52 UTC

Return-Path: <wdenniss@google.com>
X-Original-To: oauth@ietfa.amsl.com
Delivered-To: oauth@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 4B4721294C2 for <oauth@ietfa.amsl.com>; Sat, 11 Mar 2017 17:52:13 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.701
X-Spam-Level:
X-Spam-Status: No, score=-2.701 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_LOW=-0.7, RP_MATCHES_RCVD=-0.001, SPF_PASS=-0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=google.com
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 58G8In-CNJcr for <oauth@ietfa.amsl.com>; Sat, 11 Mar 2017 17:52:11 -0800 (PST)
Received: from mail-qk0-x22b.google.com (mail-qk0-x22b.google.com [IPv6:2607:f8b0:400d:c09::22b]) (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 1A04E1294E8 for <oauth@ietf.org>; Sat, 11 Mar 2017 17:52:11 -0800 (PST)
Received: by mail-qk0-x22b.google.com with SMTP id p64so202836443qke.1 for <oauth@ietf.org>; Sat, 11 Mar 2017 17:52:11 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20161025; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :cc; bh=oLu97QJa4z6IQ81wsTNyOAzd6sjZldAmlfkX/QeIOrM=; b=iuF/9ImiA4sIeD/8HEE9FBRHMqQTDhclsQdcaXfZlMX5Hhwh7kdtWVqTyo9QGKP2kI BiX1vHxib9x60J+7aMj902AmhhyBGbECekOlQzl0sOiyCy3PLzjGlZhOmavZ3TqaV0sI hWZyxIZSrh7X9Y/LFSUlu3CDLRKcKoJUAnqE0BYNWnfl5688WYwLIYayfTf0z4i/1LZ6 WuUs00hGT4Qg06j53rYboN795Pi2zFaImBQDTI21tWCaNhK/CeXKyuNgb7MUzIKx/5F/ xcnqFQR2OEmVvytUurUHne1AOiYpDqgt6w/reoeSy4m1A5iYNpX3nZzBogQ1RLrupkjF AxVQ==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:in-reply-to:references:from:date :message-id:subject:to:cc; bh=oLu97QJa4z6IQ81wsTNyOAzd6sjZldAmlfkX/QeIOrM=; b=pbplv5K8rcMlA/dfINCFs+4LTO6qclMDy1++jNkgvnvEJyboYsCej3oSdoHzmzOhXC 1qeNSg4qZHSf+9Myv7arvn9Zsp8QjoLQ2/bgUWHreYDOczQCs7qHjwt7dy2JCJ0kuH/1 Mf9UTTeG9Mb0frFKjAxs5QevhVPpPc+OsaGTP1r5ASEG8IRtNqkugxeRw2QUW+EE8FC7 ynJhI/+PUh143c7ydy4oLRCKMJdiFT9oyvbhJ0NGecPs2jGRxzRmcssAq6ZzFcMJO+Ul j75pYo8Z0RECVoQcEvBOx3bav9jve4QBGsAPQ6PGDyoySrp3HQaLw6N1m0hiBEUy+nUH OzEQ==
X-Gm-Message-State: AMke39lFfxM0ibgaduEPl7bCegsCP/OY8Kj+prjGoI82h/hsLMJmUl6ue3nCzgOoXrTjPy0Eep4QRAZZoxo7SuGY
X-Received: by 10.55.139.70 with SMTP id n67mr23806632qkd.286.1489283529925; Sat, 11 Mar 2017 17:52:09 -0800 (PST)
MIME-Version: 1.0
Received: by 10.140.36.203 with HTTP; Sat, 11 Mar 2017 17:51:49 -0800 (PST)
In-Reply-To: <CA+k3eCRf4yyn-Wa=tYPOocRSVtiMz7dJp3bF0S2KVB03bTp9PA@mail.gmail.com>
References: <148821758095.21176.8129728266233946666.idtracker@ietfa.amsl.com> <CAAP42hBGV7gCpr9xYvcTR+xq_XRDdFE6TY7WX+Sar+p+XeUgRw@mail.gmail.com> <CA+k3eCRf4yyn-Wa=tYPOocRSVtiMz7dJp3bF0S2KVB03bTp9PA@mail.gmail.com>
From: William Denniss <wdenniss@google.com>
Date: Sat, 11 Mar 2017 17:51:49 -0800
Message-ID: <CAAP42hD=waZvGSPFRD-c6tXY-gz4TK0iQ+T5OCmHRdw3NQRRSA@mail.gmail.com>
To: Brian Campbell <bcampbell@pingidentity.com>
Content-Type: multipart/alternative; boundary="94eb2c088490c5e5ab054a7ed7f7"
Archived-At: <https://mailarchive.ietf.org/arch/msg/oauth/ZTpCKCvimROBiVNIflohBsjgDp4>
Cc: "oauth@ietf.org" <oauth@ietf.org>
Subject: Re: [OAUTH-WG] I-D Action: draft-ietf-oauth-device-flow-04.txt
X-BeenThere: oauth@ietf.org
X-Mailman-Version: 2.1.17
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: Sun, 12 Mar 2017 01:52:13 -0000

Thanks for the review Brian!

On Thu, Mar 2, 2017 at 2:49 PM, Brian Campbell <bcampbell@pingidentity.com>
wrote:

> Two little nits about endpoint naming:
>
> Section 2
> <https://tools.ietf.org/html/draft-ietf-oauth-device-flow-04#section-2>
> defines "device endpoint", which is used in the document everywhere except
> the new metadata sections (section 4
> <https://tools.ietf.org/html/draft-ietf-oauth-device-flow-04#section-4>
> and 7.3.1
> <https://tools.ietf.org/html/draft-ietf-oauth-device-flow-04#section-7.3.1>)
> that use the term "device authorization endpoint.", Not a big deal but
> potentially a little confusing.
>

It should be "device authorization endpoint" everywhere to be as clear as
possible. I fixed the reference in Section 2, didn't find any other "device
endpoint" instances.


>
> The example in section 3.1
> <https://tools.ietf.org/html/draft-ietf-oauth-device-flow-04#section-3.1>
> is supposed to be showing a POST to the device endpoint but the Request-URI
> in the Request-Line is "/token", which *could* be the device endpoint but
> is probably just a copy/paste error and source of unneeded confusion.
>

Fixed in the next update, thanks!


>
>
> On Mon, Feb 27, 2017 at 11:14 AM, William Denniss <wdenniss@google.com>
> wrote:
>
>> My coauthors and I posted draft 04 of the OAuth 2.0 Device Flow for
>> Browserless and Input Constrained Devices draft today.
>>
>> Key changes:
>>
>>    1. Title updated to reflect specificity of devices that use this flow.
>>    2. User interaction section expanded.
>>    3. OAuth 2.0 Metadata
>>    <https://tools.ietf.org/html/draft-ietf-oauth-discovery> for the
>>    device authorization endpoint added.
>>    4. User interaction section expanded.
>>    5. Security Considerations section added.
>>    6. Usability Considerations section added.
>>
>> Please give it a look!
>>
>> On Mon, Feb 27, 2017 at 9:46 AM, <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 of the IETF.
>>>
>>>         Title           : OAuth 2.0 Device Flow for Browserless and
>>> Input Constrained Devices
>>>         Authors         : William Denniss
>>>                           John Bradley
>>>                           Michael B. Jones
>>>                           Hannes Tschofenig
>>>         Filename        : draft-ietf-oauth-device-flow-04.txt
>>>         Pages           : 15
>>>         Date            : 2017-02-27
>>>
>>> Abstract:
>>>    This OAuth 2.0 authorization flow for browserless and input
>>>    constrained devices, often referred to as the device flow, enables
>>>    OAuth clients to request user authorization from devices that have an
>>>    Internet connection, but don't have an easy input method (such as a
>>>    smart TV, media console, picture frame, or printer), or lack a
>>>    suitable browser for a more traditional OAuth flow.  This
>>>    authorization flow instructs the user to perform the authorization
>>>    request on a secondary device, such as a smartphone.  There is no
>>>    requirement for communication between the constrained device and the
>>>    user's secondary device.
>>>
>>>
>>> The IETF datatracker status page for this draft is:
>>> https://datatracker.ietf.org/doc/draft-ietf-oauth-device-flow/
>>>
>>> There's also a htmlized version available at:
>>> https://tools.ietf.org/html/draft-ietf-oauth-device-flow-04
>>>
>>> A diff from the previous version is available at:
>>> https://www.ietf.org/rfcdiff?url2=draft-ietf-oauth-device-flow-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
>>
>>
>