Agregar tokens de dispositivo o ID de registro - 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.

Agregar tokens de dispositivo o ID de registro

Cuando registre por primera vez una aplicación y un dispositivo móvil en un servicio de notificaciones como el Servicio de notificaciones de inserción (APNs) de Apple y la mensajería en la nube de Firebase (FCM), el servicio de notificaciones devuelve un token de dispositivo o ID de registro. Cuando añade los tokens de dispositivo o los ID de registro a Amazon SNS, estos se utilizan con laPlatformApplicationArnpara crear un punto de enlace para la aplicación y el dispositivo. Cuando Amazon SNS crea el punto de enlace, seEndpointArnSe devuelve. LaEndpointArnEl indica Amazon SNS aplicación y a qué dispositivo móvil debe enviar el mensaje de notificación.

Puede añadir tokens de dispositivo e ID de registro a Amazon SNS utilizando los métodos siguientes:

  • Añadiendo manualmente un token único a AWS con la AWS Management Console.

  • Migrando los tokens existentes de un archivo CSV a AWS con la AWS Management Console.

  • Cargando varios tokens utilizando la API CreatePlatformEndpoint.

  • 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. Inicie sesión en laConsola de Amazon SNS.

  2. Elija Apps (Aplicaciones), elija la aplicación y, a continuación, Add Endpoints (Añadir puntos de enlace).

  3. 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 y FCM debe escribir el ID de registro.

  4. (Opcional) En elUser Data (Datos de usuario), escriba información arbitraria para asociarla al punto de enlace. Amazon SNS is not use estos datos. Los datos deben estar en formato UTF-8 y tener menos de 2 KB.

  5. Por último, elija Add Endpoints (Añadir puntos de enlace).

    Ahora, con el punto de enlace 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 migrar los tokens existentes de un archivo CSV a AWS

Puede migrar los tokens existentes contenidos en un archivo CSV. El archivo CSV no debe tener más de 2 MB. Cuando migre varios tokens, se recomienda utilizar la API CreatePlatformEndpoint. Cada uno de los tokens del archivo CSV debe ir seguido de una nueva línea. Por ejemplo, el archivo CSV ha de tener un aspecto similar al siguiente:

amzn1.adm-registration.v1.XpvSSUk0Rc3hTVVV--TOKEN--KMTlmMWxwRkxMaDNST2luZz01,"User data with spaces requires quotes" amzn1.adm-registration.v1.XpvSSUk0Rc3hTVVV--TOKEN--KMTlmMWxwRkxMaDNST2luZz04,"Data,with,commas,requires,quotes" amzn1.adm-registration.v1.XpvSSUk0Rc3hTVVV--TOKEN--KMTlmMWxwRkxMaDNST2luZz02,"Quoted data requires ""escaped"" quotes" amzn1.adm-registration.v1.XpvSSUk0Rc3hTVVV--TOKEN--KMTlmMWxwRkxMaDNST2luZz03,"{""key"": ""json is allowed"", ""value"":""endpoint"", ""number"": 1}" amzn1.adm-registration.v1.XpvSSUk0Rc3hTVVV--TOKEN--KMTlmMWxwRkxMaDNST2luZz05,SimpleDataNoQuotes amzn1.adm-registration.v1.XpvSSUk0Rc3hTVVV--TOKEN--KMTlmMWxwRkxMaDNST2luZz06,"The following line has no user data" amzn1.adm-registration.v1.XpvSSUk0Rc3hTVVV--TOKEN--KMTlmMWxwRkxMaDNST2luZz07 APBTKzPGlCyT6E6oOfpdwLpcRNxQp5vCPFiFeru9oZylc22HvZSwQTDgmmw9WdNlXMerUPxmpX0w1,"Different token style"
  1. Inicie sesión en laConsola de Amazon SNS.

  2. Elija Apps (Aplicaciones), elija la aplicación y, a continuación, Add Endpoints (Añadir puntos de enlace).

  3. SeleccionarMigrar tokens existentes aAWS, elijaElija Archivo, elija su archivo CSV y, a continuación, elijaAgregar puntos finales.

Para cargar varios tokens utilizando la API CreatePlatformEndpoint.

Los siguientes pasos muestran cómo utilizar la aplicación Java de muestra (bulkuploadpaquete) proporcionado porAWSPara cargar varios tokens (tokens de dispositivo o ID de registro) 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. Los pasos suponen que ha instalado elAWS SDK for Javay tiene laAWScredenciales de seguridad para su Cuenta de AWS . Para obtener más información, consulte AWS SDK for Java. Para obtener más información acerca de las credenciales, consulte¿Cómo obtengo credenciales de seguridad?en laAWSReferencia general de.

  1. Descargue y descomprima el archivo snsmobilepush.zip.

  2. Cree un proyecto de Java nuevo 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 biblioteca OpenCSV y añádala a la ruta de compilación del paquete bulkupload.

  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 completa de la ubicación del archivo CSV que contiene los tokens.

    • Los nombres de los archivos CSV (comogoodTokens.csvybadTokens.csv) que debe crearse para registrar los tokens que Amazon SNS analiza correctamente y los que no funcionan.

    • (Opcional) Los caracteres para especificar el delimitador y citar en el archivo CSV 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. Ejecute la aplicación BatchCreatePlatformEndpointSample.java para cargar los tokens en Amazon SNS.

    En este ejemplo los puntos de enlace que se han creado para los tokens que se han cargado correctamente en Amazon SNS se registran engoodTokens.csv, mientras que los tokens mal formados se registrarían enbadTokens.csv. Además, debe ver los logs STD OUT escritos en la consola de Eclipse, que tiene 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 Amazon SNS. 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 desea recibir una notificación cada vez que se inscriba una aplicación en Amazon SNS, puede registrarse para recibir un evento de Amazon SNS que le proporcionará el ARN del nuevo punto de enlace. También puede utilizar laListEndpointByPlatformApplicationPara obtener la lista completa de puntos de enlace registrados en Amazon SNS.

  • 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. Su servidor se comportará como un proxy y transmitirá el token de dispositivo a las notificaciones de inserción en móvil de Amazon SNS, así como los datos de usuario que desee almacenar. Para ello, el servidor proxy se conectará a Amazon SNS utilizando suAWSy utilice elCreatePlatformEndpointAPI para cargar la información del token. Se devuelve el nombre de recurso de Amazon (ARN) del punto de enlace que acaba de crear, y su servidor puede almacenarlo para realizar llamadas públicas a Amazon SNS más tarde.