Udostępnij za pośrednictwem


Wycofanie manifestu aplikacji (format programu Azure AD Graph)

Po wycofaniu programu Azure AD Graph format manifestów aplikacji w usłudze Azure AD Graph jest przestarzały, a centrum administracyjne firmy Microsoft Entra wyświetla manifesty aplikacji w formacie programu Microsoft Graph. Przeczytaj ten artykuł, aby dowiedzieć się więcej na temat wpływu migracji manifestu aplikacji na środowisko użytkownika.

Ważne

Aplikacje zarejestrowane przy użyciu osobistego konta Microsoft (konta MSA) nie należą do zakresu tego wycofania. Aplikacje zarejestrowane na osobistym koncie MSA będą nadal zarządzać manifestami aplikacji w formacie usługi Azure AD Graph w centrum administracyjnym firmy Microsoft Entra do odwołania.

Data migracji

Od 13 czerwca do 16 września 2024 r. strona manifestu Rejestracje aplikacji w centrum administracyjnym firmy Microsoft Entra uruchomiła nowe środowisko z kartami, które umożliwia wyświetlanie, edytowanie, przekazywanie, pobieranie manifestu aplikacji zarówno w formacie programu Azure AD Graph, jak i w formacie programu Microsoft Graph.

Ważne

Nowe środowisko kart jest wdrażane dla użytkowników firmy Microsoft Entra w partiach, aby zapewnić jakość środowiska. Nowe środowisko może nie być natychmiast widoczne.

Od 7 stycznia 2025 r. nie będzie można wyświetlać, zapisywać, przekazywać ani pobierać manifestu aplikacji usługi Azure AD Graph na stronie manifestu Rejestracje aplikacji w centrum administracyjnym firmy Microsoft Entra.

Jak migracja manifestu aplikacji wpływa na środowisko użytkownika?

Jeśli nie wyświetlasz, edytujesz ani nie zapiszesz manifestów aplikacji, ta migracja nie ma wpływu na przepływ pracy.

Jeśli wyświetlasz lub edytujesz manifesty aplikacji, zauważysz różnice atrybutów między formatem programu Azure AD Graph i formatem programu Microsoft Graph. Zalecamy rozpoczęcie przeglądania i edytowania manifestów aplikacji zgodnie z dokumentacją dotyczącą formatu programu Microsoft Graph.

Jeśli przepływ pracy wymaga zapisania manifestów w repozytorium źródłowym do późniejszego użycia, musisz przekonwertować manifest aplikacji w formacie programu Azure AD Graph na format programu Microsoft Graph.

Różnice atrybutów między formatami programu Azure AD Graph i programu Microsoft Graph

Większość atrybutów manifestu aplikacji usługi Azure AD Graph jest taka sama. Jednak następujące atrybuty manifestu aplikacji usługi Azure AD Graph zostały przestarzałe, zmieniono nazwę lub przeniesiono je w manifeście programu Microsoft Graph.

Atrybut manifestu usługi Azure AD Manifest programu Microsoft Graph
acceptMappedClaims Przeniesiono jako acceptMappedClaims właściwość atrybutu api
accessTokenAcceptedVersion Przeniesiono i zmieniono nazwę jako requestedAccessTokenVersion właściwość atrybutu api
allowPublicClient Zmieniono nazwę jako isFallbackPublicClient
errorUrl Przestarzałe/nieobsługiwane
informationalUrls Zmieniono nazwę jako info
knownClientApplications Przeniesiono jako właściwość atrybutu api
logoUrl Przeniesiono jako właściwość atrybutu info
logoutUrl Przeniesiono jako właściwość logoutUrl atrybutu web
name displayName
oauth2AllowIdTokenImplicitFlow Przeniesiono i zmieniono nazwę jako właściwość enableAccessTokenIssuance właściwości enableIdTokenIssuance w atrybucie web
oauth2AllowImplicitFlow Przeniesiono i zmieniono nazwę jako właściwość enableAccessTokenIssuance właściwości implicitGrantSettings w atrybucie web
oauth2Permissions Przeniesiono i zmieniono nazwę jako oauth2PermissionScopes właściwość atrybutu api
preAuthorizedApplications Przeniesiono jako preAuthorizedApplications właściwość atrybutu api
replyUrlsWithType Zmieniono nazwę jako właściwość redirectUris w wielu atrybutach: web atrybut, spa atrybut, publicClient atrybut
signInUrl Przeniesiono i zmieniono nazwę jako właściwość homePageUrl atrybutu web
trustedCertificateSubjects Jest to wewnętrzna właściwość firmy Microsoft. Portal pokazuje wersję 1.0 manifestu aplikacji MS Graph, podczas gdy ta właściwość jest obecna tylko w wersji beta manifestu aplikacji MS Graph. Kontynuuj edytowanie tej właściwości przy użyciu manifestu aplikacji programu Azure AD Graph w centrum administracyjnym firmy Microsoft Entra. Udostępnimy wersję beta manifestu aplikacji MS Graph w centrum administracyjnym firmy Microsoft Entra przed wycofaniem manifestu aplikacji Programu Graph usługi Azure AD

