Hi Ludwig,
> My interpretation of this is that "resource" refers to a single resource
No. Here is the text from token exchange (see last sentence):
resource
OPTIONAL. Indicates the location of the target service or
resource where the client intends to use the requested security
token. This enables the authorization server to apply policy as
appropriate for the target, such as determining the type and
content of the token to be issued or if and how the token is to be
encrypted. In many cases, a client will not have knowledge of the
logical organization of the systems with which it interacts and
will only know the location of the service where it intends to use
the token. The "resource" parameter allows the client to indicate
to the authorization server where it intends to use the issued
token by providing the location, typically as an https URL, in the
token exchange request in the same form that will be used to
access that resource. The authorization server will typically
have the capability to map from a resource URI value to an
appropriate policy. The value of the "resource" parameter MUST be
an absolute URI, as specified by Section 4.3 of [RFC3986], which
MAY include a query component and MUST NOT include a fragment
component. Multiple "resource" parameters may be used to indicate
that the issued token is intended to be used at the multiple
resources listed.
Ciao
Hannes
-----Original Message-----
From: OAuth <oauth-boun...@ietf.org> On Behalf Of Ludwig Seitz
Sent: Dienstag, 29. Januar 2019 08:56
To: a...@ietf.org; oauth@ietf.org
Subject: Re: [OAUTH-WG] [Ace] Shepherd write-up for
draft-ietf-oauth-resource-indicators-01
On 28/01/2019 23:12, George Fletcher wrote:
> I also don't know that this raises to the level of "concern" but I
> find the parameter name of "req_aud" odd. Given that the parameter in
> the resource-indicators spec is 'resource' why not use a parameter
> name of 'audience'. That said, I have not read the thread on the ACE
> working group list so there could be very good reasons for the chosen
> name:)
>
> I do think that there is a lot of overlap (in most cases) between
> 'resource' and 'audience' and having two parameters that cover a lot
> of the same semantics is going to be confusing for developers. When
> calling an API at a resource server, the 'audience' and the 'resource'
> are pretty equivalent. Maybe in other use cases they are distinctly separate?
>
To give you all the background of "req_aud" from ACE (sorry for the long
text):
Originally in ACE we had defined the "aud" parameter for requests to the token
endpoint with the semantics that the client was requesting a token for a
certain audience (i.e. requesting that the AS copy the "aud"
parameter value into the "aud" claim value of the token).
We were then told that this collided with a use of "aud" in OAuth, that
specifies the intended audience of Authorization Servers (if I remember
correctly), so we decided to rename our parameter to "req_aud" for "requested
audience".
Mike Jones then made us aware of the work on resource indicators, but upon
closer examination I found the "resource" parameter to be more limited than the
"req_aud", since resource specifically states:
"Its value MUST be an absolute URI ... the "resource" parameter URI value is an
identifier representing the identity of the resource"
My interpretation of this is that "resource" refers to a single resource, which
is more constrained than the definition of the "aud"
claim from 7519, which uses a StringOrURI value. For example my intent was to
use "aud" and "req_aud" for group identifiers
("temperatureSensorGroup4711") and other non-uri strings (hash-of-public-key),
which I cannot do with "resource". We therefore decided to keep the "req_aud"
parameter in draft-ietf-ace-oauth-params, even though is clearly overlaps with
"resource".
Any comments and suggestions about that line of reasoning (especially from the
OAuth point of view) are very welcome.
/Ludwig
--
Ludwig Seitz, PhD
Security Lab, RISE
Phone +46(0)70-349 92 51
_______________________________________________
OAuth mailing list
OAuth@ietf.org
https://www.ietf.org/mailman/listinfo/oauth
IMPORTANT NOTICE: The contents of this email and any attachments are
confidential and may also be privileged. If you are not the intended recipient,
please notify the sender immediately and do not disclose the contents to any
other person, use it for any purpose, or store or copy the information in any
medium. Thank you.
_______________________________________________
OAuth mailing list
OAuth@ietf.org
https://www.ietf.org/mailman/listinfo/oauth
