Migración de la funcionalidad de notificaciones de inserción

Este tema contiene instrucciones de migración en la funcionalidad de notificaciones push.

Importante

Actualmente solo se admiten las notificaciones push sin procesar y las notificaciones push de aplicaciones. No se admiten las notificaciones push de distintivos ni las notificaciones push de icono.

Resumen de las API y/o diferencias en las características

Las notificaciones push se pueden dividir en estas cuatro fases independientes.

Fase Plataforma Universal de Windows (UWP) SDK para aplicaciones de Windows
Identidad Centro de partners (MSA) Registro de Aplicación de Azure (AAD)
Solicitud de canal Asincrónica Asincrónica
Id. de registro de App de Azure
Lógica de reintento integrada (hasta 5 reintentos)
Activación En proceso, PushTrigger*, activación COM* Activación COM en proceso, ShellExecute
Envío de notificaciones push Usa el punto de acceso login.live.com para recibir un token de acceso Usa el https://login.microsoftonline.com/{tenantID}/oauth2/token punto de conexión para la solicitud de token

* Compatible con Windows 10, versión 2004 (10.0; Compilación 19041) y versiones posteriores.

Configuración de identidad

En el SDK de Aplicaciones para Windows, la funcionalidad de notificaciones push utiliza la identidad del Registro de aplicaciones de Azure (AAD), lo que elimina el requisito de tener un Nombre de Familia de Paquetes (PFN) del Centro de Partners para poder utilizar notificaciones push.

Solicitudes de canal

La solicitud de canal se controla de forma asincrónica y requiere el GUID del AppID de Azure y el ID de inquilino de Azure (recibirá el AppID de Azure y el ID de inquilino de un registro de aplicación en AAD). Usas el ID de aplicación de Azure para tu identidad en lugar del Nombre de Familia del Paquete (PFN) que usa una aplicación UWP. En caso de que la solicitud encuentre un error que se pueda reintentar, la plataforma de notificaciones realizará varios intentos.

Una aplicación SDK de Aplicaciones para Windows puede comprobar el estado de una solicitud de canal.

Activación

Consulta los pasos de registro y activación de SDK de Aplicaciones para Windows en Configuración de la aplicación para recibir notificaciones push.

Envío de notificaciones push

Una aplicación SDK de Aplicaciones para Windows debe solicitar el token de acceso desde el punto de conexión de AAD, en lugar del punto de conexión de MSA.

Solicitud de token de acceso

Para una aplicación para UWP:

POST /accesstoken.srf HTTP/1.1
Host: login.live.com
Content-Type: application/x-www-form-urlencoded
Cookie: MSCC=73.140.231.96-US
Content-Length: 112

grant_type=client_credentials&client_id=<AppID_Here>&client_secret=<Client_Secret_Here>&scope=notify.windows.com

Para una aplicación de SDK de Aplicaciones para Windows (solicitud de token de acceso de AAD):

POST /{tenantID}/oauth2/v2.0/token Http/1.1
Host: login.microsoftonline.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 160

grant_type=client_credentials&client_id=<Azure_App_Registration_AppId_Here>&client_secret=<Azure_App_Registration_Secret_Here>&resource=https://wns.windows.com/

publicar HTTP en WNS

Cuando se trata de enviar una solicitud HTTP POST a WNS, no hay ningún cambio de UWP. Todavía se pasa el token de acceso en el encabezado de autorización.

POST /?token=[ChannelURI] HTTP/1.1
Host: dm3p.notify.windows.com
Content-Type: application/octet-stream
X-WNS-Type: wns/raw
Authorization: Bearer [your access token]
Content-Length: 46

{ Sync: "Hello from the Contoso App Service" }

Consulte también

  • Last updated on