<?xml version="1.0" encoding="UTF-8"?>
  <?xml-stylesheet type="text/xsl" href="rfc2629.xslt" ?>
  <!-- generated by https://github.com/cabo/kramdown-rfc version 1.7.43 (Ruby 3.3.6) -->


<!DOCTYPE rfc  [
  <!ENTITY nbsp    "&#160;">
  <!ENTITY zwsp   "&#8203;">
  <!ENTITY nbhy   "&#8209;">
  <!ENTITY wj     "&#8288;">

]>


<rfc ipr="trust200902" docName="draft-sweeney-oauth-brokered-authorization-00" category="std" consensus="true" submissionType="IETF" tocInclude="true" sortRefs="true" symRefs="true">
  <front>
    <title abbrev="OAuth Brokered Authorization">OAuth Brokered Authorization: Grant Custody for Short-Lived Client Instances</title>

    <author initials="K." surname="Sweeney" fullname="Kieran Sweeney">
      <organization></organization>
      <address>
        <email>kieran@kierans.net</email>
      </address>
    </author>

    <date year="2026" month="November" day="20"/>

    <area>sec</area>
    <workgroup>Web Authorization Protocol</workgroup>
    <keyword>OAuth</keyword> <keyword>AI agents</keyword> <keyword>client instance</keyword> <keyword>bearer token</keyword> <keyword>API key</keyword> <keyword>broker</keyword>

    <abstract>


<?line 186?>

<t>An OAuth client identifier names a registration. It does not name the running instance that presents a token. Where one registered client runs as many short-lived instances, as agent platforms do, work now in progress binds refresh tokens to the instance. Where a refresh token is bound to the instance, an authorization that a user gave through one instance ends with that instance, and no specification says how the next instance comes to act under it.</t>

<t>This document specifies one answer. A broker is the single, durable OAuth client of an upstream resource. It holds the grant and the credential for that resource and makes each request itself. A resource owner authorizes a registered client to use that grant through the broker, and the authorization server records the authorization against the client and not against any instance. Each instance obtains a short-lived, sender-constrained access token for the broker with the client credentials grant. An instance never holds a grant, a refresh token, or the upstream credential, and no instance is registered anywhere. This document defines the authorization details type that carries this authority, the checks the broker makes before it acts, and one error code.</t>



    </abstract>

    <note title="About This Document" removeInRFC="true">
      <t>
        Status information for this document may be found at <eref target="https://datatracker.ietf.org/doc/draft-sweeney-oauth-brokered-authorization/"/>.
      </t>
      <t>
        Discussion of this document takes place on the
        Web Authorization Protocol (OAuth) Working Group mailing list (<eref target="mailto:oauth@ietf.org"/>),
        which is archived at <eref target="https://mailarchive.ietf.org/arch/browse/oauth/"/>.
        Subscribe at <eref target="https://www.ietf.org/mailman/listinfo/oauth/"/>.
      </t>
      <t>Source for this draft and an issue tracker can be found at
        <eref target="https://github.com/cred-ninja/protocol"/>.</t>
    </note>


  </front>

  <middle>


<?line 192?>

<section anchor="introduction"><name>Introduction</name>

<section anchor="problem"><name>The Client, the Instance, and the Grant</name>

<t><xref target="OAUTH21"/> defines a client as an application that makes protected resource requests on behalf of a resource owner, and a client identifier as a string that represents the registration information the client provided. It does not say whether a registration stands for a piece of software, a deployment of it, or one running process. <xref target="RFC7591"/> named the difference in 2015, defining a client instance as a deployed instance of a piece of client software, but nothing in the core framework depends on it.</t>

<t>For a web application with one deployment, the difference did not matter. For agent platforms it does. One registered client runs as many concurrent instances, each lives for a task or a session, and some start further instances.</t>

<t>Work in progress identifies the instance. <xref target="ATTEST"/> authenticates a client instance by a key the instance generated and an attestation over that key, and requires a refresh token to be bound to the client instance and not only to the client. <xref target="CLIENT-INSTANCE-ID"/> adds an instance identifier that survives a key change, and has the authorization server record the instance at grant time and require the same instance at refresh. <xref target="AIMS"/> treats an agent as a workload that acts as an OAuth client and is named in the <spanx style="verb">client_id</spanx> claim.</t>

<t>These are sound, and they sharpen a question that OAuth has left to authorization server policy: where does a grant live when the instance that obtained it is gone? If the grant is reachable only through a refresh token bound to an instance, it ends with the instance, and the resource owner is asked again for each new one. If every instance is instead registered as a client of its own, each needs its own registration and its own consent at every authorization server it touches, and the resource owner can no longer tell what was approved.</t>

<t>A third course exists. A confidential client's backend can keep a refresh token that is bound to the client and not to an instance (<xref section="4.3" sectionFormat="of" target="OAUTH21"/>), and <xref target="ATTEST"/> lets a profile bind refresh tokens to something other than the instance key (its Section 13). That keeps a long-lived credential in the client's own systems. This document keeps the grant at the authorization server. Of the grant, the client keeps only an identifier, which is of no use without client authentication (<xref target="any-instance"/>).</t>

</section>
<section anchor="the-answer-given-here"><name>The Answer Given Here</name>

<t>This document answers the question for resources that are reached through a broker, by fixing what each party holds:</t>

<texttable title="Who Holds What" anchor="who-holds-what">
      <ttcol align='left'>Party</ttcol>
      <ttcol align='left'>What it is</ttcol>
      <ttcol align='left'>What it holds</ttcol>
      <c>The broker</c>
      <c>The one OAuth client of the upstream resource. Durable.</c>
      <c>The upstream grant and the upstream credential.</c>
      <c>The logical client</c>
      <c>The client identified by <spanx style="verb">client_id</spanx> at the broker's authorization server.</c>
      <c>A brokered authorization, recorded at the authorization server, and the upstream grant identifiers, which it gives to instances.</c>
      <c>The client instance</c>
      <c>One running instance of the logical client. Short-lived.</c>
      <c>A key, short-lived access tokens bound to it, and the grant identifiers it is given. No grant, no refresh token, no upstream credential. Its key works, in effect, as a refresh token for every resource owner (<xref target="any-instance"/>).</c>
</texttable>

<t>A resource owner authorizes the logical client once. Any instance that authenticates as that client can then obtain an access token for the broker with the client credentials grant, which <xref section="4.2" sectionFormat="of" target="OAUTH21"/> permits for the resources of another resource owner when that has been previously arranged with the authorization server. The brokered authorization is that arrangement. When an instance ends, its tokens expire and nothing else changes. The upstream resource sees one client and needs no change, which matters because many upstream resources accept only a bearer token or a static API key and will not adopt instance-aware mechanisms.</t>

</section>
<section anchor="existing"><name>Existing Work</name>

<t>A component that holds a credential and makes each request itself is not new. <xref section="9.1" sectionFormat="of" target="OAUTH21"/> and <xref section="6.1" sectionFormat="of" target="RFC10017"/> describe it for browser applications as the Backend for Frontend, and <xref target="RFC10017"/> ranks it above the token-mediating backend of its Section 6.2, which passes the access token to the application.</t>

<t>Two pieces of the mechanism have earlier forms. Grant Management for OAuth 2.0 <xref target="GRANT-MGMT"/> makes a grant an object at the authorization server, named by a <spanx style="verb">grant_id</spanx> that a client presents in later authorization requests. <xref target="MISSION-RA"/> defines an authorization details type with path-prefix matching at a segment boundary (its Section 4), a subset rule (its Section 5), and enforcement where the token is presented (its Section 7).</t>

<t>This document defines a type of its own, and not a use of that one, for three reasons. An entry of <xref target="MISSION-RA"/> is enforced by the resource server that the token is presented to (its Section 7), and its actions are identifiers that the serving resource defines (its Section 3). The entries defined here are enforced by a broker in front of a resource that implements nothing, and are stated in terms that resource already has: HTTP methods and paths. They name the upstream grant that the broker is to use, and <xref target="MISSION-RA"/> gives no authority to an entry with a member it does not define (its Section 7). And they are redeemed at the token endpoint with client authentication alone. A broker could also be the enforcement point for entries of <xref target="MISSION-RA"/>; that is not defined here (<xref target="open"/>).</t>

</section>
<section anchor="what-this-document-defines"><name>What This Document Defines</name>

