Mengintegrasikan token perangkat dengan Amazon SNS untuk notifikasi seluler

Saat pertama kali mendaftarkan aplikasi dan perangkat seluler dengan layanan notifikasi, seperti Apple Push Notification Service (APNs) dan Firebase Cloud Messaging (FCM), token perangkat atau registrasi IDs dikembalikan dari layanan notifikasi. Saat Anda menambahkan token perangkat atau pendaftaran IDs ke AmazonSNS, token tersebut digunakan PlatformApplicationArn API untuk membuat titik akhir untuk aplikasi dan perangkat. Saat Amazon SNS membuat titik akhir, an EndpointArn dikembalikan. EndpointArnBegitulah cara Amazon SNS mengetahui aplikasi dan perangkat seluler mana yang akan mengirim pesan notifikasi.

Anda dapat menambahkan token perangkat dan pendaftaran IDs ke Amazon SNS menggunakan metode berikut:

• Tambahkan satu token secara manual untuk AWS menggunakan AWS Management Console

• Unggah beberapa token menggunakan CreatePlatformEndpoint API

• Daftarkan token dari perangkat yang akan menginstal aplikasi Anda di masa mendatang

Untuk menambahkan token perangkat atau ID pendaftaran secara manual

1. Masuk ke SNSkonsol Amazon.

2. Di panel navigasi, pilih Pemberitahuan Push.

3. Di bagian Aplikasi Platform, pilih aplikasi Anda, lalu pilih Edit. Jika Anda belum membuat aplikasi platform, buat sekarang. Untuk petunjuk tentang cara melakukannya, lihat Membuat aplikasi SNS platform Amazon.

4. Pilih Tambahkan Titik Akhir.

5. Di kotak Token Endpoint, masukkan ID token atau ID pendaftaran, tergantung pada layanan notifikasi yang mana. Misalnya, dengan ADM dan FCM Anda memasukkan ID pendaftaran.

6. (Opsional) Di kotak Data Pengguna, masukkan informasi arbitrer untuk dikaitkan dengan endpoint. Amazon SNS tidak menggunakan data ini. Data harus dalam format UTF -8 dan kurang dari 2KB.

7. Pilih Tambahkan Titik Akhir.

   Dengan titik akhir yang dibuat, Anda dapat mengirim pesan langsung ke perangkat seluler atau mengirim pesan ke perangkat seluler yang berlangganan topik.

Untuk mengunggah beberapa token menggunakan CreatePlatformEndpoint API

Langkah-langkah berikut menunjukkan cara menggunakan contoh aplikasi Java (bulkuploadpaket) yang disediakan oleh AWS untuk mengunggah beberapa token (token perangkat atau pendaftaranIDs) ke AmazonSNS. Anda dapat menggunakan aplikasi contoh ini untuk membantu Anda memulai mengunggah token yang ada.

catatan

Langkah-langkah berikut menggunakan Eclipse Java. IDE Langkah-langkah mengasumsikan Anda telah menginstal AWS SDK for Java dan Anda memiliki kredensi AWS keamanan untuk Anda. Akun AWS Untuk informasi selengkapnya, lihat AWS SDK for Java. Untuk informasi selengkapnya tentang kredensial, lihat Bagaimana Cara Mendapatkan Kredensial Keamanan? di Referensi Umum AWS.

1. Unduh dan unzip file snsmobilepush.zip.

2. Buat Proyek Java baru di Eclipse.

3. Impor folder SNSSamples ke direktori tingkat atas Proyek Java yang baru dibuat. Di Eclipse, pilih nama Proyek Java yang tepat lalu pilih Impor, perluas Umum, pilih Sistem File, pilih Berikutnya, telusuri ke folder SNSSamples, pilih OK, lalu pilih Selesai.

4. Unduh salinan Open CSV library dan tambahkan ke Build Path bulkupload paket.

5. Buka file BulkUpload.properties yang terdapat dalam paket bulkupload.

6. Tambahkan berikut ini ke BulkUpload.properties:

   • ApplicationArn yang ingin Anda tambahkan endpoint.

   • Jalur absolut untuk lokasi CSV file Anda yang berisi token.

   • Nama-nama untuk CSV file (seperti goodTokens.csv danbadTokens.csv) yang akan dibuat untuk mencatat token yang SNS diurai Amazon dengan benar dan yang gagal.

   • (Opsional) Karakter untuk menentukan pembatas dan kutipan dalam CSV file yang berisi token.

   • (Opsional) Jumlah utas yang digunakan untuk membuat endpoint secara bersamaan. Defaultnya adalah 1 utas.

   BulkUpload.properties Anda yang selesai akan terlihat seperti berikut:

   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. Jalankan BatchCreatePlatformEndpointSample aplikasi.java untuk mengunggah token ke AmazonSNS.

   Dalam contoh ini, titik akhir yang dibuat untuk token yang berhasil diunggah ke Amazon SNS akan dicatatgoodTokens.csv, sedangkan token yang salah bentuk akan dicatat. badTokens.csv Selain itu, Anda akan melihat STD OUT log yang ditulis ke konsol Eclipse, berisi konten yang mirip dengan berikut ini:

   <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            

Untuk mendaftarkan token dari perangkat yang akan menginstal aplikasi Anda di masa mendatang

Anda dapat menggunakan salah satu dari dua opsi berikut:

• Gunakan layanan Amazon Cognito: Aplikasi seluler Anda akan memerlukan kredensi untuk membuat titik akhir yang terkait dengan aplikasi platform Amazon Anda. SNS Kami menyarankan Anda menggunakan kredensial sementara yang kedaluwarsa setelah jangka waktu tertentu. Untuk sebagian besar skenario, kami menyarankan Anda menggunakan Amazon Cognito untuk membuat kredensial keamanan sementara. Untuk informasi selengkapnya, lihat Panduan Developer Amazon Cognito . Jika Anda ingin diberi tahu saat aplikasi mendaftar dengan AmazonSNS, Anda dapat mendaftar untuk menerima SNS acara Amazon yang akan menyediakan titik akhir baru. ARN Anda juga dapat menggunakan ListEndpointByPlatformApplication API untuk mendapatkan daftar lengkap titik akhir yang terdaftar di AmazonSNS.

• Gunakan server proksi: Jika infrastruktur aplikasi Anda sudah disiapkan untuk aplikasi seluler Anda untuk menelepon dan mendaftar di setiap penginstalan, Anda dapat terus menggunakan penyiapan ini. Server Anda akan bertindak sebagai proxy dan meneruskan token perangkat ke notifikasi push SNS seluler Amazon, bersama dengan data pengguna apa pun yang ingin Anda simpan. Untuk tujuan ini, server proxy akan terhubung ke Amazon SNS menggunakan AWS kredensi Anda dan menggunakan CreatePlatformEndpoint API panggilan untuk mengunggah informasi token. Endpoint Amazon Resource Name (ARN) yang baru dibuat akan dikembalikan, yang dapat disimpan server Anda untuk melakukan panggilan publikasi berikutnya ke AmazonSNS.