Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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
-
307 Temporary Redirectvom Tokenendpunkt - Gespeicherte Anmeldeinformationen bleiben nach der Deinstallation des Agents erhalten
- Microsoft Entra SSO-Zustimmung wird nicht aufgefordert
- App-ID-Konflikt zwischen Authentifizierungskonfiguration und Plug-In
- Basis-URL in der Authentifizierungskonfiguration stimmt nicht mit dem Plugin überein
- Referenz-ID im Plug-In-Manifest ist falsch oder fehlt
- Organisationsrichtlinie schränkt Zugriff ein
- Die Schaltfläche "Anmelden" ist inaktiv oder zeigt einen allgemeinen Fehler an
- Anmelde-Popup kann nicht geöffnet werden
- Das Popup-Fenster zum Anmelden wird geöffnet, bleibt aber hängen oder wird nie geschlossen
- Fehler "Falsche Anmeldeinformationen"
- Anmelde-URL wurde nicht gefunden
- Interner Serverfehler während der Authentifizierung
- Während der Anmeldung wird das Dialogfeld "Zustimmung" 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
urlEigenschaft des MCP-Serverspezifikationsobjekts im Plug-In-Manifest für MCP-Plug-Ins oder einem Eintrag imserversArray in Ihrem OpenAPI-Dokument für API-Plug-Ins. - Der Umleitungs-URI
https://teams.microsoft.com/api/platform/v1.0/oAuthRedirectist 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.
Microsoft Entra SSO-Zustimmung wird nicht aufgefordert
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/oAuthConsentRedirectwird 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 festgelegtwindow.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öschtwindow.opener. -
Cross-Origin-Opener-PolicyHeader festgelegt aufsame-origin: Wenn eine Seite in der Umleitungskette einenCross-Origin-Opener-Policy: same-originAntwortheader bereitstellt, trennt der Browser denwindow.openerVerweis bei der ursprungsübergreifenden Navigation dauerhaft. Stellen Sie sicher, dass alle Seiten in Ihrer OAuth-Umleitungskette entweder denCross-Origin-Opener-PolicyHeader weglassen (standardmäßigunsafe-none) oder explizit aufunsafe-nonefestlegen. -
Links mit
rel="noopener": Ankertags mitrel="noopener"Streifenwindow.openervon der Zielseite. Nicht für die Navigation im Authentifizierungs-Popup verwendenrel="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.
Während der Anmeldung wird das Dialogfeld "Zustimmung" angezeigt
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.