Mengonfigurasi notifikasi Amazon SNS untuk Amazon SES

Amazon SES dapat memberi tahu Anda tentang pentalan, aduan, dan pengiriman Anda melalui Amazon Simple Notification Service (Amazon SNS).

Anda dapat mengonfigurasi notifikasi di konsol Amazon SES, atau dengan menggunakan API Amazon SES.

Prasyarat

Selesaikan langkah-langkah berikut sebelum Anda menyiapkan notifikasi Amazon SNS di Amazon SES:

1. Buat topik di Amazon SNS. Untuk informasi lebih lanjut, lihat Buat Topik di Panduan Developer Amazon Simple Notification Service.

   penting

   Saat Anda membuat topik menggunakan Amazon SNS, untuk Jenis, pilih saja Standar. (SES tidak mendukung topik tipe FIFO.)

   Apakah Anda membuat topik SNS baru atau memilih yang sudah ada, Anda perlu memberikan akses ke SES untuk mempublikasikan pemberitahuan ke topik tersebut.

   Untuk memberikan izin Amazon SES untuk mempublikasikan pemberitahuan ke topik, pada layar Edit topik di konsol SNS, perluas kebijakan Access dan di editor JSON, tambahkan kebijakan izin berikut:

   {
     "Version": "2012-10-17",
     "Id": "notification-policy",
     "Statement": [
       {
         "Effect": "Allow",
         "Principal": {
           "Service": "ses.amazonaws.com"
         },
         "Action": "sns:Publish",
         "Resource": "arn:aws:sns:topic_region:111122223333:topic_name",
         "Condition": {
           "StringEquals": {
             "AWS:SourceAccount": "111122223333",
             "AWS:SourceArn": "arn:aws:ses:topic_region:111122223333:identity/identity_name"
           }
         }
       }
     ]
   }

   Buat perubahan berikut ke contoh kebijakan sebelumnya:

   • Ganti topic_region dengan AWS Wilayah tempat Anda membuat topik SNS.

   • Ganti 111122223333 dengan ID akun AWS Anda.

   • Ganti topic_name dengan nama topik SNS Anda.

   • Ganti identity_name dengan identitas terverifikasi (alamat email atau domain) yang Anda berlangganan ke topik SNS.

2. Berlangganan setidaknya satu titik akhir ke topik. Misalnya, jika Anda ingin menerima notifikasi melalui pesan teks, berlanggananlah titik akhir SMS (yaitu nomor ponsel) ke topik tersebut. Untuk menerima notifikasi melalui email, berlanggananlah titik akhir email (alamat email) ke topik tersebut.

   Untuk informasi lebih lanjut, lihat Memulai di Panduan Developer Amazon Simple Notification Service.

3. (Opsional) Jika topik Amazon SNS Anda menggunakan AWS Key Management Service (AWS KMS) untuk enkripsi sisi server, Anda harus menambahkan izin ke kebijakan utama. AWS KMS Anda dapat menambahkan izin dengan melampirkan kebijakan berikut ke kebijakan AWS KMS utama:

   {
       "Version": "2012-10-17",
       "Statement": [
           {
               "Sid": "AllowSESToUseKMSKey",
               "Effect": "Allow",
               "Principal": {
                   "Service": "ses.amazonaws.com"
               },
               "Action": [
                   "kms:GenerateDataKey",
                   "kms:Decrypt"
               ],
               "Resource": "*"
           }
       ]
   }

Mengonfigurasi notifikasi menggunakan konsol Amazon SES

Untuk mengonfigurasi notifikasi menggunakan konsol Amazon SES

1. Buka konsol Amazon SES di https://console.aws.amazon.com/ses/.

2. Di panel navigasi, di bawah Konfigurasi, pilih Identitas yang terverifikasi.

3. Dalam wadah Identitas, pilih identitas terverifikasi yang ingin Anda terima pemberitahuan umpan balik ketika pesan yang dikirim dari identitas ini menghasilkan bouncing, keluhan, atau pengiriman.

   penting

   Pengaturan notifikasi domain terverifikasi berlaku untuk semua email yang dikirim dari alamat email di domain tersebut kecuali untuk alamat email yang juga terverifikasi.

4. Di layar detail identitas terverifikasi yang Anda pilih, pilih tab Pemberitahuan dan pilih Edit di wadah Pemberitahuan umpan balik.

