

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Mengintegrasikan token perangkat dengan Amazon SNS untuk notifikasi seluler
<a name="mobile-push-send-devicetoken"></a>

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 akan dikembalikan oleh layanan. Ini tokens/IDs ditambahkan ke Amazon SNS untuk membuat titik akhir untuk aplikasi dan perangkat, menggunakan API. [https://docs.aws.amazon.com/sns/latest/api/API_PlatformApplication.html](https://docs.aws.amazon.com/sns/latest/api/API_PlatformApplication.html) Setelah titik akhir dibuat, sebuah dikembalikan, yang [https://docs.aws.amazon.com/sns/latest/api/API_Endpoint.html](https://docs.aws.amazon.com/sns/latest/api/API_Endpoint.html)digunakan Amazon SNS untuk mengarahkan notifikasi ke aplikasi/perangkat yang benar.

Anda dapat menambahkan token perangkat atau pendaftaran IDs ke Amazon SNS dengan cara berikut:
+ Tambahkan satu token secara manual melalui Konsol Manajemen AWS
+ Unggah beberapa token menggunakan API [https://docs.aws.amazon.com/sns/latest/api/API_CreatePlatformEndpoint.html](https://docs.aws.amazon.com/sns/latest/api/API_CreatePlatformEndpoint.html)
+ Daftarkan token untuk perangkat masa depan

****Untuk menambahkan token perangkat atau ID pendaftaran secara manual****

1. Masuk ke [konsol Amazon SNS](https://console.aws.amazon.com/sns/home).

1. Di panel navigasi, pilih **Pemberitahuan Push**.

1. Di bagian **Aplikasi Platform**, pilih aplikasi Anda, lalu pilih **Edit**. Jika Anda belum membuat aplikasi platform, ikuti [Membuat aplikasi platform Amazon SNS](mobile-push-send-register.md) panduan untuk melakukannya sekarang.

1. Pilih **Buat Titik Akhir**.

1. Di kotak **Token Titik Akhir**, masukkan **token** atau **ID pendaftaran**, tergantung pada layanan notifikasi yang Anda gunakan (misalnya, ID pendaftaran FCM).

1. (Opsional) Masukkan data tambahan di bidang **Data Pengguna**. Data ini harus dikodekan UTF-8 dan kurang dari 2 KB.

1. Pilih **Buat Titik Akhir**.

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

****Untuk mengunggah beberapa token menggunakan `CreatePlatformEndpoint` API****

Langkah-langkah berikut menunjukkan cara menggunakan contoh aplikasi Java (`bulkupload`paket) yang disediakan oleh AWS untuk mengunggah beberapa token (token perangkat atau pendaftaran IDs) ke Amazon SNS. 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 untuk Java dan Anda memiliki kredensi AWS keamanan untuk Anda. Akun AWS Untuk informasi selengkapnya, lihat [AWS SDK untuk Java](https://aws.amazon.com/sdkforjava/). *Untuk informasi selengkapnya tentang kredensional, lihat [AWS kredensional keamanan di Panduan Pengguna](https://docs.aws.amazon.com/general/latest/gr/getting-aws-sec-creds.html) IAM.* 

1. Unduh dan unzip file [snsmobilepush.zip](samples/snsmobilepush.zip). 

1. Buat **proyek Java** baru di Eclipse dan impor `SNSSamples` folder ke proyek. 

1. Unduh pustaka [OpenCSV](http://sourceforge.net/projects/opencsv/) dan tambahkan ke jalur build.

1. Dalam `BulkUpload.properties` file, tentukan yang berikut ini: 
   + Anda `ApplicationArn` (aplikasi platform ARN).
   + Jalur absolut ke file CSV Anda yang berisi token.
   + Mencatat nama file untuk token yang berhasil dan gagal. Misalnya, `goodTokens.csv` dan `badTokens.csv`.
   + (Opsional) Konfigurasi untuk pembatas, karakter kutipan, dan jumlah utas yang akan digunakan.

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

1.  Jalankan **BatchCreatePlatformEndpointSampleaplikasi.java** untuk mengunggah token ke Amazon SNS. Token yang berhasil diunggah akan masuk`goodTokens.csv`, sementara token yang salah bentuk akan masuk. `badTokens.csv`

**Untuk mendaftarkan token dari perangkat untuk instalasi aplikasi masa depan**

Anda memiliki dua opsi untuk proses ini:

**Gunakan layanan Amazon Cognito**  
Aplikasi seluler Anda dapat menggunakan kredensi keamanan sementara untuk membuat titik akhir. Amazon Cognito direkomendasikan untuk menghasilkan kredensi sementara. Untuk informasi selengkapnya, lihat Panduan Pengembang *[Amazon Cognito](https://docs.aws.amazon.com/cognito/latest/developerguide/)*   
Untuk melacak [pendaftaran](application-event-notifications.md) aplikasi, gunakan peristiwa Amazon SNS untuk menerima notifikasi saat titik ARNs akhir baru dibuat.  
Atau, Anda dapat menggunakan [https://docs.aws.amazon.com/sns/latest/api/API_ListEndpointsByPlatformApplication.html](https://docs.aws.amazon.com/sns/latest/api/API_ListEndpointsByPlatformApplication.html)API untuk mengambil daftar endpoint terdaftar.

**Gunakan server proxy**  
Jika infrastruktur aplikasi Anda sudah mendukung pendaftaran perangkat saat penginstalan, Anda dapat menggunakan server sebagai proxy. Ini akan meneruskan token perangkat ke Amazon SNS melalui API. [https://docs.aws.amazon.com/sns/latest/api/API_CreatePlatformEndpoint.html](https://docs.aws.amazon.com/sns/latest/api/API_CreatePlatformEndpoint.html)  
Endpoint ARN yang dibuat oleh Amazon SNS akan dikembalikan dan dapat disimpan oleh server Anda untuk penerbitan pesan future.