<t><list style="symbols">
  <t>The brokered authorization: what it records, how it is made, and how a client instance obtains an access token under it (<xref target="brokered-authz"/>).</t>
  <t>An authorization details type <xref target="RFC9396"/> that carries the operations a token permits and the upstream grant it uses (<xref target="authz-details"/>).</t>
  <t>What the broker checks before it acts, what it never does with the upstream credential, and one new error code (<xref target="broker"/>).</t>
</list></t>

<t>This document does not define how an instance is identified or attested. It works with any client authentication method that proves possession of a key held by the instance, and it carries instance context where the authorization server has it (<xref target="instance-context"/>).</t>

<t>Apart from the path computation, the custody rules, and the upstream grant error of <xref target="broker"/>, this document does not define how the broker builds the request it sends upstream or how it filters the response. Those rules decide whether the arrangement is safe in practice, and <xref target="forwarding"/> lists what they have to cover.</t>

<t>It defines no delegation chain between agents, no receipt or audit record, and no limit accounting. It does not define how the broker comes to hold an upstream credential.</t>

</section>
</section>
<section anchor="terms"><name>Conventions and Definitions</name>

<t>The key words "<bcp14>MUST</bcp14>", "<bcp14>MUST NOT</bcp14>", "<bcp14>REQUIRED</bcp14>", "<bcp14>SHALL</bcp14>", "<bcp14>SHALL
NOT</bcp14>", "<bcp14>SHOULD</bcp14>", "<bcp14>SHOULD NOT</bcp14>", "<bcp14>RECOMMENDED</bcp14>", "<bcp14>NOT RECOMMENDED</bcp14>",
"<bcp14>MAY</bcp14>", and "<bcp14>OPTIONAL</bcp14>" in this document are to be interpreted as
described in BCP 14 <xref target="RFC2119"/> <xref target="RFC8174"/> when, and only when, they
appear in all capitals, as shown here.</t>

<?line -18?>

<t>This document uses "authorization server", "resource server", "protected resource", "client", "resource owner", and "access token" as defined in <xref target="OAUTH21"/>.</t>

<dl>
  <dt>Logical client:</dt>
  <dd>
    <t>The OAuth client identified by a client identifier at the broker's authorization server. Many client instances can authenticate as it. The term is taken from <xref target="CLIENT-INSTANCE-ID"/>.</t>
  </dd>
  <dt>Client instance:</dt>
  <dd>
    <t>One deployed, running instance of the logical client's software, as in <xref target="RFC7591"/> and <xref target="ATTEST"/>. It holds a key that no other instance holds.</t>
  </dd>
  <dt>Upstream resource:</dt>
  <dd>
    <t>A protected resource that the broker calls. It is identified by one origin and one path prefix. Where an upstream service gives each account its own origin, the origin can be fixed per upstream grant (<xref target="operations"/>).</t>
  </dd>
  <dt>Upstream credential:</dt>
  <dd>
    <t>What the upstream resource accepts as proof of authority and the broker holds: a bearer access token, together with any refresh token from which it is renewed, or a static API key. Passwords and private keys are not covered by this document.</t>
  </dd>
  <dt>Derived credential:</dt>
  <dd>
    <t>Anything obtained from the upstream resource that lets its holder act at the upstream resource without the broker. Examples are a newly issued API key or token, a session cookie, and a URL that carries its own authorization.</t>
  </dd>
  <dt>Upstream grant:</dt>
  <dd>
    <t>The authority that one resource owner has given the broker at one upstream resource, of which the upstream credential is the evidence. The broker records each upstream grant with the resource owner who made it. The authorization server assigns an identifier for it to each logical client (<xref target="authz-details"/>).</t>
  </dd>
  <dt>Brokered authorization:</dt>
  <dd>
    <t>A record at the broker's authorization server that a resource owner permits a logical client to have the broker perform stated operations under one upstream grant (<xref target="brokered-authz"/>).</t>
  </dd>
  <dt>Broker:</dt>
  <dd>
    <t>A server that holds upstream credentials and uses them to make requests to upstream resources for client instances, under the rules of this document. It is an HTTP gateway (<xref section="3.7" sectionFormat="of" target="RFC9110"/>). Together with its authorization server it is one party.</t>
  </dd>
  <dt>Broker resource:</dt>
  <dd>
    <t>A protected resource that the broker exposes and that stands for exactly one upstream resource.</t>
  </dd>
  <dt>Operation:</dt>
  <dd>
    <t>One kind of request that a broker resource offers, defined in the broker's configuration (<xref target="operations"/>).</t>
  </dd>
  <dt>Release:</dt>
  <dd>
    <t>Any act by which a client instance comes to hold an upstream credential or a derived credential.</t>
  </dd>
  <dt>Extends at a segment boundary:</dt>
  <dd>
    <t>A path P extends a path Q at a segment boundary when P begins with Q and either Q ends with "/" or the next character of P after Q is "/".</t>
  </dd>
</dl>

<t>The word "broker" is also used elsewhere for an authorization server that federates to another authorization server. That is a different role and is not meant here.</t>

</section>
<section anchor="model"><name>Model and Assumptions</name>

<figure><artwork type="ascii-art"><![CDATA[
 +-----------+  (1) client credentials  +---------------+
 |           |------------------------->| Broker's      |
 | Client    |<-------------------------| authorization |
 | instance  |  (2) access token        | server        |
 |           |                          +---------------+
 |           |  (3) request             +--------+  (4)  +----------+
 |           |------------------------->|        |------>|          |
 |           |<-------------------------| Broker |<------| Upstream |
 +-----------+  (6) response            +--------+  (5)  | resource |
                                                         +----------+
]]></artwork></figure>

<t>Beforehand, the resource owner has authorized the broker at the upstream resource (the upstream grant), and has authorized the logical client at the broker's authorization server (the brokered authorization).</t>

<t><list style="numbers" type="1">
  <t>A client instance authenticates as the logical client and asks for an access token with the client credentials grant, naming the broker resource, the upstream grant, and the operations it needs.</t>
  <t>The authorization server checks the request against the brokered authorization and issues a short-lived access token bound to the instance's key.</t>
  <t>The instance sends an HTTP request to the broker resource with the token and proof of possession.</t>
  <t>The broker validates the token and the proof, matches the request to a configured operation, checks that the token permits it, and sends the corresponding request upstream with the credential of the upstream grant the token names.</t>
  <t>The upstream resource answers the broker.</t>
  <t>The broker returns the answer.</t>
</list></t>

<t>This document rests on the following assumptions. Where one does not hold, the properties claimed in <xref target="security"/> do not hold either.</t>

<t><list style="symbols">
  <t>The broker and its authorization server are operated by one party and share the record of upstream grants and brokered authorizations.</t>
  <t>The authorization server knows which resource owner made each upstream grant.</t>
  <t>Every instance of a logical client is trusted with every brokered authorization made to that client (<xref target="any-instance"/>).</t>
  <t>A client instance's key cannot be exported by the part of the instance that an attacker can influence, and is not copied to another instance (<xref target="client-key"/>).</t>
  <t>One upstream credential stands for one resource owner (<xref target="shared-credential"/>).</t>
  <t>The broker's operator knows the upstream resource well enough to list the operations that are safe to offer (<xref target="returning"/>).</t>
  <t>The upstream resource reads a path as <xref target="RFC3986"/> describes. It does not fold case, give meaning to path parameters, or decode a second time.</t>
</list></t>

</section>
<section anchor="brokered-authz"><name>Brokered Authorizations</name>

<section anchor="record"><name>The Record</name>

<t>A brokered authorization records:</t>

<t><list style="symbols">
  <t>the resource owner who made it;</t>
  <t>the logical client it was made to;</t>
  <t>one broker resource and one upstream grant at that broker resource, made by the same resource owner;</t>
  <t>the operations permitted, as in <xref target="authz-details"/>;</t>
  <t>the issuer identifier of the authorization server that recorded it;</t>
  <t>when it ends, if it has an end.</t>
</list></t>

<t>There is at most one brokered authorization for a given logical client and upstream grant.</t>

<t>A brokered authorization is not bound to a client instance, to a key, or to a refresh token. It persists until it ends or the resource owner withdraws it.</t>

<t>The authorization server <bcp14>MUST NOT</bcp14> record a brokered authorization unless the resource owner who made the upstream grant, or a party entitled under the deployment's policy to act for that resource owner, has approved it for that logical client. Authenticating the client is not enough.</t>

</section>
<section anchor="making"><name>Making a Brokered Authorization</name>

