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.
Die dynamische Clientregistrierung (Dynamic Client Registration, DCR) ermöglicht es einem Plug-In, einen OAuth-Client automatisch bei Ihrem Identitätsanbieter zu registrieren, ohne dass Sie im Voraus manuell eine Client-ID und ein Geheimnis erstellen müssen. Anstatt eine OAuth-App statisch zu registrieren und die Anmeldeinformationen in eine Authentifizierungskonfiguration zu kopieren, stellt der Autorisierungsserver Clientanmeldeinformationen auf Anfrage gemäß RFC 7591 aus.
DCR baut auf dem OAuth 2.0-Autorisierungscodeflow auf. Im Gegensatz zu statischem OAuth konfigurieren Sie keinen Umleitungs-URI oder Clientanmeldeinformationen selbst. Der Enterprise-Tokenspeicher registriert den Client und verarbeitet diese Details im Hintergrund. Allgemeine OAuth-Konzepte finden Sie unter Konfigurieren der OAuth 2.0-Authentifizierung.
Hinweis
- DCR wird für MCP-Plug-Ins (Model Context Protocol) unterstützt.
- DCR ohne geheimen Clientschlüssel wird noch nicht unterstützt. Der Autorisierungsserver muss während der Registrierung einen geheimen Clientschlüssel ausstellen.
- PKCE ist für DCR standardmäßig aktiviert.
Warnung
DCR ist für einen MCP-Server, der durch Microsoft Entra ID geschützt ist, nicht verfügbar. Microsoft Entra ID veröffentlicht keinen RFC 7591-Registrierungsendpunkt, daher gibt es nichts, wofür der Enterprise-Tokenspeicher einen Client registrieren könnte. Bei einem Server, der durch Microsoft Entra ID geschützt ist, registrieren Sie den OAuth-Client stattdessen statisch. Weitere Informationen finden Sie unter Konfigurieren der OAuth 2.0-Authentifizierung.
Konfigurieren Sie DCR in zwei Schritten: Bestätigen Sie die Voraussetzungen, und erstellen Sie die DCR-Authentifizierungskonfiguration.
Schritt 1: Voraussetzungen bestätigen
- Ihr MCP-Server macht OAuth 2.0-geschützte Ressourcenmetadaten an seinem
.well-known/oauth-protected-resourceEndpunkt verfügbar (RFC 9728) und identifiziert den Autorisierungsserver, der ihn schützt. - Der Autorisierungsserver veröffentlicht seine Metadaten am Endpunkt (RFC 8414), einschließlich eines
registration_endpointund unterstützt die dynamische Clientregistrierung (RFC 7591), die.well-known/oauth-authorization-servereinen geheimen Clientschlüssel ausgibt. Microsoft Entra ID veröffentlicht diesen Endpunkt nicht, sodass ein MCP-Server, der durch Microsoft Entra ID geschützt ist, DCR nicht verwenden kann.
Schritt 2: Erstellen der DCR-Authentifizierungskonfiguration
Die DCR-Authentifizierung basiert auf einer Authentifizierungskonfiguration (Authentifizierungskonfiguration) – einem im Microsoft Enterprise-Tokenspeicher gespeicherten Eintrag, den Microsoft 365 Copilot verwendet, um Token für Ihr MCP-Plug-In abzurufen und zu aktualisieren. Beginnen Sie mit WIQD für ein unterstütztes Pro-Code-Projekt. die Toolkit- und Entwickler-Skill-Verfahren stehen weiterhin als Alternativen zur Verfügung.
Hinweis
Das Microsoft Teams-Entwicklerportal unterstützt DCR noch nicht. Verwenden Sie den WIQD MCP-Aktionsworkflow oder eine der nachstehenden automatisierten Alternativen.
Verwenden der Work IQ-Entwicklungstools (empfohlen)
Verwenden Sie wiqd agent add action mit dem HTTPS-Endpunkt des Servers in --mcp-server-url und wählen Sie --mcp-auth-type oauth-dynamic. Ihr Server und Autorisierungsanbieter müssen die Anforderungen für Metadaten und geheime Clientschlüssel in Schritt 1 erfüllen. DCR ist für einen durch Microsoft Entra ID geschützten Server nicht verfügbar.
Befolgen Sie die Anleitung zum WIQD-MCP-Aktionsbefehl , und schließen Sie den Bereitstellungsworkflow des Projekts ab. Der Befehl existing-manifest wiqd agent add auth bietet keinen DCR-Authentifizierungstyp. Verwenden Sie die MCP-Aktionsroute für dieses Schema.
Verwenden des Microsoft 365 Agents Toolkit
Wenn Sie einen Agent mit einem MCP-Plug-In im Microsoft 365 Agents Toolkit erstellen und die dynamische Clientregistrierung als Authentifizierungstyp auswählen, sind keine weiteren Eingaben erforderlich. Agents Toolkit ruft die Registrierungsdetails vom bekannten Endpunkt Ihres MCP-Servers ab, registriert automatisch einen neuen Client beim Autorisierungsserver, erstellt die Authentifizierungskonfiguration im Enterprise-Tokenspeicher und aktualisiert das Laufzeitauthentifizierungsobjekt in Ihrem Plug-In-Manifest.
Verwenden des Entwicklerskills für deklarative Agents
Die Fähigkeitdeclarative-agent-developer "Entwickler für deklarative Agents" () ist eine Agent-Fähigkeit in Microsoft Work IQ , die das Wissen enthält, das zum Erstellen deklarativer Agenten erforderlich ist. Anstatt Befehle auszuführen oder Manifeste selbst zu bearbeiten, beschreiben Sie Copilot oder der GitHub-CLI in natürlicher Sprache, was Sie möchten. Der Skill erstellt ein Gerüst für den deklarativen Agent, fügt das MCP-Plug-In hinzu und übernimmt die Authentifizierungskonfiguration für Sie. Bei DCR registriert der Skill den Client, erstellt die Authentifizierungskonfiguration im Enterprise-Tokenspeicher und aktualisiert das Plug-In-Manifest ohne manuelle Schritte.
Tipp
Eine exemplarische Vorgehensweise zur Verwendung des Entwicklerskills für deklarative Agents finden Sie unter Erstellen deklarativer Agents mit dem Entwicklerskill für deklarative Agents.
Plug-In-Manifest
In diesem Abschnitt wird die resultierende Konfiguration des Plug-In-Manifests als Referenz angezeigt. DCR verwendet dasselbe Laufzeitauthentifizierungsobjekt wie OAuth 2.0: Die type Eigenschaft ist auf OAuthPluginVaultfestgelegt und das reference_id ist auf die Authentifizierungskonfigurations-ID festgelegt.
"auth": {
"type": "OAuthPluginVault",
"reference_id": "auth config ID"
},