Konfigurieren der Microsoft Entra SSO-Authentifizierung

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.

Mit der einmaligen Anmeldung (Single Sign-On, SSO) von Microsoft Entra können sich Benutzer mit ihren vorhandenen Microsoft Entra ID-Anmeldeinformationen authentifizieren. Diese Integration vereinfacht die Zugriffsverwaltung und gewährleistet sichere Verbindungen mit MCP-Servern (Model Context Protocol) oder APIs, ohne dass zusätzliche Anmeldeinformationen erforderlich sind. Ihr MCP-Server oder Ihre API muss die Entra-ID verwenden, um den Zugriff zu steuern.

In diesem Artikel werden MCP-Plug-Ins als Standardexemplarische Vorgehensweise verwendet. Die gleichen Schritte gelten für API-Plug-Ins, die aus einem OpenAPI-Dokument erstellt wurden, sofern nicht anders angegeben.

Konfigurieren Sie die Entra SSO-Authentifizierung in vier Schritten: Registrieren Sie eine Entra-App, um Ihren MCP-Server zu sichern, erstellen Sie die Authentifizierungskonfiguration, aktualisieren Sie die Entra-App-Registrierung und fügen Sie die neue Token-Zielgruppe zu Ihrer API hinzu.

Schritt 1: Registrieren einer Entra-App zum Sichern Ihres MCP-Servers

Ihr MCP-Server oder Ihre API muss durch eine Entra-App-Registrierung geschützt sein. Wenn Sie noch keine haben, registrieren Sie eine App im Microsoft Entra Admin Center. Notieren Sie sich die Client-ID der App. Sie geben sie an, wenn Sie die Authentifizierungskonfiguration in Schritt 2 erstellen.

Schritt 2: Erstellen der Entra SSO-Authentifizierungskonfiguration

Die Entra SSO-Authentifizierung basiert auf einer Authentifizierungskonfiguration (Authentifizierungskonfiguration) – einem Eintrag, der im Microsoft Enterprise-Tokenspeicher gespeichert ist, den Microsoft 365 Copilot verwendet, um Token für Ihr MCP-Plug-In abzurufen. Beginnen Sie mit WIQD für ein unterstütztes Pro-Code-Projekt. Die Verfahren Toolkit, Developer-Skill und Teams Developer Portal stehen weiterhin als Alternativen zur Verfügung.

Wie auch immer Sie sie erstellen, die Authentifizierungskonfiguration verfügt über eine Authentifizierungskonfigurations-ID und eine Anwendungs-ID-URI. Sie verwenden die Anwendungs-ID-URI in Schritt 3 und Schritt 4.

Wichtig

Unabhängig davon, wie Sie die Authentifizierungskonfiguration erstellen, müssen Sie trotzdem die Schritte 3 und 4 ausführen.

Verwenden Sie wiqd agent add action für eine MCP-Aktion mit --mcp-server-url, --mcp-auth-type entra-ssound --mcp-client-id legen Sie sie auf die Client-ID der Entra-App aus Schritt 1 fest. For an OpenAPI action, use --openapi-auth-identity-provider microsoft-entra and --openapi-auth-client-id. Weitere erforderliche Aktionsoptionen finden Sie in der Anleitung zum WIQD-Aktionsbefehl .

Verwenden Sie wiqd agent add auth für ein vorhandenes Plug-In-Manifest mit --plugin-manifest, --auth-nameund --auth-type microsoft-entra. Geben Sie die für diesen Befehl dokumentierten Identitätsanbieteroptionen an, einschließlich --oauth-client-id. Schließen Sie den Bereitstellungsworkflow des Projekts ab, rufen Sie den Anwendungs-ID-URI der Authentifizierungskonfiguration ab, und fahren Sie mit Schritt 3 und Schritt 4 fort.

Verwenden des Microsoft 365 Agents Toolkit

Wenn Sie einen Agent mit einem MCP-Plug-In im Microsoft 365 Agents Toolkit erstellen, werden Sie vom Toolkit zur Eingabe eines Authentifizierungstyps aufgefordert, wenn Sie das MCP-Server-Plug-In hinzufügen. Wählen Sie Microsoft Entra SSO aus, und geben Sie die Client-ID der Entra-App aus Schritt 1 an. Agents Toolkit erstellt die Authentifizierungskonfiguration im Enterprise-Tokenspeicher, generiert die Authentifizierungskonfigurations-ID und aktualisiert das Laufzeitauthentifizierungsobjekt in Ihrem Plug-In-Manifest automatisch.

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. Der Skill unterstützt nur MCP-Plug-Ins. Wenn Sie einen MCP-Server hinzufügen, der Entra SSO verwendet, erstellt der Skill 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.

Verwenden des Teams-Entwicklerportals