<t>A resource owner makes a brokered authorization through the authorization code grant (<xref section="4.1" sectionFormat="of" target="OAUTH21"/>) at the broker's authorization server. The authorization request <bcp14>MUST</bcp14> be a pushed authorization request <xref target="RFC9126"/> in which the client instance authenticates as in <xref target="redeeming"/>. The authorization server <bcp14>MUST</bcp14> reject a request for this type that was not pushed. The request carries an <spanx style="verb">authorization_details</spanx> parameter <xref target="RFC9396"/> with exactly one object of the type defined in <xref target="authz-details"/>.</t>

<t>The authorization server shows the resource owner the logical client, the broker resource, the upstream resource it stands for, and the operations requested. It <bcp14>MUST</bcp14> make plain that:</t>

<t><list style="symbols">
  <t>any running instance of the client can use the authorization, without further approval, until it ends or is withdrawn;</t>
  <t>a path includes everything beneath it, including operations that the broker adds there later;</t>
  <t>where an operation requested hands the instance a URL that carries its own authorization (<xref target="returning"/>), that it does.</t>
</list></t>

<t>Where the resource owner has more than one upstream grant at that broker resource, the authorization server has the resource owner choose one. Where the resource owner has none, the authorization server either has one made in the same interaction or returns the <spanx style="verb">access_denied</spanx> error.</t>

<t>The brokered authorization is recorded when the authorization code is redeemed, and not before. It replaces any earlier brokered authorization for the same logical client and upstream grant. The authorization server adds the upstream grant identifier to the object, as <xref section="7.1" sectionFormat="of" target="RFC9396"/> allows a type to provide.</t>

<t>Where the authorization server did not itself register the client, as with a client identifier that is a URL under the client's control, the brokered authorization <bcp14>MUST</bcp14> have an end.</t>

<t>The token response contains the <spanx style="verb">authorization_details</spanx> as recorded, including the upstream grant identifier. The access token it returns meets the requirements of <xref target="redeeming"/>. The authorization server <bcp14>MUST NOT</bcp14> issue a refresh token: an instance that needs a further access token obtains it under <xref target="redeeming"/>.</t>

<t>An authorization server <bcp14>MAY</bcp14> provide other ways to make a brokered authorization. Those are outside this document. The rule in <xref target="record"/> applies to all of them.</t>

</section>
<section anchor="redeeming"><name>Obtaining an Access Token</name>

<t>A client instance obtains an access token for a broker resource with the client credentials grant (<xref section="4.2" sectionFormat="of" target="OAUTH21"/>). The token request:</t>

<t><list style="symbols">
  <t><bcp14>MUST</bcp14> authenticate the instance as the logical client with a method that proves possession of a private key held by that instance, such as <xref target="ATTEST"/> or mutual TLS <xref target="RFC8705"/>. A symmetric client secret <bcp14>MUST NOT</bcp14> be accepted;</t>
  <t><bcp14>MUST</bcp14> carry an <spanx style="verb">authorization_details</spanx> parameter with exactly one object of the type defined in <xref target="authz-details"/>, including its <spanx style="verb">upstream_grant</spanx> member;</t>
  <t><bcp14>MUST</bcp14> present, as the key the access token is to be bound to, the key with which the instance authenticates. The authorization server <bcp14>MUST</bcp14> refuse any other. With <xref target="ATTEST"/> that is its combined mode, in which the DPoP key is the Client Instance Key (its Section 5.2). With mutual TLS it is the client certificate.</t>
</list></t>

<t>The logical client <bcp14>MUST</bcp14> be a confidential client (<xref section="2.1" sectionFormat="of" target="OAUTH21"/>), which <xref section="4.2" sectionFormat="of" target="OAUTH21"/> requires for this grant.</t>

<t>The authorization server <bcp14>MUST</bcp14> issue an access token only if a brokered authorization exists for that logical client, that broker resource, and that upstream grant, has not ended or been withdrawn, and covers the object requested (<xref target="covering"/>). Otherwise it responds with the <spanx style="verb">invalid_authorization_details</spanx> error of <xref target="RFC9396"/>. The response <bcp14>MUST NOT</bcp14> reveal whether the upstream grant identifier exists.</t>

<t>The access token:</t>

<t><list style="symbols">
  <t><bcp14>MUST</bcp14> be sender-constrained to the key with which the instance authenticated;</t>
  <t><bcp14>MUST</bcp14> have as its audience the resource identifier <xref target="RFC8707"/> of that one broker resource;</t>
  <t><bcp14>MUST</bcp14> convey, in its <spanx style="verb">authorization_details</spanx> claim or in the introspection response (<xref section="9" sectionFormat="of" target="RFC9396"/>), exactly one object of the type defined in <xref target="authz-details"/>, which names that broker resource and that upstream grant and contains no operation beyond those requested;</t>
  <t>where it is a JWT access token <xref target="RFC9068"/>, <bcp14>MUST</bcp14> carry the client identifier in both <spanx style="verb">sub</spanx> and <spanx style="verb">client_id</spanx>. The resource owner is identified only through <spanx style="verb">upstream_grant</spanx>;</t>
  <t><bcp14>MUST NOT</bcp14> be accompanied by a refresh token.</t>
</list></t>

<t>The lifetime of an access token <bcp14>SHOULD NOT</bcp14> exceed 300 seconds. Where the broker relies on token expiry to apply a withdrawal, the lifetime <bcp14>MUST NOT</bcp14> exceed the limit stated under <xref target="withdrawal"/>.</t>

<t>A <spanx style="verb">brokered_access</spanx> object <bcp14>MUST NOT</bcp14> be conveyed in an access token issued in any other way than under <xref target="making"/> or this section.</t>

<t>An example token request, with line breaks added for display and the parameter value shown before form encoding:</t>

<figure><sourcecode type="http-message"><![CDATA[
POST /token HTTP/1.1
Host: as.broker.example
Content-Type: application/x-www-form-urlencoded
OAuth-Client-Attestation: eyJ...
DPoP: eyJ...

grant_type=client_credentials
&authorization_details=[{
   "type":"brokered_access",
   "locations":["https://broker.example/tracker"],
   "upstream_grant":"ug_5Yc1r0mB7tQk2VxN9aLd3w",
   "operations":[{"methods":["GET"],"path":"/projects/42/issues"}]
 }]
]]></sourcecode></figure>

</section>
<section anchor="instance-context"><name>Instance Context</name>

<t>Where the authorization server has instance context for the authenticated instance, such as the <spanx style="verb">client_instance</spanx> claim of <xref target="CLIENT-INSTANCE-ID"/> (its Section 7.1), it <bcp14>SHOULD</bcp14> convey it with the access token.</t>

<t>Instance context grants no authority under this document. The broker uses the key the token is bound to as the identity of the instance when it refuses an instance (<xref target="withdrawal"/>).</t>

</section>
</section>
<section anchor="authz-details"><name>The Authorization Details Type</name>

<t>This document defines the authorization details type <spanx style="verb">brokered_access</spanx>. An object of this type has the following members.</t>

<dl>
  <dt><spanx style="verb">type</spanx>:</dt>
  <dd>
    <t><bcp14>REQUIRED</bcp14>. The string <spanx style="verb">brokered_access</spanx>.</t>
  </dd>
  <dt><spanx style="verb">locations</spanx>:</dt>
  <dd>
    <t><bcp14>REQUIRED</bcp14>. An array with exactly one element, the resource identifier of a broker resource.</t>
  </dd>
  <dt><spanx style="verb">upstream_grant</spanx>:</dt>
  <dd>
    <t>The upstream grant identifier. <bcp14>OPTIONAL</bcp14> in an authorization request, where the authorization server supplies it (<xref target="making"/>). <bcp14>REQUIRED</bcp14> in a token request under <xref target="redeeming"/>, in a token response, and in what is conveyed to the broker. The value is an opaque string assigned by the broker's authorization server. It confers nothing on a party that cannot authenticate as the logical client. Among instances of one logical client it is all that separates one resource owner's authorization from another's. It <bcp14>MUST</bcp14> contain at least 128 bits of randomness, <bcp14>MUST</bcp14> be specific to one logical client, and <bcp14>MUST NOT</bcp14> be reused for a different upstream grant.</t>
  </dd>
  <dt><spanx style="verb">operations</spanx>:</dt>
  <dd>
    <t><bcp14>REQUIRED</bcp14>. A non-empty array of objects, each with these members:
