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’inscription dynamique du client (DCR) permet à un plug-in d’inscrire automatiquement un client OAuth auprès de votre fournisseur d’identité, sans vous obliger à créer manuellement un ID client et un secret à l’avance. Au lieu d’inscrire statiquement une application OAuth et de copier les informations d’identification dans une configuration d’authentification, le serveur d’autorisation émet des informations d’identification client à la demande conformément à RFC 7591.
DCR s’appuie sur le flux de code d’autorisation OAuth 2.0. Contrairement à OAuth statique, vous ne configurez pas vous-même un URI de redirection ou les informations d’identification du client : le magasin de jetons d’entreprise inscrit le client et gère ces détails en arrière-plan. Pour accéder aux concepts généraux d’OAuth, consultez Configurer l’authentification OAuth 2.0.
Remarque
- DCR est pris en charge pour les plug-ins MCP (Model Context Protocol).
- DCR sans clé secrète client n’est pas encore pris en charge. Le serveur d’autorisation doit émettre une clé secrète client lors de l’inscription.
- PKCE est activé par défaut pour DCR.
Avertissement
DCR n’est pas disponible pour un serveur MCP protégé par Microsoft Entra ID. Microsoft Entra ID ne publie pas de point de terminaison d’inscription RFC 7591, de sorte que le magasin de jetons d’entreprise n’a rien contre lequel inscrire un client. Pour un serveur protégé par Microsoft Entra ID, inscrivez le client OAuth de manière statique à la place. Pour plus d’informations, consultez Configurer l’authentification OAuth 2.0.
Configurez DCR en deux étapes : confirmez les prérequis et créez la configuration d’authentification DCR.
Étape 1 : confirmer les conditions préalables
- Votre serveur MCP expose les métadonnées de ressource protégées par OAuth 2.0 à son
.well-known/oauth-protected-resourcepoint de terminaison (RFC 9728), en identifiant le serveur d’autorisation qui le protège. - Le serveur d’autorisation publie ses métadonnées au point de
.well-known/oauth-authorization-serverterminaison (RFC 8414), y compris unregistration_endpoint, et prend en charge l’inscription client dynamique (RFC 7591) qui émet un secret client. Microsoft Entra ID ne publie pas ce point de terminaison, de sorte qu’un serveur MCP protégé par Microsoft Entra ID ne peut pas utiliser DCR.
Étape 2 : Créer la configuration de l’authentification DCR
L’authentification DCR repose sur une configuration d’authentification (configuration d’authentification) : un enregistrement stocké dans le magasin de jetons Microsoft Enterprise que Microsoft 365 Copilot utilise pour obtenir et actualiser les jetons pour votre plug-in MCP. Commencez par WIQD pour un projet pro-code pris en charge ; la boîte à outils et les procédures de compétences des développeurs restent disponibles en tant qu’alternatives.
Remarque
Le portail de développement Microsoft Teams ne prend pas encore en charge DCR. Utilisez le workflow d’action WIQD MCP ou l’une des alternatives automatisées ci-dessous.
Utiliser les outils de développement Work IQ (recommandé)
Utilisez-le wiqd agent add action avec le point de terminaison HTTPS du serveur et --mcp-server-url sélectionnez --mcp-auth-type oauth-dynamic. Votre serveur et votre fournisseur d’autorisation doivent respecter les exigences relatives aux métadonnées et à la clé secrète client à l’étape 1. DCR n’est pas disponible pour un serveur protégé par Microsoft Entra ID.
Suivez les instructions de commande d’action WIQD MCP et terminez le flux de travail d’approvisionnement du projet. La commande manifest existant wiqd agent add auth n’offre pas de type d’authentification DCR ; utilisez l’itinéraire d’action MCP pour ce schéma.
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 et que vous sélectionnez l’inscription de client dynamique comme type d’authentification, aucune autre entrée n’est requise. Agents Toolkit récupère les détails d’inscription à partir du point de terminaison bien connu de votre serveur MCP, inscrit automatiquement un nouveau client auprès du serveur d’autorisation, crée la configuration d’authentification dans le magasin de jetons d’entreprise et met à jour l’objet d’authentification d’exécution dans le manifeste de votre 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. Pour DCR, la compétence inscrit le client, 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.
Manifeste du plug-in
Cette section montre la configuration du manifeste de plug-in résultant pour référence. DCR utilise le même objet d’authentification d’exécution qu’OAuth 2.0 : la type propriété est définie sur OAuthPluginVault, et est reference_id définie sur l’ID de configuration d’authentification.
"auth": {
"type": "OAuthPluginVault",
"reference_id": "auth config ID"
},