Añadir fichas o registros de dispositivos IDs

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 de notificaciones devuelve IDs los identificadores o el registro del dispositivo. Cuando añades los tokens o el registro del dispositivo IDs a AmazonSNS, se utilizan con el PlatformApplicationArn API fin de crear un punto de conexión para la aplicación y el dispositivo. Cuando Amazon SNS crea el punto de conexión, EndpointArn se devuelve un. Así EndpointArn es como Amazon SNS sabe a qué aplicación y dispositivo móvil enviar el mensaje de notificación.

Puedes añadir los identificadores de dispositivos y el registro IDs a Amazon SNS mediante los siguientes métodos:

• Añade manualmente un único token para AWS usar el AWS Management Console

• Cargue varios tokens utilizando el CreatePlatformEndpoint API

• Registrando tokens de dispositivos que instalarán sus aplicaciones en el futuro.

Para añadir manualmente un token de dispositivo o ID de registro

1. Inicia sesión en la SNSconsola de Amazon.

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

3. En la sección Aplicaciones de plataforma, seleccione su aplicación y, a continuación, elija Editar. Si aún no ha creado una aplicación de plataforma, créela ahora. Para obtener instrucciones al respecto, consulte Creación de una aplicación de plataforma.

4. Elija Agregar puntos de conexión.

5. En el cuadro Endpoint Token (Token de punto de enlace), escriba el ID de token o el ID de registro, según el servicio de notificaciones. Por ejemplo, con ADM e FCM ingresas el ID de registro.

6. (Opcional) En el cuadro Datos de usuario, ingrese información arbitraria para asociarla al punto de enlace. Amazon SNS no utiliza estos datos. Los datos deben estar en formato UTF -8 y tener menos de 2 KB.

7. Elija Agregar puntos de conexión.

   Con el dispositivo de punto final creado, puede enviar mensajes directamente a un dispositivo móvil o enviar mensajes a dispositivos móviles que estén suscritos a un tema.

Para cargar varios tokens mediante el CreatePlatformEndpoint API

Los siguientes pasos muestran cómo utilizar la aplicación Java (bulkuploadpaquete) de ejemplo proporcionada por AWS para cargar varios tokens (tokens de dispositivo o registroIDs) a AmazonSNS. Puede utilizar esta aplicación de muestra como ayuda para comenzar a cargar sus tokens.

nota

En los siguientes pasos, se utiliza el Eclipse JavaIDE. En los pasos se da por sentado que ha instalado AWS SDK for Java y que dispone de las credenciales de AWS seguridad correspondientes Cuenta de AWS. Para obtener más información, consulte AWS SDK for Java. Para obtener más información sobre las credenciales, consulte ¿Cómo obtengo credenciales de seguridad? en la Referencia general de AWS.

1. Descargue y descomprima el archivo snsmobilepush.zip.

2. Cree un nuevo proyecto Java de en Eclipse.

3. Importe la carpeta SNSSamples al directorio superior del proyecto de Java que acaba de crear. En Eclipse, haga clic con el botón derecho en el nombre del proyecto de Java y, a continuación, elija Import (Importar), expanda General, elija File System (Sistema de archivos) y Next (Siguiente), vaya a la carpeta SNSSamples, elija OK (Aceptar) y, a continuación, Finish (Finalizar).

4. Descargue una copia de la CSVbiblioteca abierta y agréguela a la ruta de compilación del bulkupload paquete.

5. Abra el archivo BulkUpload.properties incluido en el paquete bulkupload.

6. Añada lo siguiente a BulkUpload.properties:

   • El ApplicationArn al que desea añadir puntos de enlace.

   • La ruta absoluta de la ubicación del CSV archivo que contiene los tokens.

   • Los nombres de los CSV archivos (como goodTokens.csv ybadTokens.csv) que se van a crear para registrar los tokens que Amazon SNS analiza correctamente y los que fallan.

   • (Opcional) Los caracteres para especificar el delimitador y las comillas del CSV archivo que contiene los tokens.

   • (Opcional) El número de subprocesos que deben utilizarse para crear puntos de enlace de forma simultánea. El valor predeterminado es 1 subproceso.

   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

7. Ejecuta la BatchCreatePlatformEndpointSample aplicación.java para subir los tokens a AmazonSNS.

   En este ejemplo, se registrarían los puntos de enlace que se crearon para los tokens que se cargaron correctamente en Amazon SNSgoodTokens.csv, mientras que los tokens con formato incorrecto se registrarían en ellos. badTokens.csv Además, deberías ver STD OUT los registros escritos en la consola de Eclipse con contenido similar al siguiente:

   <1>[SUCCESS] The endpoint was created with Arn arn:aws:sns:us-west-2:111122223333:app/FCM/fcmpushapp/165j2214-051z-3176-b586-138o3d420071
   <2>[ERROR: MALFORMED CSV FILE] Null token found in /mytokendirectory/mytokens.csv            

Para registrar tokens de dispositivos que instalarán sus aplicaciones en el futuro

Puede utilizar una de las dos opciones siguientes:

• Utilice el servicio Amazon Cognito: su aplicación móvil necesitará credenciales para crear puntos de enlace asociados a su aplicación de plataforma AmazonSNS. Le recomendamos que utilice credenciales temporales que venzan al cabo de un periodo de tiempo. Para la mayoría de las situaciones, le recomendamos que utilice Amazon Cognito para crear credenciales de seguridad temporales. Para obtener más información, consulte la Guía para desarrolladores de Amazon Cognito. Si quieres recibir una notificación cuando una aplicación se registre en AmazonSNS, puedes registrarte para recibir un SNS evento de Amazon que proporcionará el nuevo punto de conexiónARN. También puedes utilizar el ListEndpointByPlatformApplication API para obtener la lista completa de puntos de conexión registrados en AmazonSNS.

• Utilice un servidor proxy: si la infraestructura de la aplicación ya está configurada para que las aplicaciones móviles llamen y se registren en cada instalación, puede seguir utilizando esta configuración. Tu servidor actuará como proxy y pasará el token del dispositivo a las notificaciones push SNS móviles de Amazon, junto con cualquier dato de usuario que desees almacenar. Para ello, el servidor proxy se conectará a Amazon SNS con tus AWS credenciales y utilizará la CreatePlatformEndpoint API llamada para cargar la información del token. Se devolverá el nombre del recurso Amazon (ARN) del punto final recién creado, que su servidor podrá almacenar para realizar posteriores llamadas de publicación a AmazonSNS.