</t>

    <dl>
      <dt><spanx style="verb">methods</spanx>:</dt>
      <dd>
        <t><bcp14>REQUIRED</bcp14>. A non-empty array of HTTP method names, as they appear in a request. HEAD <bcp14>MUST NOT</bcp14> appear; an entry that lists GET permits HEAD.</t>
      </dd>
      <dt><spanx style="verb">path</spanx>:</dt>
      <dd>
        <t><bcp14>REQUIRED</bcp14>. A path relative to the broker resource, beginning with "/". The value "/" stands for the whole broker resource. The value <bcp14>MUST</bcp14> be in the form that <xref target="target"/> produces: no dot-segments, no backslash, no <spanx style="verb">%2F</spanx> or <spanx style="verb">%5C</spanx>, and normalized as that section describes.</t>
      </dd>
      <dt><spanx style="verb">names</spanx>:</dt>
      <dd>
        <t><bcp14>OPTIONAL</bcp14>. A non-empty array of operation names (<xref target="operations"/>). When present, the entry applies only to configured operations with one of those names.</t>
      </dd>
    </dl>
  </dd>
</dl>

<t>An object <bcp14>MUST NOT</bcp14> contain the <spanx style="verb">actions</spanx>, <spanx style="verb">datatypes</spanx>, <spanx style="verb">identifier</spanx>, or <spanx style="verb">privileges</spanx> members of <xref section="2.2" sectionFormat="of" target="RFC9396"/>. As <xref section="5" sectionFormat="of" target="RFC9396"/> requires, the authorization server refuses an object with an unknown member or a member that does not conform.</t>

<t>For example:</t>

<figure><sourcecode type="json"><![CDATA[
{
  "type": "brokered_access",
  "locations": ["https://broker.example/tracker"],
  "upstream_grant": "ug_5Yc1r0mB7tQk2VxN9aLd3w",
  "operations": [
    { "methods": ["GET"], "path": "/projects/42/issues" },
    { "methods": ["POST"], "path": "/projects/42/issues",
      "names": ["issue.comment"] }
  ]
}
]]></sourcecode></figure>

<section anchor="permits"><name>When an Entry Permits a Request</name>

<t>An entry of <spanx style="verb">operations</spanx> permits a request that has been matched to a configured operation (<xref target="operations"/>) when all of the following hold:</t>

<t><list style="numbers" type="1">
  <t>the request method is in <spanx style="verb">methods</spanx>, where a HEAD request is treated as GET;</t>
  <t>the request path, relative to the broker resource and as computed in <xref target="target"/>, equals <spanx style="verb">path</spanx> or extends it at a segment boundary;</t>
  <t>if the entry has <spanx style="verb">names</spanx>, the configured operation has a name and that name is in <spanx style="verb">names</spanx>;</t>
  <t>if the configured operation is one that the upstream resource determines from request content (<xref target="operations"/>), the entry has <spanx style="verb">names</spanx>.</t>
</list></t>

<t>An object permits a request when at least one of its entries does. Comparison of methods, paths, and names is by exact string.</t>

</section>
<section anchor="covering"><name>When One Object Covers Another</name>

<t>An object A covers an object B when both have the same single <spanx style="verb">locations</spanx> value and the same <spanx style="verb">upstream_grant</spanx>, and for every entry of B there is an entry of A such that:</t>

<t><list style="numbers" type="1">
  <t>every method of the entry of B is in the <spanx style="verb">methods</spanx> of the entry of A;</t>
  <t>the <spanx style="verb">path</spanx> of the entry of B equals the <spanx style="verb">path</spanx> of the entry of A or extends it at a segment boundary;</t>
  <t>if the entry of A has <spanx style="verb">names</spanx>, the entry of B has <spanx style="verb">names</spanx> and every name in it is in the <spanx style="verb">names</spanx> of the entry of A. If the entry of A has no <spanx style="verb">names</spanx>, the entry of B has none.</t>
</list></t>

<t>The authorization server issues a token under <xref target="redeeming"/> only when the brokered authorization covers the object requested.</t>

</section>
<section anchor="metadata"><name>Metadata</name>

<t>A broker resource that publishes protected resource metadata <xref target="RFC9728"/> includes <spanx style="verb">brokered_access</spanx> in <spanx style="verb">authorization_details_types_supported</spanx>. The broker's authorization server includes it in its own <spanx style="verb">authorization_details_types_supported</spanx> (<xref section="10" sectionFormat="of" target="RFC9396"/>).</t>

<t>This document does not define how a client learns the operation names a broker resource uses (<xref target="open"/>).</t>

</section>
</section>
<section anchor="broker"><name>The Broker</name>

<section anchor="operations"><name>Broker Resources and Operations</name>

<t>Each broker resource <bcp14>MUST</bcp14> correspond to exactly one upstream resource. The correspondence, and the operations the broker resource offers, are fixed in the broker's configuration and <bcp14>MUST NOT</bcp14> depend on anything in a request. The one exception is the origin of the upstream resource, which can be fixed per upstream grant when that grant is made.</t>

<t>An operation is defined by:</t>

<t><list style="symbols">
  <t>a method. An operation <bcp14>MUST NOT</bcp14> be configured with the method HEAD. A HEAD request matches an operation whose method is GET;</t>
  <t>a path relative to the broker resource, or a path pattern in which each variable matches exactly one non-empty segment;</t>
  <t>the names of the query parameters it accepts. The broker parses the query as name and value pairs separated by "&amp;" only;</t>
  <t>optionally, a name, which is a string unique within the broker resource. An operation name <bcp14>MUST NOT</bcp14> be reassigned to a different operation;</t>
  <t>where the upstream resource determines what is done from the request content and not from the method and path alone, a name and the constraints on content that identify what is permitted. Examples are a single endpoint that accepts both queries and mutations, a remote procedure call named in the content, and a batch of calls in one request.</t>
</list></t>

<t>An operation's query parameter names <bcp14>MUST NOT</bcp14> include one that the upstream resource accepts as a credential or uses to choose the account, tenant, or user that a request acts as.</t>

<t>An operation <bcp14>MUST NOT</bcp14> be configured where the upstream resource lets a query parameter, a request field, or request content override the method or the target, unless the operation's definition excludes that override.</t>

<t>An operation <bcp14>MUST NOT</bcp14> be configured with the method CONNECT or TRACE.</t>

</section>
<section anchor="target"><name>The Request Path</name>

<t>The broker resource's path prefix is the path of its resource identifier, or "/" if that is empty. The broker computes the path of a request relative to the broker resource as follows.</t>

<t><list style="numbers" type="1">
  <t>The broker <bcp14>MUST</bcp14> reject, with a 400 (Bad Request) status code, a path that contains a backslash or the percent-encoded octets <spanx style="verb">%2F</spanx> or <spanx style="verb">%5C</spanx> in either case.</t>
  <t>The broker applies the normalizations of Sections 6.2.2.1 and 6.2.2.2 of <xref target="RFC3986"/> once. It <bcp14>MUST</bcp14> then reject, with a 400 (Bad Request) status code, a path with a segment that contains ";" and that, once everything from its first ";" is removed, is "." or "..". It then applies the remove_dot_segments procedure of <xref section="5.2.4" sectionFormat="of" target="RFC3986"/>.</t>
  <t>The result <bcp14>MUST</bcp14> equal the broker resource's path prefix or extend it at a segment boundary. Otherwise the broker <bcp14>MUST</bcp14> reject the request with a 400 (Bad Request) status code.</t>
  <t>The broker removes the broker resource's path prefix, without any trailing "/", from the result. What remains, or "/" if nothing remains, is the path relative to the broker resource.</t>
</list></t>

<t>That relative path is the one matched against operations, the one tested in <xref target="permits"/>, and the one from which the path sent upstream is formed. The broker <bcp14>MUST NOT</bcp14> use any other form of the path.</t>

<t>A broker <bcp14>MUST NOT</bcp14> provide a broker resource whose upstream target is chosen by the client instance.</t>

</section>
<section anchor="tokens"><name>Access Tokens</name>

<t>An access token presented at a broker resource <bcp14>MUST</bcp14> be sender-constrained, with DPoP <xref target="RFC9449"/> or with mutual TLS <xref target="RFC8705"/>. <xref section="1.4.3" sectionFormat="of" target="OAUTH21"/> and <xref target="RFC9700"/> recommend sender-constrained access tokens. This document requires them, because a bearer token for a broker resource would be a copyable credential for everything the broker can do with it. The broker <bcp14>MUST</bcp14> reject, with a 401 (Unauthorized) status code and the <spanx style="verb">invalid_token</spanx> error, an access token that carries no key confirmation.</t>

