Problembehandlung bei der MCP- und API-Plug-In-Authentifizierung

In diesem Artikel werden häufige Probleme und Fragen beim Konfigurieren der Authentifizierung für MCP (Model Context Protocol) und API-Plug-Ins in Agents behandelt, die in Microsoft 365 Copilot ausgeführt werden.

Um Authentifizierungsfehler in Agent-Antworten anzuzeigen, aktivieren Sie den Entwicklermodus. Viele der Fehler in diesem Artikel werden in der Debug-Informations-Karte angezeigt.

Benutzer können sich nicht anmelden oder Tokenaustausch schlägt fehl

Nicht übereinstimmende Werte zwischen Ihrem OAuth-Anbieter, Ihrer Authentifizierungskonfiguration und Ihrem Plug-In-Manifest sind die häufigste Ursache für Anmeldefehler. Überprüfen Sie die folgenden Werte:

  • Die Basis-URL in Ihrer Authentifizierungskonfiguration entspricht der url Eigenschaft des MCP-Serverspezifikationsobjekts im Plug-In-Manifest für MCP-Plug-Ins oder einem Eintrag im servers Array in Ihrem OpenAPI-Dokument für API-Plug-Ins.
  • Der Umleitungs-URI https://teams.microsoft.com/api/platform/v1.0/oAuthRedirect ist als zulässiger Umleitungs-URI oder Autorisierungsrückruf-URL bei Ihrem OAuth-Anbieter registriert.
  • Das reference_idAuthentifizierungsobjekt in der Laufzeit stimmt mit der Authentifizierungskonfigurations-ID überein, die vom Microsoft Teams-Entwicklerportal generiert wurde.
  • Die Einstellungen App-Einschränkung (Nutzung nach App einschränken) und Organisationseinschränkung (Nutzung nach Organisation einschränken) ermöglichen Ihrer Teams-App und Ihrem Mandanten.

307 Temporary Redirect vom Tokenendpunkt

OAuth 2.0-Server, die HTTP-Statuscodes von ihrem Token-Endpunkt zurückgeben307 Temporary Redirect, werden nicht unterstützt. Konfigurieren Sie Ihren Anbieter für die Verwendung eines direkten Tokenendpunkts.

Gespeicherte Anmeldeinformationen bleiben nach der Deinstallation des Agents erhalten

Benutzer können sich von einem Agent über die Chat-Einstellungen>Agents in Microsoft 365 Copilot abmelden. Bei OAuth 2.0 wird durch das Abmelden das gespeicherte Token gelöscht. Bei Microsoft Entra SSO kann das Token nicht direkt gelöscht werden und bleibt möglicherweise weiterhin bestehen, nachdem ein Agent aufgrund von SSO-Zwischenspeicherung, Mandanteneinstellungen oder Clientunterschieden deinstalliert wurde.

Um die erneute Authentifizierung für Entra SSO zu erzwingen, entfernen Sie die Zustimmung des Benutzers, oder widerrufen Sie seine Sitzungen mithilfe der Microsoft Graph-APIrevokeSignInSessions.

Wenn Ihr MCP-Server oder Ihre API den On-Behalf-of-Flow verwendet, um Zugriff auf eine andere Web-API zu erhalten, für die der Benutzer seine Zustimmung erteilen muss, geben Sie einen 401 Unauthorized Fehler zurück, damit der Agent den Benutzer auffordert, sich anzumelden, um die Zustimmung zu erteilen.

Bestätigen Sie außerdem, dass:

  • Die vom Teams-Entwicklerportal generierte Anwendungs-ID-URI wird dem Bezeichner Uris Ihrer Entra-App-Registrierung hinzugefügt.
  • https://teams.microsoft.com/api/platform/v1.0/oAuthConsentRedirect wird den Umleitungs-URIs in der Webplattform hinzugefügt.
  • Die Client-ID des Microsoft Enterprise-Tokenspeichers (ab3be6b7-f5df-413d-ac2d-abf1e3fd9c0b) wird als zulässige Clientanwendung unter "API verfügbar machen " und, wenn Sie die Client-App-ID überprüfen, als zulässige Tokenzielgruppe hinzugefügt.

App-ID-Konflikt zwischen Authentifizierungskonfiguration und Plug-In

Wenn auf der Debuginformations-Karte Fehler ähnlich dem folgenden angezeigt werden:

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

Wechseln Sie zum Teams-Entwicklerportal. Suchen Sie die Registrierung Ihres OAuth-Clients oder SSO-Clients (Single Sign-On), und stellen Sie sicher, dass die App-ID in Ihrem Plug-In mit der registrierten App-ID übereinstimmt.

Basis-URL in der Authentifizierungskonfiguration stimmt nicht mit dem Plugin überein

Wenn auf der Debuginformations-Karte Fehler ähnlich dem folgenden angezeigt werden:

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

Wechseln Sie zum Teams-Entwicklerportal. Suchen Sie die Registrierung Ihres OAuth-Clients oder SSO-Clients, und stellen Sie sicher, dass die MCP-Server-URL in Ihrem Plug-In mit der registrierten Basis-URL übereinstimmt.

Referenz-ID im Plug-In-Manifest ist falsch oder fehlt

Wenn auf der Debuginformations-Karte Fehler ähnlich dem folgenden angezeigt werden:

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

