Partilhar via

Descontinuação do manifesto do aplicativo (formato Azure AD Graph)

  • Artigo

Após a descontinuação do Azure AD Graph, o formato Azure AD Graph de manifestos de aplicativo foi preterido e o centro de administração do Microsoft Entra exibe manifestos de aplicativo no formato Microsoft Graph. Leia este artigo para saber mais sobre como a migração do manifesto do aplicativo afeta sua experiência de usuário.

Importante

As aplicações registadas com a sua conta Microsoft pessoal (conta MSA) não estão no âmbito desta descontinuação. Os aplicativos registrados com sua conta pessoal do MSA continuarão a gerenciar manifestos de aplicativos no formato Azure AD Graph no centro de administração do Microsoft Entra até novo aviso.

Data de migração

De 13 de junho a 16 de setembro de 2024, a página de manifesto de registros de aplicativos no centro de administração do Microsoft Entra lançou uma nova experiência com guias que permite exibir, editar, carregar e baixar o manifesto do aplicativo no formato Azure AD Graph e no formato Microsoft Graph.

Importante

A nova experiência com guias está sendo implementada para os usuários do Microsoft Entra em lotes para garantir a qualidade da sua experiência. Você pode não ver a nova experiência imediatamente.

A partir de 7 de janeiro de 2025, não poderá ver, guardar, carregar ou transferir o manifesto da aplicação Azure AD Graph na página Manifesto de registos de aplicações no centro de administração do Microsoft Entra.

Como a migração do manifesto do aplicativo afeta sua experiência de usuário?

Se você não visualizar, editar ou salvar manifestos do aplicativo, essa migração não afetará seu fluxo de trabalho.

Se você exibir ou editar manifestos do aplicativo, notará as diferenças de atributo entre o formato do Azure AD Graph e o formato do Microsoft Graph. Recomendamos que você comece a exibir e editar manifestos do aplicativo seguindo a referência de formato do Microsoft Graph.

Se seu fluxo de trabalho exigir que você salve os manifestos em seu repositório de origem para uso posterior, você precisará converter um manifesto de aplicativo no formato Azure AD Graph para o formato Microsoft Graph.

Diferenças de atributos entre os formatos Azure AD Graph e Microsoft Graph

A maioria dos atributos de manifesto do aplicativo Azure AD Graph permanece a mesma. No entanto, os seguintes atributos de manifesto do aplicativo Azure AD Graph foram preteridos, renomeados ou realocados no manifesto do Microsoft Graph.

Atributo de manifesto do Azure AD Manifesto do Microsoft Graph
acceptMappedClaims Realocado como acceptMappedClaims propriedade do api atributo
accessTokenAcceptedVersion Realocado e renomeado como requestedAccessTokenVersion propriedade do api atributo
allowPublicClient Renomeado como isFallbackPublicClient
errorUrl Obsoleto/não suporta mais
informationalUrls Renomeado como info
knownClientApplications Realocado como uma propriedade do api atributo
logoUrl Realocado como uma propriedade do info atributo
logoutUrl Realocado como propriedade logoutUrl do web atributo
name displayName
oauth2AllowIdTokenImplicitFlow Realocado e renomeado como propriedade enableAccessTokenIssuance de propriedade enableIdTokenIssuance no web atributo
oauth2AllowImplicitFlow Realocado e renomeado como propriedade enableAccessTokenIssuance de propriedade implicitGrantSettings no web atributo
oauth2Permissions Realocado e renomeado como oauth2PermissionScopes propriedade do api atributo
preAuthorizedApplications Realocado como preAuthorizedApplications propriedade do api atributo
replyUrlsWithType Renomeado como propriedade redirectUris em vários atributos: web atributo, spa atributo, publicClient atributo
signInUrl Realocado e renomeado como propriedade homePageUrl do web atributo
trustedCertificateSubjects Esta é uma propriedade interna da Microsoft. O portal mostra a versão v1.0 do manifesto do aplicativo MS Graph, enquanto essa propriedade só está presente na versão beta do manifesto do aplicativo MS Graph. Continue a editar essa propriedade usando o manifesto do aplicativo Azure AD Graph no centro de administração do Microsoft Entra. Vamos expor a versão beta do manifesto do aplicativo MS Graph no centro de administração do Microsoft Entra antes de substituir o manifesto do aplicativo Azure AD Graph

Como faço para saber o formato do manifesto do meu aplicativo?

Você pode saber se um manifesto de aplicativo é um formato do Azure AD Graph ou do Microsoft Graph pelos atributos que ele contém. Por exemplo,

  • Se um manifesto de aplicativo tiver o atributo replyUrlsWithType, ele estará no formato Azure AD Graph.

  • Se um manifesto de aplicativo tiver o atributo implicitGrantSettings, ele estará no formato Microsoft Graph.

Converter um manifesto de aplicativo no formato Azure AD Graph para o formato Microsoft Graph

Se você armazenou um manifesto do aplicativo no formato Azure AD Graph e deseja convertê-lo para o formato Microsoft Graph:

Entre 13 de junho de 2024 e 7 de janeiro de 2025, você pode seguir as etapas abaixo e usar o portal para converter um manifesto de aplicativo no formato Azure AD Graph para o formato Microsoft:

  1. Entre no centro de administração do Microsoft Entra como pelo menos um desenvolvedor de aplicativos.

  2. Navegue até Registros do aplicativo Identity>Applications>.

  3. Selecione Novo registro e crie um novo registro de aplicativo.

  4. Na página Manifesto desse aplicativo, selecione a guia Manifesto do aplicativo Azure AD Graph.

  5. Carregue o manifesto do aplicativo no formato Azure AD Graph que você tem.

  6. Selecione a guia Manifesto do aplicativo Microsoft Graph.

  7. Selecione download.

A partir de 7 de janeiro de 2025, o centro de administração do Microsoft Entra deixará de suportar manifestos de aplicações no formato Azure AD Graph. No entanto, você pode executar a conversão manualmente.

  1. Navegue até Registros do aplicativo Identity>Applications>.

  2. Selecione Novo registro e crie um novo registro de aplicativo.

  3. Um manifesto do aplicativo é criado no novo formato com valores padrão.

  4. Examine cada atributo no manifesto do aplicativo formatado do Azure AD Graph, um por um, e edite o atributo correspondente no manifesto do aplicativo formatado do Microsoft Graph para corresponder ao seu valor.

    1. Se o atributo estiver listado em Diferenças de atributo entre o manifesto do Azure AD Graph e o manifesto do Microsoft Graph, você precisará entender a sintaxe e a semântica dos atributos antigos e novos para poder editar com êxito o valor do novo atributo no manifesto do aplicativo Microsoft Graph.

    2. Se o atributo não estiver listado em Diferenças de atributo entre o manifesto do Azure AD Graph e o manifesto do Microsoft Graph, mas você não conseguir encontrar um atributo correspondente no manifesto do aplicativo Microsoft Graph, é provável que esse atributo tenha sido preterido e você poderá descartá-lo.

    3. Para todos os outros atributos, você pode copiar o valor do atributo no manifesto do aplicativo Azure AD Graph e colá-lo no valor do atributo no manifesto do aplicativo Microsoft Graph.

Próximos passos

Saiba mais sobre o manifesto do aplicativo (formato Microsoft Graph)