<t>The broker <bcp14>MUST</bcp14> reject an access token unless its audience is the resource identifier of the broker resource at which it is presented, compared as an exact string.</t>

<t>The broker <bcp14>MUST</bcp14> reject an access token unless it conveys exactly one <spanx style="verb">brokered_access</spanx> object whose <spanx style="verb">locations</spanx> value is that same resource identifier.</t>

<t>The broker validates the token and the proof of possession as any protected resource does, and returns the errors defined in <xref section="5.3" sectionFormat="of" target="OAUTH21"/> and <xref section="7.1" sectionFormat="of" target="RFC9449"/>. Where mutual TLS is used and TLS is terminated in front of the broker, <xref section="6.5" sectionFormat="of" target="RFC8705"/> applies.</t>

</section>
<section anchor="decision"><name>Deciding Whether to Act</name>

<t>Before it sends anything upstream, the broker <bcp14>MUST</bcp14> establish that:</t>

<t><list style="numbers" type="1">
  <t>the request matches exactly one configured operation: its method, its path, every query parameter name, and any content constraint (<xref target="operations"/>); and</t>
  <t>the <spanx style="verb">brokered_access</spanx> object the token conveys permits the request (<xref target="permits"/>).</t>
</list></t>

<t>Where the request matches no operation, the broker responds with a 404 (Not Found) status code, or 405 (Method Not Allowed) where the path matches and the method does not. Where it matches more than one, the configuration is at fault and the broker responds with a 500 (Internal Server Error) status code. Where the object does not permit the request, the broker responds with a 403 (Forbidden) status code and the <spanx style="verb">insufficient_scope</spanx> error. In none of these cases is anything sent upstream.</t>

</section>
<section anchor="selection"><name>Selecting the Upstream Grant</name>

<t>The broker resource is determined by the request target. The upstream grant is the one named by <spanx style="verb">upstream_grant</spanx> in the <spanx style="verb">brokered_access</spanx> object the validated access token conveys, and by nothing else.</t>

<t>The broker <bcp14>MUST NOT</bcp14> take the upstream grant, the resource owner, or any other input to the choice of upstream credential from the request target, from a request field, from request content, or from the token's subject.</t>

<t>The broker <bcp14>MUST</bcp14> reject the request if the upstream grant named does not belong to the broker resource at which the token is presented.</t>

<t>The broker <bcp14>MUST</bcp14> reject a token unless it was issued by the issuer recorded with the brokered authorization that the upstream grant identifier names.</t>

</section>
<section anchor="withdrawal"><name>Withdrawal</name>

<t>A broker that accepts a token on its signature and expiry alone will keep accepting it after the brokered authorization behind it has been withdrawn, until the token expires. Holding the upstream credential at the broker does not change that.</t>

<t>A broker <bcp14>MUST</bcp14> apply the withdrawal of a brokered authorization, and the refusal of a particular instance key, to requests it receives after a delay no longer than a limit that the deployment states. A broker that checks the current state of the brokered authorization at each request has a limit of zero. A broker that relies on token expiry has a limit equal to the longest lifetime of the tokens it accepts.</t>

<t>A key can be refused by the logical client or by the broker's operator. How either asks is outside this document.</t>

<t>The end of a client instance requires no action. Its tokens expire. The brokered authorization and the upstream grant are not affected.</t>

</section>
<section anchor="custody"><name>The Upstream Credential Is Not Released</name>

<t>The upstream grant and any upstream refresh token belong to the broker as the client of the upstream resource. They are never bound to a client instance.</t>

<t>The broker <bcp14>MUST NOT</bcp14> place an upstream credential in a response it generates or in a field it adds to a response.</t>

<t>The broker and its authorization server <bcp14>MUST NOT</bcp14> provide an interface that returns an upstream credential to a client instance.</t>

<t>The broker <bcp14>MUST</bcp14> send an upstream credential only to the upstream resource it belongs to and, where it is an OAuth credential, to the token endpoint of the authorization server that issued it.</t>

<t>The broker <bcp14>MUST NOT</bcp14> forward to the upstream resource a header field received from a client instance that the upstream resource accepts as a credential or uses to choose the account, tenant, or user that a request acts as.</t>

<t>The broker <bcp14>MUST NOT</bcp14> forward to a client instance a response header field in which the upstream resource conveys a credential or a challenge, such as <spanx style="verb">Set-Cookie</spanx> or <spanx style="verb">WWW-Authenticate</spanx>. It follows that a <spanx style="verb">WWW-Authenticate</spanx> field in a response from a broker resource always comes from the broker.</t>

<t>A component that exercises an upstream credential on one path and releases the same credential on another does not have the properties this document describes.</t>

</section>
<section anchor="upstream-auth"><name>Errors About the Upstream Grant</name>

<t>The broker can lack a usable upstream credential: the upstream grant has expired or was withdrawn at the upstream resource, or the upstream resource refuses the credential for a reason the broker cannot see. The instance's own token is not at fault and a new one will not help.</t>

<t>When the broker has no usable upstream credential for the request, or the upstream resource answers 401 (Unauthorized) and the broker cannot obtain a credential that the upstream resource accepts, the broker <bcp14>MUST</bcp14> respond with a 403 (Forbidden) status code and a <spanx style="verb">WWW-Authenticate</spanx> challenge, for the scheme the instance used, whose <spanx style="verb">error</spanx> parameter is <spanx style="verb">upstream_authorization_required</spanx>. It does not forward the upstream 401.</t>

<figure><sourcecode type="http-message"><![CDATA[
HTTP/1.1 403 Forbidden
WWW-Authenticate: DPoP error="upstream_authorization_required",
    error_description="The broker has no credential that the
    upstream resource accepts for this request."
]]></sourcecode></figure>

<t>This error does not indicate that the access token is invalid. An instance that obtains a new access token in response to it will receive the same error. The remedy is for the resource owner to authorize the broker again at the upstream resource.</t>

</section>
<section anchor="forwarding"><name>Forwarding</name>

<t>Apart from what <xref target="target"/>, <xref target="custody"/>, and <xref target="upstream-auth"/> require, how the broker builds the request it sends upstream and how it returns the response are outside this document. A broker's rules for them have to cover at least:</t>

<t><list style="symbols">
  <t>how the path sent upstream is formed from the relative path of <xref target="target"/>;</t>
  <t>where the upstream host comes from, and that it is never taken from a value in a request;</t>
  <t>which request and response header fields pass, as an explicit list;</t>
  <t>how the query is rebuilt, so that the broker and the upstream resource read the same parameters;</t>
  <t>redirects, and that a credential is never sent to a redirect target outside the upstream resource;</t>
  <t>renewal of the upstream credential, and that the place of renewal never comes from an upstream response;</t>
  <t>stored responses, and that one upstream grant's response never answers a request under another;</t>
  <t>replay of a proof of possession, which covers the method and path of a request and not its query or content;</t>
  <t>what an instance can conclude when the broker fails to get a response, and when, if ever, a request that may have reached the upstream resource is sent a second time.</t>
</list></t>

</section>
</section>
<section anchor="security"><name>Security Considerations</name>

<section anchor="the-broker-holds-everything"><name>The Broker Holds Everything</name>

<t>A broker concentrates upstream credentials, often for many resource owners and many upstream resources. Compromise of the broker is compromise of all of them. A resource owner who uses a broker is trusting it with everything the upstream grant allows. Nothing in this document reduces that trust. It moves the grant and the credential out of every instance and into one place.</t>

</section>
<section anchor="any-instance"><name>Any Instance of the Client Can Act</name>

<t>A brokered authorization is made to a logical client. Any instance that can authenticate as that client and knows the upstream grant identifier can obtain a token under it. That is the purpose: it is what lets a new instance act without asking the resource owner again. It is also the main exposure of this design. An instance that serves one resource owner can ask for a token under another resource owner's brokered authorization to the same client, if it learns that identifier.</t>

<t>Between logical clients the design does not rest on the identifier being unknown. Between instances of one client it does. The control is the logical client's own: whatever authenticates its instances decides which code runs as that client, and the client decides which instance is given which identifier. A resource owner who approves a brokered authorization is trusting the logical client with that, as a user who authorizes any confidential client trusts its backend with the tokens of all its users. The comparison holds only where every instance is as trusted as that backend. An instance that reads untrusted content is not. The credential with which an instance authenticates works, in effect, as a refresh token for every resource owner who has made a brokered authorization to that client.</t>

<t>A logical client whose instances run in places it does not control, such as a customer's infrastructure, is a poor fit for a single client identifier under this document. This document defines no way to restrict a brokered authorization to some instances of the client (<xref target="open"/>).</t>

