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. Questi tokens/IDs vengono aggiunti ad Amazon SNS per creare un endpoint per l'app e il dispositivo utilizzando l'API. PlatformApplicationArn Una volta creato l'endpoint, EndpointArnviene restituito un messaggio che Amazon SNS utilizza per indirizzare le notifiche all'app/dispositivo corretto.

Puoi aggiungere i token del dispositivo o la registrazione IDs ad Amazon SNS nei seguenti modi:

  • Aggiungi manualmente un singolo token tramite Console di gestione AWS

  • Caricamento di diversi token usando l'API CreatePlatformEndpoint

  • Registra i token per i dispositivi futuri

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

  1. Accedi alla console Amazon SNS.

  2. Nel riquadro di navigazione, seleziona Notifiche push.

  3. Nella sezione Applicazioni della piattaforma, seleziona l'applicazione, quindi scegli Modifica. Se non hai ancora creato un'applicazione di piattaforma, segui subito la Creazione di un'applicazione della piattaforma Amazon SNS guida per farlo.

  4. Scegliere Create Endpoint (Crea endpoint).

  5. Nella casella Endpoint Token, inserisci il token o l'ID di registrazione, a seconda del servizio di notifica che stai utilizzando (ad esempio, l'ID di registrazione FCM).

  6. (Facoltativo) Inserisci dati aggiuntivi nel campo Dati utente. Questi dati devono essere codificati in UTF-8 e avere dimensioni inferiori a 2 KB.

  7. Scegliere Create Endpoint (Crea endpoint).

Una volta creato l'endpoint, puoi inviare messaggi direttamente al dispositivo mobile o ai dispositivi mobili abbonati a un argomento di Amazon SNS.

Per caricare diversi token utilizzando l'API CreatePlatformEndpoint

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

Nota

Nei passaggi seguenti viene utilizzata l'IDE Java Eclipse. I passaggi presuppongono che tu abbia installato AWS SDK per Java e che tu disponga delle credenziali AWS di sicurezza per il tuo. Account AWS Per ulteriori informazioni, consulta AWS SDK per Java. Per ulteriori informazioni sulle credenziali, consulta le credenziali AWS di sicurezza nella Guida per l'utente IAM.

  1. Download e decomprimi il file snsmobilepush.zip.

  2. Crea un nuovo progetto Java in Eclipse e importa la SNSSamples cartella nel progetto.

  3. Scarica la libreria OpenCSV e aggiungila al percorso di compilazione.

  4. Nel BulkUpload.properties file, specifica quanto segue:

    • Il tuo ApplicationArn (ARN dell'applicazione della piattaforma).

    • Il percorso assoluto del file CSV contenente i token.

    • Registrazione dei nomi di file per i token riusciti e non riusciti. Ad esempio goodTokens.csv e badTokens.csv.

    • (Facoltativo) Una configurazione per il delimitatore, il carattere di virgoletta e il numero di thread da utilizzare.

    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

  5. Esegui l'BatchCreatePlatformEndpointSampleapplicazione.java per caricare i token su Amazon SNS. I token caricati correttamente verranno registratigoodTokens.csv, mentre i token non validi verranno registrati. badTokens.csv

Per registrare token dai dispositivi per future installazioni di app

Sono disponibili due opzioni per questo processo:

Usa il servizio Amazon Cognito

La tua app mobile può utilizzare credenziali di sicurezza temporanee per creare endpoint. Amazon Cognito è consigliato per generare credenziali temporanee. Per ulteriori informazioni, consulta la Amazon Cognito Developer Guide

Per tenere traccia delle registrazioni delle app, utilizza gli eventi Amazon SNS per ricevere notifiche quando vengono creati nuovi ARNs endpoint.

In alternativa, puoi utilizzare l'ListEndpointByPlatformApplicationAPI per recuperare l'elenco degli endpoint registrati.

Utilizza un server proxy

Se l'infrastruttura dell'app supporta già la registrazione dei dispositivi al momento dell'installazione, puoi utilizzare il server come proxy. Inoltrerà i token del dispositivo ad Amazon SNS tramite CreatePlatformEndpointl'API.

L'ARN dell'endpoint creato da Amazon SNS verrà restituito e potrà essere archiviato dal server per future pubblicazioni di messaggi.