[oauth-ext-review] Proposal for a small extension to facilitate token management

Breno de Medeiros <breno@google.com> Fri, 17 April 2020 19:05 UTC

Return-Path: <breno@google.com>
X-Original-To: oauth-ext-review@ietfa.amsl.com
Delivered-To: oauth-ext-review@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 43E0A3A082B for <oauth-ext-review@ietfa.amsl.com>; Fri, 17 Apr 2020 12:05:29 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -17.6
X-Spam-Level:
X-Spam-Status: No, score=-17.6 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIMWL_WL_MED=-0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, ENV_AND_HDR_SPF_MATCH=-0.5, HTML_MESSAGE=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, USER_IN_DEF_DKIM_WL=-7.5, USER_IN_DEF_SPF_WL=-7.5] 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 LZ5spCM7WtcB for <oauth-ext-review@ietfa.amsl.com>; Fri, 17 Apr 2020 12:05:28 -0700 (PDT)
Received: from mail-il1-x131.google.com (mail-il1-x131.google.com [IPv6:2607:f8b0:4864:20::131]) (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 ED62B3A0815 for <oauth-ext-review@ietf.org>; Fri, 17 Apr 2020 12:05:27 -0700 (PDT)
Received: by mail-il1-x131.google.com with SMTP id t8so3217120ilj.3 for <oauth-ext-review@ietf.org>; Fri, 17 Apr 2020 12:05:27 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20161025; h=mime-version:from:date:message-id:subject:to; bh=IdHabmPzMmh15HOebNKlu8EJPp0xDu/f2NAZ2SuIeIQ=; b=maKVjYjYHmr0WnlJLoPflgmYnjHV0XConLLR8UsRnPMtZ91ygz4p5yUEEyp7wmUBxz ornzciwhBb235V2yhbvNBC8qkn44416pUC2GdQnRrAJwn4WPaTsG0/yAQCj+lprBxm8W edG3aWLDlSZ9+NnhiQNNbv0Qs8Kz2p05zzPz1rOq9R7oHMY7VjQtThc1i8w25GC47ifM YDtFZsJfSNZFgUjtIBD/TGGj5jsg1xltWlmK24ozw7nl3DfZawxKLqLYtvC7wK6o8dji NezCVis9wUc6+NO5RKMfym38xlfWrtfS9czCyk5wQ6VQIExngNCyACB9z4Hv4jkV9VDE WCxA==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:from:date:message-id:subject:to; bh=IdHabmPzMmh15HOebNKlu8EJPp0xDu/f2NAZ2SuIeIQ=; b=moH/GiWGDJcDGI+L4hmTuUTghPCqkyGvaSCnlXRgR0dXOw4GHDaYq4WGqFf+foYiPk Dnlk0c3bGVq8RA7x7ndhZ+mifVZ/n+imNy9Xqf/aNWwFxth+UAhY8oJKioNfw/8/4eUb XQbSsottkYxfOH/iMhFkM+xIFA9/+81kBDpIvCiJRx6TuHCRAEu4wJTaJ0SnBhD4ABCD YQeg8V+J6D3bBTB0ttj7KfF6Bges5IXNZWT0vjjwh4+s3ThUNBjWag8FUvZn6UmsPSvx CB6No6jSytS8a8Jzs7ruI4uU7O+bOF4RQnEopmqkXuRV1RVYFOab9hK29P74NxC9PQpv gKLA==
X-Gm-Message-State: AGi0PuaCUVJ/iPJ5TYWws1is9sHIFIbhH0CxbsKPF/RtscwpyoGKxiY9 7HYoKxquJa16fpw+X4O/D+uhQP54sLxJ6wc7Hly2zcHP
X-Google-Smtp-Source: APiQypKYzCCMhwTtcTEzlpmJZ5zspK12rmdLtB2cJxadHiBBsKHzaidtCpGl18kjWMQavW/I9VHdysR0/l4LE+d63hk=
X-Received: by 2002:a92:9a59:: with SMTP id t86mr4820146ili.78.1587150326415; Fri, 17 Apr 2020 12:05:26 -0700 (PDT)
MIME-Version: 1.0
From: Breno de Medeiros <breno@google.com>
Date: Fri, 17 Apr 2020 12:05:14 -0700
Message-ID: <CAAJ++qHe+phgmRUUzYv=Zj9YLFKh7x4Z+byZ=w_b=L4cC+-AHQ@mail.gmail.com>
To: oauth-ext-review@ietf.org
Content-Type: multipart/alternative; boundary="00000000000069b18105a3813b47"
Archived-At: <https://mailarchive.ietf.org/arch/msg/oauth-ext-review/uR6c2N_C8EZ40X-zNZoy-iFKF5I>
Subject: [oauth-ext-review] Proposal for a small extension to facilitate token management
X-BeenThere: oauth-ext-review@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: "Review of proposed IANA registrations for OAuth." <oauth-ext-review.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/oauth-ext-review>, <mailto:oauth-ext-review-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/oauth-ext-review/>
List-Post: <mailto:oauth-ext-review@ietf.org>
List-Help: <mailto:oauth-ext-review-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/oauth-ext-review>, <mailto:oauth-ext-review-request@ietf.org?subject=subscribe>
X-List-Received-Date: Fri, 17 Apr 2020 19:05:29 -0000

In some situations we have encountered requests from clients to have more
metadata associated with tokens to facilitate human comprehension and
management.

I would like to suggest the following extension parameters for IANA
registration, respectively an additional optional request and response
parameter in the OAuth2 token endpoint:

token_description: Value is a quote-delimited, case-sensitive string
including spaces. This is supposed to be a human-readable description of
the token.

And a matched response parameter:

token_id: Value is base64 url-safe value representing a service-generated
id.

ASes that support token_description and/or token_id MAY return these as
part of token introspection endpoint responses or MAY display these to end
users if they provide a token management interface. Otherwise it is out of
scope for the specification where token_description or token_id is made
visible or available.

ASes that support these parameters SHOULD publish for which grant types in
the token endpoint they support these parameters.

Waiting on your feedback,

-- 

--Breno