Risoluzione dei problemi di autenticazione dei plug-in MCP e API

Questo articolo illustra i problemi e le domande comuni durante la configurazione dell'autenticazione per i plug-in MCP (Model Context Protocol) e API negli agenti in esecuzione in Microsoft 365 Copilot.

Per visualizzare gli errori di autenticazione nelle risposte dell'agente, abilitare la modalità sviluppatore. Molti degli errori in questo articolo vengono visualizzati nella scheda informazioni di debug.

Gli utenti non possono accedere o lo scambio di token non riesce

La causa più comune degli errori di accesso sono i valori non corrispondenti tra il provider OAuth, la configurazione di autenticazione e il manifesto del plug-in. Verificare i valori seguenti:

  • L'URL di base nella configurazione di autenticazione corrisponde alla url proprietà dell'oggetto delle specifiche del server MCP nel manifesto del plug-in per i plug-in MCP o a una voce nell'array servers nel documento OpenAPI per i plug-in API.
  • L'URI https://teams.microsoft.com/api/platform/v1.0/oAuthRedirect di reindirizzamento viene registrato come URI di reindirizzamento consentito o URL di callback di autorizzazione con il provider OAuth.
  • L'oggetto reference_id di autenticazione nel runtime corrisponde all'ID di configurazione dell'autenticazione generato dal portale per sviluppatori di Microsoft Teams.
  • Le impostazioni di restrizione dell'app (Limita l'utilizzo da parte dell'app) e della restrizione dell'organizzazione (Limita l'utilizzo da parte dell'organizzazione) consentono l'app e il tenant di Teams.

307 Temporary Redirect Dall'endpoint del token

I server OAuth 2.0 che restituiscono 307 Temporary Redirect codici di stato HTTP dall'endpoint token non sono supportati. Configurare il provider per l'utilizzo di un endpoint token diretto.

Le credenziali archiviate vengono mantenute dopo la disinstallazione dell'agente

Gli utenti possono disconnettersi da un agente dalle impostazioni> di ChatAgenti in Microsoft 365 Copilot. Per OAuth 2.0, la disconnessione cancella il token archiviato. Per Microsoft Entra SSO, il token non può essere cancellato direttamente e potrebbe continuare a persistere dopo la disinstallazione di un agente a causa della memorizzazione nella cache SSO, delle impostazioni del tenant o di differenze tra client.

Per forzare la riautenticazione per Entra SSO, rimuovere il consenso dell'utente o revocare le sessioni usando l'API Microsoft GraphrevokeSignInSessions.

Se il server o l'API MCP utilizza il flusso per conto di per ottenere l'accesso a un'altra API Web che richiede all'utente di concedere il consenso, restituisce un 401 Unauthorized errore per indurre l'agente a richiedere all'utente di accedere per concedere il consenso.

Confermare inoltre che:

  • L'URI ID applicazione generato dal portale per sviluppatori di Teams viene aggiunto agli URI identificatori della registrazione dell'app Entra.
  • https://teams.microsoft.com/api/platform/v1.0/oAuthConsentRedirect viene aggiunto agli URI di reindirizzamento nella piattaforma Web .
  • L'ID client dell'archivio token di Microsoft Enterprise (ab3be6b7-f5df-413d-ac2d-abf1e3fd9c0b) viene aggiunto come applicazione client consentita in Esponi un'API e, se si convalida l'ID dell'app client, come gruppo di destinatari di token consentiti.

Mancata corrispondenza dell'ID app tra la configurazione di autenticazione e il plug-in

Se nella scheda informazioni di debug vengono visualizzati errori simili a:

OAuth authentication failed: The App ID used in the request does not match the App ID in the authentication configuration. (HTTP 404)

Passare al portale per sviluppatori di Teams. Trovare la registrazione del client OAuth o del client Single Sign-On (SSO) e verificare che l'ID app nel plug-in corrisponda all'ID app registrato.

L'URL di base nella configurazione di autenticazione non corrisponde al plug-in

Se nella scheda informazioni di debug vengono visualizzati errori simili a:

OAuth authentication failed: The base URL in your authentication configuration does not match the server URL. (HTTP 401)

Passare al portale per sviluppatori di Teams. Individuare la registrazione del client OAuth o SSO e verificare che l'URL del server MCP nel plug-in corrisponda all'URL di base registrato.

L'ID di riferimento nel manifesto del plug-in non è corretto o manca

