# OAuth token exchange (RFC 8693) per agenti AI: delega, impersonation e il claim act

> Come funziona il token exchange RFC 8693 quando un agente AI agisce per un utente: delega e impersonation, i claim act e may_act, e cosa controllare prima.

- URL: https://iamops.dev/it/oauth-token-exchange-delegation-impersonation/
- Language: it
- Author: Argo
- Published: 2026-11-22
- Category: Knowledge
- Depth: Approfondimento
- Time: 8 minuti
- Topics: Token Exchange, RFC 8693, Delega, OAuth, Agenti AI

## In breve

- [RFC 8693](https://iamops.dev/it/oauth-token-exchange-delegation-impersonation/#cosa-contiene-una-richiesta-di-scambio) scambia un token con un altro al token endpoint. Sono obbligatori solo subject_token e il suo tipo; il [laboratorio Keycloak](https://iamops.dev/it/keycloak-token-exchange-rfc-8693/#lesecuzione) mostra una richiesta completa.
- Con l'[impersonation](https://iamops.dev/it/oauth-token-exchange-delegation-impersonation/#delega-o-impersonation) l'API non distingue l'agente dall'utente. Con la delega il token li porta entrambi, e l'agente sta nel [claim act](https://iamops.dev/it/oauth-token-exchange-delegation-impersonation/#leggere-il-claim-act).
- In una catena di act annidati solo l'[attore più esterno](https://iamops.dev/it/oauth-token-exchange-delegation-impersonation/#leggere-il-claim-act) conta per le decisioni di accesso. Gli altri sono storia: registrali, ma non autorizzare su di loro.
- [ID-JAG](https://iamops.dev/it/id-jag-explained/#cosa-fa-un-id-jag), i transaction token e i server MCP si appoggiano tutti a questo grant. L'[OBO di Entra](https://iamops.dev/it/oauth-token-exchange-delegation-impersonation/#dove-compare-oggi-il-token-exchange) fa lo stesso lavoro con un altro grant type.
- Prima di fidarti di un provider, fai i [controlli](https://iamops.dev/it/oauth-token-exchange-delegation-impersonation/#cosa-controllo-prima-di-fidarmi-di-unimplementazione): chi può scambiare, quali audience, se tornano refresh token e se act compare davvero.

Un agente AI che chiama un'API per un utente non dovrebbe inoltrare il token dell'utente. La risposta abituale è il token exchange: l'agente, o il server MCP dietro di lui, consegna il token all'authorization server e ne riceve uno nuovo, più ristretto e destinato a una sola API. RFC 8693 definisce questo grant. È uscita a gennaio 2020, molto prima che qualcuno chiamasse agente un chatbot, e aveva già le parole che servono: delega, impersonation e attore.

Questo articolo è il riferimento a cui torno quando preparo laboratori di token exchange. Copre la richiesta, le due semantiche, i claim che le esprimono e i posti dove il grant compare oggi.

## Cosa contiene una richiesta di scambio

Un token exchange è una normale chiamata al token endpoint con grant type `urn:ietf:params:oauth:grant-type:token-exchange`. I parametri:

| Parametro | Obbligatorio | Cosa dice |
| --- | --- | --- |
| `subject_token`, `subject_token_type` | Sì | La parte per conto della quale si chiede il nuovo token |
| `actor_token`, `actor_token_type` | No | La parte che agirà |
| `resource` | No | URI assoluto del punto in cui si userà il token, senza frammento |
| `audience` | No | Nome logico del destinatario, per esempio un client ID |
| `scope` | No | Gli scope richiesti per il nuovo token |
| `requested_token_type` | No | Access token, JWT, ID token, SAML e così via, come URN |

La risposta indica cosa è stato emesso in `issued_token_type`. Come si autentica il client, e se i client non autenticati possano scambiare token, è una scelta di chi gestisce il servizio. In pratica quella scelta è tutto il modello di sicurezza: [nel mio laboratorio Keycloak](https://iamops.dev/it/keycloak-token-exchange-rfc-8693/#configurazione) solo un client aveva il privilegio di scambio, e un client senza è stato rifiutato.

`resource` e `audience` si possono ripetere, quindi uno scambio può chiedere un token valido per più destinatari. Per gli agenti non lo farei. Uno scambio per ogni API a valle rende ogni token inutile altrove.

## Delega o impersonation

La sezione 1.1 della RFC definisce le due semantiche, e la differenza è la prima cosa da decidere in un deployment di agenti AI.

- **Impersonation.** A riceve i diritti di B in un certo contesto e lì non si distingue da B. L'API che riceve il token crede di avere a che fare con B. Alcune parti del sistema possono saperlo, ma il token non è tenuto a dirlo.
- **Delega.** A mantiene la propria identità. Il token dice che A agisce per B. La RFC lo dice chiaramente: "In a sense, A is an agent for B."

Un token di delega si chiama a volte composite token, perché porta informazioni su due parti. Se il server ne emette uno dipende dalla sua policy e configurazione. Conta, perché chi chiede "token exchange" a un prodotto di solito ottiene l'impersonation. Nel mio laboratorio con Keycloak 26.8.2 il token scambiato manteneva l'utente come soggetto, nominava il server MCP solo come authorized party (`azp`) e [non aveva il claim act](https://iamops.dev/it/keycloak-token-exchange-rfc-8693/#insidie). Il supporto alla delega di Keycloak era una funzione in preview, spenta.

Per un agente, impersonation significa che l'API non sa se ha cliccato l'utente o se ha deciso l'agente. Entrambi hanno gli stessi diritti e la stessa riga di log. La delega è ciò che serve per l'audit e per policy come "gli agenti possono leggere le fatture ma non pagarle".

![Due riquadri confrontano ciò che vede un'API. A sinistra l'impersonation: il token nomina solo l'utente e l'agente è invisibile. A destra la delega: il token nomina l'utente come sub e l'agente nel claim act. Sotto: solo l'act più esterno è l'attore corrente.](https://iamops.dev/img/oauth-token-exchange-delegation-impersonation.it.svg)

*Stesso scambio, due risultati. Con l'impersonation l'API vede solo l'utente. Con la delega vede l'utente e l'agente che agisce, e può scrivere una policy per ciascuno.*

## Leggere il claim act

La delega si esprime con il claim `act`. Il suo valore è un oggetto che identifica l'attore, di solito con `sub` e a volte con `iss`. Una catena di deleghe annida un `act` dentro l'altro. Un esempio ridotto di ciò che potrebbe ricevere un'API di pagamenti dopo due passaggi:

```json
{
  "iss": "https://as.example.com",
  "aud": "https://payments.example.com",
  "sub": "user-4821",
  "scope": "invoices.read",
  "act": {
    "sub": "https://mcp.example.com",
    "act": { "sub": "https://agent.example.com" }
  }
}
```

Le regole della sezione 4.1 sono brevi e facili da sbagliare:

- L'`act` più esterno è l'**attore corrente**, qui il server MCP. Quello più annidato è il più vecchio.
- Gli attori precedenti "are informational only and are not to be considered in access control decisions."
- `act` in una risposta di introspection ha lo stesso significato che in un JWT.

Quindi una policy che dice "consenti se un attore qualsiasi della catena è l'agente fidato" è sbagliata secondo la specifica. Autorizza sull'attore corrente e sul soggetto. Registra tutta la catena, perché è la storia che chiederà chi analizza un incidente.

## may_act decide chi può diventare l'attore

Il claim `may_act` viaggia nel subject token e dice in anticipo chi può agire per il soggetto. L'authorization server può usarlo per decidere se il client, o la parte indicata in `actor_token`, può fare la delega o l'impersonation richiesta. Claim come `exp` e `aud` dentro `may_act` non hanno significato: serve solo a identificare una parte.

È utile perché sposta la decisione su chi ha emesso il token originale. Non garantisce però che il server lo controlli. Nel mio [laboratorio sul downscoping](https://iamops.dev/it/enforce-downscoping-token-exchange-a2a/#cosa-deve-controllare-anche-c) non sono riuscito a isolare se Keycloak confrontasse l'attore con `may_act`, quindi lo tratto come un'indicazione che il server può rispettare e verifico il rifiuto da solo.

## Restringere: audience, scope e durata

Le considerazioni di sicurezza di RFC 8693 sono un solo paragrafo. Suggerisce il claim `scope` e una durata limitata per contenere gli abusi dei diritti delegati. Il resto lo decide il server, e i server sono diversi:

- **Lo scope non segue ovunque il subject token.** Nel mio laboratorio A2A lo scope del token scambiato [seguiva gli scope del client che agiva](https://iamops.dev/it/enforce-downscoping-token-exchange-a2a/#lo-scambio-che-a-non-aveva-concesso), così l'agente B ha ricevuto un diritto di scrittura che A non aveva mai concesso. Una policy sul client lo ha risolto. Provalo nel tuo provider.
- **I refresh token non dovrebbero tornare.** Il mio laboratorio Keycloak ha rifiutato un refresh token in uno scambio standard. Un refresh token in mano a un agente trasforma un permesso di cinque minuti in uno permanente.
- **Durata breve.** Il token scambiato nella mia esecuzione durava 300 secondi.
- **Vincolo a una chiave.** Un token scambiato resta un bearer token se non è legato a una chiave. [DPoP](https://iamops.dev/it/dpop-par-rar-explained/#dpop-lega-il-token-a-una-chiave) è il modo abituale per legarlo.

## Dove compare oggi il token exchange

- **Server MCP.** La revisione 2026-07-28 della specifica MCP dice che i server "MUST only accept tokens that are valid for use with their own resources" e "MUST NOT accept or transit any other tokens". Un server MCP che ha bisogno di un'API a valle quindi scambia il token per ogni API. Il mio [laboratorio senza passthrough](https://iamops.dev/it/mcp-server-no-token-passthrough/#cosa-mostra-il-laboratorio) mostra il rifiuto quando non lo fa.
- **ID-JAG e Cross App Access.** Il client chiede al suo identity provider un Identity Assertion JWT con un token exchange il cui `requested_token_type` è `urn:ietf:params:oauth:token-type:id-jag`, poi lo presenta all'authorization server dell'altra applicazione. Il draft -06 è datato 31 ottobre 2026. La [spiegazione su ID-JAG](https://iamops.dev/it/id-jag-explained/#cosa-fa-un-id-jag) racconta il flusso in modo semplice.
- **Transaction token.** Il draft del WG OAuth (-11, 30 luglio 2026) usa il token exchange con il tipo `urn:ietf:params:oauth:token-type:txn_token` per trasformare un token esterno in un token di breve durata che viaggia dentro un solo dominio di fiducia. Le mie [note da IETF 127](https://iamops.dev/it/ietf-127-id-jag-workload-grants-transaction-tokens/#transaction-token-oltre-il-confine) coprono il lavoro più recente oltre il confine.
- **On-behalf-of di Microsoft Entra.** OBO risolve lo stesso problema con un altro grant: il livello intermedio chiama il token endpoint con il grant JWT bearer e `requested_token_use=on_behalf_of`. Non è una richiesta RFC 8693, e il risultato non conserva il client originale, come ha mostrato il mio [laboratorio OBO](https://iamops.dev/it/entra-on-behalf-of-agent-middle-tier/#indicazioni-di-sicurezza).
- **Altri provider.** Amazon Cognito e WorkOS Connect hanno aggiunto RFC 8693 a novembre 2026, come annotato nel mio [laboratorio Keycloak](https://iamops.dev/it/keycloak-token-exchange-rfc-8693/#cosa-mostra-il-laboratorio).

## Cosa controllo prima di fidarmi di un'implementazione

1. Quali client possono scambiare token, e se è un'impostazione per singolo client.
2. Se uno scambio verso un'audience a cui il client non ha diritto viene rifiutato.
3. Se lo scope del nuovo token è limitato dal subject token e non dal client che agisce.
4. Se può tornare un refresh token.
5. Se `act` compare, e se si può renderlo obbligatorio. Se no, prevedi di registrare tu l'unione di utente, agente e audience.
6. Cosa controlla l'API a valle: audience, attore corrente e scope per operazione.

## Cosa non ho verificato

Questo articolo si basa sulla RFC, sui draft citati e sui miei laboratori precedenti. Non ho eseguito un nuovo laboratorio, non ho provato la delega con `act` in nessun provider e non ho confrontato il comportamento di Cognito o WorkOS. Una spiegazione semplice del token exchange è nel backlog.

## Sources

- [RFC 8693: OAuth 2.0 Token Exchange (January 2020)](https://www.rfc-editor.org/rfc/rfc8693)
- [Model Context Protocol specification, revision 2026-07-28: Authorization](https://modelcontextprotocol.io/specification/2026-07-28/basic/authorization)
- [draft-ietf-oauth-identity-assertion-authz-grant-06 (31 October 2026)](https://datatracker.ietf.org/doc/draft-ietf-oauth-identity-assertion-authz-grant/)
- [draft-ietf-oauth-transaction-tokens-11 (30 July 2026)](https://datatracker.ietf.org/doc/draft-ietf-oauth-transaction-tokens/)
- [Microsoft identity platform: OAuth 2.0 On-Behalf-Of flow](https://learn.microsoft.com/en-us/entra/identity-platform/v2-oauth2-on-behalf-of-flow)
- [Keycloak documentation: Configuring and using token exchange](https://www.keycloak.org/securing-apps/token-exchange)

Discuss: [X](https://x.com/iamopsdev) | [LinkedIn](https://www.linkedin.com/company/iamops-dev/)
