oauth A. Schwenkschuster Internet-Draft P. Kasselmann Intended status: Informational SPIRL Expires: 31 August 2025 K. Burgin MITRE M. Jenkins NSA-CCSS B. Campbell Ping Identity 27 February 2025 OAuth Identity and Authorization Chaining Across Domains draft-ietf-oauth-identity-chaining-04 Abstract This specification defines a mechanism to preserve identity and authorization information across trust domains that use the OAuth 2.0 Framework. Discussion Venues This note is to be removed before publishing as an RFC. Discussion of this document takes place on the Web Authorization Protocol Working Group mailing list (oauth@ietf.org), which is archived at https://mailarchive.ietf.org/arch/browse/oauth/. Source for this draft and an issue tracker can be found at https://github.com/oauth-wg/oauth-identity-chaining. Status of This Memo This Internet-Draft is submitted in full conformance with the provisions of BCP 78 and BCP 79. Internet-Drafts are working documents of the Internet Engineering Task Force (IETF). Note that other groups may also distribute working documents as Internet-Drafts. The list of current Internet- Drafts is at https://datatracker.ietf.org/drafts/current/. Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as "work in progress." This Internet-Draft will expire on 31 August 2025. Schwenkschuster, et al. Expires 31 August 2025 [Page 1] Internet-Draft OAuth Identity and Authorization Chainin February 2025 Copyright Notice Copyright (c) 2025 IETF Trust and the persons identified as the document authors. All rights reserved. This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (https://trustee.ietf.org/ license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Revised BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Revised BSD License. Table of Contents 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 3 1.1. Requirements Language . . . . . . . . . . . . . . . . . . 3 2. Identity and Authorization Chaining Across Domains . . . . . 3 2.1. Overview . . . . . . . . . . . . . . . . . . . . . . . . 4 2.2. Authorization Server Discovery . . . . . . . . . . . . . 6 2.3. Token Exchange . . . . . . . . . . . . . . . . . . . . . 6 2.3.1. Token Exchange Request . . . . . . . . . . . . . . . 6 2.3.2. Processing rules . . . . . . . . . . . . . . . . . . 7 2.3.3. Token Exchange Response . . . . . . . . . . . . . . . 7 2.3.4. Example . . . . . . . . . . . . . . . . . . . . . . . 8 2.4. JWT Authorization Grant . . . . . . . . . . . . . . . . . 8 2.4.1. Access Token Request . . . . . . . . . . . . . . . . 9 2.4.2. Processing rules . . . . . . . . . . . . . . . . . . 9 2.4.3. Access Token Response . . . . . . . . . . . . . . . . 9 2.4.4. Example . . . . . . . . . . . . . . . . . . . . . . . 10 2.5. Claims transcription . . . . . . . . . . . . . . . . . . 10 3. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 11 3.1. Media Types . . . . . . . . . . . . . . . . . . . . . . . 11 4. Security Considerations . . . . . . . . . . . . . . . . . . . 11 4.1. Client Authentication . . . . . . . . . . . . . . . . . . 11 4.2. Sender Constraining Tokens . . . . . . . . . . . . . . . 11 4.3. Authorized use of Subject Token . . . . . . . . . . . . . 12 5. References . . . . . . . . . . . . . . . . . . . . . . . . . 12 5.1. Normative References . . . . . . . . . . . . . . . . . . 12 5.2. Informative References . . . . . . . . . . . . . . . . . 13 Appendix A. Use cases . . . . . . . . . . . . . . . . . . . . . 13 A.1. Preserve User Context across Multi-cloud, Multi-Hybrid environments . . . . . . . . . . . . . . . . . . . . . . 14 A.2. Continuous Integration Accessing External Resources . . . 14 A.3. API Security Use Case . . . . . . . . . . . . . . . . . . 14 A.4. Extend Single-Sign-On to API Access . . . . . . . . . . . 14 A.5. Cross-domain API authorization . . . . . . . . . . . . . 15 Schwenkschuster, et al. Expires 31 August 2025 [Page 2] Internet-Draft OAuth Identity and Authorization Chainin February 2025 Appendix B. Examples . . . . . . . . . . . . . . . . . . . . . . 15 B.1. Resource server acting as client . . . . . . . . . . . . 15 B.2. Authorization server acting as client . . . . . . . . . . 17 B.3. Delegated Key Binding . . . . . . . . . . . . . . . . . . 19 Appendix C. Acknowledgements . . . . . . . . . . . . . . . . . . 20 Appendix D. Document History . . . . . . . . . . . . . . . . . . 20 Contributors . . . . . . . . . . . . . . . . . . . . . . . . . . 21 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 22 1. Introduction Applications often require access to resources that are distributed across multiple trust domains where each trust domain has its own OAuth 2.0 authorization server. A request may transverse multiple resource servers in multiple trust domains before completing. All protected resources involved in such a request need to know on whose behalf the request was originally initiated (i.e. the user), what authorization was granted and optionally which other resource servers were called prior to making an authorization decision. This information needs to be preserved, even when a request crosses one or more trust domains. This document refers to this as "chaining" and defines a mechanism for preserving identity and authorization information across domains using a combination of OAuth 2.0 Token Exchange [RFC8693] and JSON Web Token (JWT) Profile for OAuth 2.0 Client Authentication and Authorization Grants [RFC7523]. 1.1. Requirements Language The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in BCP 14 [RFC2119] [RFC8174] when, and only when, they appear in all capitals, as shown here. 2. Identity and Authorization Chaining Across Domains This specification describes a combination of OAuth 2.0 Token Exchange [RFC8693] and JWT Profile for OAuth 2.0 Client Authentication and Authorization Grants [RFC7523] to achieve identity and authorization chaining across domains. Schwenkschuster, et al. Expires 31 August 2025 [Page 3] Internet-Draft OAuth Identity and Authorization Chainin February 2025 A client in trust domain A that needs to access a resource server in trust domain B requests a JWT authorization grant from the authorization server for trust domain A using a profile of OAuth 2.0 Token Exchange [RFC8693]. The client in trust domain A then presents the received grant as an assertion to the authorization server in trust domain B to obtain an access token for the protected resource in trust domain B using a profile of JWT Profile for OAuth 2.0 Client Authentication and Authorization Grants [RFC7523]. 2.1. Overview The identity and authorization chaining flow outlined below describes how a combination of OAuth 2.0 Token Exchange [RFC8693] and JWT Profile for OAuth 2.0 Client Authentication and Authorization Grants [RFC7523] are used to address the use cases identified. Schwenkschuster, et al. Expires 31 August 2025 [Page 4] Internet-Draft OAuth Identity and Authorization Chainin February 2025 +-------------+ +--------+ +-------------+ +---------+ |Authorization| | Client | |Authorization| |Protected| |Server | | Trust | |Server | |Resource | |Trust | |Domain A| |Trust | |Trust | |Domain A | | | |Domain B | |Domain B | +-------------+ +--------+ +-------------+ +---------+ | | | | | |----+ | | | (A) discover | | | | | Authorization |<---+ | | | Server | | | | Trust Domain B| | | | | | | | | | | | (B) exchange token | | | | [RFC 8693] | | | |<-------------------| | | | | | | | (C) | | | | - - - - - - - - - >| | | | | | | | | (D) present | | | | authorization grant | | | | [RFC 7523] | | | | ------------------->| | | | | | | | (E) | | | | <- - - - - - - - - -| | | | | | | | (F) access | | | --------------------------------->| | | | | | | | | Figure 1: Identity and Authorization Chaining Flow The flow illustrated in Figure 1 shows the steps the client in trust domain A needs to perform to access a protected resource in trust domain B. In this flow, the client is in posession of a token that an authorization server will accept as part of a token exchange flow as defined in Token Exchange (Section 2.3). How the client obtained this token is out of scope of this specification. The client has a way to discover the authorization server in Domain B and a trust relationship exists between Domain A and Domain B (e.g., through federation). It includes the following: Schwenkschuster, et al. Expires 31 August 2025 [Page 5] Internet-Draft OAuth Identity and Authorization Chainin February 2025 * (A) The client in trust domain A discovers the location of the authorization server of trust domain B. See Authorization Server Discovery (Section 2.2). * (B) The client in trust domain A exchanges a token it has in its posession with the authorization server in trust domain A for a JWT authorization grant that can be used at the authorization server in trust domain B. See Token Exchange (Section 2.3). * (C) The authorization server of trust domain A processes the request and returns a JWT authorization grant that the client can use with the authorization server of trust domain B. This requires a trust relationship between the authorization servers in trust domain A and trust domain B (e.g., through federation). * (D) The client in trust domain A presents the authorization grant to the authorization server of trust domain B. See Access Token Request (Section 2.4.1). * (E) Authorization server of trust domain B validates the JWT authorization grant and returns an access token. * (F) The client in trust domain A uses the access token received from the authorization server in trust domain B to access the protected resource in trust domain B. 2.2. Authorization Server Discovery This specification does not define authorization server discovery. A client MAY use the authorization_servers property as defined in [I-D.ietf-oauth-resource-metadata], maintain a static mapping or use other means to identify the authorization server. 2.3. Token Exchange The client in trust domain A performs token exchange as defined in [RFC8693] with the authorization server in trust domain A in order to obtain a JWT authorization grant that can be used with the authorization server of trust domain B as specified in section 1.3 of [RFC6749]. 2.3.1. Token Exchange Request The parameters described in section 2.1 of [RFC8693] apply here with the following restrictions: scope Schwenkschuster, et al. Expires 31 August 2025 [Page 6] Internet-Draft OAuth Identity and Authorization Chainin February 2025 OPTIONAL. Additional scopes to indicate scopes included in the returned JWT authorization grant. See Claims transcription (Section 2.5). resource REQUIRED if audience is not set. URI of authorization server for trust domain B. audience REQUIRED if resource is not set. Well known/logical name of authorization server for trust domain B. 2.3.2. Processing rules * If the request itself is not valid or if the given resource or audience are unknown, or are unacceptable based on policy, the authorization server in trust domain A MUST deny the request. * The authorization server in trust domain A MAY add, remove or change claims. See Claims transcription (Section 2.5). 2.3.3. Token Exchange Response All of section 2.2 of [RFC8693] applies. In addition, the following applies to implementations that conform to this specification. * The "aud" claim in the returned JWT authorization grant MUST identify the requested authorization server in trust domain B. This corresponds with RFC 7523 Section 3, Point 3 (https://datatracker.ietf.org/doc/html/rfc7523#section-3) and is there to reduce misuse and to prevent clients from presenting access tokens as an authorization grant to an authorization server in trust domain B. * The "aud" claim included in the returned JWT authorization grant MAY identify multiple authorization servers, provided that trust relationships exist with them (e.g. through federation). It is RECOMMENDED that the "aud" claim is restricted to a single authorization server in trust domain B to prevent an authorization server from presenting the client's authorization grant to an authorization server in a different trust domain. For example, this will prevent the authorization server in trust domain B from presenting the authorization grant it received from the client in trust domain A to the authorization server for trust domain C. Schwenkschuster, et al. Expires 31 August 2025 [Page 7] Internet-Draft OAuth Identity and Authorization Chainin February 2025 2.3.4. Example The example below shows the message invoked by the client in trust domain A to perform token exchange with the authorization server in trust domain A (https://as.a.org/auth) to receive a JWT authorization grant for the authorization server in trust domain B (https://as.b.org/auth). POST /auth/token HTTP/1.1 Host: as.a.org Content-Type: application/x-www-form-urlencoded grant_type=urn%3Aietf%3Aparams%3Aoauth%3Agrant-type%3Atoken-exchange &resource=https%3A%2F%2Fas.b.org%2Fauth &subject_token=ey... &subject_token_type=urn%3Aietf%3Aparams%3Aoauth%3Atoken-type%3Aaccess_token Figure 2: Token exchange request HTTP/1.1 200 OK Content-Type: application/json Cache-Control: no-cache, no-store { "access_token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJo dHRwczovL2FzLmEub3JnL2F1dGgiLCJleHAiOjE2OTUyODQwOTIsImlhdCI6MTY5N TI4NzY5Miwic3ViIjoiam9obl9kb2VAYS5vcmciLCJhdWQiOiJodHRwczovL2FzLm Iub3JnL2F1dGgifQ.304Pv9e6PnzcQPzz14z-k2ZyZvDtP5WIRkYPScwdHW4", "token_type":"N_A", "issued_token_type":"urn:ietf:params:oauth:token-type:jwt", "expires_in":60 } Figure 3: Token exchange response 2.4. JWT Authorization Grant The client presents the JWT authorization grant it received from the authorization server in trust domain A as an authorization grant to the authorization server in trust domain B to obtain an access token for a resource server in trust domain B. The authorization grant is presented as defined in the JWT Profile for OAuth 2.0 Client Authentication and Authorization Grants [RFC7523]. Schwenkschuster, et al. Expires 31 August 2025 [Page 8] Internet-Draft OAuth Identity and Authorization Chainin February 2025 2.4.1. Access Token Request The authorization grant is a JWT bearer token, which the client in trust domain A uses to request an access token from the authorization server in trust domain B as described in the JWT Profile for OAuth 2.0 Client Authentication and Authorization Grants [RFC7523]. For the purpose of this specification the following descriptions apply: grant_type REQUIRED. As defined in Section 2.1 of [RFC7523] the value urn:ietf:params:oauth:grant-type:jwt-bearer indicates the request is a JWT bearer assertion authorization grant. assertion REQUIRED. Authorization grant returned by the authorization server for domain A (see Token Exchange (Section 2.3) response). scope OPTIONAL. The client in trust domain A MAY indicate the audience it is trying to access through the scope parameter or the resource parameter defined in [RFC8707]. 2.4.2. Processing rules The authorization server in trust domain B MUST validate the JWT authorization grant as specified in Sections 3 and 3.1 of [RFC7523]. The following processing rules also apply: * The "aud" claim MUST identify the authorization server in trust domain B as a valid intended audience of the assertion using either the token endpoint as described Section 3 [RFC7523] or the issuer identifier as defined in Section 2 of [RFC8414]. * The authorization server in trust domain B SHOULD deny the request if it is not able to identify the subject. * Due to policy the request MAY be denied (for instance if federation with trust domain A is not established). 2.4.3. Access Token Response The authorization server in trust domain B responds with an access token as described in section 5.1 of [RFC6749]. Schwenkschuster, et al. Expires 31 August 2025 [Page 9] Internet-Draft OAuth Identity and Authorization Chainin February 2025 2.4.4. Example The example belows shows how the client in trust domain A presents an authorization grant to the authorization server in trust domain B (https://as.b.org/auth) to receive an access token for a protected resource in trust domain B. POST /auth/token HTTP/1.1 Host: as.b.org Content-Type: application/x-www-form-urlencoded grant_type=urn%3Aietf%3Aparams%3Aoauth%3Agrant-type%3Ajwt-bearer &assertion=ey... Figure 4: Assertion request HTTP/1.1 200 OK Content-Type: application/json Cache-Control: no-cache, no-store { "access_token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJo dHRwczovL2FzLmIub3JnL2F1dGgiLCJleHAiOjE2OTUyODQwOTIsImlhdCI6MTY5N TI4NzY5Miwic3ViIjoiam9obi5kb2UuMTIzIiwiYXVkIjoiaHR0cHM6Ly9iLm9yZy 9hcGkifQ.CJBuv6sr6Snj9in5T8f7g1uB61Ql8btJiR0IXv5oeJg", "token_type":"Bearer", "expires_in":60 } Figure 5: Assertion response 2.5. Claims transcription Authorization servers MAY transcribe claims when either producing JWT authorization grants in the token exchange flow or access tokens in the assertion flow. Transcription of claims may be required for the following reasons: * *Transcribing the subject identifier*: The subject identifier can differ between the parties involved. For example, a user is identified in trust domain A as "johndoe@a.org" but in trust domain B they are identified as "doe.john@b.org". The mapping from one identifier to the other MAY either happen in the token exchange step and the updated identifier is reflected in the returned JWT authorization grant or in the assertion step where the updated identifier would be reflected in the access token. To support this both authorization servers MAY add, change or remove claims as described above. Schwenkschuster, et al. Expires 31 August 2025 [Page 10] Internet-Draft OAuth Identity and Authorization Chainin February 2025 * *Selective disclosure*: Authorization servers MAY remove or hide certain claims due to privacy requirements or reduced trust towards the targeting trust domain. * *Controlling scope*: Clients MAY use the scope parameter to control transcribed claims (e.g. downscoping). Authorization Servers SHOULD verify that the requested scopes are not higher privileged than the scopes of the presented subject_token. * *Including JWT authorization grant claims*: The authorization server in trust domain B which is performing the assertion flow MAY leverage claims from the JWT authorization grant presented by the client in trust doman A and include them in the returned access token. The populated claims SHOULD be namespaced or validated to prevent the injection of invalid claims. The representation of transcribed claims and their format is not defined in this specification. 3. IANA Considerations 3.1. Media Types This specification does not define any new media types. It is RECOMMENDED that any profile or deployment-specific implementation adopt explicit typing as defined in JSON Web Token Best Current Practices [RFC8725] and define a new media type [RFC2046] in the "Media Types" registry [IANA.MediaTypes] in the manner described in [RFC6838]. 4. Security Considerations 4.1. Client Authentication Authorization Servers SHOULD follow the OAuth 2.0 Security Best Current Practice [I-D.ietf-oauth-security-topics] for client authentication. 4.2. Sender Constraining Tokens Authorization Servers SHOULD follow the The OAuth 2.1 Authorization Framework [I-D.draft-ietf-oauth-v2-1] for sender constraining tokens. Schwenkschuster, et al. Expires 31 August 2025 [Page 11] Internet-Draft OAuth Identity and Authorization Chainin February 2025 4.3. Authorized use of Subject Token The authorization server in trust domain A SHOULD perform client authentication and verify that the client in trust domain A is authorized to present the token used as a subject_token in the token exchange flow before issuing an authorization grant. By doing so, it minimizes the risk of an attacker making a lateral move by using a stolen token from trust domain A to obtain an authorization grant with which to authenticate to an authorization server in trust domain B and request an access token for a resource server in trust domain B. 5. References 5.1. Normative References [RFC6749] Hardt, D., Ed., "The OAuth 2.0 Authorization Framework", RFC 6749, DOI 10.17487/RFC6749, October 2012, . [RFC8693] Jones, M., Nadalin, A., Campbell, B., Ed., Bradley, J., and C. Mortimore, "OAuth 2.0 Token Exchange", RFC 8693, DOI 10.17487/RFC8693, January 2020, . [RFC7523] Jones, M., Campbell, B., and C. Mortimore, "JSON Web Token (JWT) Profile for OAuth 2.0 Client Authentication and Authorization Grants", RFC 7523, DOI 10.17487/RFC7523, May 2015, . [RFC8707] Campbell, B., Bradley, J., and H. Tschofenig, "Resource Indicators for OAuth 2.0", RFC 8707, DOI 10.17487/RFC8707, February 2020, . [RFC8414] Jones, M., Sakimura, N., and J. Bradley, "OAuth 2.0 Authorization Server Metadata", RFC 8414, DOI 10.17487/RFC8414, June 2018, . [RFC8725] Sheffer, Y., Hardt, D., and M. Jones, "JSON Web Token Best Current Practices", BCP 225, RFC 8725, DOI 10.17487/RFC8725, February 2020, . [RFC2046] Freed, N. and N. Borenstein, "Multipurpose Internet Mail Extensions (MIME) Part Two: Media Types", RFC 2046, DOI 10.17487/RFC2046, November 1996, . Schwenkschuster, et al. Expires 31 August 2025 [Page 12] Internet-Draft OAuth Identity and Authorization Chainin February 2025 [RFC6838] Freed, N., Klensin, J., and T. Hansen, "Media Type Specifications and Registration Procedures", BCP 13, RFC 6838, DOI 10.17487/RFC6838, January 2013, . [IANA.MediaTypes] "*** BROKEN REFERENCE ***". [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, DOI 10.17487/RFC2119, March 1997, . [RFC8174] Leiba, B., "Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words", BCP 14, RFC 8174, DOI 10.17487/RFC8174, May 2017, . 5.2. Informative References [I-D.ietf-oauth-security-topics] Lodderstedt, T., Bradley, J., Labunets, A., and D. Fett, "OAuth 2.0 Security Best Current Practice", Work in Progress, Internet-Draft, draft-ietf-oauth-security- topics-29, 3 June 2024, . [I-D.ietf-oauth-resource-metadata] Jones, M. B., Hunt, P., and A. Parecki, "OAuth 2.0 Protected Resource Metadata", Work in Progress, Internet- Draft, draft-ietf-oauth-resource-metadata-13, 15 October 2024, . [I-D.draft-ietf-oauth-v2-1] Hardt, D., Parecki, A., and T. Lodderstedt, "The OAuth 2.1 Authorization Framework", Work in Progress, Internet- Draft, draft-ietf-oauth-v2-1-12, 15 November 2024, . Appendix A. Use cases This sections outlines some use cases where the identity and authorization chaining described in this document can be applied. The use cases described are not exhaustive, but are representative of the type of use cases enabled by this specification. Other use cases may also be supported by this specification. Schwenkschuster, et al. Expires 31 August 2025 [Page 13] Internet-Draft OAuth Identity and Authorization Chainin February 2025 A.1. Preserve User Context across Multi-cloud, Multi-Hybrid environments A user attempts to access a service that is implemented as a number of on-premise and cloud-based microservices. Both the on-premise and cloud-based services are segmented by multiple trust boundaries that span one or more on-premise or cloud service environments. Every microservice can apply an authorization policy that takes the context of the original user, as well as intermediary microservices into account, irrespective of where the microservices are running and even when a microservice in one trust domain calls another service in another trust domain. A.2. Continuous Integration Accessing External Resources A continuous integration system needs to access external resources, for example to upload an artifact or to run tests. These resources are protected by different authorization servers. The identity information of the build, for example metadata such as commit hashes or repository, should be preserved and carried across the domain boundary. This not just prevents maintaining credentials it also allows fine grained access control at the resource. A.3. API Security Use Case A home devices company provides a "Camera API" to enable access to home cameras. Partner companies use this Camera API to integrate the camera feeds into their security dashboards. Using OAuth between the partner and the Camera API, a partner can request the feed from a home camera to be displayed in their dashboard. The user has an account with the camera provider. The user may be logged in to view the partner provided dashboard, or they may authorize emergency access to the camera. The home devices company must be able to independently verify that the request originated and was authorized by a user who is authorized to view the feed of the requested home camera. A.4. Extend Single-Sign-On to API Access A user that authenticated to an enterprise Identity Provider (IdP) does not have to sign-in to multiple SaaS applications if the SaaS applications are configured to trust the enteprise IdP. It is possible to extend this SSO relationship to API access by allowing the Client to contact the enterprise IdP and exchange the identity assertion (ID Token or SAML Token) that it previously received from the enteprise IdP for an authorization grant. The authorization grant can be used to obtain an access token from the SaaS application's authorization server, provided that a trust Schwenkschuster, et al. Expires 31 August 2025 [Page 14] Internet-Draft OAuth Identity and Authorization Chainin February 2025 relationship has been established between the enterprise IdP which issues the authorization grant and the SaaS authorization server. As a result SaaS servers that trust the enterprise IdP do not require the user to complete an interactive delegated OAuth 2.0 flow to obtain an access token to access the SaaS provider's APIs. A.5. Cross-domain API authorization An e-mail client can be used with arbitrary email servers, without requiring pre-established relationships between each email client and each email server. An e-mail client obtains an identity assertion (ID Token or SAML token) from an IdP. When the e-mail client needs access to a separate API, such as a third-party calendaring application, the email client exchanges the identity assertion for an authorization grant and uses this authorization grant to obtain an access token for the third-party calendaring application from the authorization server trusted by the third-party calendaring application. If the authorization server trusts the issuer of the authorization grant, the e-mail client obtains an access token without any additional user interaction. Appendix B. Examples This section contains two examples, demonstrating how this specification may be used in different environments with specific requirements. The first example shows the resource server acting as the client and the second example shows the authorization server acting as the client. B.1. Resource server acting as client As part of completing a request, a resource server in Domain A may need to access a resource server in Domain B. This requires the resource server in Domain A to obtain an Access Token from an authorization server in Domain B, which it may then be presented to the resource server in Domain B. A Resource server in Domain B may use the flows described in this specification by assuming the role of a client when attempting to access the resource server in Domain B. Resources servers may act as clients if the following is true: * The resource server has the ability to determine the authorization server of the protected resource outside its trust domain. * Authorization Server B is reachable by the resource server and is able to perform the appropriate client authentication (if required). The flow would look like this: Schwenkschuster, et al. Expires 31 August 2025 [Page 15] Internet-Draft OAuth Identity and Authorization Chainin February 2025 +-------------+ +---------------+ +-------------+ +---------+ |Authorization| |Resource Server| |Authorization| |Protected| |Server | |Domain A | |Server | |Resource | |Domain A | |(acting as | |Domain B | |Domain B | | | | Client) | | | | | +-------------+ +---------------+ +-------------+ +---------+ | | | | | | (A) request protected resource | | | metadata | | | --------------------------------->| | | <- - - - - - - - - - - - - - - - -| | | | | | (B) exchange token | | | | [RFC 8693] | | | |<--------------------| | | | | | | | (C) | | | | - - - - - - - - - >| | | | | | | | | (D) present | | | | authorization | | | | grant [RFC 7523] | | | |-------------------->| | | | | | | | (E) | | | |<- - - - - - - - - - | | | | | | | | (F) access | | | --------------------------------->| | | | | | | | | Figure 6: Resource server acting as client The flow contains the following steps: (A) The resource server of Domain A needs to access protected resource in Domain B. It requires an access token to do so which it does not possess. In this example [I-D.ietf-oauth-resource-metadata] is used to receive information about the authorization server which protects the resource in domain B. This step MAY be skipped if discovery is not needed and other means of discovery MAY be used. The protected resource returns its metadata along with the authorization server information. Schwenkschuster, et al. Expires 31 August 2025 [Page 16] Internet-Draft OAuth Identity and Authorization Chainin February 2025 (B) Now, after the resource server has identified the authorization server for Domain B, the resource server requests a JWT authorization grant for the authorization server in Domain B from its own authorization server (Domain A). This happens via the token exchange protocol. (C) If successful, the authorization server returns a JWT authorization grant to the resource server. (D) The resource server presents the JWT authorization grant to the authorization server of Domain B. (E) The authorization server of Domain B uses claims from the JWT authorization grant to identify the user and its access. If access is granted an access token is returned. (F) The resource server uses the access token to access the protected resource at Domain B. B.2. Authorization server acting as client Authorization servers may act as clients too. This can be necessary because of following reasons: * Clients in Domain A may not have knowledge of authorization servers in Domain B. * Clients in domain A may not have network access to other authorization servers in Domain B. * Strict access control on resources outside the trust domain is required and enforced by authorization servers in Domain B. * Authorization servers in domain B require client authentication, but are unable to manage clients outside of Domain B. Under these conditions, an authorization server in Domain A may obtain an Access Token from an authorization server in Domain B on- behalf-of any client in Domain A. This enables clients in Domain A to access a protected resource server in Domain B. Resource servers in domain A may act as a client to the authorization server in Domain A in order to obtain an access token to access a protected resource in Domain B in order to complete a request. The authorization server may use the flows described in this specification by acting first as a client to itself to obtain an assertion grant and then act as a client to the authorization server in domain B to request an access token for protected resources in Schwenkschuster, et al. Expires 31 August 2025 [Page 17] Internet-Draft OAuth Identity and Authorization Chainin February 2025 Domain B. The flow when authorization servers act as a client on- behalf of another client in it's own trust domain would look like this: +--------+ +-------------+ +-------------+ +---------+ |Client | |Authorization| |Authorization| |Protected| | | |Server | |Server | |Resource | |Domain A| |Domain A | |Domain B | |Domain B | | | |(acting as | | | | | | | |client) | | | | | +--------+ +-------------+ +-------------+ +---------+ | | | | | (A) request or | | | | exchange token for | | | | protected resource | | | | in domain B. | | | | -------------------->| | | | | | | | |----+ | | | | | (B) determine | | | |<---+ authorization | | | | server B | | | | | | | | | | | |----+ | | | | | (C) issue | | | |<---+ authorization | | | | grant ("internal | | | | token exchange") | | | | | | | | | | | | (D) present | | | | authorization grant | | | | [RFC 7523] | | | | --------------------->| | | | | | | | (E) | | | | <- - - - - - - - - - -| | | | | | | (F) | | | | <- - - - - - - - - - | | | | | | | | | (G) access | | | ---------------------------------------------------------->| | | | | | | | | Figure 7: Authorization server acting as client Schwenkschuster, et al. Expires 31 August 2025 [Page 18] Internet-Draft OAuth Identity and Authorization Chainin February 2025 The flow contains the following steps: (A) The client in Domain A requests a token for the protected resource in Domain B from the authorization server in Domain A. This specification does not define this step. A profile of Token Exchange [RFC8693] may be used. (B) The authorization server of Domain A determines the authorization server of Domain B. This could have been passed by the client, is statically maintained or dynamically resolved. (C) Once the authorization server in Domain B is determined, the authorization server in Domain A issues a JWT authorization grant to itself. This reflects to Token exchange (Section 2.3) of this specification and can be seen as an "internal token exchange". (D) The authorization server in Domain A acts as a client and presents the JWT authorization grant to the authorization server of Domain B. This presentation happens between the authorization servers. Authorization server A may be required to perform client authentication while doing so. This reflects to [See Access Token Request (Section 2.4.1)] of this specification. (E) The authorization server of Domain B returns an access token for the protected resource in Domain B to the authorization server in Domain A. (F) The authorization server of Domain A returns the access token to the client in Domain A. (G) The client in Domain A uses the received access token to access the protected resource in Domain B. B.3. Delegated Key Binding In some environments, there is a need to bind the access token issued by the Authorization Server in Domain B to a private key held by the client in Domain A. This is so that the Resource Server in Domain B can verify the proof of possession of the private key of the client in Domain A when the client in Domain A presents the token to the Resource Server in Domain B. Any application in Domain A may act as a client, including applications that are resource servers in Domain A and need to access resource servers in Domain B in order to complete a request. Schwenkschuster, et al. Expires 31 August 2025 [Page 19] Internet-Draft OAuth Identity and Authorization Chainin February 2025 In the case where the Resource Server in Domain A is acting as the client, the access token may be constrained using existing techniques as described in Security Considerations (add reference once it is merged). The case where the Authorization Server in Domain A is acting as a client is more complicated since the Authorization Server in domain A acting as client does not have access to the key material of the client on whose behalf the access token is being requested. However, the trust relationship between the Authorization Server in Domain A and the Authorization Server in Domain B can be leveraged to sender constrain the access token issued by the Authorization Server in domain B. This can be achieved as follows. The Authorization Server in Domain A verifies proof of possession of the key presented by the client. It then conveys the key of the client in Domain A in the token request sent to the Authorization Server in Domain B. This can, for example, be accomplished by including a "requested_cnf" claim that contains the "cnf" claim of the Resource Server in Domain A, in the assertion authorization grant sent to the Authorization Server in Domain B. The Authorization Server in Domain B then includes a "cnf" claim that matches the value of the "requested_cnf" claim in the authorization grant in the returned access token. The client in domain A that presents the access token must use the key matching the "cnf" claim to generate a DPoP proof or setup a MTLS session when presenting the access token to a resource server in Domain B. Appendix C. Acknowledgements The editors would like to thank Joe Jubinski, Justin Richer, Aaron Parecki, Dean H. Saxe, and others (please let us know, if you've been mistakenly omitted) for their valuable input, feedback and general support of this work. Appendix D. Document History [[ To be removed from the final specification ]] -latest -04 * Clarified diagrams and description of authorization server acting as a client. * Remove references to sd-jwt. * Added text to recommend use of explicit typing. Schwenkschuster, et al. Expires 31 August 2025 [Page 20] Internet-Draft OAuth Identity and Authorization Chainin February 2025 * Added security consideration on preventing lateral moves. * Editorial updates to be consistent about the trust domain for a client, authorization server or resource server. * Added sender constraining of tokens to security considerations -03 * Editorial updates -02 * remove recommendation to not use RFC8693's requested_token_type * Corrected discrepancy between alphabetic numbering of the diagram and text in the resource acting as client example -01 * limit the authorization grant format to RFC7523 JWT * minor example fixes * editorial fixes * added Aaron Parecki to acknowledgements * renamed section headers to be more explicit * use more specific term "JWT authorization grant" * changed name to "OAuth Identity and Authorization Chaining Across Domains" * move use cases to appendix and add continuous integration use case -00 * initial working group version (previously draft-schwenkschuster- oauth-identity-chaining) Contributors Atul Tulshibagwale SGNL Email: atuls@sgnl.ai Schwenkschuster, et al. Expires 31 August 2025 [Page 21] Internet-Draft OAuth Identity and Authorization Chainin February 2025 George Fletcher Capital One Email: george.fletcher@capitalone.com Rifaat Shekh-Yusef EY Email: rifaat.shekh-yusef@ca.ey.com Hannes Tschofenig Email: hannes.tschofenig@gmx.net Authors' Addresses Arndt Schwenkschuster SPIRL Email: arndts.ietf@gmail.com Pieter Kasselmann SPIRL Email: pieter@spirl.com Kelley Burgin MITRE Email: kburgin@mitre.org Mike Jenkins NSA-CCSS Email: mjjenki@cyber.nsa.gov Brian Campbell Ping Identity Email: bcampbell@pingidentity.com Schwenkschuster, et al. Expires 31 August 2025 [Page 22]