Integración de tokens de dispositivo con Amazon SNS para las notificaciones móviles - Amazon Simple Notification Service

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Integración de tokens de dispositivo con Amazon SNS para las notificaciones móviles

La primera vez que registras una aplicación y un dispositivo móvil en un servicio de notificaciones, como el Servicio de Notificaciones Push de Apple (APNs) y Firebase Cloud Messaging (FCM), el servicio devuelve IDs los identificadores del dispositivo o el registro. Se tokens/IDs añaden a Amazon SNS para crear un punto final para la aplicación y el dispositivo mediante la PlatformApplicationArnAPI. Una vez creado el punto de conexión, se devuelve un EndpointArn, que Amazon SNS utiliza para dirigir las notificaciones a la aplicación o dispositivo correctos.

Puede añadir los identificadores de dispositivo o el registro IDs a Amazon SNS de las siguientes maneras:

  • Añada manualmente un único token a través del Consola de administración de AWS

  • Cargue varios tokens utilizando la API CreatePlatformEndpoint

  • Registre los tokens para dispositivos futuros

Para añadir manualmente un identificador de dispositivo o un identificador de registro
  1. Inicie sesión en la consola de Amazon SNS.

  2. En el panel de navegación, seleccione Notificaciones push.

  3. En la sección Aplicaciones de plataforma, seleccione la aplicación y, a continuación, elija Editar. Si aún no ha creado una aplicación de plataforma, siga la guía de Creación de una aplicación de plataforma de Amazon SNS para hacerlo ahora.

  4. Seleccione Crear punto de conexión.

  5. En el cuadro Token de punto de conexión, introduzca el token o el ID de registro, en función del servicio de notificaciones que utilice (por ejemplo, el ID de registro de FCM).

  6. (Opcional) Introduzca datos adicionales en el campo Datos de usuario. Estos datos deben estar codificados en UTF-8 y ocupar menos de 2 KB.

  7. Seleccione Crear punto de conexión.

Una vez creado el punto de conexión, puede enviar mensajes directamente al dispositivo móvil o a dispositivos móviles que estén suscritos a un tema de Amazon SNS.

Cómo cargar varios tokens utilizando la API CreatePlatformEndpoint

En los siguientes pasos se muestra cómo utilizar la aplicación Java (bulkuploadpaquete) de ejemplo proporcionada por AWS para cargar varios tokens (tokens de dispositivo o registro IDs) a Amazon SNS. Puede utilizar esta aplicación de muestra como ayuda para comenzar a cargar sus tokens.

nota

Los siguientes pasos utilizan el IDE de Eclipse Java. En los pasos se da por sentado que ha instalado AWS SDK para Java y dispone de las credenciales AWS de seguridad correspondientes. Cuenta de AWS Para obtener más información, consulte AWS SDK para Java. Para obtener más información sobre credenciales, consulte Credenciales de seguridad de AWS en la Guía del usuario de IAM.

  1. Descargue y descomprima el archivo snsmobilepush.zip.

  2. Cree un nuevo Proyecto de Java en Eclipse e importe la carpeta SNSSamples al proyecto.

  3. Descargue la Biblioteca OpenCSV y añádala a la ruta de compilación.

  4. En el archivo BulkUpload.properties, especifique lo siguiente:

    • Su ApplicationArn (ARN de la aplicación de plataforma).

    • La ruta completa del archivo CSV que contiene los tokens.

    • Nombres de los archivos de registro de los tokens correctos y fallidos. Por ejemplo, goodTokens.csv y badTokens.csv.

    • (Opcional) Una configuración para el delimitador, el carácter de comilla y el número de subprocesos que se van a utilizar.

    El BulkUpload.properties finalizado ha de tener un aspecto similar al siguiente:

    applicationarn: arn:aws:sns:us-west-2:111122223333:app/FCM/fcmpushapp csvfilename: C:\\mytokendirectory\\mytokens.csv goodfilename: C:\\mylogfiles\\goodtokens.csv badfilename: C:\\mylogfiles\\badtokens.csv delimiterchar: ',' quotechar: '"' numofthreads: 5
  5. Ejecute la aplicación BatchCreatePlatformEndpointSample.java para cargar los tokens en Amazon SNS. Los tokens que se carguen correctamente se registrarán en goodTokens.csv, mientras que los que tengan un formato incorrecto se registrarán en badTokens.csv.

Cómo registrar tokens de dispositivo para futuras instalaciones de aplicaciones

Dispone de dos opciones para realizar este proceso:

Uso del servicio de Amazon Cognito

Su aplicación móvil puede utilizar credenciales de seguridad temporales para crear puntos de conexión. Para generar credenciales temporales se recomienda utilizar Amazon Cognito. Para obtener más información, consulte la Guía para desarrolladores de Amazon Cognito.

Para realizar un seguimiento de los registros de aplicaciones, utilice los eventos de Amazon SNS para recibir notificaciones cuando se cree un nuevo ARNs punto final.

Como alternativa, puede utilizar la API ListEndpointByPlatformApplication para recuperar la lista de puntos de conexión registrados.

Uso de un servidor proxy

Si la infraestructura de la aplicación ya admite el registro de dispositivos en el momento de la instalación, puede usar el servidor como proxy. Reenviará los tokens de dispositivo a Amazon SNS a través de la API CreatePlatformEndpoint.

El ARN del punto de conexión creado por Amazon SNS se devolverá y el servidor podrá almacenarlo para la publicación de mensajes futuros.