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.
Les agents déclaratifs dans Microsoft 365 Copilot se connectent aux services principaux via des plug-ins API ou MCP. Ces intégrations d’action connectent l’agent à un serveur MCP (Model Context Protocol) ou à une API décrite dans un document OpenAPI. Configurez l’authentification afin que Microsoft 365 Copilot puisse obtenir et envoyer les informations d’identification appropriées au nom de l’utilisateur connecté.
Remarque
Cet article configure l’authentification dans un manifeste de plug-in d’API ou MCP pour un agent déclaratif. Il ne configure pas le package installable externe. Voir Plug-ins et actions d’agent déclaratif pour la relation de manifeste.
Les procédures d’authentification utilisent un plug-in MCP comme exemple par défaut. Le plug-in MCP est l’intégration de l’agent au serveur distant, et non au serveur lui-même. Les mêmes étapes de configuration s’appliquent aux plug-ins d’API créés à partir d’un document OpenAPI, sauf indication contraire dans chaque article.
Schémas d’authentification pris en charge
Choisissez le schéma d’authentification qui correspond à la façon dont votre serveur MCP ou votre API protège ses points de terminaison :
| Schéma d’authentification | Plug-ins MCP | Plug-ins API | Article |
|---|---|---|---|
| Authentification unique (SSO) Microsoft Entra | Pris en charge | Pris en charge | Configurer l’authentification SSO de Microsoft Entra |
| Inscription client dynamique (DCR) | Pris en charge | Non pris en charge | Configurer l’inscription du client dynamique |
| Flux de code d’autorisation OAuth 2.0 | Pris en charge | Pris en charge | Configurer l’authentification OAuth 2.0 |
| Clé API | Non pris en charge | Pris en charge | Configurer l’authentification par clé API |
| Aucune authentification (anonyme) | Pris en charge | Pris en charge | Ne configurer aucune authentification (anonyme) |
Remarque
Ce tableau couvre les plug-ins MCP et API utilisés comme actions d’agent déclaratif. Un plug-in qui fait référence à un serveur agentConnectors MCP distant dans le manifeste de l’application Microsoft 365 utilise une configuration d’autorisation différente. Ce schéma inclut ApiKeyPluginVault, tandis que les plug-ins MCP utilisés comme actions d’agent déclaratif ne prennent pas en charge les clés API. Pour connaître la configuration et la configuration requise pour l’hôte, consultez Configurer des serveurs MCP distants pour les plug-ins Microsoft 365 Copilot.
Fonctionnement de l’authentification par plug-in
Pour les schémas qui nécessitent des informations d’identification, une configuration d’authentification (auth config) est un enregistrement stocké dans le magasin de jetons Microsoft Enterprise qui contient les informations d’identification ou les détails client nécessaires pour s’authentifier auprès de votre serveur MCP ou API. L’accès anonyme ne nécessite pas de configuration d’authentification. Choisissez le chemin de configuration pris en charge pour votre projet :
-
Work IQ Dev Tools (recommandé) configure l’authentification lorsque vous ajoutez une action OpenAPI ou MCP distante avec
wiqd agent add action. Pour configurer un type d’authentification pris en charge dans un manifeste de plug-in existant, utilisezwiqd agent add auth. Suivez les instructions WIQD spécifiques au schéma ci-dessous pour connaître les options appropriées, puis complétez le workflow d’approvisionnement de l’agent pour votre environnement. - Microsoft 365 Agents Toolkit crée la configuration d’authentification et met à jour automatiquement le manifeste du plug-in à mesure que vous générez l’agent.
- La compétence de développeur d’agent déclaratif (plug-ins MCP uniquement) crée la configuration d’authentification et met à jour le manifeste pour vous à partir d’instructions en langage naturel.
- Le portail de développement Microsoft Teams vous permet de créer manuellement la configuration d’authentification, ou d’en gérer une qui est créée par Agents Toolkit ou la compétence.
Pour les schémas authentifiés, votre manifeste de plug-in référence la configuration d’authentification par son ID dans l’objet d’authentification d’exécution. Au moment de l’exécution, Microsoft 365 Copilot utilise la configuration d’authentification pour obtenir un jeton ou une clé API à partir du magasin de jetons et l’inclut lorsque le plug-in appelle votre serveur MCP ou votre API.
Commencez par la section WIQD du schéma d’authentification choisi. Les mêmes articles conservent les alternatives Toolkit, Developer-Skill, Portal et Manual lorsqu’elles sont prises en charge.
- Configurer l’authentification SSO Microsoft Entra avec WIQD
- Configurer l’inscription du client dynamique avec WIQD
- Configurer l’authentification OAuth 2.0 avec WIQD
- Configurer l’authentification par clé API avec WIQD
- Configurer l’authentification anonyme avec WIQD
Remarque
Pour un package de plug-in qui connecte Cowork à un serveur MCP distant, suivez l’authentification dans le manifeste de l’application. Les étapes d’inscription des informations d’identification partagées ne rendent pas cette configuration interchangeable avec la configuration du manifeste du plug-in MCP d’un agent. Si votre fournisseur OAuth utilise la plateforme d’identités Microsoft et que la connexion nécessite une actualisation automatique du jeton, incluez offline_access dans le champ Étendue de la configuration OAuth les étendues déléguées spécifiques à l’API.