Comprendere le connessioni OAuth
Distinguere l'accesso a una connessione MCP dall'autorizzazione dei relativi servizi upstream.
Tradotto automaticamente dall’inglese. Leggi l’originale in inglese
2 minuti di lettura · Guida per il cliente
OAuth è un modello di autenticazione supportato, ma ogni flusso di consenso deve essere configurato e testato per la destinazione esatta. Un test della chiave API riuscito non stabilisce la disponibilità OAuth per un particolare client AI.
Identificare le due relazioni di consenso#
Un client AI può autenticarsi su un'installazione o sul relativo gateway utilizzando un flusso di accesso proprietario supportato. Separatamente, un server potrebbe aver bisogno delle credenziali OAuth per chiamare un servizio upstream per conto di un account aziendale.
Questi non sono intercambiabili. Un broker OAuth upstream potrebbe necessitare dell'autorizzazione del provider e degli endpoint del token, dei dettagli e degli ambiti di registrazione del client. Non passare una connessione chiave API esistente a OAuth semplicemente perché il client offre un pulsante OAuth.
Seguire il flusso di connessione concordato#
Utilizza l'indirizzo esatto del server o del gateway nell'handoff. Quando si apre una schermata di consenso del browser, controlla il dominio, l'account e l'accesso richiesto. Autorizzare solo il pubblico e l'ambito previsti utilizzando la normale procedura del fornitore.
Non inviare un URL di richiamata contenente un codice di autorizzazione per supportarlo o incollarlo in una conversazione AI. Mantieni i token e i segreti client nel percorso di configurazione crittografato supportato.
Verificare dopo il consenso#
Conferma che il client AI ritorni allo stato connesso, scopra solo gli strumenti previsti e completi l'azione di sola lettura concordata nell'account corretto. Laddove l'aggiornamento fa parte del flusso configurato, verificalo anziché dare per scontato che la connessione iniziale durerà indefinitamente.
Quando il consenso fallisce#
Registrare la fase e l'errore redatto. Un indirizzo di reindirizzamento non corrispondente, un flusso di registrazione non supportato, un account errato, un ambito mancante o una concessione upstream scaduta possono richiedere correzioni diverse. Non disabilitare l'autenticazione, accettare un avviso di certificato o riutilizzare il token di un'altra persona come soluzione alternativa.