共用方式為


應用程式資訊清單 (Azure AD Graph 格式) 淘汰

在 Azure AD Graph 淘汰之後,應用程式指令清單的 Azure AD Graph 格式已被取代,而 Microsoft Entra 系統管理中心會以 Microsoft Graph 格式顯示應用程式資訊清單。 請讀取這篇文章,深入了解應用程式資訊清單移轉如何影響您的使用者體驗。

重要

使用您的個人 Microsoft 帳戶註冊的應用程式(MSA 帳戶)不在此淘汰的範圍內。 向個人 MSA 帳戶註冊的應用程式將繼續在 Microsoft Entra 系統管理中心以 Azure AD Graph 格式管理應用程式資訊清單,直到進一步通知為止。

移轉日期

從 2024 年 6 月 13 日至 9 月 16 日,Microsoft Entra 系統管理中心的應用程式註冊資訊清單頁面推出了新的索引標籤體驗,讓您以 Azure AD Graph 格式和 Microsoft Graph 兩種格式來檢視、編輯、上傳、下載應用程式資訊清單。

重要

新的索引標籤體驗正大量向 Microsoft Entra 使用者推出,以確保您的體驗品質。 您可能不會立即看到新的體驗。

從 2025 年 1 月 7 日起,您將無法在 Microsoft Entra 系統管理中心的應用程式註冊 資訊清單頁面中檢視、儲存、上傳或下載 Azure AD Graph 應用程式資訊清單。

應用程式資訊清單移轉如何影響您的使用者體驗?

如果您沒有檢視、編輯或儲存應用程式資訊清單,此移轉就不會影響您的工作流程。

如果您檢視或編輯應用程式資訊清單,您會注意到 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 重新置放為屬性 logoutUrlweb 屬性
name displayName
oauth2AllowIdTokenImplicitFlow 重新置放並重新命名為 web 屬性中屬性 enableIdTokenIssuance 的屬性 enableAccessTokenIssuance
oauth2AllowImplicitFlow 重新置放並重新命名為 web 屬性中屬性 implicitGrantSettings 的屬性 enableAccessTokenIssuance
oauth2Permissions 重新置放並重新命名為 oauth2PermissionScopes 屬性的 api 屬性
preAuthorizedApplications 重新置放為 preAuthorizedApplications 屬性的 api 屬性
replyUrlsWithType 在多個屬性中重新命名為屬性 redirectUrisweb 屬性、 spa 屬性、 publicClient 屬性
signInUrl 重新置放並重新命名為屬性 homePageUrlweb 屬性
trustedCertificateSubjects 這是 Microsoft 內部屬性。 入口網站會顯示 v1.0 版的 MS Graph 應用程式資訊清單,而此屬性只存在於搶鮮版 (Beta) 的 MS Graph 應用程式資訊清單中。 繼續使用 Microsoft Entra 系統管理中心的 Azure AD Graph 應用程式資訊清單編輯此屬性。 我們將先在 Microsoft Entra 系統管理中心公開 MS Graph 應用程式資訊清單搶鮮版 (Beta),再取代 Azure AD Graph 應用程式資訊清單

如何判斷應用程式資訊清單的格式?

您可以依應用程式資訊清單所包含的屬性來判斷應用程式資訊清單是 Azure AD Graph 格式抑或是 Microsoft Graph 格式。 例如,

  • 如果應用程式資訊清單具有屬性 replyUrlsWithType,則其格式為 Azure AD Graph。

  • 如果應用程式資訊清單具有屬性 implicitGrantSettings,則是使用 Microsoft Graph 格式。

將 Azure AD Graph 格式的應用程式資訊清單轉換為 Microsoft Graph 格式

如果您已以 Azure AD Graph 格式儲存應用程式資訊清單,並想要將其轉換成 Microsoft Graph 格式:

在 2024 年 6 月 13 日至 2025 年 1 月 7 日期間,您可以遵循下列步驟,使用入口網站,將 Azure AD Graph 格式的應用程式資訊清單轉換成 Microsoft 格式:

  1. 以不低於 [應用程式開發人員] 的身分登入 [Microsoft Entra 系統管理中心]

  2. 瀏覽至 [身分識別] > [應用程式] > [應用程式註冊]

  3. 選取 新註冊 並建立新應用程式註冊。

  4. 在該應用程式的資訊清單頁面,選取 Azure AD Graph 應用程式資訊清單索引標籤。

  5. 上傳您擁有的 Azure AD Graph 格式應用程式資訊清單。

  6. 選取 Microsoft Graph 應用程式資訊清單 索引標籤。

  7. 選取 下載

從 2025 年 1 月 7 日起,Microsoft Entra 系統管理中心將不再支援 Azure AD Graph 格式的應用程式資訊清單。 不過,您可以手動執行轉換。

  1. 瀏覽至 [身分識別] > [應用程式] > [應用程式註冊]

  2. 選取 新註冊 並建立新應用程式註冊。

  3. 應用程式資訊清單會以具有預設值的新格式建立。

  4. 逐一檢查 Azure AD Graph 格式化應用程式資訊清單中的每個屬性,並編輯 Microsoft Graph 格式化應用程式資訊清單中的對應屬性,以符合其值。

    1. 如果該屬性列在 Azure AD Graph 資訊清單與 Microsoft Graph 資訊清單之間的屬性差異中,您必須了解舊屬性與新屬性的語法和語義,才能在 Microsoft Graph 應用程式資訊清單中成功編輯新的屬性值。

    2. 如果該屬性未列在 Azure AD Graph 資訊清單與 Microsoft Graph 資訊清單之間的屬性差異中 ,但在 Microsoft Graph 應用程式資訊清單找不到對應的屬性,則該屬性可能已被取代,您可以捨棄此屬性。

    3. 對於所有其他屬性,您可以在 Azure AD Graph 應用程式資訊清單中複製屬性的值,並將其貼至 Microsoft Graph 應用程式資訊清單中的屬性值。

下一步

了解 應用程式資訊清單 (Microsoft Graph 格式)