Re: [OAUTH-WG] "access grant" terminology

"William Mills" <wmills@yahoo-inc.com> Mon, 12 July 2010 05:28 UTC

Return-Path: <wmills@yahoo-inc.com>
X-Original-To: oauth@core3.amsl.com
Delivered-To: oauth@core3.amsl.com
Received: from localhost (localhost [127.0.0.1]) by core3.amsl.com (Postfix) with ESMTP id 691B83A6905 for <oauth@core3.amsl.com>; Sun, 11 Jul 2010 22:28:53 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -17.543
X-Spam-Level:
X-Spam-Status: No, score=-17.543 tagged_above=-999 required=5 tests=[AWL=0.056, BAYES_00=-2.599, USER_IN_DEF_WHITELIST=-15]
Received: from mail.ietf.org ([64.170.98.32]) by localhost (core3.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id lxfL7XX2l-b4 for <oauth@core3.amsl.com>; Sun, 11 Jul 2010 22:28:52 -0700 (PDT)
Received: from mrout3.yahoo.com (mrout3.yahoo.com [216.145.54.173]) by core3.amsl.com (Postfix) with ESMTP id EAD863A68A0 for <oauth@ietf.org>; Sun, 11 Jul 2010 22:28:51 -0700 (PDT)
Received: from SNV-EXPF01.ds.corp.yahoo.com (snv-expf01.ds.corp.yahoo.com [207.126.227.250]) by mrout3.yahoo.com (8.13.8/8.13.8/y.out) with ESMTP id o6C5QXVS022630; Sun, 11 Jul 2010 22:26:33 -0700 (PDT)
DomainKey-Signature: a=rsa-sha1; s=serpent; d=yahoo-inc.com; c=nofws; q=dns; h=received:x-mimeole:content-class:mime-version: content-type:content-transfer-encoding:subject:date:message-id: in-reply-to:x-ms-has-attach:x-ms-tnef-correlator:thread-topic: thread-index:references:from:to:return-path:x-originalarrivaltime; b=c2Ozx3TrdTebuNacvps6aCmH94+DWzmFvzTVy0+LrO1VVLgOlo/+ALtlnOvhWv8o
Received: from SNV-EXVS08.ds.corp.yahoo.com ([207.126.227.8]) by SNV-EXPF01.ds.corp.yahoo.com with Microsoft SMTPSVC(6.0.3790.4675); Sun, 11 Jul 2010 22:26:33 -0700
X-MimeOLE: Produced By Microsoft Exchange V6.5
Content-class: urn:content-classes:message
MIME-Version: 1.0
Content-Type: text/plain; charset="US-ASCII"
Content-Transfer-Encoding: quoted-printable
Date: Sun, 11 Jul 2010 22:26:32 -0700
Message-ID: <012AB2B223CB3F4BB846962876F47217059B6BBB@SNV-EXVS08.ds.corp.yahoo.com>
In-Reply-To: <C85E82A8.36FA5%eran@hueniverse.com>
X-MS-Has-Attach:
X-MS-TNEF-Correlator:
Thread-Topic: [OAUTH-WG] "access grant" terminology
Thread-Index: Acsgo1IqSaP1dBzARzCLBHb7zz8NFwAAl688ADYdKEA=
References: <AANLkTikq4C9FYySiDmJqEBJIiYoYGxC9ZbpaPqHKgDgY@mail.gmail.com> <C85E82A8.36FA5%eran@hueniverse.com>
From: William Mills <wmills@yahoo-inc.com>
To: Eran Hammer-Lahav <eran@hueniverse.com>, Brian Eaton <beaton@google.com>, OAuth WG <oauth@ietf.org>
X-OriginalArrivalTime: 12 Jul 2010 05:26:33.0296 (UTC) FILETIME=[CA41B500:01CB2182]
Subject: Re: [OAUTH-WG] "access grant" terminology
X-BeenThere: oauth@ietf.org
X-Mailman-Version: 2.1.9
Precedence: list
List-Id: OAUTH WG <oauth.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/listinfo/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: Mon, 12 Jul 2010 05:28:53 -0000

I think "access credential" is  better that either of those.  Using
"grant" as a noun is a somewhat obscure usage, a la "land grant", which
I think of more as the deed to a property.

> -----Original Message-----
> From: oauth-bounces@ietf.org [mailto:oauth-bounces@ietf.org] 
> On Behalf Of Eran Hammer-Lahav
> Sent: Saturday, July 10, 2010 8:04 PM
> To: Brian Eaton; OAuth WG
> Subject: Re: [OAUTH-WG] "access grant" terminology
> 
> 
> 
> 
> On 7/10/10 7:46 PM, "Brian Eaton" <beaton@google.com> wrote:
> 
> > The term "access grant" in the -09 spec is a bit odd.  Normally 
> > "access grant" or "permission grant" would refer to a 
> specific policy 
> > decision made by a resource owner.
> > 
> > But that's not how the -09 spec uses the term.  The -09 
> spec refers to 
> > authorization codes and assertions as "access grants".  
> Again, that's 
> > weird.  Normally an assertion would be referred to as a 
> "credential", 
> > not a grant.
> 
> Access grant is something that represents the decision made 
> by the resource owner. If the resource owner approves access, 
> it is represented by a authorization code. If the resource 
> owner shares its password, it is equivalent to unlimited access grant.
> 
> I coined the term based on common language, not on any 
> existing terminology.
> If there is a real conflict here, I am happy to consider 
> another term, but it doesn't sound like this is the case, or 
> that the term is used against its meaning.
> 
> > I think the term "authorization credential" might be a 
> better fit than 
> > "access grant".
> > 
> > It certainly describes the purpose of the authorization 
> code and the 
> > assertion.  And the term "credential" is normally used to describe 
> > things that need to be verified and protected.
> 
> I think authorization credential is going to confuse most 
> readers. The spec refers to credentials almost exclusively 
> when dealing with identifier and password (client, end-user), 
> or as a general term for client authentication.
> Authorization is specific to the end-user authorization 
> endpoint and will be confusing when used with assertions and 
> other grant types.
> 
> So I'm open to other ideas but not this one.
> 
> Note that since this term impacts the name of the current 'grant_type'
> parameter, changing it means code changes.
> 
> If anyone has a last minute idea please share (or if you are 
> happy with the current grant type). I expect it to be 
> annoying to change once -10 is stable for 4 weeks.
> 
> EHL
> 
> 
> _______________________________________________
> OAuth mailing list
> OAuth@ietf.org
> https://www.ietf.org/mailman/listinfo/oauth
>