

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
<a name="mobile-push-send-devicetoken"></a>

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 [https://docs.aws.amazon.com/sns/latest/api/API_PlatformApplication.html](https://docs.aws.amazon.com/sns/latest/api/API_PlatformApplication.html)API. Una vez creado el punto de conexión, se devuelve un [https://docs.aws.amazon.com/sns/latest/api/API_Endpoint.html](https://docs.aws.amazon.com/sns/latest/api/API_Endpoint.html), 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 [https://docs.aws.amazon.com/sns/latest/api/API_CreatePlatformEndpoint.html](https://docs.aws.amazon.com/sns/latest/api/API_CreatePlatformEndpoint.html)
+ 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](https://console.aws.amazon.com/sns/home).

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

1. 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](mobile-push-send-register.md) para hacerlo ahora.

1. Seleccione **Crear punto de conexión**.

1. 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).

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

1. 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 (`bulkupload`paquete) 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](https://aws.amazon.com/sdkforjava/). Para obtener más información sobre credenciales, consulte [Credenciales de seguridad de AWS](https://docs.aws.amazon.com/general/latest/gr/getting-aws-sec-creds.html) en la *Guía del usuario de IAM*. 

1. Descargue y descomprima el archivo [snsmobilepush.zip](samples/snsmobilepush.zip). 

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

1. Descargue la [Biblioteca OpenCSV](http://sourceforge.net/projects/opencsv/) y añádala a la ruta de compilación.

1. 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
   ```

1.  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](https://docs.aws.amazon.com/cognito/latest/developerguide/)*.   
Para realizar un seguimiento de los [registros](application-event-notifications.md) 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 [https://docs.aws.amazon.com/sns/latest/api/API_ListEndpointsByPlatformApplication.html](https://docs.aws.amazon.com/sns/latest/api/API_ListEndpointsByPlatformApplication.html) 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 [https://docs.aws.amazon.com/sns/latest/api/API_CreatePlatformEndpoint.html](https://docs.aws.amazon.com/sns/latest/api/API_CreatePlatformEndpoint.html).  
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.