Condividi tramite


Deprecazione del manifesto dell'app (formato Azure AD Graph)

Dopo la deprecazione di Azure AD Graph, il formato Azure AD Graph dei manifesti dell'applicazione è deprecato e l'interfaccia di amministrazione di Microsoft Entra visualizza i manifesti dell'app in formato Microsoft Graph. Leggere questo articolo per altre informazioni su come la migrazione del manifesto dell'app influisce sull'esperienza utente.

Importante

Le app registrate con l'account Microsoft personale (account MSA) non rientrano nell'ambito di questa deprecazione. Le app registrate con l'account del servizio gestito personale continueranno a gestire i manifesti dell'app nel formato Graph di Azure AD nell'interfaccia di amministrazione di Microsoft Entra fino a un ulteriore avviso.

Data della migrazione

Dal 13 giugno al 16 settembre 2024, la pagina del manifesto Registrazioni app nell'interfaccia di amministrazione di Microsoft Entra ha lanciato una nuova esperienza a schede che consente di visualizzare, modificare, caricare e scaricare il manifesto dell'app sia in formato Azure AD Graph che in formato Microsoft Graph.

Importante

La nuova esperienza a schede viene implementata agli utenti di Microsoft Entra in batch per garantire la qualità dell'esperienza. È possibile che la nuova esperienza non venga visualizzata immediatamente.

A partire dal 7 gennaio 2025, non sarà possibile visualizzare, salvare, caricare o scaricare il manifesto dell'app Graph di Azure AD nella pagina del manifesto Registrazioni app nell'interfaccia di amministrazione di Microsoft Entra.

In che modo la migrazione del manifesto dell'app influisce sull'esperienza utente?

Se non si visualizzano, modificano o salvano i manifesti dell'app, questa migrazione non influisce sul flusso di lavoro.

Se si visualizzano o si modificano i manifesti dell'app, si noteranno le differenze di attributo tra il formato Azure AD Graph e il formato Microsoft Graph. È consigliabile iniziare a visualizzare e modificare i manifesti dell'app seguendo le informazioni di riferimento sul formato Microsoft Graph.

Se il flusso di lavoro richiede di salvare i manifesti nel repository di origine per un uso successivo, è necessario convertire un manifesto dell'app in formato Azure AD Graph al formato Microsoft Graph.

Differenze di attributi tra i formati Azure AD Graph e Microsoft Graph

La maggior parte degli attributi del manifesto dell'app Graph di Azure AD rimane invariata. Tuttavia, gli attributi seguenti del manifesto dell'app Graph di Azure AD sono stati deprecati, rinominati o rilocati nel manifesto di Microsoft Graph.

Attributo manifesto di Azure AD Manifesto di Microsoft Graph
acceptMappedClaims Rilocato come acceptMappedClaims proprietà dell'apiattributo
accessTokenAcceptedVersion Rilocato e rinominato come requestedAccessTokenVersion proprietà dell'apiattributo
allowPublicClient Rinominato in isFallbackPublicClient
errorUrl Deprecato/non più supportato
informationalUrls Rinominato in info
knownClientApplications Rilocato come proprietà dell'apiattributo
logoUrl Rilocato come proprietà dell'infoattributo
logoutUrl Rilocato come proprietà logoutUrl dell'webattributo
name displayName
oauth2AllowIdTokenImplicitFlow Rilocato e rinominato come proprietà enableAccessTokenIssuance della proprietà enableIdTokenIssuance nell'webattributo
oauth2AllowImplicitFlow Rilocato e rinominato come proprietà enableAccessTokenIssuance della proprietà implicitGrantSettings nell'webattributo
oauth2Permissions Rilocato e rinominato come oauth2PermissionScopes proprietà dell'apiattributo
preAuthorizedApplications Rilocato come preAuthorizedApplications proprietà dell'apiattributo
replyUrlsWithType Rinominato come proprietà redirectUris in più attributi: web attributo, spa attributo, attributo, publicClient attributo
signInUrl Rilocato e rinominato come homePageUrl proprietà dell'webattributo
trustedCertificateSubjects Si tratta di una proprietà interna di Microsoft. Il portale mostra la versione 1.0 del manifesto dell'app MS Graph, mentre questa proprietà è presente solo nella versione beta del manifesto dell'app MS Graph. Continuare a modificare questa proprietà usando il manifesto dell'app Azure AD Graph nell'interfaccia di amministrazione di Microsoft Entra. Verrà esposta la versione beta del manifesto dell'app MS Graph nell'interfaccia di amministrazione di Microsoft Entra prima di deprecare il manifesto dell'app Azure AD Graph

Come si riconosce il formato del manifesto dell'app?

È possibile stabilire se un manifesto dell'app è un formato Graph di Azure AD o Microsoft Graph in base agli attributi contenuti. Ad esempio:

  • Se un manifesto dell'app ha l'attributo replyUrlsWithType, è in formato Graph di Azure AD.

  • Se un manifesto dell'app ha l'attributo implicitGrantSettings, è in formato Microsoft Graph.

Convertire un manifesto dell'app in formato Graph di Azure AD in formato Microsoft Graph

Se è stato archiviato un manifesto dell'app in formato Graph di Azure AD e si vuole convertirlo in formato Microsoft Graph:

Tra il 13 giugno 2024 e il 7 gennaio 2025, è possibile seguire la procedura seguente e usare il portale per convertire un manifesto dell'app in formato Graph di Azure AD in formato Microsoft:

  1. Accedere all'interfaccia di amministrazione di Microsoft Entra almeno come Sviluppatore di applicazioni.

  2. Passare a Identità>Applicazioni>Registrazioni app.

  3. Seleziona Nuova registrazione per creare una nuova registrazione dell'app.

  4. Nella pagina Manifesto dell'applicazione selezionare la scheda manifesto dell'app Azure AD Graph.

  5. Caricare il manifesto dell'app in formato Azure AD Graph.

  6. Selezionare la scheda manifesto dell'app Microsoft Graph.

  7. Selezionare Download.

A partire dal 7 gennaio 2025, l'interfaccia di amministrazione di Microsoft Entra non supporterà più i manifesti delle app in formato Azure AD Graph. Tuttavia, è possibile eseguire la conversione manualmente.

  1. Passare a Identità>Applicazioni>Registrazioni app.

  2. Seleziona Nuova registrazione per creare una nuova registrazione dell'app.

  3. Viene creato un manifesto dell'app nel nuovo formato con valori predefiniti.

  4. Nel manifesto dell'app formattato in Azure AD Graph esaminare ogni attributo uno alla volta e modificare l'attributo corrispondente nel manifesto dell'app formattato in Microsoft Graph in modo che corrisponda al relativo valore.

    1. Se l'attributo è elencato in Differenze tra il manifesto di Azure AD Graph e il manifesto di Microsoft Graph, è necessario comprendere la sintassi e la semantica degli attributi precedenti e dei nuovi in modo da poter modificare correttamente il valore del nuovo attributo nel manifesto dell'app Microsoft Graph.

    2. Se l'attributo non è elencato in Differenze tra il manifesto di Azure AD Graph e il manifesto di Microsoft Graph, ma non è possibile trovare un attributo corrispondente nel manifesto dell'app Microsoft Graph, è probabile che questo attributo sia deprecato ed è possibile ignorarlo.

    3. Per tutti gli altri attributi, è possibile copiare il valore dell'attributo nel manifesto dell'app Azure AD Graph e incollarlo nel valore dell'attributo nel manifesto dell'app Microsoft Graph.

Passaggi successivi

Informazioni sul manifesto dell'app (formato Microsoft Graph)