Re: [OAUTH-WG] Authorization Code Grant diagram Improvement OAuth 2.1 draft-ietf-oauth-v2-1

Warren Parad <wparad@rhosys.ch> Thu, 30 July 2020 17:28 UTC

Return-Path: <wparad@rhosys.ch>
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 C67D83A0FF0 for <oauth@ietfa.amsl.com>; Thu, 30 Jul 2020 10:28:58 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.086
X-Spam-Level:
X-Spam-Status: No, score=-2.086 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, HTML_FONT_LOW_CONTRAST=0.001, HTML_IMAGE_RATIO_04=0.001, HTML_MESSAGE=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_KAM_HTML_FONT_INVALID=0.01, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=rhosys.ch
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 FXPJg7aKyL1i for <oauth@ietfa.amsl.com>; Thu, 30 Jul 2020 10:28:56 -0700 (PDT)
Received: from mail-qk1-x72b.google.com (mail-qk1-x72b.google.com [IPv6:2607:f8b0:4864:20::72b]) (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 6950A3A0FE6 for <oauth@ietf.org>; Thu, 30 Jul 2020 10:28:56 -0700 (PDT)
Received: by mail-qk1-x72b.google.com with SMTP id e13so26332739qkg.5 for <oauth@ietf.org>; Thu, 30 Jul 2020 10:28:56 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=rhosys.ch; s=google; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=GiCI9ggwc0zOnIogzlNILkhN47bt5s62EI3W4ovjbkY=; b=V0qxQjwXxyC/XiYH69vNxFe0ThfZ5E4Kjm/jwPSzq2okLpM23AK36oohO/UUmIuAhD gCXBiUZAKBH3SQk/9kku5TjL0Kmm99AFofWScTXagHoEeK8JCmDvRTQlNJoB1dE+qhfD ixsXv0QXeV5ReQwj934Z7u8aKkNGKT1svvxn8=
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=GiCI9ggwc0zOnIogzlNILkhN47bt5s62EI3W4ovjbkY=; b=pvg/ZPkTn7OE07tnXVkbeRb9fQlXAC3ueu2XiZBNutz4DPodKwxQlmAv3am9QdJxod dy41hsaXN7qmL4Gelg+d+KCwO3rxQHICoJfOa2/NI1n8AxQpjMBEg1dOAdhvI+IhSh0k eTm00r8nE20DjJwn3bAJvkBj/j2Em16+3uNVwLd113NtbNzxYu9DklI6JVmobU/iXm4h 0BJLxTHijSTFTjuUiEQT+xAQAi46gwJl0a2mEo5OFVq3lK8X8vMjSazGywA+HsnW10tm u+wQj/l9NqGIkFlg+HajmJ/MOiDaet2NV1fdaOa063PvRIbncRUolmTrelUyT+/IBBvF Jhfw==
X-Gm-Message-State: AOAM533nuRel+ilCRDS5cDwHXoJgcnT3nquKGXJElCnI1Vp76YyzXbKh FT9eII7Js2OxTvmQRJNf7iBMp/qB1Zahjhcji6H65Mtz4Q==
X-Google-Smtp-Source: ABdhPJzWMwHggn9EjFB8rRrkzb3FrhNPx2G6Jk0rCLnJjFO+XSaoXPWpkr8LqHhm0NVUghEDh2aOsnkQd0zsfxuL5S8=
X-Received: by 2002:a05:620a:628:: with SMTP id 8mr264841qkv.103.1596130133899; Thu, 30 Jul 2020 10:28:53 -0700 (PDT)
MIME-Version: 1.0
References: <CAJot-L0pNWox1aX5GOkD=QVJakRVVtn=PvysciB2Wak6ijG+Dw@mail.gmail.com> <CAGBSGjo_w5+fOE0bQeeiuQLt0-Xkt+Gdu01C3BHZeuOZNh4Taw@mail.gmail.com> <CAJot-L0XmQ2wbmXPDjhwT4tT8nihmEXxc-N3orfeV21EKyYCPA@mail.gmail.com> <CAD9ie-sf+yxQaL-a1jVm=XyVCTkm2v9rc_8fWZOJsd62rCRQYQ@mail.gmail.com>
In-Reply-To: <CAD9ie-sf+yxQaL-a1jVm=XyVCTkm2v9rc_8fWZOJsd62rCRQYQ@mail.gmail.com>
From: Warren Parad <wparad@rhosys.ch>
Date: Thu, 30 Jul 2020 19:28:42 +0200
Message-ID: <CAJot-L2PwMigsvD9j_enPMtb32w-RWgXe6nLL9wCm-UqDbDC_g@mail.gmail.com>
To: Dick Hardt <dick.hardt@gmail.com>
Cc: Aaron Parecki <aaron@parecki.com>, oauth <oauth@ietf.org>
Content-Type: multipart/related; boundary="000000000000a5c53a05abac0152"
Archived-At: <https://mailarchive.ietf.org/arch/msg/oauth/gnuiT7pPpZ0wOTfB01FTWACTbR0>
Subject: Re: [OAUTH-WG] Authorization Code Grant diagram Improvement OAuth 2.1 draft-ietf-oauth-v2-1
X-BeenThere: oauth@ietf.org
X-Mailman-Version: 2.1.29
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: Thu, 30 Jul 2020 17:28:59 -0000

Wow only now I understand that, I didn't notice the hats on the arrows, and
I was further confused why (B) had two "out arrows". Would still recommend
these being 1a and 1b, 2a/b, 3a/b.

Warren Parad

Founder, CTO
Secure your user data and complete your authorization architecture.
Implement Authress <https://bit.ly/37SSO1p>.


On Thu, Jul 30, 2020 at 7:24 PM Dick Hardt <dick.hardt@gmail.com> wrote:

> The (A), (B), and (C) label the same flow that bounces through the
> User-Agent. See note below the diagram.
>
> Note the tails and arrows at each end of (A) and (C), and the arrows at
> both ends of (B) to indicate an interaction between the RO and the AS. (in
> my original version, I had the User instead of the RO).
>
> The (A) and (C) flows are shown to go through the User-Agent to make it
> clear it is a redirect flow in contrast to (D) and (E) in which the Client
> directly talks to the AS.
>
>
> ᐧ
>
> On Thu, Jul 30, 2020 at 9:57 AM Warren Parad <wparad@rhosys.ch> wrote:
>
>> From the OAuth RFC, these were actually letters. I don't see a necessary
>> association between the left side of the diagram and the right side, it
>> just seems unnecessarily confusing.
>> [image: image.png]
>>
>> Warren Parad
>>
>> Founder, CTO
>> Secure your user data and complete your authorization architecture.
>> Implement Authress <https://bit.ly/37SSO1p>.
>>
>>
>> On Thu, Jul 30, 2020 at 5:49 PM Aaron Parecki <aaron@parecki.com> wrote:
>>
>>> These numbers in the diagram correspond to the numbered steps in the
>>> paragraphs below the diagram. Perhaps using non-duplicated numbers would
>>> help, such as "1a" and "1b" instead of two instances of "1"? Although I'm
>>> not sure how that would work exactly because the "1/2/3" are really just a
>>> single action as described by the "Note" below the diagram in your
>>> screenshot.
>>>
>>> ---
>>> Aaron Parecki
>>> https://aaronparecki.com
>>> https://oauth2simplified.com
>>>
>>> On Thu, Jul 30, 2020 at 8:43 AM Warren Parad <wparad@rhosys.ch> wrote:
>>>
>>>>
>>>> https://www.ietf.org/id/draft-ietf-oauth-v2-1-00.html#name-authorization-code-grant
>>>>
>>>> Can we avoid using (1, 2, 3) on the left side of the diagram to
>>>> describe, I'm not even sure what they are supposed to represent, not to
>>>> mention the RO in the diagram doesn't really provide value (for me)
>>>> relevant to the code grant flow. It's confusing to see these numerical
>>>> identifiers twice in the same picture. But maybe there is something hidden
>>>> in this that I'm missing, still 3a and 3b could be used to identify
>>>> different legs of the same code path.
>>>> [image: image.png]
>>>>
>>>>
>>>> *Warren Parad*
>>>> Secure your user data and complete your authorization architecture.
>>>> Implement Authress <https://bit..ly/37SSO1p>.
>>>> <https://rhosys.ch>
>>>> _______________________________________________
>>>> 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
>>
>