Wechseln Sie zum Teams-Entwicklerportal. Suchen Sie die Registrierung Ihres OAuth-Clients oder SSO-Clients, und überprüfen Sie, ob die ID in der Laufzeit auth.reference_id Ihres MCP-Servers mit der ID der Authentifizierungskonfiguration im Teams-Entwicklerportal übereinstimmt.

Organisationsrichtlinie schränkt Zugriff ein

Wenn auf der Debuginformations-Karte Fehler ähnlich dem folgenden angezeigt werden:

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

Wenden Sie sich an die Administratoren Ihrer organization, um den Zugriff für Ihre App zu überprüfen und zu aktivieren.

Die Schaltfläche "Anmelden" ist inaktiv oder zeigt einen allgemeinen Fehler an

Wenn Ihre Anmeldeschaltfläche inaktiv oder deaktiviert ist oder wenn Sie sie auswählen, wird der allgemeine Fehler "Anforderung kann nicht verarbeitet werden" angezeigt, was auf vorübergehende Authentifizierungs- oder Sitzungsprobleme hindeuten kann. Versuchen Sie die Abfrage erneut. Wenn das Problem weiterhin besteht, installieren Sie die App erneut, oder wenden Sie sich an die Administratoren Ihrer organization.

Anmelde-Popup kann nicht geöffnet werden

Aktivieren Sie Popups für die Website in den Einstellungen Ihres Browsers und versuchen Sie es erneut.

Das Popup-Fenster zum Anmelden wird geöffnet, bleibt aber hängen oder wird nie geschlossen

Wenn das Anmelde-Popup geöffnet wird und der Benutzer die Authentifizierung abschließt, das Popup jedoch nie geschlossen wird und Copilot das Authentifizierungsergebnis nicht erhält, wurde der Verweis des window.opener Popups wahrscheinlich während der OAuth-Umleitungskette zerstört. Ohne window.openerkann das Popup das Authentifizierungsergebnis nicht an Copilot zurücksenden. Ein häufiges Symptom ist, dass die Anmeldung beim ersten Mal fehlschlägt, aber beim erneuten Versuch erfolgreich ist, da zwischengespeicherte Anmeldeinformationen die Seite überspringen, die zerstört wurde window.opener.

Überprüfen Sie die folgenden Elemente in Ihrer OAuth-Umleitungskette.

  • JavaScript-Annullierung window.opener: Einige Anmeldeseiten wurden als pauschale Sicherheitsmaßnahme gegen Reverse Tabnabbing festgelegt window.opener = null . Wenn eine Seite in der Authentifizierungsumleitungskette diesen Code ausführt, verliert das Popup seine Verbindung zu Copilot. Beschränken Sie den Tabnabbing-Schutz nur auf die vom Benutzer initiierte Navigation, und werden Sie bei Umleitungen im Popup nicht gelöscht window.opener .
  • Cross-Origin-Opener-Policy Header festgelegt auf same-origin: Wenn eine Seite in der Umleitungskette einen Cross-Origin-Opener-Policy: same-origin Antwortheader bereitstellt, trennt der Browser den window.opener Verweis bei der ursprungsübergreifenden Navigation dauerhaft. Stellen Sie sicher, dass alle Seiten in Ihrer OAuth-Umleitungskette entweder den Cross-Origin-Opener-Policy Header weglassen (standardmäßig unsafe-none) oder explizit auf unsafe-nonefestlegen.
  • Links mit rel="noopener": Ankertags mit rel="noopener" Streifen window.opener von der Zielseite. Nicht für die Navigation im Authentifizierungs-Popup verwenden rel="noopener" .

Um dieses Problem zu debuggen, öffnen Sie die Entwicklertools Ihres Browsers im Popup-Fenster und geben window.opener Sie bei jedem Schritt der Umleitungskette die Konsole ein. Wenn window.opener die Rückgabe vor der endgültigen Umleitung erfolgt null , geben Sie an, welche Seite sie gelöscht hat. Sie können auch die Antwortkopfzeilen auf der Registerkarte "Netzwerk " auf Cross-Origin-Opener-Policy Werte auf jeder Seite in der Kette überprüfen.

Fehler "Falsche Anmeldeinformationen"

Wenn im Anmelde-Popup oder in der Chatantwort ein Fehler vom Typ "Falsche Anmeldeinformationen" angezeigt wird, stellen Sie sicher, dass Sie die richtigen Anmeldeinformationen eingeben. Wenn der Fehler weiterhin besteht, stellen Sie sicher, dass der Benutzer über die erforderlichen Berechtigungen verfügt.

Anmelde-URL wurde nicht gefunden

Deinstallieren und installieren Sie die App erneut, und versuchen Sie dann erneut, sich anzumelden.

Interner Serverfehler während der Authentifizierung

Überprüfen Sie die Details im Authentifizierungs-Popup, und wenden Sie sich bei Berechtigungsproblemen an die Administratoren Ihrer Organization.

Wenn ein Zustimmungsdialogfeld angezeigt wird, in dem Berechtigungen oder eine geschäftliche Begründung angefordert werden, überprüfen Sie die angeforderten Berechtigungen und geben Sie bei Bedarf eine geschäftliche Begründung an. Wenn Sie sich nicht sicher sind oder wenn das Zustimmungsdialogfeld Berechtigungen anfordert, die die Zustimmung des Administrators erfordern, wenden Sie sich an die Administratoren Ihrer organization.