Partage via

Manifeste de l’application (format Azure AD Graph)

  • Article

Après la dépréciation d’Azure AD Graph, le format Azure AD Graph des manifestes d’application est déconseillé et le Centre d’administration Microsoft Entra affiche les manifestes d’application au format Microsoft Graph. Lisez cet article pour en savoir plus sur la façon dont la migration des manifestes d’application a un impact sur votre expérience utilisateur.

Important

Les applications inscrites avec votre compte Microsoft personnel (compte MSA) ne sont pas concernées par cette dépréciation. Les applications inscrites avec votre compte MSA personnel continueront à gérer les manifestes d’application au format Azure AD Graph dans le centre d’administration Microsoft Entra jusqu’à nouvel ordre.

Date de migration

Du 13 au 16 septembre 2024, la page manifeste des inscriptions d’applications du centre d’administration Microsoft Entra a lancé une nouvelle expérience avec onglets qui vous permet d’afficher, de modifier, de télécharger, de charger le manifeste de l’application au format Azure AD Graph et au format Microsoft Graph.

Important

La nouvelle expérience avec onglets est déployée auprès des utilisateurs de Microsoft Entra par lots pour garantir la qualité de votre expérience. Vous ne verrez peut-être pas immédiatement la nouvelle expérience.

À compter du 7 janvier 2025, vous ne pourrez plus afficher, enregistrer, charger ou télécharger le manifeste d’application Azure AD Graph dans la page de manifeste des inscriptions d’applications dans le centre d’administration Microsoft Entra.

Quel est l’impact de la migration des manifestes d’application sur votre expérience utilisateur ?

Si vous n’affichez pas, modifiez ou enregistrez des manifestes d’application, cette migration n’a pas d’impact sur votre flux de travail.

Si vous affichez ou modifiez des manifestes d’application, vous remarquez les différences d’attribut entre le format Azure AD Graph et le format Microsoft Graph. Nous vous recommandons de commencer à afficher et à modifier des manifestes d’application en suivant la référence au format Microsoft Graph.

Si votre flux de travail vous oblige à enregistrer les manifestes dans votre référentiel source pour une utilisation ultérieure, vous devez convertir un manifeste d’application au format Azure AD Graph au format Microsoft Graph.

Différences des propriétés entre Azure AD Graph et Microsoft Graph

La plupart des attributs de manifeste d’application Azure AD Graph restent identiques. Toutefois, les attributs de manifeste d’application Azure AD Graph suivants ont été dépréciés, renommés ou déplacés dans le manifeste Microsoft Graph.

Attribut de manifeste Azure AD Manifeste Microsoft Graph
acceptMappedClaims Déplacé en tant que acceptMappedClaims propriété de l’attribut api
accessTokenAcceptedVersion Déplacé et renommé en tant que requestedAccessTokenVersion propriété de l’attribut api
allowPublicClient Renommé en isFallbackPublicClient
errorUrl Dépréciation/fin de prise en charge
informationalUrls Renommé en info
knownClientApplications Déplacé en tant que propriété de l’attribut api
logoUrl Déplacé en tant que propriété de l’attribut info
logoutUrl Déplacé en tant que propriété logoutUrl de l’attribut web
name displayName
oauth2AllowIdTokenImplicitFlow Déplacé et renommé en tant que propriété enableAccessTokenIssuance de la propriété enableIdTokenIssuance dans l’attribut web
oauth2AllowImplicitFlow Déplacé et renommé en tant que propriété enableAccessTokenIssuance de la propriété implicitGrantSettings dans l’attribut web
oauth2Permissions Déplacé et renommé en tant que propriété oauth2PermissionScopes de l’attribut api
preAuthorizedApplications Déplacé en tant que propriété preAuthorizedApplications de l’attribut api
replyUrlsWithType Renommé en tant que propriété redirectUris dans plusieurs attributs : attribut web, attribut spa, attribut publicClient
signInUrl Déplacé et renommé en tant que propriété homePageUrl de l’attribut web
trustedCertificateSubjects Il s’agit d’une propriété interne Microsoft. Le portail affiche la version v1.0 du manifeste de l’application MS Graph alors que cette propriété est présente uniquement dans la version bêta du manifeste d’application MS Graph. Continuez à modifier cette propriété à l’aide du manifeste d’application Azure AD Graph dans le Centre d’administration Microsoft Entra. Nous allons exposer la version bêta du manifeste d’application MS Graph dans le centre d’administration Microsoft Entra avant de déprécier le manifeste d’application Azure AD Graph

Comment faire indiquer le format de mon manifeste de l’application ?

Vous pouvez savoir si un manifeste d’application est un format Azure AD Graph ou un format Microsoft Graph par les attributs qu’il contient. Par exemple,

  • Si un manifeste d’application a l’attribut replyUrlsWithType, il est au format Azure AD Graph.

  • Si un manifeste d’application a l’attribut implicitGrantSettings, il est au format Microsoft Graph.

Convertir un manifeste d’application au format Azure AD Graph vers le format Microsoft Graph

Si vous avez stocké un manifeste d’application au format Azure AD Graph et souhaitez le convertir vers Microsoft Graph :

Entre le 13 juin 2024 et le 7 janvier 2025, vous pouvez suivre les étapes ci-dessous et utiliser le portail pour convertir un manifeste d’application au format Azure AD Graph vers le format Microsoft :

  1. Connectez-vous au centre d’administration de Microsoft Entra au minimum en tant que Développeur d’application.

  2. Accédez à Identité>Applications>Inscriptions d’applications.

  3. Sélectionnez Nouvelle inscription et créez une inscription d’application.

  4. Dans la page Manifeste de cette application, sélectionnez l’onglet Manifeste de l’application Azure AD Graph.

  5. Chargez le manifeste d’application au format Azure AD Graph que vous avez.

  6. Sélectionnez l’onglet Manifeste de l’application Microsoft Graph.

  7. Sélectionnez Télécharger.

À compter du 7 janvier 2025, le centre d’administration Microsoft Entra ne prendra plus en charge les manifestes d’application au format Azure AD Graph. Toutefois, vous pouvez effectuer la conversion manuellement.

  1. Accédez à Identité>Applications>Inscriptions à l’application.

  2. Sélectionnez Nouvelle inscription et créez une inscription d’application.

  3. Un manifeste d’application est créé dans le nouveau format avec des valeurs par défaut.

  4. Parcourez chaque attribut dans le manifeste d’application au format Azure AD Graph un par un et modifiez l’attribut correspondant dans le manifeste d’application au format Microsoft Graph pour qu’il corresponde à sa valeur.

    1. Si l’attribut est répertorié dans les différences d’attribut entre le manifeste Azure AD Graph et le manifeste Microsoft Graph, vous devez comprendre la syntaxe et la sémantique des anciens et nouveaux attributs afin de pouvoir modifier correctement la valeur du nouvel attribut dans le manifeste d’application Microsoft Graph.

    2. Si l’attribut n’est pas répertorié dans les différences d’attribut entre le manifeste Azure AD Graph et le manifeste Microsoft Graph, mais que vous ne trouvez pas d’attribut correspondant dans le manifeste d’application Microsoft Graph, cet attribut a probablement été déprécié et vous pouvez l’abandonner.

    3. Pour tous les autres attributs, vous pouvez copier la valeur de l’attribut dans le manifeste d’application Azure AD Graph et la coller dans la valeur de l’attribut dans le manifeste d’application Microsoft Graph.

Étapes suivantes

En savoir plus sur le manifeste d’application (format Microsoft Graph)