Che cos'è la propagazione dei token?
La propagazione dei token è il meccanismo che consente di trasmettere in modo sicuro un token di identità o di accesso (come OAuth o JWT) da un servizio o un'applicazione a un altro, in modo che i sistemi a valle possano agire per conto dell'utente o del cliente originale senza necessità di una nuova autenticazione. In ambito aziendale, questo meccanismo è comunemente utilizzato nelle applicazioni multilivello in cui un'applicazione front-end chiama più servizi back-end, ciascuno dei quali deve sapere "chi" è l'utente e quali azioni è autorizzato a compiere. Casi d'uso tipici includono il Single Sign-On (SSO) tra strumenti interni, l'orchestrazione di flussi di lavoro tra più API o microservizi preservando il contesto dell'utente, l'applicazione di un controllo degli accessi granulare nelle piattaforme dati e l'abilitazione di integrazioni B2B sicure in cui i sistemi dei partner chiamano servizi interni utilizzando autorizzazioni delegate.
SnapLogic MCP Server e OAuth2
SnapLogic MCP Server consente agli utenti di creare, configurare e gestire con facilità i server MCP per l'integrazione con sistemi agenti esterni. SnapLogic MCP Server supporta le politiche di autenticazione OAuth2 che consentono la propagazione dei token.
Esercitazioni pratiche
In questo esempio, esamineremo un server MCP con una pipeline MCP Server in cui il token JWT è disponibile nella pipeline sia in formato grezzo che con i campi risolti.
ⓘ Le configurazioni riportate nell'esempio riguardano esclusivamente la propagazione dei token e non influiscono sull'elaborazione vera e propria da parte del server MCP. Tuttavia, se vengono utilizzate, le attestazioni risolte devono esistere; in caso contrario, si verificherà un errore.
Componenti
- Server MCP con politica dei token JWT OAuth2 configurata
- Una pipeline del server MCP
1. Configurazione delle politiche
La politica JWT OAuth2 di MCP supporta la propagazione dei token in due ambiti:
- Propaga token grezzo – Questa operazione propaga il token grezzo ai parametri della pipeline.
- Intestazioni da aggiungere – Questa operazione estrae le informazioni contenute nel token JWT; i campi possono essere estratti tramite un'espressione, ad esempio:
$.sub, oppure le richieste nel loro complesso utilizzando$.
I campi saranno quindi disponibili nella pipeline se esistono i parametri di pipeline corrispondenti.
2. Configurazione della pipeline
Ora che la policy è stata configurata correttamente, dovremo aggiungere delle chiavi ai parametri della pipeline in modo che i valori possano essere passati alle chiavi dichiarate. Nella policy abbiamo abilitato Propagate raw token e altri due Headers to Add: user e claims, quindi abbiamo RAW_TOKEN, USER, e CLAIMS dichiarate nelle chiavi. Si noti che tutte le chiavi devono essere in maiuscolo se provengono dalle intestazioni.
⚠️ Le chiavi nei parametri devono esistere e corrispondere ai campi in maiuscolo nella politica. Inoltre, i campi nell'intestazione contenenti trattini - verranno sostituiti con trattini bassi _ nei parametri della pipeline.
I valori specificati nei parametri devono esistere e corrispondere ai campi in maiuscolo nella politica. Inoltre, i campi nell'intestazione contenenti trattini - verranno sostituiti con trattini bassi _ nei parametri della pipeline.
Queste sono le configurazioni necessarie per abilitare la propagazione dei token. Gli utenti possono ora implementare strategie personalizzate nella pipeline per un controllo più granulare sugli strumenti da rendere disponibili nella pipeline.
