Abschaffung des App-Manifest (Azure AD Graph-Format)

Artikel
09/25/2024

Infolge der Ablehnung von Azure AD Graph wird das Azure AD Graph-Format für Anwendungsmanifeste veraltet und das Microsoft Entra Admin Center zeigt die App-Manifeste im Microsoft Graph-Format an. Lesen Sie diesen Artikel, um mehr darüber zu erfahren, wie sich die Migration des App-Manifests auf Ihre Benutzererfahrung auswirkt.

Wichtig

Apps, die mit Ihrem persönlichen Microsoft-Konto (MSA-Konto) registriert sind, sind von dieser Abschaffung nicht betroffen. Apps, die mit Ihrem persönlichen MSA-Konto registriert sind, werden bis auf weiteres im Microsoft Entra Admin Center App-Manifeste im Azure AD Graph-Format verwalten.

Migrationsdatum

Vom 13. Juni bis zum 16. September 2024 wurde auf der App-Registrierungen-Manifestseite im Microsoft Entra Admin Center eine neue Benutzeroberfläche im Registerkartenformat eingeführt, mit der Sie das App-Manifest sowohl im Azure AD Graph-Format als auch im Microsoft Graph-Format anzeigen, bearbeiten, hochladen und herunterladen können.

Wichtig

Die neue Benutzeroberfläche im Registerkartenformat wird schrittweise an Microsoft Entra-Benutzer ausgeliefert, um die Qualität der Benutzeroberfläche zu gewährleisten. Sie werden die neue Perspektive nicht sofort erkennen.

Ab dem 7. Januar 2025 können Sie das Azure AD Graph-App-Manifest nicht auf der App-Registrierungen-Manifestseite im Microsoft Entra Admin Center anzeigen, speichern, hochladen oder herunterladen.

Wie wirkt sich die Migration von App-Manifesten auf Ihre Benutzererfahrung aus?

Wenn Sie App-Manifeste nicht anzeigen, bearbeiten oder speichern, hat diese Migration keine Auswirkungen auf Ihren Arbeitsablauf.

Wenn Sie App-Manifeste anzeigen oder bearbeiten, werden Sie die Attributunterschiede zwischen dem Azure AD Graph-Format und dem Microsoft Graph-Format feststellen. Wir empfehlen, dass Sie mit dem Anzeigen und Bearbeiten von App-Manifesten gemäß der Microsoft Graph Format-Referenz beginnen.

Wenn Ihr Arbeitsablauf erfordert, dass Sie die Manifeste in Ihrem Quell-Repository zur späteren Verwendung speichern, müssen Sie ein App-Manifest im Azure AD Graph-Format in das Microsoft Graph-Format konvertieren.

Attributunterschiede zwischen den Formaten Azure AD Graph und Microsoft Graph

Die meisten Azure AD Graph App-Manifest-Attribute bleiben gleich. Die folgenden Attribute des Azure AD Graph-App-Manifests wurden jedoch aufgehoben, umbenannt oder in das Microsoft Graph-Manifest versetzt.

Azure AD Manifest-Attribut	Microsoft Graph-Manifest
`acceptMappedClaims`	Verschoben als `acceptMappedClaims` Eigenschaft des `api` Attributs
`accessTokenAcceptedVersion`	Verschoben und umbenannt in `requestedAccessTokenVersion` Eigenschaft des Attributs `api`
`allowPublicClient`	Umbenannt als `isFallbackPublicClient`
`errorUrl`	Abgeschafft/keine Unterstützung mehr
`informationalUrls`	Umbenannt als `info`
`knownClientApplications`	Verschoben als eine Eigenschaft des Attributs `api`
`logoUrl`	Verschoben als Eigenschaft des `info` Attributs
`logoutUrl`	Verlegt als Eigenschaft `logoutUrl` des Attributs `web`
`name`	`displayName`
`oauth2AllowIdTokenImplicitFlow`	Verschoben und umbenannt in Eigenschaft `enableAccessTokenIssuance` von Eigenschaft `enableIdTokenIssuance` im Attribut `web`
`oauth2AllowImplicitFlow`	Verschoben und umbenannt in Eigenschaft `enableAccessTokenIssuance` von Eigenschaft `implicitGrantSettings` im Attribut `web`
`oauth2Permissions`	Verschoben und umbenannt in `oauth2PermissionScopes` Eigenschaft des Attributs `api`
`preAuthorizedApplications`	Verschoben als `preAuthorizedApplications`-Eigenschaft des `api`-Attributs
`replyUrlsWithType`	Umbenannt in Eigenschaft `redirectUris` in mehreren Attributen: `web` Attribut, `spa` Attribut, `publicClient` Attribut
`signInUrl`	Verschoben und umbenannt in Eigenschaft `homePageUrl` des Attributs `web`
`trustedCertificateSubjects`	Dies ist eine Microsoft-interne Eigenschaft. Das Portal zeigt die Version v1.0 des MS Graph-Anwendungsmanifests, während diese Eigenschaft nur in der Beta-Version des MS Graph-Anwendungsmanifests vorhanden ist. Bearbeiten Sie diese Eigenschaft weiterhin mit dem Azure AD Graph App Manifest im Microsoft Entra Admin Center. Wir werden die Beta-Version des MS Graph-Anwendungsmanifests im Microsoft Entra Admin Center veröffentlichen, bevor wir das Azure AD Graph-Anwendungsmanifest verwerfen

