Compartir vía


Desuso de manifiesto de aplicación (formato de Azure AD Graph)

Después del desuso de Azure AD Graph, el formato de Azure AD Graph de los manifiestos de aplicación está en desuso y el Centro de administración de Microsoft Entra muestra manifiestos de aplicación en formato Microsoft Graph. Lee este artículo para obtener más información sobre cómo afecta la migración del manifiesto de aplicación a la experiencia del usuario.

Importante

Las aplicaciones registradas con tu cuenta personal de Microsoft (cuenta de MSA) no están en el ámbito de este desuso. Las aplicaciones registradas con tu cuenta de MSA personal seguirán administrando manifiestos de aplicación en el formato de Azure AD Graph en el Centro de administración de Microsoft Entra hasta nuevo aviso.

Fecha de migración

Del 13 de junio al 16 de septiembre de 2024, la página de manifiesto Registros de aplicaciones del Centro de administración Microsoft Entra inició una nueva experiencia con pestañas que te permiten ver, editar, cargar y descargar el manifiesto de la aplicación tanto en formato de Azure AD Graph como en formato de Microsoft Graph.

Importante

La nueva experiencia con pestañas se está implementando para los usuarios de Microsoft Entra en lotes para garantizar la calidad de tu experiencia. Es posible que no veas la nueva experiencia inmediatamente.

A partir del 7 de enero de 2025, no podrás ver, guardar, cargar ni descargar el manifiesto de aplicación de Azure AD Graph en la página de manifiesto Registros de aplicaciones del Centro de administración Microsoft Entra.

¿Cómo afecta la migración del manifiesto de aplicación a la experiencia del usuario?

Si no ves, editas ni guardas manifiestos de aplicación, esta migración no afecta al flujo de trabajo.

Si ves o editas manifiestos de aplicación, observas las diferencias de atributo entre el formato de Azure AD Graph y el formato de Microsoft Graph. Te recomendamos que empieces a ver y editar manifiestos de aplicación siguiendo la Referencia de formato de Microsoft Graph.

Si tu flujo de trabajo requiere que guardes los manifiestos en tu repositorio de origen para usarlos más adelante, necesitas convertir un manifiesto de aplicación en formato de Azure AD Graph a formato de Microsoft Graph.

Diferencias de atributos entre los formatos de Azure AD Graph y Microsoft Graph

La mayoría de los atributos del manifiesto de aplicación de Azure AD Graph permanecen iguales. Sin embargo, los siguientes atributos de manifiesto de aplicación de Azure AD Graph han quedado en desuso, se han cambiado el nombre o se han reubicado en el manifiesto de Microsoft Graph.

Atributo de manifiesto de Azure AD Manifiesto de Microsoft Graph
acceptMappedClaims Reubicado como propiedad acceptMappedClaims del atributo api
accessTokenAcceptedVersion Reubicado y cambiado de nombre como propiedad requestedAccessTokenVersion del atributo api
allowPublicClient Se ha cambiado el nombre a isFallbackPublicClient
errorUrl En desuso/ya es compatible
informationalUrls Se ha cambiado el nombre a info
knownClientApplications Reubicado como una propiedad del atributo api
logoUrl Reubicado como una propiedad del atributo info
logoutUrl Reubicado como propiedad logoutUrl del atributo web
name displayName
oauth2AllowIdTokenImplicitFlow Reubicado y cambiado de nombre como propiedad enableAccessTokenIssuance de la propiedad enableIdTokenIssuance en el atributo web
oauth2AllowImplicitFlow Reubicado y cambiado de nombre como propiedad enableAccessTokenIssuance de la propiedad implicitGrantSettings en el atributo web
oauth2Permissions Reubicado y cambiado de nombre como propiedad oauth2PermissionScopes del atributo api
preAuthorizedApplications Reubicado como propiedad preAuthorizedApplications del atributo api
replyUrlsWithType Cambiado el nombre como propiedad redirectUris en varios atributos: atributo web, atributo spa, atributo publicClient
signInUrl Reubicado y cambiado de nombre como propiedad homePageUrl del atributo web
trustedCertificateSubjects Se trata de una propiedad interna de Microsoft. El portal muestra la versión v1.0 del manifiesto de aplicación de MS Graph, mientras que esta propiedad solo está presente en la versión beta del manifiesto de la aplicación de MS Graph. Sigue editando esta propiedad mediante el manifiesto de la aplicación de Graph de Azure AD en Centro de administración Microsoft Entra. Expondremos la versión beta del manifiesto de aplicación de MS Graph en el Centro de administración Microsoft Entra antes de dejar de usar el manifiesto de aplicación de Azure AD Graph

