Résoudre les problèmes d’authentification MCP et des plug-ins d’API

Cet article aborde les problèmes et questions courants lorsque vous configurez l’authentification pour le protocole MCP (Model Context Protocol) et les plug-ins d’API dans les agents exécutés dans Microsoft 365 Copilot.

Pour afficher les erreurs d’authentification dans les réponses de l’agent, activez le mode développeur. La plupart des erreurs de cet article apparaissent dans la carte d’informations de débogage.

Les utilisateurs ne peuvent pas se connecter ou l’échange de jetons échoue

Les valeurs discordantes entre votre fournisseur OAuth, votre configuration d’authentification et votre manifeste de plug-in sont la cause la plus fréquente d’échecs de connexion. Vérifiez les valeurs suivantes :

  • L’URL de base dans votre configuration d’authentification correspond à la url propriété de l’objet de spécification du serveur MCP dans le manifeste de plug-in pour les plug-ins MCP, ou à une entrée dans le servers tableau dans votre document OpenAPI pour les plug-ins d’API.
  • L’URI https://teams.microsoft.com/api/platform/v1.0/oAuthRedirect de redirection est inscrit en tant qu’URI de redirection autorisé ou URL de rappel d’autorisation auprès de votre fournisseur OAuth.
  • L’objet reference_idd’authentification au moment de l’exécution correspond à l’ID de configuration d’authentification généré par le portail de développement Microsoft Teams.
  • Les paramètres Restriction d’application (Restreindre l’utilisation par application) et Restriction de l’organisation (Restreindre l’utilisation par organisation) autorisent votre application Teams et votre locataire.

307 Temporary Redirect à partir du point de terminaison du jeton

Les serveurs OAuth 2.0 qui renvoient 307 Temporary Redirect des codes d’status HTTP à partir de leur point de terminaison de jeton ne sont pas pris en charge. Configurez votre fournisseur pour utiliser un point de terminaison de jeton direct.

Les informations d’identification stockées sont conservées après la désinstallation de l’agent

Les utilisateurs peuvent se déconnecter d’un agent à partir des paramètres> de ChatAgents dans Microsoft 365 Copilot. Pour OAuth 2.0, la déconnexion efface le jeton stocké. Pour l’authentification unique de Microsoft Entra, le jeton ne peut pas être effacé directement et peut continuer à être conservé après la désinstallation d’un agent en raison de la mise en cache SSO, des paramètres de locataire ou des différences entre les clients.

Pour forcer la réauthentification d’Entra SSO, supprimez le consentement de l’utilisateur ou révoquez ses sessions à l’aide de l’API Microsoft GraphrevokeSignInSessions.

Si votre serveur MCP ou API utilise le flux pour le compte de pour accéder à une autre API web qui nécessite que l’utilisateur accorde son consentement, renvoyez une 401 Unauthorized erreur pour que l’agent invite l’utilisateur à se connecter pour accorder le consentement.

Vérifiez également que :

  • L’URI d’ID d’application généré par le portail de développement Teams est ajouté aux identificateurs Uris de votre inscription d’application Entra.
  • https://teams.microsoft.com/api/platform/v1.0/oAuthConsentRedirect est ajouté aux URI de redirection dans la plateforme Web .
  • L’ID client du magasin de jetons Microsoft Enterprise (ab3be6b7-f5df-413d-ac2d-abf1e3fd9c0b) est ajouté en tant qu’application cliente autorisée sous Exposer une API et, si vous validez l’ID d’application cliente, en tant qu’audience de jeton autorisée.

Incompatibilité d’ID d’application entre la configuration d’authentification et le plug-in

Si vous voyez des erreurs dans votre carte d’informations de débogage similaires à :

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

Accédez au portail des développeurs Teams. Recherchez votre inscription de client OAuth ou d’authentification unique (SSO) et vérifiez que l’ID d’application dans votre plug-in correspond à l’ID d’application inscrit.

L’URL de base dans la configuration de l’authentification ne correspond pas au plug-in

Si vous voyez des erreurs dans votre carte d’informations de débogage similaires à :

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

Accédez au portail des développeurs Teams. Recherchez votre inscription de client OAuth ou de client SSO et vérifiez que l’URL du serveur MCP dans votre plug-in correspond à l’URL de base inscrite.

L’ID de référence dans le manifeste du plug-in est incorrect ou manquant

Si vous voyez des erreurs dans votre carte d’informations de débogage similaires à :

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

