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.
Les documents de métadonnées d’ID client (CIMD) permettent à un client OAuth de s’identifier à l’aide d’une URL HTTPS au lieu d’un ID client préattribué. Le document situé à cette URL contient les métadonnées OAuth du client. Microsoft Entra ID récupère et valide le document, représente le client en tant qu’identité d’agent au sein du locataire et émet des jetons conformément aux stratégies de consentement et de sécurité existantes du locataire.
Important
La prise en charge des documents de métadonnées d’ID client dans Microsoft Entra ID est en préversion publique. Cette version préliminaire est fournie sans contrat de niveau de service et n’est pas recommandée pour les environnements de production. Certaines fonctionnalités peuvent ne pas être prises en charge ou avoir des fonctionnalités limitées. Pour plus d’informations, consultez Conditions du contrat de licence universel pour les services en ligne.
CIMD est utile lorsqu’un client doit se connecter à de nombreux serveurs d’autorisation avec lesquels il n’a aucune relation antérieure. Par exemple, un client MCP peut découvrir à l’exécution des serveurs distants Model Context Protocol (MCP), et chaque serveur peut utiliser un serveur d’autorisation différent. L’inscription de chaque client auprès de chaque serveur d’autorisation ne passe pas à l’échelle.
CIMD est défini par la spécification du document de métadonnées d’ID client OAuth. La spécification d’autorisation MCP recommande CIMD pour les clients qui n’ont pas d’autre mécanisme d’inscription pris en charge.
Fonctionnement de CIMD avec Microsoft Entra ID
Un flux d’autorisation CIMD classique comporte les étapes suivantes :
- Un client MCP découvre qu’un serveur MCP utilise Microsoft Entra ID comme serveur d’autorisation.
- Le client lit les métadonnées du serveur d’autorisation et détermine que CIMD est pris en charge.
- Le client envoie une demande d’autorisation. Son
client_idest l’URL HTTPS de son document de métadonnées. - Microsoft Entra ID récupère le document et valide son contenu, y compris une correspondance exacte entre le document demandé
client_idet le documentclient_id. - Microsoft Entra ID dérive un ID d’application stable à partir de l’URL canonique du document et recherche une identité d’agent correspondante dans le locataire.
- Si l’identité n’existe pas, la stratégie de locataire détermine si elle peut être créée par le biais du consentement. Un administrateur peut à la place ajouter le client CIMD à l’avance.
- Microsoft Entra ID valide l’URI de redirection et les autorisations demandés, obtient tout consentement requis et émet un jeton d’accès restreint à l’audience.
- Le client présente le jeton au serveur MCP.
L’URL CIMD est l’identité durable du client. Le déplacement du document vers une autre URL crée une identité différente et ne conserve pas les autorisations accordées à l’ancienne identité.
Comment Microsoft Entra représente un client CIMD
Microsoft Entra ID représente un client CIMD en tant qu’identité d’agent dans chaque tenant où le client est approuvé.
Une identité d’agent prise en charge par CIMD :
- Possède un ID d’application dérivé de l’URL CIMD canonique.
- Stocke l’URL CIMD en tant qu’identificateur immuable.
- Possède un modèle d’identité d’agent en lecture seule dans chaque locataire et aucun principal de service de modèle.
- Utilise le document de métadonnées externes comme source de vérité pour sa configuration OAuth.
- Apparaît dans l’inventaire des identités de l’agent, les journaux d’audit et les journaux de connexion.
Étant donné que les métadonnées restent dans le document externe, les fonctionnalités qui inspectent la configuration OAuth stockée sur un objet d’application Entra peuvent ne pas évaluer un client CIMD. Passez en revue les considérations de gouvernance avant d’adopter CIMD.
Quand utiliser CIMD
Les implémenteurs doivent toujours préférer la préinscription d’un client avec Entra si possible. Pour les intégrations à volume élevé ou stratégique, un ID client inscrit classique fournit l’identité la plus stable et les fonctionnalités Entra les plus étendues. CIMD ne doit être utilisé que lorsque toutes les conditions suivantes s’appliquent :
- Le client doit se connecter à de nombreux serveurs d’autorisation gérés indépendamment.
- Les serveurs d’autorisation ne peuvent pas préinscrire raisonnablement le client.
- Le client utilise un flux OAuth délégué avec présence de l’utilisateur.
- Le client peut publier des métadonnées stables sur une URL HTTPS publique.
- Le client accepte les limitations décrites dans cet article.
Un client MCP qui découvre de nombreux serveurs distants au moment de l’exécution est le scénario principal.
Fonctionnalités prises en charge et limitations
Le tableau suivant récapitule les fonctionnalités et limitations des identités d’agent adossées à CIMD.
| Capability | Prise en charge de CIMD |
|---|---|
| Flux de code d’autorisation OAuth avec un utilisateur connecté | Supported |
| Jetons d’actualisation | Supported |
| Clé de preuve pour le code Exchange (PKCE) | Supported |
| Flux des informations d’identification du client | Non pris en charge |
| Flux de code de périphérique | Supported |
| Agissant comme ressource OAuth ou destinataire du jeton | Non pris en charge |
| Jetons d’ID ou jetons SAML pour la connexion utilisateur | Non pris en charge |
| Secrets clients partagés | Non pris en charge |
| vérification Publisher ou certification Microsoft 365 | Non pris en charge |
| Plusieurs identités d’agent partageant un blueprint | Non pris en charge |
| Comptes d’utilisateur de l’agent | Non pris en charge |
| Windows Gestionnaire de comptes web (WAM) | Non pris en charge |
| Conversion sur place vers ou à partir d’un ID client classique | Non pris en charge |
Modèle de sécurité
CIMD prouve qu’un client contrôle une URL. Il ne prouve pas que le client est fiable ou doit recevoir l’accès aux données organisationnelles.
Microsoft Entra ID applique les protections suivantes :
- Identificateurs HTTPS uniquement : Un ID client CIMD doit être une URL HTTPS avec un chemin d’accès. Les informations utilisateur et les fragments ne sont pas autorisés dans l’URL.
-
Correspondance exacte de l’identité : Le
client_iddans le document doit correspondre exactement à l’URL utilisée comme ID client. - Correspondance de redirection exacte : L’URI de redirection dans une demande d’autorisation doit correspondre exactement à un URI dans le document.
- Application de la stratégie de consentement : La stratégie de consentement du locataire existante détermine si les utilisateurs peuvent ajouter le client et quelles autorisations déléguées elles peuvent accorder.
- Pas de jetons d’application uniquement : Les clients CIMD ne peuvent pas utiliser le flux d’informations d’identification du client.
- Restriction d'audience : Microsoft Entra ID n'émet pas de jetons dont l'audience est le client CIMD.
Dans la stratégie de consentement recommandée par défaut, les utilisateurs ne peuvent donner leur consentement qu’aux autorisations OAuth à faible risque pour les clients CIMD. Les autorisations sensibles nécessitent le consentement de l’administrateur. Pour obtenir des conseils d’administrateur, consultez Gérer les clients CIMD dans Microsoft Entra ID.
Considérations sur la gouvernance
Avant d’utiliser CIMD, tenez compte des considérations suivantes :
- Le propriétaire du client contrôle le document de métadonnées et peut modifier son contenu.
- L’URL du document est immuable dans Microsoft Entra ID. Une modification d’URL nécessite une nouvelle identité et de nouvelles autorisations de consentement.
- La stratégie de gestion des applications et d’autres contrôles qui inspectent la configuration stockée sur un objet d’application ne couvrent pas les métadonnées qui restent uniquement dans le document CIMD.
- Les clients CIMD ne prennent pas en charge la vérification du Publisher ni la certification Microsoft 365.
- Entra ne fournit pas de liste verte de domaine géré par le locataire ni de liste de blocage pour les URL CIMD.
- La perte de contrôle de l’URL du document ou de son domaine peut affecter chaque locataire qui fait confiance à cette identité cliente.
Utilisez des autorisations déléguées avec privilèges minimum, préapprouvez les clients qui ont besoin d’un accès sensible, surveillez leurs connexions et supprimez les identités qui ne sont plus requises.