Re: [OAUTH-WG] Proposed Syntax Changes in Dynamic Registration

Nat Sakimura <sakimura@gmail.com> Mon, 20 May 2013 18:42 UTC

Return-Path: <sakimura@gmail.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 06E4321F8E56 for <oauth@ietfa.amsl.com>; Mon, 20 May 2013 11:42:16 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.599
X-Spam-Level:
X-Spam-Status: No, score=-2.599 tagged_above=-999 required=5 tests=[BAYES_00=-2.599, HTML_MESSAGE=0.001, NO_RELAYS=-0.001]
Received: from mail.ietf.org ([12.22.58.30]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id DEtAlwyg6-FM for <oauth@ietfa.amsl.com>; Mon, 20 May 2013 11:42:15 -0700 (PDT)
Received: from mail-la0-x235.google.com (mail-la0-x235.google.com [IPv6:2a00:1450:4010:c03::235]) by ietfa.amsl.com (Postfix) with ESMTP id B0D5821F8B18 for <oauth@ietf.org>; Mon, 20 May 2013 11:42:14 -0700 (PDT)
Received: by mail-la0-f53.google.com with SMTP id ea20so2861647lab.12 for <oauth@ietf.org>; Mon, 20 May 2013 11:42:13 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=x-received:references:from:mime-version:in-reply-to:date:message-id :subject:to:cc:content-type; bh=bgIiPsk5uIkG4eHrZcCoHdcVhDYm9HGrNmritQtkMHs=; b=1DNXGdMU/pcET06B0ZYm2c/RIO+LPiP+/oaFAwKaNDInb+egFi9VTV9PhBD8IcLkdX Wdb7ElvpVoFl4poj1uuvqAnFC2drYV3jo4ZmMaK319DfJg3kRSpm8j2oZkySKBmWEuvV QR3b3dNsUV5bdbs6TAgOdPfJNcpDluh/uBxBlRBsoWDfegjf+GkH/jxTAVPDCe1UMSWO DuEjC+ZtY+IBntrG7lb8Bju9pBcnIo8DdFHNuBsy1G0qjGsfZDpcYgiqbteQyiE5HsiP mF/Pr6yR4Bufmm1wuA8EByCJ5eHACwdK1fSr6cN5W4yBY79mAo1deQ8tZG6erq5i2fBF s0tg==
X-Received: by 10.152.115.173 with SMTP id jp13mr29029207lab.49.1369075333519; Mon, 20 May 2013 11:42:13 -0700 (PDT)
References: <519A3C9A.8060305@mitre.org>
From: Nat Sakimura <sakimura@gmail.com>
Mime-Version: 1.0 (1.0)
In-Reply-To: <519A3C9A.8060305@mitre.org>
Date: Mon, 20 May 2013 20:42:09 +0200
Message-ID: <-3365254035477557424@unknownmsgid>
To: Justin Richer <jricher@mitre.org>
Content-Type: multipart/alternative; boundary="001a11c235dced69ce04dd2ab03c"
Cc: "oauth@ietf.org" <oauth@ietf.org>
Subject: Re: [OAUTH-WG] Proposed Syntax Changes in Dynamic Registration
X-BeenThere: oauth@ietf.org
X-Mailman-Version: 2.1.12
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: Mon, 20 May 2013 18:42:16 -0000

No change please.

=nat via iPhone

On May 20, 2013, at 17:10, Justin Richer <jricher@mitre.org> wrote:

 Phil Hunt's review of the Dynamic Registration specification has raised a
couple of issues that I felt were getting buried by the larger discussion
(which I still strongly encourage others to jump in to). Namely, Phil has
suggested a couple of syntax changes to the names of several parameters.


1) expires_at -> client_secret_expires_at
2) issued_at -> client_id_issued_at
3) token_endpoint_auth_method -> token_endpoint_client_auth_method


I'd like to get a feeling, *especially from developers* who have deployed
this draft spec, what we ought to do for each of these:

 A) Keep the parameter names as-is
 B) Adopt the new names as above
 C) Adopt a new name that I will specify

In all cases, clarifying text will be added to the parameter *definitions*
so that it's more clear to people reading the spec what each piece does.
Speaking as the editor: "A" is the default as far as I'm concerned, since
we shouldn't change syntax without very good reason to do so. That said, if
it's going to be better for developers with the new parameter names, I am
open to fixing them now.

Naming things is hard.

 -- Justin

_______________________________________________
OAuth mailing list
OAuth@ietf.org
https://www.ietf.org/mailman/listinfo/oauth