Accédez au portail des développeurs Teams. Recherchez votre inscription de client OAuth ou de client SSO et vérifiez que l’ID dans le runtime de votre serveur MCP correspond à l’ID auth.reference_id de configuration de l’authentification dans le portail de développement Teams.

La stratégie de l’organisation restreint l’accès

Si vous voyez des erreurs dans votre carte d’informations de débogage similaires à :

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

Contactez les administrateurs de votre organisation pour examiner et activer l’accès à votre application.

Le bouton de connexion est inactif ou affiche une erreur générale

Si votre bouton de connexion est inactif ou désactivé, ou si le fait de le sélectionner affiche une erreur générale « La demande ne peut pas être traitée », cette condition peut indiquer des problèmes temporaires d’authentification ou de session. Réessayez la requête. Si le problème persiste, réinstallez l’application ou contactez les administrateurs de votre organisation.

Échec de l’ouverture de la fenêtre contextuelle de connexion

Activez les fenêtres contextuelles pour le site dans les paramètres de votre navigateur et réessayez.

La fenêtre contextuelle de connexion s’ouvre, mais reste bloquée ou ne se ferme jamais

Si la fenêtre contextuelle de connexion s’ouvre et que l’utilisateur termine l’authentification, mais que la fenêtre contextuelle ne se ferme jamais et que Copilot ne reçoit pas le résultat de l’authentification, la référence de la fenêtre contextuelle a probablement été détruite window.opener pendant la chaîne de redirection OAuth. Sans window.opener, la fenêtre contextuelle ne peut pas communiquer le résultat de l’authentification à Copilot. Un symptôme courant est que la connexion échoue la première fois, mais réussit lors de la nouvelle tentative, car les informations d’identification mises en cache ignorent la page qui a détruit window.opener.

Vérifiez les éléments suivants dans votre chaîne de redirection OAuth.

  • JavaScript nullifying window.opener: Certaines pages de connexion sont définies window.opener = null comme une mesure de sécurité générale contre le tabnabbing inversé. Si une page de la chaîne de redirection d’authentification exécute ce code, la fenêtre contextuelle perd sa connexion à Copilot. Les protections par tabulation s’appliquent uniquement à la navigation initiée par l’utilisateur et ne les effacent window.opener pas lors des redirections dans les fenêtres contextuelles.
  • Cross-Origin-Opener-Policy défini sur same-origin: Si une page de la chaîne de redirection sert un Cross-Origin-Opener-Policy: same-origin en-tête de réponse, le navigateur coupe définitivement la référence sur la window.opener navigation cross-origin. Assurez-vous que toutes les pages de votre chaîne de redirection OAuth omettent l’en-tête Cross-Origin-Opener-Policy (qui est défini par défaut sur unsafe-none) ou le définissent explicitement sur unsafe-none.
  • Liens utilisant rel="noopener": Ancrer les tags avec rel="noopener" bande window.opener de la page cible. Ne l’utilisez rel="noopener" pas pour naviguer dans la fenêtre contextuelle d’authentification.

Pour déboguer ce problème, ouvrez les outils de développement de votre navigateur dans la fenêtre contextuelle et tapez window.opener dans la console à chaque étape de la chaîne de redirection. Si revient window.openernull avant la redirection finale, identifiez la page qui l’a effacée. Vous pouvez également case activée les en-têtes de réponse de l’onglet Réseau pour Cross-Origin-Opener-Policy les valeurs de chaque page de la chaîne.

Erreur d’informations d’identification incorrectes

Si vous voyez une erreur « Informations d’identification incorrectes » dans la fenêtre contextuelle de connexion ou la réponse à la conversation, vérifiez que vous entrez les informations d’identification correctes. Si l’erreur persiste, assurez-vous que l’utilisateur dispose des autorisations requises.

URL de connexion introuvable

Désinstallez puis réinstallez l’application, puis essayez de vous connecter à nouveau.

Erreur de serveur interne lors de l’authentification

Vérifiez les détails dans la fenêtre contextuelle d’authentification et contactez les administrateurs de votre organisation pour les problèmes d’autorisations.

Si une boîte de dialogue de consentement s’affiche pour demander des autorisations ou une justification métier, examinez les autorisations demandées et fournissez une justification professionnelle si nécessaire. Si vous n’êtes pas sûr ou si la boîte de dialogue de consentement demande des autorisations qui nécessitent un consentement administrateur, contactez les administrateurs de votre organisation.