Jak mogę powiedzieć format manifestu aplikacji?

Możesz określić, czy manifest aplikacji jest formatem programu Azure AD Graph, czy formatem programu Microsoft Graph, według atrybutów, które zawiera. Na przykład:

  • Jeśli manifest aplikacji ma atrybut replyUrlsWithType, jest w formacie usługi Azure AD Graph.

  • Jeśli manifest aplikacji ma atrybut implicitGrantSettings, jest w formacie programu Microsoft Graph.

Konwertowanie manifestu aplikacji w formacie programu Azure AD Graph na format programu Microsoft Graph

Jeśli manifest aplikacji został zapisany w formacie programu Azure AD Graph i chcesz przekonwertować go na format programu Microsoft Graph:

Od 13 czerwca 2024 r. do 7 stycznia 2025 r. możesz wykonać poniższe kroki i użyć portalu, aby przekonwertować manifest aplikacji w formacie programu Azure AD Graph na format firmy Microsoft:

  1. Zaloguj się do centrum administracyjnego firmy Microsoft Entra co najmniej jako deweloper aplikacji.

  2. Przejdź do aplikacji tożsamości>> Rejestracje aplikacji.

  3. Wybierz pozycję Nowa rejestracja i utwórz nową rejestrację aplikacji.

  4. Na stronie Manifest dla tej aplikacji wybierz kartę Manifest aplikacji usługi Azure AD Graph.

  5. Przekaż manifest aplikacji w formacie programu Azure AD Graph, który masz.

  6. Wybierz kartę Manifest aplikacji microsoft Graph.

  7. Wybierz pozycję Pobierz.

Od 7 stycznia 2025 r. centrum administracyjne firmy Microsoft Entra nie będzie już obsługiwać manifestów aplikacji w formacie usługi Azure AD Graph. Można jednak wykonać konwersję ręcznie.

  1. Przejdź do aplikacji tożsamości>> Rejestracje aplikacji.

  2. Wybierz pozycję Nowa rejestracja i utwórz nową rejestrację aplikacji.

  3. Manifest aplikacji jest tworzony w nowym formacie z wartościami domyślnymi.

  4. Przejrzyj każdy atrybut w programie Azure AD Graph sformatowany manifest aplikacji jeden po jednym i zmodyfikuj odpowiedni atrybut w manifeście aplikacji sformatowanej w programie Microsoft Graph, aby dopasować jego wartość.

    1. Jeśli atrybut znajduje się na liście Różnice atrybutów między manifestem programu Azure AD Graph i manifestem programu Microsoft Graph, musisz zrozumieć składnię i semantyka starych i nowych atrybutów, aby można było pomyślnie edytować wartość nowego atrybutu w manifeście aplikacji programu Microsoft Graph.

    2. Jeśli atrybut nie znajduje się na liście Różnice atrybutów między manifestem programu Azure AD Graph i manifestem programu Microsoft Graph, ale nie można znaleźć odpowiedniego atrybutu w manifeście aplikacji programu Microsoft Graph, ten atrybut prawdopodobnie będzie przestarzały i można odrzucić ten atrybut.

    3. Dla wszystkich innych atrybutów można skopiować wartość atrybutu w manifeście aplikacji usługi Azure AD Graph i wkleić go do wartości atrybutu w manifeście aplikacji programu Microsoft Graph.

Następne kroki

Dowiedz się więcej o manifeście aplikacji (format programu Microsoft Graph)