</section>
<section anchor="client-key"><name>The Instance's Key</name>

<t>Everything this document says about access tokens depends on the instance's key. A key that sits in the memory or the files of the same process that reads untrusted content is as easy to copy as a bearer token. An instance that an attacker can induce to disclose a bearer credential can be induced to disclose such a key.</t>

<t>The arrangement is only better than a bearer credential where the key cannot be exported by the part of the instance that an attacker can influence: held in hardware, in an operating system key store, or in a separate process that signs proofs and does not reveal the key. Even then, an attacker who controls the instance can make any request the token permits, and can obtain further tokens under <xref target="redeeming"/>, for as long as it controls the instance. The broker and the brokered authorization limit what that is. They do not make a compromised instance safe.</t>

</section>
<section anchor="returning"><name>Operations That Return Credentials</name>

<t>Custody is defeated if an instance can get a derived credential out of the upstream resource. Operations that do this include:</t>

<t><list style="symbols">
  <t>operations that create or return credentials, such as an endpoint that issues an API key or a personal access token for the resource owner's account;</t>
  <t>operations that reflect the request, including its header fields, in the response;</t>
  <t>operations that change where the upstream resource sends credentials or secrets, such as registering a webhook or a redirect URI that the instance controls.</t>
</list></t>

<t>An operation of these kinds <bcp14>MUST NOT</bcp14> be configured (<xref target="operations"/>).</t>

<t>An operation whose response contains a URL that carries its own authorization, as many download operations do, releases a derived credential for one object for a limited time. It <bcp14>SHOULD NOT</bcp14> be configured. Where it is, the authorization server <bcp14>MUST</bcp14> tell the resource owner so when the brokered authorization is made (<xref target="making"/>).</t>

<t>The list of operations is only as good as the operator's knowledge of the upstream resource. An upstream resource can add a credential-returning behavior to an existing operation without notice. Where the operation is determined by content, the content constraint has to be at least as exact as the upstream resource's own parsing. These are limits of the arrangement, not of this document's wording.</t>

</section>
<section anchor="requests-that-are-not-what-they-seem"><name>Requests That Are Not What They Seem</name>

<t>The broker decides on a request and the upstream resource acts on one. Any difference between how the two read the same message is a way around the decision. The path computation (<xref target="target"/>), the operation list (<xref target="operations"/>), and the forwarding rules a broker adopts (<xref target="forwarding"/>) each close one such difference. They do not close differences in how the upstream resource parses content, and they do nothing about content in a response that is meant to mislead the instance that reads it.</t>

<t>A <spanx style="verb">path</spanx> in a <spanx style="verb">brokered_access</spanx> object is a prefix. An entry for "/projects/42" without <spanx style="verb">names</spanx> permits every configured operation at or beneath it with the listed methods, except one determined by request content.</t>

</section>
<section anchor="shared-credential"><name>A Credential Shared Between Resource Owners</name>

<t>Some upstream resources issue one credential for a whole organization. Where a broker uses one upstream credential for requests made under several resource owners' authority, the upstream resource enforces nothing between them, and the broker's operation list and token checks are the only separation. This document's rules do not make that safe. They assume one upstream credential per resource owner.</t>

</section>
<section anchor="what-the-upstream-resource-sees"><name>What the Upstream Resource Sees</name>

<t>The upstream resource sees one client, the broker. It cannot tell which logical client or which instance caused a request, and it applies its rate limits and quotas to the credential. Instances that share an upstream grant share those limits, and one can exhaust them for the others. A broker <bcp14>SHOULD</bcp14> limit each logical client and each instance key separately.</t>

<t>Attribution of a request to an instance exists only at the broker. A broker <bcp14>SHOULD</bcp14> keep, for each request it sends upstream, the client identifier, the thumbprint of the key the token was bound to, any instance context, and the upstream grant identifier. This document defines no format for that record.</t>

</section>
<section anchor="withdrawal-is-not-immediate"><name>Withdrawal Is Not Immediate</name>

<t>Withdrawal of a brokered authorization stops new tokens at once and takes effect at the broker within the limit stated under <xref target="withdrawal"/>, and not sooner. A request that the broker has already sent upstream is not recalled.</t>

<t>Withdrawing the upstream grant itself is done at the upstream resource and is outside this document.</t>

</section>
</section>
<section anchor="privacy-considerations"><name>Privacy Considerations</name>

<t>The broker sees every request and every response it handles, in full, for every resource owner and client it serves.</t>

<t>The upstream resource sees the broker and not the instance. It does not learn which client or instance made a request unless the broker tells it.</t>

<t>An upstream grant identifier is a stable value that stands for one resource owner at one upstream resource. It is seen by the logical client and its instances. It is specific to one logical client (<xref target="authz-details"/>), so two clients cannot correlate a resource owner by it.</t>

</section>
<section anchor="iana"><name>IANA Considerations</name>

<section anchor="oauth-extensions-error-registration"><name>OAuth Extensions Error Registration</name>

<t>This document requests registration of the following value in the "OAuth Extensions Error Registry" established by <xref section="11.4" sectionFormat="of" target="RFC6749"/>, under the extension point described in <xref section="6.5" sectionFormat="of" target="OAUTH21"/>.</t>

<dl>
  <dt>Name:</dt>
  <dd>
    <t><spanx style="verb">upstream_authorization_required</spanx></t>
  </dd>
  <dt>Usage Location:</dt>
  <dd>
    <t>resource access error response</t>
  </dd>
  <dt>Protocol Extension:</dt>
  <dd>
    <t>OAuth Brokered Authorization</t>
  </dd>
  <dt>Change Controller:</dt>
  <dd>
    <t>IETF</t>
  </dd>
  <dt>Reference:</dt>
  <dd>
    <t><xref target="upstream-auth"/> of this document</t>
  </dd>
</dl>

</section>
<section anchor="authorization-details-type"><name>Authorization Details Type</name>

<t><xref target="RFC9396"/> establishes no registry of authorization details types. This document makes no request for the type <spanx style="verb">brokered_access</spanx>. The plain type name departs from the recommendation in <xref section="2.1" sectionFormat="of" target="RFC9396"/>. A URN under <spanx style="verb">urn:ietf:params:oauth</spanx> <xref target="RFC6755"/> is the alternative.</t>

</section>
</section>
<section anchor="impl-status"><name>Implementation Status</name>

<t>Note to the RFC Editor: please remove this section and the reference to <xref target="RFC7942"/> before publication.</t>

<t>This section records the status of known implementations of the protocol defined by this specification at the time of posting of this Internet-Draft, and is based on a proposal described in <xref target="RFC7942"/>. The description of implementations in this section is intended to assist the IETF in its decision processes in progressing drafts to RFCs. Please note that the listing of any individual implementation here does not imply endorsement by the IETF. Furthermore, no effort has been spent to verify the information presented here that was supplied by IETF contributors. This is not intended as, and must not be construed to be, a catalog of available implementations or their features. Readers are advised to note that other implementations may exist.</t>

<t>According to <xref target="RFC7942"/>, "this will allow reviewers and working groups to assign due consideration to documents that have the benefit of running code, which may serve as evidence of valuable experimentation and feedback that have made the implemented protocols more mature. It is up to the individual working groups to use this information as they see fit".</t>

<section anchor="cred-sdk"><name>Cred SDK</name>

<dl>
  <dt>Implementer:</dt>
  <dd>
    <t>Kieran Sweeney (author of this document)</t>
  </dd>
  <dt>Location:</dt>
  <dd>
    <t>https://github.com/cred-ninja/sdk</t>
  </dd>
  <dt>License:</dt>
  <dd>
    <t>Apache-2.0</t>
  </dd>
  <dt>Maturity:</dt>
  <dd>
    <t>Experimental. It does not implement this document.</t>
  </dd>
  <dt>Contact:</dt>
  <dd>
    <t>kieran@kierans.net</t>
  </dd>
</dl>

<t>The following is taken from <xref target="CRED-DELEG"/> and was not checked against the code. The implementation follows the same division of custody: provider credentials stay in the server's vault, the server makes the upstream call, and by default the server hands no provider token to an agent. It differs from this document as follows. An agent holds a Delegation Token as defined in <xref target="CRED-DELEG"/>, and not an access token obtained with the client credentials grant, and the <spanx style="verb">brokered_access</spanx> type is not used. An exercise request names an upstream URL, method, and body at a single endpoint, where this document has the instance send an ordinary request to a broker resource. Requests are checked against a catalogue of operations for two providers.</t>

