Integrazione dei token dei dispositivi con Amazon SNS per le notifiche mobili - Amazon Simple Notification Service

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Integrazione dei token dei dispositivi con Amazon SNS per le notifiche mobili

Quando registri per la prima volta un'app e un dispositivo mobile con un servizio di notifica, come Apple Push Notification Service (APNs) e Firebase Cloud Messaging (FCM), i token del dispositivo o la registrazione IDs vengono restituiti dal servizio di notifica. Quando aggiungi i token del dispositivo o la registrazione IDs ad AmazonSNS, vengono utilizzati con il PlatformApplicationArn API per creare un endpoint per l'app e il dispositivo. Quando Amazon SNS crea l'endpoint, EndpointArn viene restituito un. In EndpointArn questo modo Amazon SNS sa a quale app e dispositivo mobile inviare il messaggio di notifica.

Puoi aggiungere i token del dispositivo e la registrazione IDs ad Amazon SNS utilizzando i seguenti metodi:

  • Aggiungi manualmente un singolo token all' AWS utilizzo di AWS Management Console

  • Carica diversi token utilizzando il CreatePlatformEndpoint API

  • Registrazione di token dai dispositivi che installeranno le tue app in futuro

Per aggiungere manualmente un token di dispositivo o un ID di registrazione

  1. Accedi alla SNSconsole Amazon.

  2. Nel riquadro di navigazione, scegli Notifiche push.

  3. Nella sezione Applicazioni della piattaforma, seleziona l'applicazione, quindi scegli Modifica. Se non hai già creato un'applicazione di piattaforma, creane una ora. Per istruzioni su come eseguire questa operazione, consultare Creazione di un'applicazione SNS della piattaforma Amazon.

  4. Scegli Add endpoints.

  5. Nella casella Endpoint Token (Token di endpoint), immetti l'ID del token o l'ID di registrazione, a seconda del servizio di notifica. Ad esempio, con ADM e FCM inserisci l'ID di registrazione.

  6. (Opzionale) Nella casella User Data (Dati utente), immetti le informazioni arbitrarie da associare all'endpoint. Amazon SNS non utilizza questi dati. I dati devono essere in formato UTF -8 e inferiori a 2 KB.

  7. Scegli Add endpoints.

    Con l'endpoint creato, è possibile inviare messaggi direttamente a un dispositivo mobile o inviare messaggi a dispositivi mobili abbonati a un argomento.

Per caricare diversi token utilizzando il CreatePlatformEndpoint API

I passaggi seguenti mostrano come utilizzare l'app Java di esempio (bulkuploadpacchetto) fornita da AWS per caricare diversi token (token del dispositivo o registrazioneIDs) su Amazon. SNS Puoi usare questa app di esempio per iniziare a caricare i token esistenti.

Nota

I passaggi seguenti utilizzano Eclipse Java. IDE I passaggi presuppongono che tu abbia installato AWS SDK for Java e che tu disponga delle credenziali AWS di sicurezza per il tuo. Account AWS Per ulteriori informazioni, consulta AWS SDK for Java. Per ulteriori informazioni sulle credenziali, consulta Come ottenere le credenziali di sicurezza? in Riferimenti generali di AWS.

  1. Download e decomprimi il file snsmobilepush.zip.

  2. Crea un nuovo Progetto Java in Eclipse.

  3. Importa la cartella SNSSamples nella directory di primo livello del progetto Java appena creato. In Eclipse, fai clic con il pulsante destro del mouse sul nome del progetto Java e scegli Import (Importa), espandi General (Generale), scegli File System e quindi scegli Next (Avanti). Seleziona la cartella SNSSamples, scegli OK e quindi Finish (Termina).

  4. Scarica una copia della CSVlibreria Open e aggiungila al Build Path del bulkupload pacchetto.

  5. Apri il file BulkUpload.properties contenuto nel pacchetto bulkupload.

  6. Aggiungi i seguenti elementi a BulkUpload.properties:

    • L'ApplicationArn a cui desideri aggiungere gli endpoint.

    • Il percorso assoluto per la posizione del CSV file contenente i token.

    • I nomi dei CSV file (come goodTokens.csv ebadTokens.csv) da creare per registrare i token che Amazon SNS analizza correttamente e quelli che falliscono.

    • (Facoltativo) I caratteri per specificare il delimitatore e la citazione nel file contenente i CSV token.

    • (Opzionale) Il numero di thread da utilizzare per creare gli endpoint contemporaneamente. Il valore predefinito è 1 thread.

    L'elemento BulkUpload.properties completato si presenta in maniera analoga a quanto segue:

    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. Esegui l' BatchCreatePlatformEndpointSampleapplicazione.java per caricare i token su Amazon. SNS

    In questo esempio, gli endpoint creati per i token che sono stati caricati correttamente su Amazon SNS verrebbero registratigoodTokens.csv, mentre i token con formato errato verrebbero registrati. badTokens.csv Inoltre, dovresti vedere STD OUT i log scritti sulla console di Eclipse, contenenti contenuti simili ai seguenti: 

    <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
Per registrare i token dai dispositivi che installeranno le tue app in futuro

Puoi utilizzare una delle seguenti due opzioni:

  • Usa il servizio Amazon Cognito: la tua app mobile avrà bisogno di credenziali per creare endpoint associati alla tua applicazione della piattaforma Amazon. SNS Consigliamo di utilizzare credenziali temporanee che scadono dopo un periodo di tempo. Per la maggior parte degli scenari, ti consigliamo di utilizzare Amazon Cognito per creare credenziali di sicurezza temporanee. Per ulteriori informazioni, consulta la Guida per sviluppatori di Amazon Cognito . Se desideri ricevere una notifica quando un'app si registra su AmazonSNS, puoi registrarti per ricevere un SNS evento Amazon che fornirà il nuovo endpointARN. Puoi anche utilizzare il ListEndpointByPlatformApplication API per ottenere l'elenco completo degli endpoint registrati con AmazonSNS.

  • Usa un server proxy: se la tua infrastruttura applicativa è già configurata per le tue app mobili per effettuare chiamate e registrarti in ogni installazione, puoi continuare a utilizzare questa configurazione. Il tuo server fungerà da proxy e passerà il token del dispositivo alle notifiche push di Amazon per SNS dispositivi mobili, insieme a tutti i dati utente che desideri archiviare. A tal fine, il server proxy si connetterà ad Amazon SNS utilizzando AWS le tue credenziali e utilizzerà la CreatePlatformEndpoint API chiamata per caricare le informazioni sul token. Verrà restituito l'endpoint Amazon Resource Name (ARN) appena creato, che il server può archiviare per effettuare successive chiamate di pubblicazione ad AmazonSNS.