¿Cómo puedo saber el formato del manifiesto de mi aplicación?

Puedes saber si un manifiesto de aplicación es de formato de Azure AD Graph o de Microsoft Graph por los atributos que contiene. Por ejemplo,

  • Si un manifiesto de aplicación tiene el atributo replyUrlsWithType, se encuentra en formato de Azure AD Graph.

  • Si un manifiesto de aplicación tiene el atributo implicitGrantSettings, está en formato Microsoft Graph.

Conversión de un manifiesto de aplicación en formato de Azure AD Graph al formato de Microsoft Graph

Si has almacenado un manifiesto de aplicación en formato de Azure AD Graph y quieres convertirlo al formato de Microsoft Graph:

Entre el 13 de junio de 2024 y el 7 de enero de 2025, puedes seguir los pasos que se indican a continuación y usar el portal para convertir un manifiesto de aplicación en formato de Azure AD Graph a formato de Microsoft:

  1. Inicie sesión en el Centro de administración de Microsoft Entra al menos como Desarrollador de aplicaciones.

  2. Vaya aIdentidad>Aplicaciones>Registros de aplicaciones.

  3. Selecciona Nuevo registro y crea un nuevo registro de aplicación.

  4. En la página Manifiesto de esa aplicación, selecciona la pestaña Manifiesto de aplicación de Azure AD Graph.

  5. Carga el manifiesto de aplicación en formato de Azure AD Graph que tengas.

  6. Selecciona la pestaña Manifiesto de aplicación de Microsoft Graph.

  7. Selecciona Descargar.

A partir del 7 de enero de 2025, el Centro de administración de Microsoft Entra ya no admitirá manifiestos de aplicación en formato de Azure AD Graph. Sin embargo, puedes realizar la conversión manualmente.

  1. Vaya aIdentidad>Aplicaciones>Registros de aplicaciones.

  2. Selecciona Nuevo registro y crea un nuevo registro de aplicación.

  3. Se crea un manifiesto de aplicación en el nuevo formato con valores predeterminados.

  4. Recorre cada atributo del manifiesto de aplicación con formato de Azure AD Graph uno por uno y edita el atributo correspondiente en el manifiesto de aplicación con formato de Microsoft Graph para que coincida con su valor.

    1. Si el atributo aparece en Diferencias de atributos entre el manifiesto de Azure AD Graph y el manifiesto de Microsoft Graph, debes comprender la sintaxis y la semántica de los atributos antiguos y nuevos para poder editar correctamente el valor del nuevo atributo en el manifiesto de la aplicación de Microsoft Graph.

    2. Si el atributo no aparece en Diferencias de atributo entre el manifiesto de Azure AD Graph y el manifiesto de Microsoft Graph, pero no puedes encontrar un atributo correspondiente en el manifiesto de la aplicación de Microsoft Graph, es probable que este atributo haya quedado en desuso y puedes descartar este atributo.

    3. Para todos los demás atributos, puedes copiar el valor del atributo en el manifiesto de la aplicación de Azure AD Graph y pegarlo en el valor del atributo en el manifiesto de la aplicación de Microsoft Graph.

Pasos siguientes

Más información sobre el Manifiesto de aplicación (formato de Microsoft Graph)