</section>
</section>
<section anchor="open"><name>Open Issues</name>

<t><list style="symbols">
  <t>Restricting a brokered authorization to some instances of the logical client, for example by attester, by tenant, or by a condition the resource owner sets (<xref target="any-instance"/>).</t>
  <t>An instance that starts a further instance of a different logical client. This document covers only instances of the client the brokered authorization was made to.</t>
  <t>Client instances that authenticate with an assertion issued by their platform and not with a key of their own.</t>
  <t>A broker as the enforcement point for authorization details types defined elsewhere, such as that of <xref target="MISSION-RA"/>.</t>
  <t>How a client learns the operation names a broker resource uses.</t>
  <t>The forwarding rules listed in <xref target="forwarding"/>, which are candidates for a companion document.</t>
  <t>Upstream resources that answer with a challenge for stronger authentication or for interactive consent.</t>
  <t>Evidence of each request sent upstream that a party other than the broker can check.</t>
  <t>Operation of the broker and its authorization server by separate parties.</t>
</list></t>

</section>


  </middle>

  <back>


<references title='References' anchor="sec-combined-references">

    <references title='Normative References' anchor="sec-normative-references">

<reference anchor="OAUTH21" >
  <front>
    <title>The OAuth 2.1 Authorization Framework</title>
    <author initials="D." surname="Hardt">
      <organization></organization>
    </author>
    <author initials="A." surname="Parecki">
      <organization></organization>
    </author>
    <author initials="T." surname="Lodderstedt">
      <organization></organization>
    </author>
    <date year="2026" month="October" day="31"/>
  </front>
  <seriesInfo name="Internet-Draft" value="draft-ietf-oauth-v2-1-17"/>
</reference>
<reference anchor="RFC3986" >
  <front>
    <title>Uniform Resource Identifier (URI): Generic Syntax</title>
    <author initials="T." surname="Berners-Lee">
      <organization></organization>
    </author>
    <author initials="R." surname="Fielding">
      <organization></organization>
    </author>
    <author initials="L." surname="Masinter">
      <organization></organization>
    </author>
    <date year="2005" month="January"/>
  </front>
  <seriesInfo name="STD" value="66"/>
  <seriesInfo name="RFC" value="3986"/>
  <seriesInfo name="DOI" value="10.17487/RFC3986"/>
</reference>


