Compartilhar via

Preterimento do manifesto do aplicativo (formato do Azure AD Graph)

  • Artigo

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

Importante

Os aplicativos registrados com sua conta pessoal da Microsoft (conta MSA) não estão no escopo dessa substituição. Os aplicativos registrados com sua conta MSA pessoal continuarão a gerenciar manifestos de aplicativo no formato Azure AD Graph no centro de administração do Microsoft Entra até outras alterações acontecerem.

Data da migração

De 13 de junho a 16 de setembro de 2024, a página de manifesto de registros de aplicativo no centro de administração do Microsoft Entra lançou uma nova experiência com guias que permite exibir, editar, fazer upload 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 lançada para usuários do Microsoft Entra em lotes para garantir a qualidade de sua experiência. Talvez você não veja a nova experiência imediatamente.

A partir de 7 de janeiro de 2025, você não poderá mais exibir, salvar, fazer upload ou baixar o manifesto do aplicativo Azure AD Graph na página de manifesto de registros de aplicativo no centro de administração do Microsoft Entra.

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

Se você não exibe, edita ou salva manifestos do aplicativo, essa migração não afetará seu fluxo de trabalho.

Se você exibir ou editar manifestos do aplicativo, perceberá 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 o fluxo de trabalho exigir que você salve os manifestos no repositório de origem para uso posterior, será necessário converter um manifesto do aplicativo do 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 do Azure AD Graph permanece sem alterações. No entanto, os seguintes atributos de manifesto do aplicativo do 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 a propriedade acceptMappedClaims do atributo api
accessTokenAcceptedVersion Realocado e renomeado como a propriedade requestedAccessTokenVersion do atributo api
allowPublicClient Renomeado como isFallbackPublicClient
errorUrl Preterido/sem suporte mais
informationalUrls Renomeado como info
knownClientApplications Realocado como uma propriedade do atributo api
logoUrl Realocado como uma propriedade do atributo info
logoutUrl Realocado como a propriedade logoutUrl do atributo web
name displayName
oauth2AllowIdTokenImplicitFlow Realocado e renomeado como a propriedade enableAccessTokenIssuance da propriedade enableIdTokenIssuance no atributo web
oauth2AllowImplicitFlow Realocado e renomeado como a propriedade enableAccessTokenIssuance da propriedade implicitGrantSettings no atributo web
oauth2Permissions Realocado e renomeado como a propriedade oauth2PermissionScopes do atributo api
preAuthorizedApplications Realocado como a propriedade preAuthorizedApplications do atributo api
replyUrlsWithType Renomeado como a propriedade redirectUris em vários atributos: atributo web, atributo spa e atributo publicClient
signInUrl Realocado e renomeado como a propriedade homePageUrl do atributo web
trustedCertificateSubjects Essa é uma propriedade interna da Microsoft. O portal mostra a versão v1.0 do manifesto do aplicativo do MS Graph, enquanto essa propriedade está presente apenas na versão beta do manifesto do aplicativo do MS Graph. Continue editando essa propriedade usando o manifesto do aplicativo do Azure AD Graph no centro de administração do Microsoft Entra. Vamos expor a versão beta do manifesto do aplicativo do MS Graph no centro de administração do Microsoft Entra antes de substituir o manifesto do aplicativo do Azure AD Graph

Como saber qual é o formato do manifesto do meu aplicativo?

Você consegue saber se um manifesto do 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 do aplicativo tiver o atributo implicitGrantSettings, ele estará no formato do Microsoft Graph.

Converter um manifesto do aplicativo no formato do Azure AD Graph para o formato do 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 do aplicativo no formato Azure AD Graph para o formato Microsoft:

  1. Faça login no Centro de administração do Microsoft Entra como pelo menos um Desenvolvedor de aplicativos.

  2. Navegue até Identidade>Aplicativos>Registros do aplicativo.

  3. Selecione Novo registro e crie um 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 do manifesto do aplicativo Microsoft Graph.

  7. Selecione Baixar.

A partir de 7 de janeiro de 2025, o centro de administração do Microsoft Entra não dará mais suporte a manifestos do aplicativo no formato Azure AD Graph. No entanto, você pode realizar a conversão manualmente.

  1. Navegue até Identidade>Aplicativos>Registros do aplicativo.

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

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

  4. Percorra por cada atributo no manifesto do aplicativo formatado do Azure AD Graph, um a 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 do 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 do 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 do Azure AD Graph e colá-lo no valor do atributo no manifesto do aplicativo do Microsoft Graph.

Próximas etapas

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