Administrar permisos API y registro de aplicación para las notificaciones de Microsoft Graph (en desuso)

Importante

La API de notificaciones de Microsoft Graph está en desuso y dejará de devolver datos a finales de enero de 2022. Para obtener una experiencia de notificación alternativa, consulte Microsoft Azure Notification Hubs. Para obtener más información, consulte la entrada de blog Retirada de la API de notificaciones de Microsoft Graph (beta).

Para que el servicio de aplicaciones se integre con las notificaciones de Microsoft Graph, debe registrar la aplicación con la Plataforma de identidad de Microsoft para desarrolladores para admitir cuentas de Microsoft o cuentas profesionales o educativas, y declarar los permisos API que se necesiten.

Registrar la aplicación para admitir cuentas de Microsoft o cuentas profesionales y educativas

Registre la aplicación en el Centro de administración Microsoft Entra para admitir cuentas de Microsoft o cuentas profesionales o educativas. Si ha registrado previamente la aplicación en el Portal de aplicaciones de Microsoft, las aplicaciones existentes se mostrarán en la página registros de aplicaciones.

Para saber cómo registrar aplicaciones, vea Registrar una aplicación con la Plataforma de identidad de Microsoft para desarrolladores. Al registrar la aplicación, asegúrese de tener a mano el Id. de cliente o de aplicación. Va a necesitar este identificador más adelante al registrar la aplicación en experiencias en varios dispositivos en el Centro de partners para clientes Windows, Android o iOS.

Nota:

Si todavía no tiene una cuenta de Microsoft y le gustaría hacerse una, vaya a la página Cuenta de Microsoft. Si va a escribir una aplicación que necesita usar Azure AD v1.0 como marco de autenticación e identidad para cuentas profesionales o educativas, consulte Biblioteca de autenticación de Azure Active Directory (ADAL). Si está interesado en conocer o usar el nuevo Plataforma de identidad de Microsoft convergente (v2.0), consulte ¿Cuál es el Plataforma de identidad de Microsoft?.

Secretos y certificados de aplicación

Para permitir que la aplicación se identifique y autentique al obtener tokens de autenticación, puede cargar su propio certificado o crear un nuevo secreto de cliente en Certificados & secretos en la página registros de aplicaciones de Centro de administración Microsoft Entra.

Captura de pantalla de los certificados y secretos de la aplicación en el Centro de administración Microsoft Entra

Nota:

Si decide crear un nuevo secreto de cliente, asegúrese de copiar y guardarlo en un lugar seguro. No podrá acceder a ella de nuevo después de salir del portal.

Permisos API

Necesitará agregar permisos adicionales para poder usar las notificaciones de Microsoft Graph. Elija Agregar un permiso y, en las API de Microsoft, seleccione Microsoft Graph y, después, seleccione Permisos delegados.

Captura de pantalla de la página Solicitar permisos de API del Centro de administración Microsoft Entra

Agregue los permisos siguientes:

  • User.Read: permite el inicio de sesión del usuario en la aplicación

  • UserActivity.ReadWrite.CreatedByApp: permite la suscripción de la aplicación para la recuperación de notificaciones

Captura de pantalla que muestra los permisos delegados para las notificaciones en el Centro de administración Microsoft Entra

Pasos siguientes

Obtenga más información sobre permisos y consentimientos o vea la referencia de permisos de Microsoft Graph.

Ahora que ha registrado la aplicación, visite el Centro de partners para configurar la aplicación y dirigirse a las plataformas de aplicaciones correspondientes (Windows, iOS o Android) para recibir notificaciones enviadas a través de Microsoft Graph. Para obtener más información, vea Incorporación a experiencias en varios dispositivos.

Nota:

Si solo tiene como destino puntos de conexión web, puede omitir el registro del Centro de partners y a prender a configurar el servicio de aplicaciones para enviar notificaciones.