<reference anchor="RFC6749">
  <front>
    <title>The OAuth 2.0 Authorization Framework</title>
    <author fullname="D. Hardt" initials="D." role="editor" surname="Hardt"/>
    <date month="October" year="2012"/>
    <abstract>
      <t>The OAuth 2.0 authorization framework enables a third-party application to obtain limited access to an HTTP service, either on behalf of a resource owner by orchestrating an approval interaction between the resource owner and the HTTP service, or by allowing the third-party application to obtain access on its own behalf. This specification replaces and obsoletes the OAuth 1.0 protocol described in RFC 5849. [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name="RFC" value="6749"/>
  <seriesInfo name="DOI" value="10.17487/RFC6749"/>
</reference>

<reference anchor="RFC8705" >
  <front>
    <title>OAuth 2.0 Mutual-TLS Client Authentication and Certificate-Bound Access Tokens</title>
    <author initials="B." surname="Campbell">
      <organization></organization>
    </author>
    <author initials="J." surname="Bradley">
      <organization></organization>
    </author>
    <author initials="N." surname="Sakimura">
      <organization></organization>
    </author>
    <author initials="T." surname="Lodderstedt">
      <organization></organization>
    </author>
    <date year="2020" month="February"/>
  </front>
  <seriesInfo name="RFC" value="8705"/>
  <seriesInfo name="DOI" value="10.17487/RFC8705"/>
</reference>
<reference anchor="RFC8707" >
  <front>
    <title>Resource Indicators for OAuth 2.0</title>
    <author initials="B." surname="Campbell">
      <organization></organization>
    </author>
    <author initials="J." surname="Bradley">
      <organization></organization>
    </author>
    <author initials="H." surname="Tschofenig">
      <organization></organization>
    </author>
    <date year="2020" month="February"/>
  </front>
  <seriesInfo name="RFC" value="8707"/>
  <seriesInfo name="DOI" value="10.17487/RFC8707"/>
</reference>


<reference anchor="RFC9110">
  <front>
    <title>HTTP Semantics</title>
    <author fullname="R. Fielding" initials="R." role="editor" surname="Fielding"/>
    <author fullname="M. Nottingham" initials="M." role="editor" surname="Nottingham"/>
    <author fullname="J. Reschke" initials="J." role="editor" surname="Reschke"/>
    <date month="June" year="2022"/>
    <abstract>
      <t>The Hypertext Transfer Protocol (HTTP) is a stateless application-level protocol for distributed, collaborative, hypertext information systems. This document describes the overall architecture of HTTP, establishes common terminology, and defines aspects of the protocol that are shared by all versions. In this definition are core protocol elements, extensibility mechanisms, and the "http" and "https" Uniform Resource Identifier (URI) schemes.</t>
      <t>This document updates RFC 3864 and obsoletes RFCs 2818, 7231, 7232, 7233, 7235, 7538, 7615, 7694, and portions of 7230.</t>
    </abstract>
  </front>
  <seriesInfo name="STD" value="97"/>
  <seriesInfo name="RFC" value="9110"/>
  <seriesInfo name="DOI" value="10.17487/RFC9110"/>
</reference>

<reference anchor="RFC9126" >
  <front>
    <title>OAuth 2.0 Pushed Authorization Requests</title>
    <author initials="T." surname="Lodderstedt">
      <organization></organization>
    </author>
    <author initials="B." surname="Campbell">
      <organization></organization>
    </author>
    <author initials="N." surname="Sakimura">
      <organization></organization>
    </author>
    <author initials="D." surname="Tonge">
      <organization></organization>
    </author>
    <author initials="F." surname="Skokan">
      <organization></organization>
    </author>
    <date year="2021" month="September"/>
  </front>
  <seriesInfo name="RFC" value="9126"/>
  <seriesInfo name="DOI" value="10.17487/RFC9126"/>
</reference>


<reference anchor="RFC9396">
  <front>
    <title>OAuth 2.0 Rich Authorization Requests</title>
    <author fullname="T. Lodderstedt" initials="T." surname="Lodderstedt"/>
    <author fullname="J. Richer" initials="J." surname="Richer"/>
    <author fullname="B. Campbell" initials="B." surname="Campbell"/>
    <date month="May" year="2023"/>
    <abstract>
      <t>This document specifies a new parameter authorization_details that is used to carry fine-grained authorization data in OAuth messages.</t>
    </abstract>
  </front>
  <seriesInfo name="RFC" value="9396"/>
  <seriesInfo name="DOI" value="10.17487/RFC9396"/>
</reference>
<reference anchor="RFC9449">
  <front>
    <title>OAuth 2.0 Demonstrating Proof of Possession (DPoP)</title>
    <author fullname="D. Fett" initials="D." surname="Fett"/>
    <author fullname="B. Campbell" initials="B." surname="Campbell"/>
    <author fullname="J. Bradley" initials="J." surname="Bradley"/>
    <author fullname="T. Lodderstedt" initials="T." surname="Lodderstedt"/>
    <author fullname="M. Jones" initials="M." surname="Jones"/>
    <author fullname="D. Waite" initials="D." surname="Waite"/>
    <date month="September" year="2023"/>
    <abstract>
      <t>This document describes a mechanism for sender-constraining OAuth 2.0 tokens via a proof-of-possession mechanism on the application level. This mechanism allows for the detection of replay attacks with access and refresh tokens.</t>
    </abstract>
  </front>
  <seriesInfo name="RFC" value="9449"/>
  <seriesInfo name="DOI" value="10.17487/RFC9449"/>
</reference>

<reference anchor="RFC9728" >
  <front>
    <title>OAuth 2.0 Protected Resource Metadata</title>
    <author initials="M." surname="Jones">
      <organization></organization>
    </author>
    <author initials="P." surname="Hunt">
      <organization></organization>
    </author>
    <author initials="A." surname="Parecki">
      <organization></organization>
    </author>
    <date year="2025" month="April"/>
  </front>
  <seriesInfo name="RFC" value="9728"/>
  <seriesInfo name="DOI" value="10.17487/RFC9728"/>
</reference>


<reference anchor="RFC2119">
  <front>
    <title>Key words for use in RFCs to Indicate Requirement Levels</title>
    <author fullname="S. Bradner" initials="S." surname="Bradner"/>
    <date month="March" year="1997"/>
    <abstract>
      <t>In many standards track documents several words are used to signify the requirements in the specification. These words are often capitalized. This document defines these words as they should be interpreted in IETF documents. This document specifies an Internet Best Current Practices for the Internet Community, and requests discussion and suggestions for improvements.</t>
    </abstract>
  </front>
  <seriesInfo name="BCP" value="14"/>
  <seriesInfo name="RFC" value="2119"/>
  <seriesInfo name="DOI" value="10.17487/RFC2119"/>
</reference>
<reference anchor="RFC8174">
  <front>
    <title>Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words</title>
    <author fullname="B. Leiba" initials="B." surname="Leiba"/>
    <date month="May" year="2017"/>
    <abstract>
      <t>RFC 2119 specifies common key words that may be used in protocol specifications. This document aims to reduce the ambiguity by clarifying that only UPPERCASE usage of the key words have the defined special meanings.</t>
    </abstract>
  </front>
  <seriesInfo name="BCP" value="14"/>
  <seriesInfo name="RFC" value="8174"/>
  <seriesInfo name="DOI" value="10.17487/RFC8174"/>
</reference>



    </references>

    <references title='Informative References' anchor="sec-informative-references">

<reference anchor="RFC6755" >
  <front>
    <title>An IETF URN Sub-Namespace for OAuth</title>
    <author initials="B." surname="Campbell">
      <organization></organization>
    </author>
    <author initials="H." surname="Tschofenig">
      <organization></organization>
    </author>
    <date year="2012" month="October"/>
  </front>
  <seriesInfo name="RFC" value="6755"/>
  <seriesInfo name="DOI" value="10.17487/RFC6755"/>
</reference>
<reference anchor="RFC7591" >
  <front>
    <title>OAuth 2.0 Dynamic Client Registration Protocol</title>
    <author initials="J." surname="Richer" role="editor">
      <organization></organization>
    </author>
    <author initials="M." surname="Jones">
      <organization></organization>
    </author>
    <author initials="J." surname="Bradley">
      <organization></organization>
    </author>
    <author initials="M." surname="Machulak">
      <organization></organization>
    </author>
    <author initials="P." surname="Hunt">
      <organization></organization>
    </author>
    <date year="2015" month="July"/>
  </front>
  <seriesInfo name="RFC" value="7591"/>
  <seriesInfo name="DOI" value="10.17487/RFC7591"/>
</reference>


<reference anchor="RFC7942">
  <front>
    <title>Improving Awareness of Running Code: The Implementation Status Section</title>
    <author fullname="Y. Sheffer" initials="Y." surname="Sheffer"/>
    <author fullname="A. Farrel" initials="A." surname="Farrel"/>
    <date month="July" year="2016"/>
    <abstract>
      <t>This document describes a simple process that allows authors of Internet-Drafts to record the status of known implementations by including an Implementation Status section. This will allow reviewers and working groups to assign due consideration to documents that have the benefit of running code, which may serve as evidence of valuable experimentation and feedback that have made the implemented protocols more mature.</t>
      <t>This process is not mandatory. Authors of Internet-Drafts are encouraged to consider using the process for their documents, and working groups are invited to think about applying the process to all of their protocol specifications. This document obsoletes RFC 6982, advancing it to a Best Current Practice.</t>
    </abstract>
  </front>
  <seriesInfo name="BCP" value="205"/>
  <seriesInfo name="RFC" value="7942"/>
  <seriesInfo name="DOI" value="10.17487/RFC7942"/>
</reference>
<reference anchor="RFC9068">
  <front>
    <title>JSON Web Token (JWT) Profile for OAuth 2.0 Access Tokens</title>
    <author fullname="V. Bertocci" initials="V." surname="Bertocci"/>
    <date month="October" year="2021"/>
    <abstract>
      <t>This specification defines a profile for issuing OAuth 2.0 access tokens in JSON Web Token (JWT) format. Authorization servers and resource servers from different vendors can leverage this profile to issue and consume access tokens in an interoperable manner.</t>
    </abstract>
  </front>
  <seriesInfo name="RFC" value="9068"/>
  <seriesInfo name="DOI" value="10.17487/RFC9068"/>
</reference>

<reference anchor="RFC9700" >
  <front>
    <title>Best Current Practice for OAuth 2.0 Security</title>
    <author initials="T." surname="Lodderstedt">
      <organization></organization>
    </author>
    <author initials="J." surname="Bradley">
      <organization></organization>
    </author>
    <author initials="A." surname="Labunets">
      <organization></organization>
    </author>
    <author initials="D." surname="Fett">
      <organization></organization>
    </author>
    <date year="2025" month="January"/>
  </front>
  <seriesInfo name="BCP" value="240"/>
  <seriesInfo name="RFC" value="9700"/>
  <seriesInfo name="DOI" value="10.17487/RFC9700"/>
</reference>
<reference anchor="RFC10017" >
  <front>
    <title>OAuth 2.0 for Browser-Based Applications</title>
    <author initials="A." surname="Parecki">
      <organization></organization>
    </author>
    <author initials="P." surname="De Ryck">
      <organization></organization>
    </author>
    <author initials="D." surname="Waite">
      <organization></organization>
    </author>
    <date year="2026" month="August"/>
  </front>
  <seriesInfo name="BCP" value="212"/>
  <seriesInfo name="RFC" value="10017"/>
  <seriesInfo name="DOI" value="10.17487/RFC10017"/>
</reference>
<reference anchor="ATTEST" >
  <front>
    <title>OAuth 2.0 Attestation-Based Client Authentication</title>
    <author initials="T." surname="Looker">
      <organization></organization>
    </author>
    <author initials="P." surname="Bastian">
      <organization></organization>
    </author>
    <author initials="C." surname="Bormann">
      <organization></organization>
    </author>
    <date year="2026" month="October" day="13"/>
  </front>
  <seriesInfo name="Internet-Draft" value="draft-ietf-oauth-attestation-based-client-auth-12"/>
</reference>
<reference anchor="CLIENT-INSTANCE-ID" >
  <front>
    <title>OAuth 2.0 Client Instance Identifiers</title>
    <author initials="K." surname="McGuinness">
      <organization></organization>
    </author>
    <date year="2026" month="November" day="02"/>
  </front>
  <seriesInfo name="Internet-Draft" value="draft-mcguinness-oauth-client-instance-id-01"/>
</reference>
<reference anchor="AIMS" >
  <front>
    <title>AI Identity Management System</title>
    <author >
      <organization></organization>
    </author>
    <date year="2026" month="November" day="02"/>
  </front>
  <seriesInfo name="Internet-Draft" value="draft-ietf-wimse-aims-01"/>
</reference>
<reference anchor="GRANT-MGMT" target="https://openid.net/specs/oauth-v2-grant-management-ID1.html">
  <front>
    <title>Grant Management for OAuth 2.0</title>
    <author initials="T." surname="Lodderstedt">
      <organization></organization>
    </author>
    <author initials="S." surname="Low">
      <organization></organization>
    </author>
    <author initials="D." surname="Postnikov">
      <organization></organization>
    </author>
    <date year="2023" month="May"/>
  </front>
<refcontent>OpenID Foundation FAPI Working Group, oauth-v2-grant-management-03</refcontent></reference>
<reference anchor="MISSION-RA" >
  <front>
    <title>Mission Resource Access Profile for OAuth 2.0</title>
    <author initials="K." surname="McGuinness">
      <organization></organization>
    </author>
    <date year="2026" month="October" day="22"/>
  </front>
  <seriesInfo name="Internet-Draft" value="draft-mcguinness-oauth-mission-resource-access-00"/>
</reference>
<reference anchor="CRED-DELEG" target="https://datatracker.ietf.org/doc/draft-sweeney-wimse-credential-delegation/">
  <front>
    <title>Credential Delegation Protocol for AI Agents in Multi-System Environments</title>
    <author initials="K." surname="Sweeney">
      <organization></organization>
    </author>
    <date year="2026" month="October" day="30"/>
  </front>
<refcontent>Work in Progress, draft-sweeney-wimse-credential-delegation-02</refcontent></reference>


    </references>

</references>


<?line 738?>

<section numbered="false" anchor="acknowledgments"><name>Acknowledgments</name>

<t>The final hop to a bearer-only third-party API was a scenario in the WIMSE work at the IETF 127 Hackathon.</t>

</section>


  </back>

</rfc>