Wie kann ich das Format meines App-Manifests definieren?

Ob es sich bei einem App-Manifest um ein Azure AD Graph-Format oder ein Microsoft Graph-Format handelt, definieren Sie an den enthaltenen Attributen. Beispiel:

Wenn ein App-Manifest das Attribut replyUrlsWithType hat, dann ist es im Azure AD Graph-Format.
Wenn ein App-Manifest das Attribut implicitGrantSettings hat, ist es im Microsoft Graph-Format.

Konvertieren eines Anwendungsmanifests im Azure AD Graph-Format in das Microsoft Graph-Format

Wenn Sie ein App-Manifest im Azure AD Graph-Format gespeichert haben und es in das Microsoft Graph-Format konvertieren möchten:

Zwischen dem 13. Juni 2024 und dem 7. Januar 2025 können Sie die folgenden Schritte ausführen und das Portal verwenden, um ein App-Manifest im Azure AD Graph-Format in das Microsoft-Format zu konvertieren:

Melden Sie sich beim Microsoft Entra Admin Center mindestens mit der Rolle Anwendungsentwickler an.
Navigieren Sie zu Identität>Anwendungen>App-Registrierungen.
Wählen Sie Neue Registrierung und erstellen Sie eine neue App-Registrierung.
Wählen Sie auf der Seite Manifest für diese Anwendung die Registerkarte Azure AD Graph app manifest.
Laden Sie das App-Manifest im Azure AD Graph-Format hoch, das Sie haben.
Wählen Sie die Registerkarte Microsoft Graph Anwendungsmanifest.
Wählen Sie Herunterladen

Ab dem 7. Januar 2025 wird das Microsoft Entra Admin Center keine App-Manifeste im Azure AD Graph Format mehr unterstützen. Sie können die Konvertierung jedoch auch manuell durchführen.

Browsen Sie zu Identität>Anwendungen>App-Registrierungen.
Wählen Sie Neue Registrierung und erstellen Sie eine neue App-Registrierung.
Ein App-Manifest wird im neuen Format mit Standardwerten erstellt.
Gehen Sie jedes Attribut im Azure AD Graph-formatierten App-Manifest einzeln durch und bearbeiten Sie das entsprechende Attribut im Microsoft Graph-formatierten App-Manifest so, dass es seinem Wert entspricht.
1. Wenn das Attribut in Attributunterschiede zwischen Azure AD Graph-Manifest und Microsoft Graph-Manifest aufgeführt ist, müssen Sie die Syntax und Semantik der alten und neuen Attribute verstehen, damit Sie den Wert des neuen Attributs im Microsoft Graph-App-Manifest erfolgreich bearbeiten können.
2. Wenn das Attribut nicht in Attributunterschiede zwischen Azure AD Graph-Manifest und Microsoft Graph-Manifest aufgeführt ist, Sie aber kein entsprechendes Attribut im Microsoft Graph-App-Manifest finden können, ist dieses Attribut wahrscheinlich veraltet und Sie können dieses Attribut verwerfen.
3. Für alle anderen Attribute können Sie den Wert des Attributs im Azure AD Graph-App-Manifest kopieren und in den Wert des Attributs im Microsoft Graph-App-Manifest einfügen.

Nächste Schritte

Erfahren Sie mehr über das Anwendungsmanifest (Microsoft Graph Format)

Freigeben über