Нерекомендуемые выражения манифеста приложения (формат Azure AD Graph)
После нерекомендуния Azure AD Graph формат манифестов приложений Azure AD устарел, а Центр администрирования Microsoft Entra отображает манифесты приложений в формате Microsoft Graph. Ознакомьтесь с этой статьей, чтобы узнать больше о том, как миграция манифеста приложения влияет на взаимодействие с пользователем.
Внимание
Приложения, зарегистрированные в вашей личной учетной записи Майкрософт (учетная запись MSA), не находятся в области этого нерекомендуемого использования. Приложения, зарегистрированные в вашей личной учетной записи MSA, будут продолжать управлять манифестами приложений в формате Azure AD Graph в Центре администрирования Microsoft Entra до дальнейшего уведомления.
Дата миграции
С 13 июня по 16 сентября 2024 г. страница манифеста Регистрация приложений в Центре администрирования Microsoft Entra запустила новый интерфейс с вкладками, позволяющий просматривать, редактировать, загружать манифест приложения как в формате Azure AD Graph, так и в формате Microsoft Graph.
Внимание
Новый интерфейс табуляции развертывается для пользователей Microsoft Entra в пакетах, чтобы обеспечить качество работы. Возможно, вы не увидите новый интерфейс немедленно.
Начиная с 7 января 2025 г. вы не сможете просматривать, сохранять, загружать или скачивать манифест приложения Azure AD Graph на странице манифеста Регистрация приложений в Центре администрирования Microsoft Entra.
Как миграция манифеста приложения влияет на взаимодействие с пользователем?
Если вы не просматриваете, редактируете или сохраняете манифесты приложения, эта миграция не влияет на рабочий процесс.
Если вы просматриваете или редактируете манифесты приложения, обратите внимание на различия между форматом Azure AD Graph и форматом Microsoft Graph. Рекомендуется начать просмотр и редактирование манифестов приложения после ссылки на формат Microsoft Graph.
Если рабочий процесс требует сохранения манифестов в исходном репозитории для последующего использования, необходимо преобразовать манифест приложения в формате Azure AD Graph в формат Microsoft Graph.
Различия атрибутов между форматами Azure AD Graph и Microsoft Graph
Большинство атрибутов манифеста приложения Azure AD Graph остаются одинаковыми. Однако следующие атрибуты манифеста приложения Azure AD Graph устарели, переименованы или перемещены в манифесте Microsoft Graph.
| Атрибут манифеста Azure AD | Манифест Microsoft Graph |
|---|---|
acceptMappedClaims |
Перемещено как acceptMappedClaims свойство атрибута api |
accessTokenAcceptedVersion |
Перемещено и переименовано как requestedAccessTokenVersion свойство атрибута api |
allowPublicClient |
Переименовано как isFallbackPublicClient |
errorUrl |
Не рекомендуется или больше не поддерживается |
informationalUrls |
Переименовано как info |
knownClientApplications |
Перемещается как свойство атрибута api |
logoUrl |
Перемещается как свойство атрибута info |
logoutUrl |
Перемещено как свойство logoutUrl атрибута web |
name |
displayName |
oauth2AllowIdTokenImplicitFlow |
Перемещено и переименовано как свойство enableAccessTokenIssuance свойства enableIdTokenIssuance в атрибуте web |
oauth2AllowImplicitFlow |
Перемещено и переименовано как свойство enableAccessTokenIssuance свойства implicitGrantSettings в атрибуте web |
oauth2Permissions |
Перемещено и переименовано как oauth2PermissionScopes свойство атрибута api |
preAuthorizedApplications |
Перемещено как preAuthorizedApplications свойство атрибута api |
replyUrlsWithType |
Переименовано как свойство redirectUris в нескольких атрибутах: web атрибут, атрибут, spa publicClient атрибут |
signInUrl |
Перемещено и переименовано как свойство homePageUrl атрибута web |
trustedCertificateSubjects |
Это внутреннее свойство Майкрософт. На портале показана версия 1.0 манифеста приложения MS Graph, пока это свойство присутствует только в бета-версии манифеста приложения MS Graph. Продолжайте изменять это свойство с помощью манифеста приложения Azure AD Graph в Центре администрирования Microsoft Entra. Мы предоставим бета-версию манифеста приложения MS Graph в Центре администрирования Microsoft Entra перед отменой манифеста приложения Azure AD Graph |
Разделы справки сообщить формат манифеста приложения?
Вы можете определить, является ли манифест приложения форматом Azure AD Graph или форматом Microsoft Graph атрибутами, содержащимися в нем. Например,
Если манифест приложения имеет атрибут
replyUrlsWithType, он находится в формате Graph Azure AD.Если манифест приложения имеет атрибут
implicitGrantSettings, он находится в формате Microsoft Graph.
Преобразование манифеста приложения в формате Azure AD Graph в формат Microsoft Graph
Если вы сохранили манифест приложения в формате Azure AD Graph и хотите преобразовать его в формат Microsoft Graph:
В период с 13 июня 2024 г. до 7 января 2025 г. можно выполнить приведенные ниже действия и использовать портал для преобразования манифеста приложения в формате Azure AD Graph в формат Microsoft:
Войдите в Центр администрирования Microsoft Entra как минимум разработчик приложений.
Перейдите к приложениям> удостоверений>Регистрация приложений.
Выберите "Создать регистрацию" и создайте новую регистрацию приложения.
На странице манифеста этого приложения выберите вкладку манифеста приложения Azure AD Graph.
Отправьте манифест приложения в формате Azure AD Graph, который у вас есть.
Перейдите на вкладку манифеста приложения Microsoft Graph.
Выберите скачивание.
Начиная с 7 января 2025 г. Центр администрирования Microsoft Entra больше не будет поддерживать манифесты приложений в формате Azure AD Graph. Однако вы можете выполнить преобразование вручную.
Перейдите к приложениям> удостоверений>Регистрация приложений.
Выберите "Создать регистрацию" и создайте новую регистрацию приложения.
Манифест приложения создается в новом формате со значениями по умолчанию.
Перейдите по каждому атрибуту манифеста приложения в формате Azure AD Graph по одному и измените соответствующий атрибут в манифесте приложения в формате Microsoft Graph, чтобы соответствовать его значению.
Если атрибут указан в различиях между манифестом Azure AD Graph и манифестом Microsoft Graph, необходимо понять синтаксис и семантику старых и новых атрибутов, чтобы можно было успешно изменить значение нового атрибута в манифесте приложения Microsoft Graph.
Если атрибут не указан в различиях атрибутов между манифестом Azure AD Graph и манифестом Microsoft Graph, но не удается найти соответствующий атрибут в манифесте приложения Microsoft Graph, этот атрибут, скорее всего, устарел, и этот атрибут можно отменить.
Для всех остальных атрибутов можно скопировать значение атрибута в манифесте приложения Azure AD Graph и вставить его в значение атрибута в манифесте приложения Microsoft Graph.
Следующие шаги
Сведения о манифесте приложения (формат Microsoft Graph)