5. Perluas kotak daftar topik SNS dari setiap jenis umpan balik yang ingin Anda terima notifikasi, dan pilih topik SNS yang Anda miliki, Tanpa topik SNS, atau topik SNS yang tidak Anda miliki.

   1. Jika Anda memilih topik SNS yang tidak Anda miliki, bidang ARN topik SNS akan disajikan di mana Anda harus memasukkan topik SNS ARN yang dibagikan kepada Anda oleh pengirim delegasi Anda. (Hanya pengirim delegasi Anda yang akan mendapatkan notifikasi ini karena mereka memiliki topik SNS. Untuk mempelajari lebih lanjut tentang pengiriman delegasi, lihatGambaran umum otorisasi pengiriman.)

   penting

   Topik Amazon SNS yang Anda gunakan untuk pemberitahuan pentalan, keluhan, dan pengiriman harus sama Wilayah AWS dengan yang Anda gunakan Amazon SES.

   Selain itu, Anda harus berlangganan satu atau beberapa titik akhir ke topik tersebut untuk menerima notifikasi. Misalnya, jika Anda ingin notifikasi dikirimkan ke suatu alamat email, Anda harus berlangganan titik akhir email ke topik tersebut. Untuk informasi lebih lanjut, lihat Memulai di Panduan Developer Amazon Simple Notification Service.

6. (Opsional) Jika Anda ingin pemberitahuan topik Anda menyertakan header dari email asli, centang Sertakan header email asli kotak tepat di bawah nama topik SNS dari setiap jenis umpan balik. Opsi ini hanya tersedia jika Anda telah menetapkan topik Amazon SNS untuk tipe notifikasi terkait. Untuk informasi tentang isi header email asli, lihat objek mail di Isi notifikasi.

7. Pilih Simpan perubahan. Perubahan yang Anda buat pada pengaturan notifikasi Anda mungkin memerlukan beberapa menit untuk diterapkan.

8. (Opsional) Jika Anda memilih notifikasi topik Amazon SNS untuk pantulan dan keluhan, Anda dapat menonaktifkan notifikasi email sepenuhnya sehingga Anda tidak menerima pemberitahuan ganda melalui email dan notifikasi SNS. Untuk menonaktifkan pemberitahuan email untuk bouncing dan keluhan, di bawah tab Notifikasi pada layar detail identitas terverifikasi, dalam wadah Penerusan Umpan Balik Email, pilih Edit, hapus centang pada kotak Diaktifkan, dan pilih Simpan perubahan.

Setelah mengonfigurasi pengaturan, Anda akan mulai menerima notifikasi pentalan, aduan, dan pengiriman ke topik Amazon SNS Anda. Notifikasi ini dalam format JavaScript Object Notation (JSON) dan mengikuti struktur yang dijelaskan dalam. Isi notifikasi

Anda akan dikenakan tarif Amazon SNS standar untuk notifikasi pentalan, aduan, dan pengiriman. Untuk informasi lebih lanjut, lihat halaman harga Amazon SNS.

catatan

Jika upaya untuk memublikasikan ke topik Amazon SNS Anda gagal karena topik telah dihapus atau Anda Akun AWS tidak lagi memiliki izin untuk mempublikasikannya, Amazon SES menghapus konfigurasi untuk topik tersebut jika telah dikonfigurasi untuk pantulan atau keluhan (bukan pengiriman - untuk pemberitahuan pengiriman, SES tidak akan menghapus setelan konfigurasi topik SNS). Selain itu, Amazon SES kembali mengaktifkan notifikasi email pentalan dan aduan untuk identitas, dan Anda menerima notfikasi dari perubahan tersebut melalui email. Jika beberapa identitas dikonfigurasi untuk menggunakan topik tersebut, konfigurasi topik untuk setiap identitas berubah ketika masing-masing identitas mengalami kegagalan untuk memublikasikan ke topik.

Mengonfigurasi notifikasi menggunakan API Amazon SES

Anda juga dapat mengonfigurasi notifikasi pentalan, aduan, dan pengiriman dengan menggunakan API Amazon SES. Gunakan operasi berikut untuk mengonfigurasi notifikasi:

• SetIdentityNotificationTopic

• SetIdentityFeedbackForwardingEnabled

• GetIdentityNotificationAttributes

• SetIdentityHeadersInNotificationsEnabled

Anda dapat menggunakan tindakan API ini untuk menulis aplikasi front-end yang disesuaikan untuk notifikasi. Untuk deskripsi lengkap mengenai tindakan API terkait notifikasi, lihat Referensi API Amazon Simple Email Service.

Pemecahan masalah notifikasi umpan balik

Tidak menerima notifikasi

Jika Anda tidak menerima notifikasi, pastikan bahwa Anda berlangganan titik akhir ke topik yang dikirimkan notifikasi. Ketika Anda berlangganan titik akhir email ke topik, Anda menerima email yang meminta Anda untuk mengonfirmasi langganan Anda. Anda harus mengonfirmasi langganan sebelum mulai menerima notifikasi email. Untuk informasi lebih lanjut, lihat Memulai di Panduan Developer Amazon Simple Notification Service.

Kesalahan InvalidParameterValue saat memilih topik

Jika Anda menerima kesalahan yang menyatakan bahwa terjadi kesalahan InvalidParameterValue, periksa topik Amazon SNS untuk melihat jika dienkripsi menggunakan AWS KMS. Jika ya, Anda harus mengubah kebijakan untuk AWS KMS kunci tersebut. Lihat Prasyarat untuk kebijakan sampel.