Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
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
-
307 Temporary RedirectDall'endpoint del token - Le credenziali archiviate vengono mantenute dopo la disinstallazione dell'agente
- Il consenso di Microsoft Entra SSO non viene richiesto
- Mancata corrispondenza dell'ID app tra la configurazione di autenticazione e il plug-in
- L'URL di base nella configurazione di autenticazione non corrisponde al plug-in
- L'ID di riferimento nel manifesto del plug-in non è corretto o manca
- I criteri dell'organizzazione limitano l'accesso
- Il pulsante Accedi è inattivo o visualizza un errore generale
- Il popup di accesso non si apre
- Il popup di accesso si apre, ma si blocca o non si chiude mai
- Errore di credenziali non corrette
- URL di accesso non trovato
- Errore interno del server durante l'autenticazione
- Viene visualizzata una finestra di dialogo di consenso durante l'accesso
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
urlproprietà dell'oggetto delle specifiche del server MCP nel manifesto del plug-in per i plug-in MCP o a una voce nell'arrayserversnel documento OpenAPI per i plug-in API. - L'URI
https://teams.microsoft.com/api/platform/v1.0/oAuthRedirectdi reindirizzamento viene registrato come URI di reindirizzamento consentito o URL di callback di autorizzazione con il provider OAuth. - L'oggetto
reference_iddi 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.
Il consenso di Microsoft Entra SSO non viene richiesto
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/oAuthConsentRedirectviene 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 impostatewindow.opener = nullcome 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 cancellarlowindow.openerdurante i reindirizzamenti all'interno di un popup. -
Cross-Origin-Opener-Policyheader impostato susame-origin: Se una pagina della catena di reindirizzamento utilizza un'intestazione diCross-Origin-Opener-Policy: same-originrisposta, il browser interrompe definitivamente il riferimento durante lawindow.openernavigazione tra le origini. Assicurati che tutte le pagine della catena di reindirizzamento OAuth ometta l'intestazioneCross-Origin-Opener-Policy(che per impostazione predefinita èunsafe-none) o la imposti esplicitamente suunsafe-none. -
Collegamenti che utilizzano
rel="noopener": tag di ancoraggio conrel="noopener"strisciawindow.openerdalla pagina di destinazione. Non usarerel="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.
Viene visualizzata una finestra di dialogo di consenso durante l'accesso
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.