Migración de la funcionalidad de notificaciones de inserción
Este tema contiene instrucciones de migración en el área de características de notificaciones de inserción.
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 | UWP | SDK para aplicaciones de Windows |
|---|---|---|
| Identidad | Centro de partners (MSA) | registro de App 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 login.live.com punto de conexión para recibir un token de acceso | Usa el punto de conexión para la https://login.microsoftonline.com/{tenantID}/oauth2/token 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 característica de notificaciones push usa la identidad del registro de App de Azure (AAD), que elimina el requisito de tener un nombre de familia de paquetes (PFN) del Centro de partners para poder usar notificaciones push.
- Para una aplicación para UWP, registras y registras la aplicación en el Centro de partners de la Tienda Windows.
- Para una aplicación de SDK de Aplicaciones para Windows, cree una cuenta de Azure y cree un registro de App de Azure (AAD).
Solicitudes de canal
La solicitud de canal se controla de forma asincrónica y requieren el GUID de App de Azure ID y el identificador de inquilino de Azure (recibirá el identificador de inquilino y el identificador de App de Azure ID de un registro de aplicación de AAD). Usas el App de Azure ID de tu identidad en lugar del nombre de familia de paquete (PFN) que usa una aplicación para UWP. En caso de que la solicitud se produzca un error reintentos, la plataforma de notificaciones intentará varios reintentos.
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/
HTTP Post to WNS
Cuando se trata de enviar una solicitud HTTP POST a WNS, no hay ningún cambio de UWP. El token de acceso todavía se pasa 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" }