Die Registrierung im Teams-Entwicklerportal ist optional, wenn Sie das Agents-Toolkit oder den deklarativen Agent-Entwicklerskill verwenden. Verwenden Sie es, wenn Sie die Authentifizierungskonfiguration manuell erstellen möchten, oder - häufiger - um eine Authentifizierungskonfiguration zu verwalten, die Agents Toolkit oder der bereits erstellte Skill enthält. Im Portal können Sie die Authentifizierungskonfiguration auf eine bestimmte Teams-App oder Microsoft 365-organization beschränken und andere Eigenschaften ändern.

  1. Öffnen Sie das Teams-Entwicklerportal. Wählen Sie Extras ->Registrierung der Client-ID von Microsoft Entra SSO aus.

  2. Wenn noch keine Registrierungen vorhanden sind, wählen Sie Client-ID registrieren aus. Wenn Sie bereits registriert sind, wählen Sie Neue Clientregistrierung aus.

  3. Füllen Sie die folgenden Felder aus.

    • Registrierungsname: Ein Anzeigename für Ihre Registrierung.
    • Basis-URL: Die Basis-URL Ihrer API. Dieser Wert sollte der URL in der url Eigenschaft des MCP-Serverspezifikationsobjekts im Plug-In-Manifest für MCP-basierte Plug-Ins oder einem Eintrag im servers Array in Ihrem OpenAPI-Dokument für API-Plug-Ins entsprechen.
    • Einschränken der Nutzung nach Organisation: Wählen Sie aus, welche Microsoft 365-organization Zugriff auf Ihre App hat, um auf API-Endpunkte zuzugreifen.
    • Einschränken der Nutzung nach App: Wählen Sie eine beliebige Teams-App aus, wenn Sie Ihre endgültige App-ID nicht kennen. Nachdem Sie Ihre App veröffentlicht haben, binden Sie diese Registrierung an Ihre veröffentlichte App-ID.
    • Client-ID: Die Client-ID der in Entra registrierten App.
    • Umfang: Die Berechtigungen, die Ihr Plugin von Entra anfordert. Verwenden Sie wie bei OAuth 2.0 die Bereichswerte, die von Ihrer Entra-App und -API benötigt werden.
  4. Wählen Sie Speichern aus.

  5. Nach Abschluss der Registrierung wird die Authentifizierungskonfiguration erstellt und eine Authentifizierungskonfigurations-ID (derzeit als Microsoft Entra SSO-Registrierungs-ID im Teams-Entwicklerportal bezeichnet) und ein Anwendungs-ID-URI generiert.

Hinzufügen der Auth-Konfigurations-ID zum Plug-In-Manifest

Wenn Sie die Authentifizierungskonfiguration manuell im Teams-Entwicklerportal erstellen, legen Sie die type Eigenschaft des Laufzeitauthentifizierungsobjekts auf OAuthPluginVaultund legen Sie die reference_id auf die Authentifizierungskonfigurations-ID fest. Das Agents-Toolkit und der deklarative Agent-Entwicklerskill erledigen dies für Sie.

"auth": {
  "type": "OAuthPluginVault",
  "reference_id": "auth config ID"
},

Schritt 3: Aktualisieren der Entra-App-Registrierung

Führen Sie die folgenden Schritte aus, unabhängig davon, wie Sie die Authentifizierungskonfiguration in Schritt 2 erstellt haben.

  1. Öffnen Sie das Microsoft Entra Admin Center. Aktualisieren Sie die Entra-App-Registrierung, die Ihren MCP-Server oder Ihre API mit dem Anwendungs-ID-URI aus der SSO-Registrierung sichert. Wenn Sie eine vorhandene Anwendungs-ID-URI haben, die der App-Registrierung zugeordnet ist, verwenden Sie den Manifest-Editor, um eine weitere URI im Abschnitt identifierUris hinzuzufügen.

    "identifierUris": [
      "<<URI1>>",
      "<<URI2>>"
    ]
    

    Hinweis

    Sie können nicht mehrere URIs über die Benutzeroberfläche des Entra Admin Centers hinzufügen. Die Benutzeroberfläche zeigt nur den ersten URI in der Liste an. Das Hinzufügen mehrerer URIs wirkt sich nicht auf Ihre vorhandenen URIs und Bereiche aus, auch wenn sie auf der Benutzeroberfläche unterschiedlich angezeigt werden.

  2. Wählen Sie Authentifizierung unter Verwalten aus. Fügen Sie sie zu den Umleitungs-URIs in der Webplattform hinzuhttps://teams.microsoft.com/api/platform/v1.0/oAuthConsentRedirect.

  3. Wählen Sie unter Verwaltendie Option API verfügbar machen. Wählen Sie Clientanwendung hinzufügen aus, und fügen Sie die Client-ID des Microsoft Enterprise-Tokenspeichers hinzu. ab3be6b7-f5df-413d-ac2d-abf1e3fd9c0b

Schritt 4: Hinzufügen der neuen Token-Zielgruppe zu Ihrer API

Aktualisieren Sie Ihren MCP-Server oder Ihre API, um den neuen Bezeichner-URI als Tokenzielgruppe zuzulassen. Wenn Ihr MCP-Server oder Ihre API die Clientanwendungs-ID überprüft, stellen Sie sicher, dass die Client-ID des Microsoft Enterprise-Tokenspeichers (ab3be6b7-f5df-413d-ac2d-abf1e3fd9c0b) als zulässige Clientanwendung hinzugefügt wurde.

Tipp

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.