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.
Tipp
Empfohlen: Beginnen Sie mit Work IQ Dev Tools für unterstützte Pro-Code-, deklarative Agent- und Plug-In-Szenarien. Siehe WIQD-Schnellstart. Toolkitbasierte Anweisungen bleiben für vorhandene Projekte und Workflows verfügbar, die sie erfordern. Überprüfen Sie die Unterstützung der Funktionen und der Zielerfahrung , bevor Sie ein Tool auswählen: WIQD ist nicht für benutzerdefinierte Engine-Agenten vorgesehen.
Deklarative Agents in Microsoft 365 Copilot stellen über API- oder MCP-Plug-Ins eine Verbindung mit Back-End-Diensten her. Diese Aktionsintegrationen verbinden den Agent mit einem MCP-Server (Model Context Protocol) oder einer API, die in einem OpenAPI-Dokument beschrieben wird. Konfigurieren Sie die Authentifizierung, damit Microsoft 365 Copilot die richtigen Anmeldeinformationen im Namen des angemeldeten Benutzers abrufen und senden kann.
Hinweis
In diesem Artikel wird die Authentifizierung in einem API- oder MCP-Plug-In-Manifest für einen deklarativen Agent konfiguriert. Das äußere installierbare Paket wird nicht konfiguriert. Siehe Plugins und deklarative Agentaktionen für die Manifestbeziehung.
In den exemplarischen Vorgehensweisen für die Authentifizierung wird ein MCP-Plug-In als Standardbeispiel verwendet. Das MCP-Plug-In ist die Integration des Agenten in den Remoteserver, nicht den Server selbst. Die gleichen Konfigurationsschritte gelten für API-Plug-Ins, die aus einem OpenAPI-Dokument erstellt wurden, sofern nicht in jedem Artikel angegeben.
Unterstützte Authentifizierungsschemas
Wählen Sie das Authentifizierungsschema aus, das der Art und Weise entspricht, wie Ihr MCP-Server oder Ihre API seine Endpunkte schützt:
| Authentifizierungsschema | MCP-Plugins | API-Plug-Ins | Artikel |
|---|---|---|---|
| Microsoft Entra einmaliges Anmelden (SSO) | Unterstützt | Unterstützt | Konfigurieren der Microsoft Entra SSO-Authentifizierung |
| Dynamische Clientregistrierung (DCR) | Unterstützt | Nicht unterstützt | Konfigurieren der dynamischen Clientregistrierung |
| OAuth 2.0 Autorisierungscodeflow | Unterstützt | Unterstützt | OAuth 2.0-Authentifizierung konfigurieren |
| API-Schlüssel | Nicht unterstützt | Unterstützt | API-Schlüssel-Authentifizierung konfigurieren |
| Keine Authentifizierung (anonym) | Unterstützt | Unterstützt | Keine Authentifizierung konfigurieren (anonym) |
Hinweis
Diese Tabelle behandelt MCP- und API-Plug-Ins, die als deklarative Agentaktionen verwendet werden. Ein Plug-In, das im agentConnectors Microsoft 365-App-Manifest auf einen Remote-MCP-Server verweist, verwendet eine andere Autorisierungskonfiguration. Dieses Schema umfasst ApiKeyPluginVault, während MCP-Plug-Ins, die als deklarative Agent-Aktionen verwendet werden, API-Schlüssel nicht unterstützen. Informationen zu Konfigurations- und Hostanforderungen finden Sie unter Konfigurieren von MCP-Remoteservern für Microsoft 365 Copilot-Plug-Ins.
Funktionsweise der Plug-In-Authentifizierung
Für Schemas, die Anmeldeinformationen erfordern, ist eine Authentifizierungskonfiguration (Authentifizierungskonfiguration) ein im Microsoft Enterprise-Tokenspeicher gespeicherter Eintrag, der die Anmeldeinformationen oder Clientdetails enthält, die für die Authentifizierung bei Ihrem MCP-Server oder Ihrer API erforderlich sind. Für anonymen Zugriff ist keine Authentifizierungskonfiguration erforderlich. Wählen Sie den unterstützten Konfigurationspfad für Ihr Projekt aus:
-
Work IQ Dev Tools (empfohlen) konfiguriert die Authentifizierung, wenn Sie eine OpenAPI- oder Remote-MCP-Aktion mit
wiqd agent add actionhinzufügen. Um einen unterstützten Authentifizierungstyp in einem vorhandenen Plug-In-Manifest zu konfigurieren, verwenden Siewiqd agent add auth. Befolgen Sie die unten stehenden schemaspezifischen WIQD-Anweisungen für die richtigen Optionen, und führen Sie dann den Bereitstellungsworkflow des Agents für Ihre Umgebung aus. - Das Microsoft 365 Agents Toolkit erstellt die Authentifizierungskonfiguration und aktualisiert Ihr Plug-In-Manifest automatisch, wenn Sie den Agent erstellen.
- Der Entwicklerskill "Deklarativer Agent" (nur MCP-Plug-Ins) erstellt die Authentifizierungskonfiguration und aktualisiert das Manifest für Sie über Anweisungen in natürlicher Sprache.
- Im Microsoft Teams-Entwicklerportal können Sie die Authentifizierungskonfiguration manuell erstellen oder ein von Agents, Toolkit oder den erstellten Skill verwalten.
Bei authentifizierten Schemata verweist Ihr Plug-In-Manifest anhand seiner ID im Laufzeitauthentifizierungsobjekt auf die Authentifizierungskonfiguration. Zur Laufzeit verwendet Microsoft 365 Copilot die Authentifizierungskonfiguration, um ein Token oder einen API-Schlüssel aus dem Tokenspeicher abzurufen, und fügt es ein, wenn das Plug-In Ihren MCP-Server oder Ihre API aufruft.
Beginnen Sie mit dem WIQD-Abschnitt für das ausgewählte Authentifizierungsschema. Dieselben Artikel enthalten Toolkit-, Entwickler-Skill-, Portal- und manuelle Alternativen, sofern unterstützt.
- Konfigurieren der Microsoft Entra SSO-Authentifizierung mit WIQD
- Konfigurieren der dynamischen Clientregistrierung mit WIQD
- Konfigurieren der OAuth 2.0-Authentifizierung mit WIQD
- Konfigurieren der API-Schlüssel-Authentifizierung mit WIQD
- Anonyme Authentifizierung mit WIQD konfigurieren
Hinweis
Folgen Sie für ein Plug-In-Paket, das Cowork mit einem Remote-MCP-Server verbindet, der Authentifizierung im App-Manifest. Schritte zur Registrierung freigegebener Anmeldeinformationen machen diese Konfiguration nicht austauschbar mit der MCP-Plug-In-Manifestkonfiguration eines Agents. Wenn Ihr OAuth-Anbieter die Microsoft Identity Platform verwendet und die Verbindung eine automatische Tokenaktualisierung benötigt, schließen Sie sie in das Feld Bereich der OAuth-Konfiguration mit allen API-spezifischen delegierten Bereichen einoffline_access.