Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Conseil
Recommandé : Commencez avec les outils de développement Work IQ pour les scénarios de plug-in et d’agent déclaratif pro-code pris en charge. Voir le guide de démarrage rapide de WIQD. Les instructions basées sur la boîte à outils restent disponibles pour les projets existants et les flux de travail qui les nécessitent. Vérifiez la prise en charge de la capacité et de l’expérience cible avant de choisir un outil : WIQD ne cible pas les agents de moteur personnalisés.
L’authentification unique (SSO) de Microsoft Entra permet aux utilisateurs de s’authentifier avec leurs informations d’identification Microsoft Entra ID existantes. Cette intégration simplifie la gestion des accès et garantit des connexions sécurisées aux serveurs MCP (Model Context Protocol) ou aux API sans nécessiter d’informations d’identification supplémentaires. Votre serveur MCP ou API doit utiliser l’ID Entra pour contrôler l’accès.
Cet article utilise des plug-ins MCP comme procédure pas à pas par défaut. Les mêmes étapes s’appliquent aux plug-ins d’API créés à partir d’un document OpenAPI, sauf indication contraire.
Configurez l’authentification SSO Entra en quatre étapes : inscrivez une application Entra pour sécuriser votre serveur MCP, créez la configuration d’authentification, mettez à jour l’inscription de l’application Entra et ajoutez la nouvelle audience de jeton à votre API.
Étape 1 : Inscrire une application Entra pour sécuriser votre serveur MCP
Votre serveur MCP ou API doit être sécurisé par une inscription d’application Entra. Si vous n’en avez pas déjà un, inscrivez une application dans le centre d’administration Microsoft Entra. Notez l’ID client de l’application : vous le fournissez lorsque vous créez la configuration de l’authentification à l’étape 2.
Étape 2 : Créer la configuration de l’authentification SSO Entra
L’authentification SSO d’Entra repose sur une configuration d’authentification (Auth Config) : un enregistrement stocké dans le magasin de jetons Microsoft Enterprise que Microsoft 365 Copilot utilise pour obtenir des jetons pour votre plug-in MCP. Commencez par WIQD pour un projet pro-code pris en charge. Les procédures Toolkit, developer-skill et Teams developer portal restent disponibles en tant qu’alternatives.
Quelle que soit la façon dont vous la créez, la configuration d’authentification possède un ID de configuration d’authentification et un URI d’ID d’application. Vous utilisez l’URI d’ID d’application aux étapes 3 et 4.
Important
Quelle que soit la façon dont vous créez la configuration d’authentification, vous devez quand même suivre les étapes 3 et 4.
Utiliser les outils de développement Work IQ (recommandé)
Pour une action MCP, utilisez wiqd agent add action avec , --mcp-auth-type entra-ssoet --mcp-client-id définissez l’ID --mcp-server-urlclient de l’application Entra à l’étape 1. Pour une action OpenAPI, utilisez --openapi-auth-identity-provider microsoft-entra et --openapi-auth-client-id. Consultez les instructions de commande d’action WIQD pour connaître les autres options d’action requises.
Dans le cas d’un manifeste de plug-in existant, utilisez wiqd agent add auth avec --plugin-manifest, --auth-nameet --auth-type microsoft-entra. Fournissez les options de fournisseur d’identité documentées pour cette commande, y compris --oauth-client-id. Terminez le workflow d’approvisionnement du projet, obtenez l’URI d’ID d’application de la configuration d’authentification, puis passez aux étapes 3 et 4.
Utiliser le kit de ressources des agents Microsoft 365
Lorsque vous générez un agent avec un plug-in MCP dans Microsoft 365 Agents Toolkit, le kit de ressources vous invite à entrer un type d’authentification lorsque vous ajoutez le plug-in du serveur MCP. Sélectionnez Microsoft Entra SSO et indiquez l’ID client de l’application Entra à l’étape 1. Agents Toolkit crée la configuration d’authentification dans le magasin de jetons d’entreprise, génère l’ID de configuration d’authentification et met automatiquement à jour l’objet d’authentification d’exécution dans votre manifeste de plug-in.
Utiliser la compétence de développeur d’agent déclaratif
La compétence de développeur d’agent déclaratif (declarative-agent-developer) est une compétence d’agent dans Microsoft Work IQ qui regroupe les connaissances nécessaires à la création d’agents déclaratifs. Au lieu d’exécuter des commandes ou de modifier vous-même des manifestes, décrivez ce que vous voulez Copilot ou l’interface de ligne de commande GitHub en langage naturel. La compétence structure l’agent déclaratif, ajoute le plug-in MCP et gère la configuration de l’authentification pour vous. La compétence prend uniquement en charge les plug-ins MCP. Lorsque vous ajoutez un serveur MCP qui utilise l’authentification unique d’Entra, la compétence crée la configuration d’authentification dans le magasin de jetons d’entreprise et met à jour le manifeste du plug-in sans étape manuelle.
Conseil
Pour une vidéo de présentation de l’utilisation de la compétence de développeur d’agent déclaratif, consultez Créer des agents déclaratifs avec la compétence de développeur d’agent déclaratif.
Utiliser le portail de développement Teams
L’inscription au portail des développeurs Teams est facultative si vous utilisez Agents Toolkit ou la compétence de développeur d’agent déclaratif. Utilisez-le lorsque vous souhaitez créer la configuration d’authentification manuellement, ou - plus couramment - pour gérer une configuration d’authentification déjà créée par Agents Toolkit ou la compétence. Dans le portail, vous pouvez restreindre la configuration de l’authentification à une application Teams ou à une organisation Microsoft 365 spécifique et modifier d’autres propriétés.
Ouvrez le portail de développement Teams. Sélectionnez Outils ->Enregistrement de l’ID client SSO de Microsoft Entra.
Si vous n’avez pas d’inscriptions existantes, sélectionnez Enregistrer l’ID client. Si vous avez déjà des inscriptions, sélectionnez Nouvelle inscription de client.
Renseignez les champs suivants.
- Nom de l’enregistrement : un nom convivial pour votre enregistrement.
-
URL de base : URL de base de votre API. Cette valeur doit correspondre à l’URL dans la propriété de l’objet
urlde spécification du serveur MCP dans le manifeste du plugin pour les plugins basés sur MCP, ou à une entrée dans leserverstableau dans votre document OpenAPI pour les plugins API. - Restreindre l’utilisation par organisation : sélectionnez l’organisation Microsoft 365 qui a accès à votre application pour accéder aux points de terminaison d’API.
- Restreindre l’utilisation par application : sélectionnez une application Teams si vous ne connaissez pas votre ID d’application final. Après avoir publié votre application, liez cette inscription à votre ID d’application publiée.
- ID client : ID client de l’application inscrite dans Entra.
- Portée : les autorisations que votre plug-in demande à Entra. Comme avec OAuth 2.0, utilisez les valeurs d’étendue requises par votre application et votre API Entra.
Sélectionnez Enregistrer.
L’inscription crée la configuration d’authentification et génère un ID de configuration d’authentification (actuellement intitulé Microsoft Entra ID d’inscription à l’authentification unique dans le portail de développement Teams) et un URI d’ID d’application.
Ajouter l’ID de configuration de l’authentification au manifeste du plug-in
Lorsque vous créez la configuration d’authentification manuellement dans le portail de développement Teams, définissez la type propriété de l’objet d’authentification d’exécution sur OAuthPluginVault, et définissez sur l’ID de configuration d’authentificationreference_id. Agents Toolkit et la compétence de développeur d’agent déclaratif le font pour vous.
"auth": {
"type": "OAuthPluginVault",
"reference_id": "auth config ID"
},
Étape 3 : Mettre à jour l’inscription de l’application Entra
Quelle que soit la façon dont vous avez créé la configuration de l’authentification à l’étape 2, procédez comme suit.
Ouvrez le centre d’administration Microsoft Entra. Mettez à jour l’inscription d’application Entra qui sécurise votre serveur MCP ou API avec l’URI d’ID d’application de l’inscription SSO. Si vous avez un URI d’ID d’application existant mappé à l’inscription de l’application, utilisez l’éditeur de manifeste pour ajouter un autre URI dans la section identifierUris .
"identifierUris": [ "<<URI1>>", "<<URI2>>" ]Remarque
Vous ne pouvez pas ajouter plusieurs URI via l’interface utilisateur du centre d’administration Entra. L’interface utilisateur n’affiche que le premier URI de la liste. L’ajout de plusieurs URI n’affecte pas vos URI et étendues existants, même s’ils s’affichent différemment dans l’interface utilisateur.
Sélectionnez Authentification sous Gérer. Ajouter
https://teams.microsoft.com/api/platform/v1.0/oAuthConsentRedirectaux URI de redirection dans la plateforme web .Sélectionnez Exposer une API sous Gérer. Sélectionnez Ajouter une application cliente et ajoutez l’ID client du magasin de jetons Microsoft Enterprise,
ab3be6b7-f5df-413d-ac2d-abf1e3fd9c0b.
Étape 4 : Ajouter la nouvelle audience de jeton à votre API
Mettez à jour votre serveur MCP ou API pour autoriser le nouvel URI d’identificateur comme audience de jeton. Si votre serveur MCP ou API valide l’ID d’application cliente, assurez-vous que l’ID client du magasin de jetons Microsoft Enterprise (ab3be6b7-f5df-413d-ac2d-abf1e3fd9c0b) est ajouté en tant qu’application cliente autorisée.
Conseil
Si votre serveur MCP ou API utilise le flux pour le compte de pour accéder à une autre API web qui nécessite que l’utilisateur accorde son consentement, renvoyez une 401 Unauthorized erreur pour que l’agent invite l’utilisateur à se connecter pour accorder le consentement.