Documents de métadonnées d’ID client dans Microsoft Entra ID (aperçu)

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 :

Diagramme de couloir montrant un utilisateur qui connecte un client MCP à un serveur MCP. Le client découvre Microsoft Entra ID, envoie une demande d’autorisation avec une URL CIMD en tant qu’ID client, et Entra récupère et valide le document de métadonnées. Entra obtient le consentement si nécessaire, crée une identité d’agent si nécessaire et émet un jeton d’accès que le client utilise pour appeler le serveur MCP.

  1. Un client MCP découvre qu’un serveur MCP utilise Microsoft Entra ID comme serveur d’autorisation.
  2. Le client lit les métadonnées du serveur d’autorisation et détermine que CIMD est pris en charge.
  3. Le client envoie une demande d’autorisation. Son client_id est l’URL HTTPS de son document de métadonnées.
  4. Microsoft Entra ID récupère le document et valide son contenu, y compris une correspondance exacte entre le document demandé client_id et le documentclient_id.
  5. 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.
  6. 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.
  7. 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.
  8. 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_id dans 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.