Se nella scheda informazioni di debug vengono visualizzati errori simili a:

OAuth authentication failed: No matching configuration found for referenceID in 'runtime.auth' section of the action manifest

Passare al portale per sviluppatori di Teams. Trovare la registrazione del client OAuth o SSO e verificare che l'ID nel runtime del server MCP corrisponda all'ID di configurazione dell'autenticazione auth.reference_id nel portale per sviluppatori di Teams.

I criteri dell'organizzazione limitano l'accesso

Se nella scheda informazioni di debug vengono visualizzati errori simili a:

OAuth authentication failed: Access is restricted by your organization's policy. (HTTP 404)

Contattare gli amministratori dell'organizzazione per verificare e abilitare l'accesso all'app.

Il pulsante Accedi è inattivo o visualizza un errore generale

Se il pulsante di accesso è inattivo o disabilitato oppure se la selezione restituisce un errore generale "Impossibile elaborare la richiesta", questa condizione potrebbe indicare problemi temporanei di autenticazione o di sessione. Ripetere la query. Se il problema persiste, reinstalla l'app o contatta gli amministratori della tua organizzazione.

Il popup di accesso non si apre

Abilita i popup per il sito nelle impostazioni del browser e riprova.

Il popup di accesso si apre, ma si blocca o non si chiude mai

Se il popup di accesso si apre e l'utente completa l'autenticazione, ma il popup non si chiude mai e Copilot non riceve il risultato dell'autenticazione, è probabile che il riferimento al popup venga distrutto durante la catena di window.opener reindirizzamento OAuth. Senza window.opener, il popup non può comunicare il risultato dell'autenticazione a Copilot. Un sintomo comune è che l'accesso non riesce la prima volta, ma ha esito positivo al nuovo tentativo, perché le credenziali memorizzate nella cache ignorano la pagina che è stata distrutta window.opener.

Controlla gli elementi seguenti nella catena di reindirizzamento OAuth.

  • Annullamento window.openerJavaScript : Alcune pagine di accesso impostate window.opener = null come misura di sicurezza generale contro il tabnabbing inverso. Se una pagina della catena di reindirizzamento di autenticazione esegue questo codice, il popup perde la connessione a Copilot. Applica l'ambito alle protezioni tabbing solo per la navigazione avviata dall'utente e non cancellarlo window.opener durante i reindirizzamenti all'interno di un popup.
  • Cross-Origin-Opener-Policy header impostato su same-origin: Se una pagina della catena di reindirizzamento utilizza un'intestazione di Cross-Origin-Opener-Policy: same-origin risposta, il browser interrompe definitivamente il riferimento durante la window.opener navigazione tra le origini. Assicurati che tutte le pagine della catena di reindirizzamento OAuth ometta l'intestazione Cross-Origin-Opener-Policy (che per impostazione predefinita è unsafe-none) o la imposti esplicitamente su unsafe-none.
  • Collegamenti che utilizzano rel="noopener": tag di ancoraggio con rel="noopener" striscia window.opener dalla pagina di destinazione. Non usare rel="noopener" per la navigazione all'interno del popup di autenticazione.

Per eseguire il debug del problema, aprire gli strumenti di sviluppo del browser nella finestra popup e digitare window.opener nella console ogni passaggio della catena di reindirizzamento. Se window.opener viene restituito null prima del reindirizzamento finale, identifica quale pagina lo ha cancellato. È anche possibile controllare le intestazioni delle risposte della scheda Rete per i Cross-Origin-Opener-Policy valori in ogni pagina della catena.

Errore di credenziali non corrette

Se viene visualizzato un errore "Credenziali non corrette" nel popup di accesso o nella risposta della chat, assicurarsi di immettere le credenziali corrette. Se l'errore persiste, assicurarsi che l'utente disponga delle autorizzazioni necessarie.

URL di accesso non trovato

Disinstalla e reinstalla l'app, quindi prova ad accedere.

Errore interno del server durante l'autenticazione

Controllare i dettagli nel popup di autenticazione e contattare gli amministratori dell'organizzazione per problemi di autorizzazione.

Se viene visualizzata una finestra di dialogo di consenso che richiede autorizzazioni o una giustificazione aziendale, esaminare le autorizzazioni richieste e, se necessario, fornire una motivazione aziendale. In caso di dubbi o se la finestra di dialogo di consenso richiede autorizzazioni che richiedono il consenso dell'amministratore, contatta gli amministratori della tua organizzazione.