Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Membuat aturan penerimaan pada panduan konsol
Bagian ini akan memandu Anda untuk membuat dan menentukan aturan penerimaan menggunakan konsol Amazon SES. Poin-poin penting untuk memahami cara kerja aturan penerimaan adalah:
+ *Set aturan* berisi set aturan penerimaan yang berurutan; *Aturan penerimaan* berisi set tindakan yang berurutan.
+ Aturan penerimaan memberitahu Amazon SES cara menangani surat masuk dengan mengeksekusi daftar tindakan yang berurutan yang Anda tentukan.
+ Daftar tindakan yang diurutkan ini secara opsional dapat dibuat bergantung pada pencocokan pertama kondisi penerima; jika tidak ditentukan, tindakan akan diterapkan ke semua identitas milik domain terverifikasi Anda.
+ Aturan penerimaan dibuat dan ditentukan dalam kontainer yang disebut set aturan - sementara Anda dapat membuat beberapa set aturan, hanya satu yang dapat aktif pada satu waktu.
+ Aturan penerimaan dalam set aturan aktif dijalankan sesuai urutan yang Anda tentukan.
+ Sebelum Anda membuat aturan penerimaan, Anda harus membuat *Set aturan* untuk menyimpan aturan tersebut.
Secara opsional, Anda dapat menggunakan API `CreateReceiptRuleSet` untuk membuat set aturan penerimaan yang kosong, seperti yang dijelaskan dalam [Referensi API Amazon Simple Email Service](https://docs.aws.amazon.com/ses/latest/APIReference/API_CreateReceiptRuleSet.html). Kemudian, Anda dapat menggunakan konsol Amazon SES atau API `CreateReceiptRule` untuk menambahkan aturan penerimaan padanya.
Sebelum melanjutkan panduan, pastikan Anda telah memenuhi semua prasyarat yang diperlukan untuk menggunakan penerimaan email berbasis penerima.
## Prasyarat
Prasyarat berikut harus dipenuhi sebelum melanjutkan penyiapan kontrol email berbasis penerima menggunakan aturan penerimaan:
1. Pastikan titik akhir Anda berada di Wilayah AWS tempat Amazon SES mendukung penerimaan email. Tabel [titik akhir Penerimaan Email](https://docs.aws.amazon.com/general/latest/gr/ses.html#ses_inbound_endpoints) dalam Referensi Umum AWS daftar titik akhir penerima email untuk semua Wilayah AWS tempat SES mendukung penerimaan email.
1. Anda harus terlebih dahulu [membuat dan memverifikasi identitas domain](verify-addresses-and-domains.md) di Amazon SES.
1. Selanjutnya, Anda perlu menentukan server email mana yang dapat menerima email untuk domain Anda dengan [menerbitkan catatan MX](receiving-email-mx-record.md) ke pengaturan DNS domain Anda. (Catatan MX harus merujuk ke titik akhir Amazon SES yang menerima email untuk AWS Wilayah tempat Anda menggunakan Amazon SES.)
1. Terakhir, Anda perlu [memberikan izin Amazon SES](receiving-email-permissions.md) untuk mengakses AWS sumber daya lain untuk menjalankan tindakan aturan penerimaan.
## Membuat set aturan dan aturan penerimaan
Panduan ini terlebih dahulu dimulai dengan membuat set aturan untuk menyimpan aturan Anda dan dilanjutkan ke wizard **Buat aturan** untuk membuat, menentukan, dan mengurutkan aturan penerimaan Anda. Wizard berisi empat layar untuk menentukan pengaturan aturan, menambahkan syarat penerima, menambahkan tindakan, dan meninjau semua pengaturan Anda.
**Untuk membuat set aturan dan aturan penerimaan menggunakan konsol tersebut.**
1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon SES di [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/).
1. Di panel navigasi, di **Konfigurasi**, pilih **Penerimaan email**.
**catatan**
*Penerimaan email* tidak akan terlihat di panel navigasi kiri konsol SES jika akun Anda berada di Wilayah AWS tempat SES tidak mendukung penerimaan email. Lihat item pertama yang tercantum di[Prasyarat](#receipt-rules-prerequisites).
1. Di bawah tab **Set aturan tanda terima** di panel **Penerima email**, pilih **Buat set aturan**.
1. Masukkan nama yang unik untuk set aturan Anda dan pilih **Buat set aturan**.
1. Pilih **Buat aturan** dan pilihan ini akan membuka wizard **Buat aturan**.
1. Pada halaman **Tentukan pengaturan aturan**, di **Detail aturan penerimaan**, masukkan **Nama aturan**.
1. Untuk **Status**, hapus hanya kotak centang **Diaktifkan** jika Anda tidak ingin Amazon SES menjalankan aturan ini setelah pembuatan; jika tidak, biarkan opsi ini tercentang.
1. (Opsional) Di **Opsi keamanan dan perlindungan**, untuk **Keamanan Lapisan Pengangkutan (TLS)**, pilih **Wajib** jika Anda ingin Amazon SES menolak pesan masuk yang tidak dikirim melalui sambungan aman.
1. (Opsional) Untuk **Pemindaian spam dan virus**, pilih **Diaktifkan** jika Anda ingin Amazon SES memindai spam dan virus pada pesan masuk.
1. Untuk melanjutkan ke langkah berikutnya, pilih **Selanjutnya**.
1. (Opsional) Pada Halaman **Tambah syarat penerima**, untuk menentukan satu kondisi penerima atau lebih gunakan prosedur berikut ini. Untuk setiap aturan penerimaan Anda dapat memiliki maksimal 100 syarat penerima.
1. Di **Syarat penerima**, pilih **Menambahkan kondisi penerima baru** untuk menentukan alamat email penerima atau domain yang ingin Anda terapkan aturan penerimaan. Alamat *pengguna@contoh.com* pada tabel berikut menunjukkan cara menentukan kondisi penerima.
****
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/ses/latest/dg/receiving-email-receipt-rules-console-walkthrough.html)
**penting**
Jika beberapa akun Amazon SES menerima email pada domain umum (misalnya, jika beberapa tim di perusahaan yang sama masing-masing memiliki akun Amazon SES terpisah), Amazon SES memproses semua aturan penerimaan yang cocok secara bersamaan untuk setiap akun tersebut. Perilaku ini dapat mengakibatkan situasi ketika satu akun menghasilkan pentalan, sementara akun lain menerima email.
Kami menyarankan Anda berkoordinasi dengan tim lain di organisasi Anda yang menggunakan Amazon SES untuk memastikan bahwa setiap akun menggunakan aturan penerimaan unik, dan agar aturan-aturan tersebut tidak tumpang tindih. Dalam situasi ini, hal terbaik adalah mengonfigurasi aturan penerimaan Anda dengan hanya menggunakan alamat email atau subdomain yang unik untuk grup atau tim Anda.
1. Ulangi langkah ini untuk setiap syarat penerima yang ingin Anda tambahkan. Setelah Anda selesai menambahkan syarat penerima, pilih **Selanjutnya**.
1. Pada halaman **Tambahkan tindakan**, untuk menambahkan satu tindakan ke aturan penerimaan atau lebih gunakan prosedur berikut.
1. Buka menu **Tambah aksi baru**, dan kemudian pilih salah satu dari tipe tindakan berikut:
+ **[Tambahkan header](receiving-email-action-add-header.md)** - Tindakan ini menambahkan header kustom ke email yang diterima.
+ **[Mengembalikan respons pentalan](receiving-email-action-bounce.md)** - Tindakan ini menolak email yang diterima dengan mengembalikan respons pentalan ke pengirim.
+ **[Panggil fungsi Lambda](receiving-email-action-lambda.md)**- Tindakan ini memanggil kode Anda melalui fungsi AWS Lambda.
+ **[Mengirimkan ke bucket S3](receiving-email-action-s3.md)** - Tindakan ini menyimpan email yang diterima dalam bucket Amazon Simple Storage Service (S3).
+ **[Terbitkan ke topik Amazon SNS](receiving-email-action-sns.md)** - Tindakan ini mempublikasikan email lengkap topik Amazon Simple Notification Service (SNS).
+ **[Hentikan set aturan](receiving-email-action-stop.md)** - Tindakan ini mengakhiri evaluasi dari set aturan penerimaan.
+ **[Integrasikan dengan Amazon WorkMail](receiving-email-action-workmail.md)**- Tindakan ini terintegrasi dengan Amazon WorkMail.
Untuk informasi lebih lanjut tentang setiap tindakan ini, lihat [Pilihan tindakan](receiving-email-action.md).
1. Ulangi langkah ini untuk setiap tindakan yang ingin Anda tetapkan. Jika Anda memiliki beberapa tindakan yang ditetapkan, Anda dapat menyusun ulang tindakan tersebut dengan menggunakan panah atas/bawah dalam kontainer tindakan. Pilih **Selanjutnya** untuk melanjutkan ke halaman **Tinjau**.
1. Pada halaman **Tinjau**, tinjau pengaturan dan tindakan aturan. Jika Anda perlu melakukan perubahan, pilih opsi **Edit**, atau gunakan bagian navigasi di sisi kiri halaman untuk pergi secara langsung menuju langkah yang berisi konten yang ingin Anda edit. Anda secara opsional dapat membuat perubahan pada urutan tindakan yang tercantum dalam tabel **Tindakan** pada halaman **Tinjauan** menggunakan up/down panah di kolom Urutkan **ulang**.
1. Saat Anda siap untuk melanjutkan, pilih **Buat aturan**.
1. Pada halaman konfirmasi untuk set aturan, pilih **Set as active** jika Anda ingin segera menerapkan aturan yang ditetapkan.
### Modifikasi aturan setelah pembuatan
Setelah membuat set aturan, Anda dapat mengedit kedua set aturan serta aturan penerimaan yang disimpannya. Tidak hanya dapat diedit, tetapi ada juga opsi untuk menduplikasi aturan yang ditetapkan atau aturannya sehingga yang baru dapat dibuat dengan cepat. Daftar berikut menunjukkan modifikasi yang tersedia untuk set aturan dan aturan penerimaan:
+ **Set aturan** terdaftar dengan namanya, status dan tanggal pembuatannya. Pilihan modifikasi untuk set aturan adalah:
+ Tombol alihkan **Tetapkan sebagai aktif/tidak aktif** akan beralih di antara pengaturan status.
+ Tombol **Duplikasi** akan menyalin set aturan. Anda akan diminta untuk memberikan nama yang unik.
+ Tombol **Hapus** akan menghapus set aturan. Anda akan diminta untuk mengonfirmasi tindakan yang tidak dapat dipulihkan ini.
+ **Aturan penerimaan** tercantum dengan nama, status, keamanan, dan urutan mereka. Pilihan modifikasi untuk aturan penerimaan adalah:
+ **Panah naik/bawah** untuk menyusun ulang eksekusi aturan dalam set aturan.
+ Tombol **Duplikasi** akan membuat salinan aturan yang dipilih. Anda akan diminta untuk memberikan nama yang unik.
+ Tombol **Edit** akan membuka aturan yang dipilih sehingga salah satu parameternya seperti pengaturan aturan, kondisi penerima, dan tindakan dapat diedit.
+ Tombol **Hapus** akan menghapus aturan yang dipilih. Anda akan diminta untuk mengonfirmasi tindakan yang tidak dapat dipulihkan ini.
+ Tombol **Buat aturan** akan mengizinkan Anda untuk membuat dan menambahkan aturan baru untuk set aturan saat ini.
# Pilihan tindakan
Setiap aturan penerimaan untuk penerimaan email Amazon SES berisi daftar tindakan yang berurutan. Bagian ini menjelaskan opsi spesifik untuk setiap tipe tindakan.
Tipe tindakan adalah sebagai berikut:
+ [Tambahkan tindakan header](receiving-email-action-add-header.md)
+ [Kembalikan tindakan respons pantulan](receiving-email-action-bounce.md)
+ [Panggil tindakan Fungsi Lambda](receiving-email-action-lambda.md)
+ [Mengirimkan ke tindakan bucket S3](receiving-email-action-s3.md)
+ [Terbitkan ke topik tindakan Amazon SNS](receiving-email-action-sns.md)
+ [Hentikan tindakan set aturan](receiving-email-action-stop.md)
+ [Integrasikan dengan WorkMail tindakan Amazon](receiving-email-action-workmail.md)
# Tambahkan tindakan header
Tindakan **Tambah Header** menambahkan header kustom ke email yang diterima. Anda biasanya menggunakan tindakan ini hanya jika dikombinasikan dengan tindakan lain. Tindakan ini memiliki opsi berikut.
+ **Nama header—**Nama header yang akan ditambahkan. Nama header harus berkisar antara 1 hingga 50 karakter, inklusif, dan hanya terdiri dari karakter alfanumerik (a-z, A-Z, 0-9) dan tanda hubung.
+ **Nilai header—**Nilai header yang akan ditambahkan. Nilai header harus kurang dari 2048 karakter, dan tidak boleh berisi karakter baris baru ("\$1r" atau "\$1n").
# Kembalikan tindakan respons pantulan
Tindakan **Pentalan** menolak email dengan mengembalikan respons pentalan ke pengirim dan memberitahu Anda melalui Amazon SNS secara opsional. Tindakan ini memiliki opsi berikut.
+ **Kode Balasan SMTP—** Kode balasan SMTP, seperti yang ditentukan oleh [RFC 5321](https://tools.ietf.org/html/rfc5321).
+ **Kode Status SMTP—**Kode status disempurnakan SMTP, seperti yang ditentukan oleh [RFC 3463](https://tools.ietf.org/html/rfc3463).
+ **Pesan—**Teks yang dapat dibaca manusia untuk disertakan dalam email pentalan.
+ **Pengirim Balasan—**Alamat email dari pengirim email yang terpental. Ini adalah alamat tempat mengirim email pentalan. Alamat tersebut harus diverifikasi dengan Amazon SES.
**catatan**
Pesan pantulan tidak dikirim melalui domain MAIL FROM kustom Anda, tetapi dibuat secara internal oleh SES dan ditandatangani hanya dengan tanda tangan `amazonses.com` DKIM. Sebagai solusinya, gunakan opsi **Balas Pengirim** untuk menyetel alamat email untuk pesan bouncing Anda. Lihat [AWS re:Post artikel](https://repost.aws/questions/QURvN-26L_SJOcY9JoSFgCdg/ses-receiving-return-bounce-response-action-not-sending-bounce) ini untuk informasi lebih lanjut.
+ **Topik SNS—**Nama atau ARN dari topik Amazon SNS yang secara opsional akan memberi tahu ketika email pentalan dikirim. Contoh topik Amazon SNS ARN adalah *arn:aws:sns:us-east* - 1:123456789012:. MyTopic Anda juga dapat membuat topik Amazon SNS saat mengatur tindakan dengan memilih **Buat Topik SNS**. Untuk informasi lebih lanjut tentang topik Amazon SNS, lihat [Panduan Developer Amazon Simple Notification Service](https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html).
**catatan**
Topik Amazon SNS yang Anda pilih harus berada di AWS Wilayah yang sama dengan titik akhir Amazon SES yang Anda gunakan untuk menerima email.
Anda dapat mengetikkan nilai Anda sendiri untuk bidang ini, atau Anda dapat memilih templat yang mengisi bidang Kode Balasan SMTP, Kode Status SMTP, dan Pesan dengan nilai berdasarkan alasan pentalan. Templat berikut ini tersedia:
+ **Kotak Surat Tidak Ada—** Kode Balasan SMTP = 550, SMTP Status Code = 5.1.1
+ **Pesan Terlalu Besar—** Kode Balasan SMTP = 552, Kode Status SMTP = 5.3.4
+ **Kotak Surat Penuh—** Kode Balasan SMTP = 552, Kode Status SMTP = 5.2.2
+ **Konten Pesan Ditolak—** Kode Balasan SMTP = 500, Kode Status SMTP = 5.6.1
+ **Kegagalan yang Tidak Diketahui—** Kode Balasan SMTP = 554, Kode Status SMTP = 5.0.0
+ **Kegagalan Sementara—** Kode Balasan SMTP = 450, Kode Status SMTP = 4.0.0
Untuk kode pentalan tambahan yang mungkin Anda gunakan dengan mengetikkan nilai kustom di bidang, lihat [RFC 3463](https://tools.ietf.org/html/rfc3463).
# Panggil tindakan Fungsi Lambda
Tindakan Lambda memanggil kode Anda melalui fungsi Lambda dan memberitahu Anda melalui Amazon SNS secara opsional. Tindakan ini memiliki opsi dan persyaratan berikut.
**Opsi**
+ **Fungsi Lambda—**ARN fungsi Lambda. *Contoh fungsi Lambda ARN adalah arn:aws:lambda:us-east-1:account-id:function:. MyFunction*
+ **Tipe pemanggilan—**Tipe pemanggilan fungsi Lambda. Jenis pemanggilan **RequestResponse**berarti bahwa eksekusi fungsi menghasilkan respons langsung. Jenis pemanggilan **Peristiwa** berarti bahwa fungsi tersebut dipanggil secara asinkron. Kami menyarankan Anda menggunakan jenis pemanggilan **Acara** kecuali eksekusi sinkron diperlukan untuk kasus penggunaan Anda.
Ada batas waktu 30 detik pada pemanggilan **RequestResponse**.
Untuk informasi selengkapnya, lihat [Memanggil fungsi Lambda](https://docs.aws.amazon.com/lambda/latest/dg/lambda-invocation.html) di Panduan *AWS Lambda Pengembang.*
+ **Topik SNS-** Nama atau ARN dari topik Amazon SNS untuk memberi tahu kapan fungsi Lambda yang ditentukan dipicu. Contoh topik Amazon SNS ARN adalah *arn:aws:sns:us-east* - 1:123456789012:. MyTopic Untuk informasi lebih lanjut, lihat [Membuat topik Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html) dalam *Panduan Developer Amazon Simple Notification Service*.
**Persyaratan**
+ Fungsi Lambda yang Anda pilih harus berada di AWS Wilayah yang sama dengan titik akhir Amazon SES yang Anda gunakan untuk menerima email.
+ Topik Amazon SNS yang Anda pilih harus berada di AWS Wilayah yang sama dengan titik akhir Amazon SES yang Anda gunakan untuk menerima email.
## Menulis fungsi Lambda Anda
Untuk memproses email Anda, fungsi Lambda Anda dapat dipanggil secara tidak sinkron (yaitu, menggunakan tipe pemanggilan `Event`). Objek peristiwa yang diteruskan ke fungsi Lambda Anda akan berisi metadata yang berkaitan dengan peristiwa email masuk. Anda juga dapat menggunakan metadata untuk mengakses konten pesan dari bucket Amazon S3 Anda.
Jika Anda benar-benar ingin mengontrol arus email, fungsi Lambda Anda harus dipanggil secara sinkron (yaitu, menggunakan tipe pemanggilan `RequestResponse`) dan fungsi Lambda Anda harus memanggil metode `callback` dengan dua argumen: argumen pertama adalah `null`, dan argumen kedua adalah properti `disposition` yang diatur ke `STOP_RULE`, `STOP_RULE_SET`, atau `CONTINUE`. Jika argumen kedua adalah `null` atau tidak memiliki properti `disposition` yang valid, arus email akan berlanjut dan tindakan serta aturan diproses lebih lanjut, yang sama dengan `CONTINUE`.
Misalnya, Anda dapat menghentikan set aturan penerimaan dengan menulis baris berikut di akhir kode fungsi Lambda Anda:
```
callback( null, { "disposition" : "STOP_RULE_SET" });
```
Untuk contoh AWS Lambda kode, lihat[Contoh fungsi Lambda](receiving-email-action-lambda-example-functions.md). Untuk contoh kasus penggunaan tingkat tinggi, lihat [Contoh kasus penggunaan](receiving-email-action-lambda-example-use-cases.md).
### Format input
Amazon SES meneruskan informasi ke fungsi Lambda dalam format JSON. Objek tingkat atas berisi array `Records`, yang diisi dengan properti `eventSource`, `eventVersion`, dan `ses`. Objek `ses` berisi objek `receipt` dan `mail`, dalam format yang sama persis seperti di notifikasi Amazon SNS yang telah dijelaskan di [Isi notifikasi](receiving-email-notifications-contents.md).
Data yang diteruskan Amazon SES ke Lambda mencakup metadata tentang pesan, serta beberapa header email. Namun, data tersebut tidak berisi isi pesan.
Berikut ini adalah tampilan tingkat tinggi dari struktur input yang diberikan Amazon SES ke fungsi Lambda.
```
{
"Records": [
{
"eventSource": "aws:ses",
"eventVersion": "1.0",
"ses": {
"receipt": {
},
"mail": {
}
}
}
]
}
```
### Nilai pengembalian
Fungsi Lambda Anda dapat mengendalikan arus surat dengan mengembalikan salah satu nilai berikut:
+ `STOP_RULE`—Saat ini tidak ada tindakan lebih lanjut dalam aturan penerimaan yang akan diproses, tetapi aturan penerimaan dapat diproses lebih lanjut.
+ `STOP_RULE_SET`—Tidak ada tindakan atau aturan penerimaan akan diproses lebih lanjut.
+ `CONTINUE` atau nilai tidak valid lainnya— Hal ini berarti tindakan dan aturan penerimaan dapat diproses lebih lanjut.
**Topics**
+ [Menulis fungsi Lambda Anda](#receiving-email-action-lambda-function)
+ [Contoh peristiwa email masuk](receiving-email-action-lambda-event.md)
+ [Contoh kasus penggunaan](receiving-email-action-lambda-example-use-cases.md)
+ [Contoh fungsi Lambda](receiving-email-action-lambda-example-functions.md)
# Contoh peristiwa email masuk
Ada dua cara untuk mengirim peristiwa email masuk ke fungsi Lambda. Metode pertama adalah menggunakan tindakan Lambda pada aturan penerimaan Anda untuk mengirimkan langsung catatan peristiwa ke fungsi. Metode kedua adalah menggunakan tindakan Amazon SNS dalam aturan penerimaan Anda untuk mengirim catatan peristiwa ke Amazon SNS, lalu menambahkan fungsi Lambda sebagai titik akhir berlangganan ke topik Amazon SNS.
Bagian ini berisi contoh catatan peristiwa yang dapat dikirim Amazon SES ke Lambda. Anda dapat menggunakan contoh berikut ini untuk membuat dan menguji fungsi Lambda.
**catatan**
Contoh di bagian ini menyertakan jeda baris agar membuatnya lebih mudah dibaca. Jika Anda menyalin contoh di bagian ini, Anda harus menghapus jeda baris tambahan agar dapat menghasilkan objek JSON yang valid.
## Catatan peristiwa disediakan oleh tindakan Lambda
Ketika Anda menambahkan tindakan Lambda ke aturan penerimaan, Amazon SES mengirimkan catatan peristiwa ke Lambda setiap kali mereka menerima pesan masuk. Peristiwa ini berisi informasi tentang beberapa header email untuk pesan masuk, serta hasil dari beberapa tes yang dilakukan Amazon SES pada pesan masuk. Namun, itu menghilangkan isi email yang masuk.
Contoh berikut menunjukkan nilai-nilai yang biasanya ada dalam catatan peristiwa ini.
```
{
"Records": [{
"eventSource": "aws:ses",
"eventVersion": "1.0",
"ses": {
"mail": {
"timestamp": "2019-08-05T21:30:02.028Z",
"source": "prvs=144d0cba7=sender@example.com",
"messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
"destination": ["recipient@example.com"],
"headersTruncated": false,
"headers": [{
"name": "Return-Path",
"value": ""
}, {
"name": "Received",
"value": "from smtp.example.com [203.0.113.0]) by inbound-smtp.us-east-1.amazonaws.com
with SMTP id bsvpsoklfhu7u50iur7h0kk9a2ou0r7iexample for recipient@example.com;
Mon, 05 Aug 2019 21:30:02 +0000 (UTC)"
}, {
"name": "X-SES-Spam-Verdict",
"value": "PASS"
}, {
"name": "X-SES-Virus-Verdict",
"value": "PASS"
}, {
"name": "Received-SPF",
"value": "pass (spfCheck: domain of example.com designates 203.0.113.0 as permitted sender)
client-ip=203.0.113.0; envelope-from=prvs=144d0cba42=sender@example.com; helo=
smtp.example.com;"
}, {
"name": "Authentication-Results",
"value": "amazonses.com; spf=pass (spfCheck: domain of example.com designates 203.0.113.0
as permitted sender) client-ip=203.0.113.0; envelope-from=prvs=144d0cba42=
sender@example.com; helo=smtp.example.com; dkim=pass header.i=@example.com;
dmarc=none header.from=example.com;"
}, {
"name": "X-SES-RECEIPT",
"value": "AEFBQUFBQUFBQUFHbFo0VU81VzVuYmRDNm51nhTVWpabDh6J4V2l5cG5PSHFtNzlBeUk90example"
}, {
"name": "X-SES-DKIM-SIGNATURE",
"value": "a=rsa-sha256; q=dns/txt; b=Cm1emU30VcD6example=; c=relaxed/simple; s=6gbrjpgwjs
5zn6fwqknexample; d=amazonses.com; t=1567719002; v=1; bh=DSofsjAoUvyZj6YsBDP5en
pRO1otGb7Nes0Qexample=; h=From:To:Cc:Bcc:Subject:Date:Message-ID:MIME-Version:
Content-Type:X-SES-RECEIPT;"
}, {
"name": "DKIM-Signature",
"value": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=example.com; i=@example.com; q=dns/txt;
s=example12345; t=1567719001; x=1599255001; h=from:to:subject:date:message-id:
references:in-reply-to:mime-version; bh=sjAoUvyZj6YsBDP5enpRO1otGb7s0Qexample=;
b=EQw2D4RLOW2IHE9OgfEA4WXp+AENJtaD2+63wmd5J+d+t/xoaiKUGClOS7WhpyOmlipryOz+iOhxU
v350xJIHjLTi9Jsnlw76mRK8o4770TaUz620joCVN21n4cxsrRZpv+1kS0EcAxaF30pmwlni+XT4ems
Vxn7zO0I8example=;"
}, {
"name": "Received",
"value": "from mail.example.com (mail.example.com [203.0.113.0]) by email-inbound-relay-
1d-9ec21598.us-east-1.example.com (Postfix) with ESMTPS id 57F83A2042 for
; Mon, 5 Aug 2019 21:29:58 +0000 (UTC)"
}, {
"name": "From",
"value": "\"Doe, John\" "
}, {
"name": "To",
"value": "\"recipient@example.com\" "
}, {
"name": "Subject",
"value": "This is a test"
}, {
"name": "Thread-Topic",
"value": "This is a test"
}, {
"name": "Thread-Index",
"value": "AQHVZDAaQ58yKI8q7kaAjkhC5stGexample"
}, {
"name": "Date",
"value": "Mon, 5 Aug 2019 21:29:57 +0000"
}, {
"name": "Message-ID",
"value": ""
}, {
"name": "References",
"value": "<1FCED16B-F6B0-4506-A6F0-594DFexample@example.com>"
}, {
"name": "In-Reply-To",
"value": "<1FCED16B-F6B0-4506-A6F0-594DFexample@example.com>"
}, {
"name": "Accept-Language",
"value": "en-US"
}, {
"name": "Content-Language",
"value": "en-US"
}, {
"name": "X-MS-Has-Attach",
"value": ""
}, {
"name": "X-MS-TNEF-Correlator",
"value": ""
}, {
"name": "x-ms-exchange-messagesentrepresentingtype",
"value": "1"
}, {
"name": "x-ms-exchange-transport-fromentityheader",
"value": "Hosted"
}, {
"name": "x-originating-ip",
"value": "[203.0.113.0]"
}, {
"name": "Content-Type",
"value": "multipart/alternative; boundary=\"_000_F8098FDD49A344F6112B195BDAexamplecom_\""
}, {
"name": "MIME-Version",
"value": "1.0"
}, {
"name": "Precedence",
"value": "Bulk"
}],
"commonHeaders": {
"returnPath": "prvs=144d0cba7=sender@example.com",
"from": ["\"Doe, John\" "],
"date": "Mon, 5 Aug 2019 21:29:57 +0000",
"to": ["\"recipient@example.com\" "],
"messageId": "",
"subject": "This is a test"
}
},
"receipt": {
"timestamp": "2019-08-05T21:30:02.028Z",
"processingTimeMillis": 1205,
"recipients": ["recipient@example.com"],
"spamVerdict": {
"status": "PASS"
},
"virusVerdict": {
"status": "PASS"
},
"spfVerdict": {
"status": "PASS"
},
"dkimVerdict": {
"status": "PASS"
},
"dmarcVerdict": {
"status": "GRAY"
},
"action": {
"type": "Lambda",
"functionArn": "arn:aws:lambda:us-east-1:123456789012:function:IncomingEmail",
"invocationType": "Event"
}
}
}
}]
}
```
## Catatan peristiwa yang disediakan oleh tindakan Amazon SNS
Ketika Anda menambahkan tindakan Amazon SNS ke aturan penerimaan Anda, notifikasi berisi seluruh isi email. Jika Anda ingin fungsi Lambda memproses isi email, Anda harus menambahkan tindakan Amazon SNS ke aturan tanda terima dan kemudian, di Amazon SNS, berlangganan fungsi Lambda Anda ke fungsi Amazon SNS. Konfigurasi ini menyebabkan fungsi Lambda Anda diaktifkan ketika menerima notifikasi dari topik Amazon SNS.
```
{
'Records': [
{
'EventSource': 'aws:sns',
'EventVersion': '1.0',
'EventSubscriptionArn': 'arn:aws:sns:us-east-1:123456789012:IncomingEmail:12345678',
'Sns': {
'Type': 'Notification',
'MessageId': 'EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000',
'TopicArn': 'arn:aws:sns:us-east-1:123456789012:IncomingEmail',
'Subject': 'Amazon SES Email Receipt Notification',
'Message': ,
'Timestamp': '2019-09-06T18:52:16.076Z',
'SignatureVersion': '1',
'Signature': '012345678901example==',
'SigningCertUrl': 'https://sns.us-east-1.amazonaws.com/SimpleNotificationService
-01234567890123456789012345678901.pem',
'UnsubscribeUrl': 'https://sns.us-east-1.amazonaws.com/?Action=Unsubscribe&
SubscriptionArn=arn:aws:sns:us-east-1:0123456789012:IncomingEmail:
0b863538-3f32-462e-9c89-8d8e0example',
'MessageAttributes': {}
}
}
]
}
```
Atribut `Message` berisi string JSON yang dikodekan. String ini berisi header dan isi pesan. Isi pesan itu sendiri merupakan base64 yang dikodekan. Jika Anda ingin menggunakan isi pesan di fungsi Lambda, Anda harus terlebih dahulu mendekode atribut `Message`, dan kemudian mendekode objek `Content`.
Contoh berikut menunjukkan nilai-nilai yang terkandung dalam atribut `Message`.
```
{
"notificationType": "Received",
"mail": {
"timestamp": "2019-09-06T18:52:14.965Z",
"source": "0100016d07eb7477-8e1938ce-475e-4e4b-89cb-example-000000@amazonses.com",
"messageId": "12345678901example",
"destination": ["recipient@example.com"],
"headersTruncated": false,
"headers": [{
"name": "Return-Path",
"value": "<0100016d07eb7477-8e1938ce-475e-4e4b-89cb-example-000000@amazonses.com>"
}, {
"name": "Received",
"value": "from a1-23.smtp-out.amazonses.com (a1-23.smtp-out.amazonses.com [203.0.113.0]) by
inbound-smtp.us-east-1.amazonaws.com with SMTP id
12345678901example for recipient@example.com; Fri, 06 Sep 2019
18:52:14 +0000 (UTC)"
}, {
"name": "X-SES-Spam-Verdict",
"value": "PASS"
}, {
"name": "X-SES-Virus-Verdict",
"value": "PASS"
}, {
"name": "Received-SPF",
"value": "pass (spfCheck: domain of amazonses.com designates 203.0.113.0 as permitted sender)
client-ip=203.0.113.0; envelope-from=0100016d07eb7477-8e1938ce-475e-4e4b-89cb-example
-000000@amazonses.com; helo=a1-23.smtp-out.amazonses.com;"
}, {
"name": "Authentication-Results",
"value": "amazonses.com; spf=pass (spfCheck: domain of amazonses.com designates 203.0.113.0
as permitted sender) client-ip=203.0.113.0; envelope-from=0100016d07eb7477-8e1938ce
-475e-4e4b-89cb-example-000000@amazonses.com; helo=a1-23.smtp-out.amazonses.com;
dkim=pass header.i=@amazonses.com; dmarc=none header.from=example.com;"
}, {
"name": "X-SES-RECEIPT",
"value": "AEFBQUFBQUFBQUFFQkx0QUJZZENEXAMPLE="
}, {
"name": "X-SES-DKIM-SIGNATURE",
"value": "a=rsa-sha256; q=dns/txt; b=d5azwgA2iBqAjA4NBm1ARzjJ95raRmy4G84iVdd3x2JzSHeUnQuTuLmJ
AqRrYY3WpMIVRFy01hITaguCVjUPWBR0xF6fCEXH85cf3RNeFQyLfWZqoXKfBdjFRV+13troDterH2MxBUL
8rjzcvdHetl0ImwlaK2PGmePTexample=; c=relaxed/simple; s=EXAMPLE7c191be45-e9aedb9a-02
f9-4d12-a87d-dd0099a07f8a-000000; d=amazonses.com; t=1567795935; v=1; bh=CZ1SghsYaA
6SSCbitzsLISeFoNlpdtH1Pyiexample=; h=From:To:Cc:Bcc:Subject:Date:Message-ID:MIME-
Version:Content-Type:X-SES-RECEIPT;"
}, {
"name": "DKIM-Signature",
"value": "v=1; a=rsa-sha256; q=dns/txt; c=relaxed/simple; s=EXAMPLE7c191be45-e9aedb9a-02f9-
4d12-a87d-dd0099a07f8a-000000; d=amazonses.com; t=1567795934; h=From:To:Subject:
MIME-Version:Content-Type:Message-ID:Date:Feedback-ID; bh=CZ1SghsYaA6SSCbitzsLISeFo
NlpdtH1Pyiexample=; b=L6VXqR1PSN/FYqJI/VAfPRKFgtakcHCYJvuJqVYbuJT8I3FOhqOvkbcgHxOgs
woxPfvGrL6S53H8Er5Do/CPvOM4Tx3ilE+a0GTYVLjKmwltNeN09YWlJAoqG5KMQPZUxRYaNvYPInLzUdGi
rdjkbSIgZEnrvq5MzaMWexample="
}, {
"name": "From",
"value": "sender@example.com"
}, {
"name": "To",
"value": "recipient@example.com"
}, {
"name": "Subject",
"value": "Amazon SES Test"
}, {
"name": "MIME-Version",
"value": "1.0"
}, {
"name": "Content-Type",
"value": "multipart/alternative; boundary=\"----=_Part_869787_396523212.15677example\""
}, {
"name": "Message-ID",
"value": "<0100016d07eb7477-8e1938ce-475e-4e4b-89cb-example-000000@email.amazonses.com>"
}, {
"name": "Date",
"value": "Fri, 6 Sep 2019 18:52:14 +0000"
}, {
"name": "X-SES-Outgoing",
"value": "2019.09.06-203.0.113.0"
}, {
"name": "Feedback-ID",
"value": "1.us-east-1.ZitRoTk0xziun8WEJevt+cSJ17QNuCwulg2D2v3nrT0=:AmazonSES"
}],
"commonHeaders": {
"returnPath": "0100016d07eb7477-8e1938ce-475e-4e4b-89cb-example-000000@amazonses.com",
"from": ["sender@example.com"],
"date": "Fri, 6 Sep 2019 18:52:14 +0000",
"to": ["recipient@example.com"],
"messageId": "<0100016d07eb7477-8e1938ce-475e-4e4b-89cb-example-000000@email.amazonses.com>",
"subject": "Amazon SES Test"
}
},
"receipt": {
"timestamp": "2019-09-06T18:52:14.965Z",
"processingTimeMillis": 1098,
"recipients": ["recipient@example.com"],
"spamVerdict": {
"status": "PASS"
},
"virusVerdict": {
"status": "PASS"
},
"spfVerdict": {
"status": "PASS"
},
"dkimVerdict": {
"status": "GRAY"
},
"dmarcVerdict": {
"status": "GRAY"
},
"action": {
"type": "SNS",
"topicArn": "arn:aws:sns:us-east-1:123456789012:IncomingEmail",
"encoding": "BASE64"
}
},
"content": "UmV0dXJuLVBhdGg6IDwwMTAwMDE2ZDA3ZWI3NDc3LThlMTkzOGNlLTQ3NWUtNGU0Yi04OWNiLWV4YW1wbGUtM
DAwMDAwQGFtYXpvbnNlcy5jb20+ClJlY2VpdmVkOiBmcm9tIGExLTIzLnNtdHAtb3V0LmFtYXpvbnNlcy5jb2
0gKGExLTIzLnNtdHAtb3V0LmFtYXpvbnNlcy5jb20gWzIwMy4wLjExMy4wXSkKIGJ5IGluYm91bmQtc210cC5
1cy1lYXN0LTEuYW1hem9uYXdzLmNvbSB3aXRoIFNNVFAgaWQgZW5xMTBpYW1lMXFjdTMxamg1ZGEyZ244OWlt
dm90Mms2ZXhhbXBsZQogZm9yIHJlY2lwaWVudEBleGFtcGxlLmNvbTsKIEZyaSwgMDYgU2VwIDIwMTkgMTg6N
TI6MTQgKzAwMDAgKFVUQykKWC1TRVMtU3BhbS1WZXJkaWN0OiBQQVNTClgtU0VTLVZpcnVzLVZlcmRpY3Q6IF
BBU1MKUmVjZWl2ZWQtU1BGOiBwYXNzIChzcGZDaGVjazogZG9tYWluIG9mIGFtYXpvbnNlcy5jb20gZGVzaWd
uYXRlcyAyMDMuMC4xMTMuMCBhcyBwZXJtaXR0ZWQgc2VuZGVyKSBjbGllbnQtaXA9MjAzLjAuMTEzLjA7IGVu
dmVsb3BlLWZyb209MDEwMDAxNmQwN2ViNzQ3Ny04ZTE5MzhjZS00NzVlLTRlNGItODljYi1leGFtcGxlLTAwM
DAwMEBhbWF6b25zZXMuY29tOyBoZWxvPWExLTIzLnNtdHAtb3V0LmFtYXpvbnNlcy5jb207CkF1dGhlbnRpY2
F0aW9uLVJlc3VsdHM6IGFtYXpvbnNlcy5jb207CiBzcGY9cGFzcyAoc3BmQ2hlY2s6IGRvbWFpbiBvZiBhbWF
6b25zZXMuY29tIGRlc2lnbmF0ZXMgMjAzLjAuMTEzLjAgYXMgcGVybWl0dGVkIHNlbmRlcikgY2xpZW50LWlw
PTIwMy4wLjExMy4wOyBlbnZlbG9wZS1mcm9tPTAxMDAwMTZkMDdlYjc0NzctOGUxOTM4Y2UtNDc1ZS00ZTRiL
Tg5Y2ItZXhhbXBsZS0wMDAwMDBAYW1hem9uc2VzLmNvbTsgaGVsbz1hMS0yMy5zbXRwLW91dC5hbWF6b25zZX
MuY29tOwogZGtpbT1wYXNzIGhlYWRlci5pPUBhbWF6b25zZXMuY29tOwogZG1hcmM9bm9uZSBoZWFkZXIuZnJ
vbT1leGFtcGxlLmNvbTsKWC1TRVMtUkVDRUlQVDogQUVGQlFVRkJRVUZCUVVGRlFreDBRVUpaWkVORVhBTVBM
RT0KWC1TRVMtREtJTS1TSUdOQVRVUkU6IGE9cnNhLXNoYTI1NjsgcT1kbnMvdHh0OyBiPWQ1YXp3Z0EyaUJxQ
WpBNE5CbTFBUnpqSjk1cmFSbXk0Rzg0aVZkZDN4Mkp6U0hlVW5RdVR1TG1KQXFScllZM1dwTUlWUkZ5MDFoSV
RhZ3VDVmpVUFdCUjB4RjZmQ0VYSDg1Y2YzUk5lRlF5TGZXWnFvWEtmQmRqRlJWKzEzdHJvRHRlckgyTXhCVUw
4cmp6Y3ZkSGV0bDBJbXdsYUsyUEdtZVBUZXhhbXBsZT07IGM9cmVsYXhlZC9zaW1wbGU7IHM9RVhBTVBMRTdj
MTkxYmU0NS1lOWFlZGI5YS0wMmY5LTRkMTItYTg3ZC1kZDAwOTlhMDdmOGEtMDAwMDAwOyBkPWFtYXpvbnNlc
y5jb207IHQ9MTU2Nzc5NTkzNTsgdj0xOyBiaD1DWjFTZ2hzWWFBNlNTQ2JpdHpzTElTZUZvTmxwZHRIMVB5aW
V4YW1wbGU9OyBoPUZyb206VG86Q2M6QmNjOlN1YmplY3Q6RGF0ZTpNZXNzYWdlLUlEOk1JTUUtVmVyc2lvbjp
Db250ZW50LVR5cGU6WC1TRVMtUkVDRUlQVDsKREtJTS1TaWduYXR1cmU6IHY9MTsgYT1yc2Etc2hhMjU2OyBx
PWRucy90eHQ7IGM9cmVsYXhlZC9zaW1wbGU7CglzPUVYQU1QTEU3YzE5MWJlNDUtZTlhZWRiOWEtMDJmOS00Z
DEyLWE4N2QtZGQwMDk5YTA3ZjhhLTAwMDAwMDsgZD1hbWF6b25zZXMuY29tOyB0PTE1Njc3OTU5MzQ7CgloPU
Zyb206VG86U3ViamVjdDpNSU1FLVZlcnNpb246Q29udGVudC1UeXBlOk1lc3NhZ2UtSUQ6RGF0ZTpGZWVkYmF
jay1JRDsKCWJoPUNaMVNnaHNZYUE2U1NDYml0enNMSVNlRm9ObHBkdEgxUHlpTWV4YW1wbGU9OwoJYj1leGFt
cGxlPQpGcm9tOiBzZW5kZXJAZXhhbXBsZS5jb20KVG86IHJlY2lwaWVudEBleGFtcGxlLmNvbQpTdWJqZWN0O
iBBbWF6b24gU0VTIFRlc3QKTUlNRS1WZXJzaW9uOiAxLjAKQ29udGVudC1UeXBlOiBtdWx0aXBhcnQvYWx0ZX
JuYXRpdmU7IAoJYm91bmRhcnk9Ii0tLS09X1BhcnRfODY5Nzg3XzM5NjUyMzIxMi4xNTY3N2V4YW1wbGUiCk1
lc3NhZ2UtSUQ6IDwwMTAwMDE2ZDA3ZWI3NDc3LThlMTkzOGNlLTQ3NWUtNGU0Yi04OWNiLWV4YW1wbGUtMDAw
MDAwQGVtYWlsLmFtYXpvbnNlcy5jb20+CkRhdGU6IEZyaSwgNiBTZXAgMjAxOSAxODo1MjoxNCArMDAwMApYL
VNFUy1PdXRnb2luZzogMjAxOS4wOS4wNi0yMDMuMC4xMTMuMApGZWVkYmFjay1JRDogMS51cy1lYXN0LTEuWm
l0Um9UazB4eml1bjhXRUpldnQrZXhhbXBsZT06QW1hem9uU0VTCgotLS0tLS09X1BhcnRfODY5Nzg3XzM5NjU
yMzIxMi4xNTY3N2V4YW1wbGUKQ29udGVudC1UeXBlOiB0ZXh0L3BsYWluOyBjaGFyc2V0PVVURi04CkNvbnRl
bnQtVHJhbnNmZXItRW5jb2Rpbmc6IDdiaXQKCkFtYXpvbiBTRVMgVGVzdApUaGlzIGVtYWlsIHdhcyBzZW50I
HdpdGggQW1hem9uIFNFUy4KLS0tLS0tPV9QYXJ0Xzg2OTc4N18zOTY1MjMyMTIuMTU2NzdleGFtcGxlCkNvbn
RlbnQtVHlwZTogdGV4dC9odG1sOyBjaGFyc2V0PVVURi04CkNvbnRlbnQtVHJhbnNmZXItRW5jb2Rpbmc6IDd
iaXQKCjxodG1sPgo8aGVhZD48L2hlYWQ+Cjxib2R5PgogIDxoMT5BbWF6b24gU0VTIFRlc3Q8L2gxPgogIDxw
PlRoaXMgZW1haWwgd2FzIHNlbnQgd2l0aCBBbWF6b24gU0VTLjwvcD4KPGltZyBhbHQ9IiIgc3JjPSJodHRwO
i8vZXhhbXBsZS5yLnVzLWVhc3QtMS5hd3N0cmFjay5tZS9JMC8wMTAwMDE2ZDA3ZWI3NDc3LThlMTkzOGNlLT
Q3NWUtNGU0Yi04OWNiLWV4YW1wbGUtMDAwMDAwL3UtWUphaHRkTTJTclhZQ2QiIHN0eWxlPSJkaXNwbGF5OiB
ub25lOyB3aWR0aDogMXB4OyBoZWlnaHQ6IDFweDsiPgo8L2JvZHk+CjwvaHRtbD4KICAgICAgICAgICAgCi0t
LS0tLT1fUGFydF84Njk3ODdfMzk2NTIzMjEyLjE1Njc3ZXhhbXBsZS0tCg=="
}
```
# Contoh kasus penggunaan
Contoh berikut menguraikan beberapa aturan yang mungkin Anda atur untuk menggunakan hasil fungsi Lambda untuk mengontrol aliran surat. Untuk tujuan demonstrasi, banyak dari contoh ini menggunakan tindakan S3 sebagai hasilnya.
## Kasus penggunaan 1: Menghapus spam di semua domain
Contoh ini menunjukkan aturan global yang menghapus spam di semua domain Anda. Aturan 2 dan 3 disertakan untuk menunjukkan bahwa Anda dapat menerapkan aturan khusus domain setelah spam dihapus di semua domain.
### Aturan 1
*Daftar penerima: *Kosong. Oleh karena itu, aturan ini akan berlaku untuk semua penerima di semua domain terverifikasi Anda.
*Tindakan*
1. Tindakan Lambda (sinkron) yang mengembalikan `STOP_RULE_SET` jika email tersebut adalah spam. Jika tidak, ia mengembalikan `CONTINUE`. Lihat contoh fungsi Lambda untuk menghapus spam di [Contoh fungsi Lambda](receiving-email-action-lambda-example-functions.md).
### Aturan 2
*Daftar penerima: *example1.com
*Tindakan*
1. Setiap tindakan.
### Aturan 3
*Daftar penerima: *contoh2.com
*Tindakan*
1. Setiap tindakan.
## Kasus penggunaan 2: Pentalkan spam ke semua domain
Contoh ini menunjukkan aturan global yang mementalkan spam di semua domain Anda. Aturan 2 dan 3 disertakan untuk menunjukkan bahwa Anda dapat menerapkan aturan khusus domain setelah spam dipentalkan di semua domain.
### Aturan 1
*Daftar penerima: *Kosong. Oleh karena itu, aturan ini akan berlaku untuk semua penerima di semua domain terverifikasi Anda.
*Tindakan*
1. Tindakan Lambda (sinkron) yang mengembalikan `CONTINUE` jika email tersebut adalah spam. Jika tidak, ia mengembalikan `STOP_RULE`.
1. Tindakan pentalan ("500 5.6.1. Isi pesan ditolak").
1. Hentikan tindakan.
### Aturan 2
*Daftar penerima: *contoh1.com
*Tindakan*
1. Setiap tindakan
### Aturan 3
*Daftar penerima: *contoh2.com
*Tindakan*
1. Setiap tindakan
## Kasus penggunaan 3: Menerapkan aturan yang paling spesifik
Contoh ini menunjukkan bagaimana Anda dapat menggunakan tindakan Berhenti untuk mencegah email diproses oleh beberapa aturan. Pada contoh ini, Anda memiliki satu aturan untuk alamat tertentu, dan aturan lain untuk semua alamat email di domain tersebut. Dengan menggunakan tindakan Berhenti, pesan yang sesuai dengan aturan untuk alamat email tertentu tidak diproses oleh aturan umum yang berlaku untuk domain.
### Aturan 1
*Daftar penerima: *pengguna@contoh.com
*Tindakan*
1. Tindakan Lambda (asinkron).
1. Hentikan tindakan.
### Aturan 2
*Daftar penerima: *contoh.com
*Tindakan*
1. Setiap tindakan.
## Kasus penggunaan 4: Log peristiwa email ke CloudWatch
Contoh ini menunjukkan cara menyimpan log audit semua email melalui sistem Anda sebelum menyimpan email tersebut ke Amazon SES.
### Aturan 1
*Daftar penerima: *contoh.com
*Tindakan*
1. Tindakan Lambda (asinkron) yang menulis objek peristiwa ke log. CloudWatch Contoh fungsi Lambda di [Contoh fungsi Lambda](receiving-email-action-lambda-example-functions.md) log to. CloudWatch
1. Tindakan S3.
## Kasus penggunaan 5: Menghapus email yang menggagalkan DKIM
Contoh ini menunjukkan bagaimana Anda dapat menyimpan semua email masuk ke bucket Amazon S3, tetapi hanya mengirimkan email yang masuk ke alamat email tertentu, dan lolos DKIM, ke aplikasi email otomatis Anda.
### Aturan 1
*Daftar penerima: *contoh.com
*Tindakan*
1. Tindakan S3.
1. Tindakan Lambda (sinkron) yang mengembalikan `STOP_RULE_SET` jika pesan menggagalkan DKIM. Jika tidak, ia mengembalikan `CONTINUE`.
### Aturan 2
*Daftar penerima: *support@contoh.com
*Tindakan*
1. Tindakan Lambda (asinkron) yang memicu aplikasi otomatis.
## Kasus penggunaan 6: Menyaring surat berdasarkan baris subjek
Contoh ini menunjukkan bagaimana Anda dapat menghapus semua email masuk domain yang berisi kata "diskon" di baris subjek, lalu memproses email yang ditujukan untuk sistem otomatis satu arah, dan memproses email yang ditujukan ke semua penerima lain di domain dengan cara berbeda.
### Aturan 1
*Daftar penerima: *contoh.com
*Tindakan*
1. Tindakan Lambda (sinkron) yang mengembalikan `STOP_RULE_SET` jika baris subjek berisi kata "diskon". Jika tidak, ia mengembalikan `CONTINUE`.
### Aturan 2
*Daftar penerima: *support@contoh.com
*Tindakan*
1. Tindakan S3 dengan bucket 1.
1. Tindakan Lambda (tidak sinkron) yang memicu aplikasi otomatis.
1. Hentikan tindakan.
### Aturan 3
*Daftar penerima: *contoh.com
*Tindakan*
1. Tindakan S3 dengan bucket 2.
1. Tindakan Lambda (tidak sinkron) yang memproses email untuk domain lainnya.
# Contoh fungsi Lambda
Topik ini berisi contoh fungsi Lambda yang mengendalikan aliran email.
## Contoh 1: Hapus spam
Contoh ini menghentikan pemrosesan pesan yang memiliki setidaknya satu indikator spam.
```
export const handler = async (event, context, callback) => {
console.log('Spam filter');
const sesNotification = event.Records[0].ses;
console.log("SES Notification:\n", JSON.stringify(sesNotification, null, 2));
// Check if any spam check failed
if (sesNotification.receipt.spfVerdict.status === 'FAIL'
|| sesNotification.receipt.dkimVerdict.status === 'FAIL'
|| sesNotification.receipt.spamVerdict.status === 'FAIL'
|| sesNotification.receipt.virusVerdict.status === 'FAIL') {
console.log('Dropping spam');
// Stop processing rule set, dropping message
callback(null, {'disposition':'STOP_RULE_SET'});
} else {
callback(null, {'disposition':'CONTINUE'});
}
};
```
## Contoh 2: Lanjutkan jika header tertentu ditemukan
Contoh ini terus memproses aturan saat ini hanya jika email berisi nilai header tertentu.
```
export const handler = async (event, context, callback) => {
console.log('Header matcher');
const sesNotification = event.Records[0].ses;
console.log("SES Notification:\n", JSON.stringify(sesNotification, null, 2));
// Iterate over the headers
for (let index in sesNotification.mail.headers) {
const header = sesNotification.mail.headers[index];
// Examine the header values
if (header.name === 'X-Header' && header.value === 'X-Value') {
console.log('Found header with value.');
callback(null, {'disposition':'CONTINUE'});
return;
}
}
// Stop processing the rule if the header value wasn't found
callback(null, {'disposition':'STOP_RULE'});
};
```
## Contoh 3: Mengambil email dari Amazon S3
Contoh ini mendapatkan email mentah dari Amazon S3 dan memprosesnya.
**catatan**
Anda harus terlebih dahulu menulis email ke Amazon S3 menggunakan Tindakan S3.
[Pastikan bahwa fungsi Lambda memiliki izin IAM untuk mengambil objek dari ember S3—lihat artikel re:Post ini untuk informasi selengkapnya.AWS](https://repost.aws/knowledge-center/lambda-execution-role-s3-bucket)
Ada kemungkinan bahwa batas waktu eksekusi Lambda default terlalu pendek untuk alur kerja Anda, pertimbangkan untuk meningkatkannya.
```
import { S3Client, GetObjectCommand } from "@aws-sdk/client-s3";
const bucketName = '';
export const handler = async (event, context, callback) => {
const client = new S3Client();
console.log('Process email');
var sesNotification = event.Records[0].ses;
console.log("SES Notification:\n", JSON.stringify(sesNotification, null, 2));
console.log("MessageId: " + sesNotification.mail.messageId)
const getObjectCommand = new GetObjectCommand({
Bucket: bucketName,
Key: sesNotification.mail.messageId
});
try {
const response = await client.send(getObjectCommand);
const receivedMail = await response.Body.transformToString();
console.log(receivedMail);
callback(null, {'disposition':'CONTINUE'})
} catch (e) {
// Perform error handling here
console.log("Encountered S3 client error: "+ e, e.stack);
callback(null, {'disposition':'STOP_RULE_SET'})
}
};
```
## Contoh 4: Pentalkan pesan yang menggagalkan autentikasi DMARC
Contoh ini mengirimkan pesan pentalan jika email yang masuk gagal autentikasi DMARC.
**catatan**
Saat menggunakan contoh ini, atur nilai variabel lingkungan `emailDomain` menjadi domain penerima email Anda.
Pastikan bahwa fungsi Lambda memiliki `ses:SendBounce` izin untuk identitas SES yang mengirim pesan bouncing.
```
import { SESClient, SendBounceCommand } from "@aws-sdk/client-ses";
const sesClient = new SESClient();
// Assign the emailDomain environment variable to a constant.
const emailDomain = process.env.emailDomain;
export const handler = async (event, context, callback) => {
console.log('Spam filter starting');
const sesNotification = event.Records[0].ses;
const messageId = sesNotification.mail.messageId;
const receipt = sesNotification.receipt;
console.log('Processing message:', messageId);
// If DMARC verdict is FAIL and the sending domain's policy is REJECT
// (p=reject), bounce the email.
if (receipt.dmarcVerdict.status === 'FAIL'
&& receipt.dmarcPolicy.status === 'REJECT') {
// The values that make up the body of the bounce message.
const sendBounceParams = {
BounceSender: `mailer-daemon@${emailDomain}`,
OriginalMessageId: messageId,
MessageDsn: {
ReportingMta: `dns; ${emailDomain}`,
ArrivalDate: new Date(),
ExtensionFields: [],
},
// Include custom text explaining why the email was bounced.
Explanation: "Unauthenticated email is not accepted due to the sending domain's DMARC policy.",
BouncedRecipientInfoList: receipt.recipients.map((recipient) => ({
Recipient: recipient,
// Bounce with 550 5.6.1 Message content rejected
BounceType: 'ContentRejected',
})),
};
console.log('Bouncing message with parameters:');
console.log(JSON.stringify(sendBounceParams, null, 2));
const sendBounceCommand = new SendBounceCommand(sendBounceParams);
// Try to send the bounce.
try {
const response = await sesClient.send(sendBounceCommand);
console.log(response);
console.log(`Bounce for message ${messageId} sent, bounce message ID: ${response.MessageId}`);
// Stop processing additional receipt rules in the rule set.
callback(null, {disposition: 'STOP_RULE_SET'});
} catch (e) {
// If something goes wrong, log the issue.
console.log(`An error occurred while sending bounce for message: ${messageId}`, e);
// Perform any additional error handling here
callback(e)
}
// If the DMARC verdict is anything else (PASS, QUARANTINE or GRAY), accept
// the message and process remaining receipt rules in the rule set.
} else {
console.log('Accepting message:', messageId);
callback(null, {disposition: 'CONTINUE'});
}
};
```
# Mengirimkan ke tindakan bucket S3
Tindakan **bucket Deliver to S3 mengirimkan email ke bucket** S3 dan secara opsional dapat memberi tahu Anda melalui SNS dan banyak lagi. Tindakan ini memiliki opsi berikut.
+ **Bucket S3** — Nama bucket S3 untuk menyimpan email yang diterima. Anda juga dapat membuat bucket S3 baru saat menyiapkan tindakan dengan memilih **Buat Bucket S3**. Amazon SES memberikan Anda email mentah yang tidak dimodifikasi yang umumnya dalam format Multipurpose Internet Mail Extensions (MIME). Untuk informasi lebih lanjut tentang format MIME, lihat [RFC 2045](https://tools.ietf.org/html/rfc2045).
**penting**
Bucket Amazon S3 harus ada di wilayah di mana SES [Penerimaan email](regions.md#region-receive-email) tersedia; jika tidak, Anda harus menggunakan opsi peran IAM yang dijelaskan di bawah ini.
Saat Anda menyimpan email ke bucket S3, ukuran email maksimum default (termasuk header) adalah 40 MB.
SES tidak mendukung aturan penerimaan yang mengunggah ke bucket S3 yang diaktifkan dengan kunci objek yang dikonfigurasi dengan periode retensi default.
Jika menerapkan enkripsi pada bucket S3 Anda dengan menentukan kunci KMS Anda sendiri, pastikan untuk menggunakan ARN kunci KMS yang sepenuhnya memenuhi syarat, dan bukan alias kunci KMS; menggunakan alias dapat mengakibatkan data dienkripsi dengan kunci KMS milik pemohon, dan bukan administrator bucket. Lihat [Menggunakan enkripsi untuk operasi lintas akun](https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucket-encryption.html#bucket-encryption-update-bucket-policy).
+ **Object key prefix** — Sebuah awalan nama kunci opsional untuk digunakan dalam bucket S3. Awalan nama kunci memungkinkan Anda mengatur bucket S3 Anda dalam struktur folder. *Misalnya, jika Anda menggunakan *Email* sebagai **key prefix Object**, email Anda akan muncul di bucket S3 di folder bernama Email.*
+ **Enkripsi pesan** — Opsi untuk mengenkripsi pesan email yang diterima sebelum mengirimkannya ke bucket S3 Anda.
+ **Kunci enkripsi KMS** - (Tersedia jika *enkripsi Pesan* dipilih.) AWS KMS Kunci yang harus digunakan SES untuk mengenkripsi email Anda sebelum menyimpannya ke ember S3. Anda dapat menggunakan kunci KMS default atau kunci terkelola pelanggan yang Anda buat di KMS.
**catatan**
Kunci KMS yang Anda pilih harus berada di AWS wilayah yang sama dengan titik akhir SES yang Anda gunakan untuk menerima email.
+ Untuk menggunakan kunci KMS default, pilih **aws/ses** saat Anda mengatur aturan tanda terima di konsol SES. Jika Anda menggunakan SES API, Anda dapat menentukan kunci KMS default dengan menyediakan ARN dalam bentuk. `arn:aws:kms:REGION:AWSACCOUNTID:alias/aws/ses` Misalnya, jika ID AWS akun Anda adalah 123456789012 dan Anda ingin menggunakan kunci KMS default di wilayah us-east-1, ARN dari kunci KMS default adalah. `arn:aws:kms:us-east-1:123456789012:alias/aws/ses` Jika Anda menggunakan kunci KMS default, Anda tidak perlu melakukan langkah tambahan untuk memberikan izin SES untuk menggunakan kunci tersebut.
+ Untuk menggunakan kunci terkelola pelanggan yang Anda buat di KMS, berikan ARN kunci KMS dan pastikan Anda menambahkan pernyataan ke kebijakan kunci Anda untuk memberikan izin SES untuk menggunakannya. Untuk informasi lebih lanjut tentang memberi izin, lihat [Memberikan izin ke Amazon SES untuk menerima email](receiving-email-permissions.md).
Untuk informasi selengkapnya tentang penggunaan KMS dengan SES, lihat [Panduan AWS Key Management Service Pengembang](https://docs.aws.amazon.com/kms/latest/developerguide/services-ses.html). Jika Anda tidak menentukan kunci KMS di konsol atau API, SES tidak akan mengenkripsi email Anda.
**penting**
Email Anda dienkripsi oleh SES menggunakan klien enkripsi S3 sebelum surat dikirimkan ke S3 untuk penyimpanan. Itu tidak dienkripsi menggunakan enkripsi sisi server S3. Ini berarti Anda harus menggunakan klien enkripsi S3 untuk mendekripsi email setelah mengambilnya dari S3, karena layanan tidak memiliki akses untuk menggunakan kunci KMS Anda untuk dekripsi. Klien enkripsi ini tersedia di [AWS SDK untuk Java](https://aws.amazon.com/sdk-for-java/) dan [AWS SDK untuk Ruby](https://aws.amazon.com/sdk-for-ruby/). Untuk informasi selengkapnya, lihat [Panduan Pengguna Amazon Simple Storage Service](https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingClientSideEncryption.html).
+ Peran **IAM — Peran** IAM yang digunakan oleh SES untuk mengakses sumber daya dalam aksi *Deliver to S3* (bucket Amazon S3, topik SNS, dan kunci KMS). Jika tidak disediakan, Anda harus secara eksplisit memberikan izin kepada SES untuk mengakses setiap sumber daya secara individual—lihat. [Memberikan izin ke Amazon SES untuk menerima email](receiving-email-permissions.md)
Jika Anda ingin menulis ke bucket S3 yang ada di wilayah di mana *penerimaan Email* SES tidak tersedia, Anda harus menggunakan peran IAM yang memiliki kebijakan izin tulis ke S3 sebagai kebijakan peran sebaris. Anda dapat menerapkan kebijakan izin untuk tindakan ini langsung dari konsol:
1. Pilih **Buat peran baru** di bidang **peran IAM** dan masukkan nama diikuti oleh **Buat peran**. (Kebijakan kepercayaan IAM untuk peran ini akan dibuat secara otomatis di latar belakang.)
1. Karena kebijakan kepercayaan IAM dibuat secara otomatis, Anda hanya perlu menambahkan kebijakan izin tindakan ke peran—pilih **Lihat peran di bawah bidang peran** **IAM untuk membuka konsol IAM**.
1. Di bawah tab **Izin**, pilih **Tambahkan izin** dan pilih **Buat kebijakan sebaris**.
1. Pada halaman **Tentukan izin**, pilih **JSON** di Editor **kebijakan**.
1. Salin dan tempel kebijakan izin dari [Izin peran IAM untuk tindakan S3](receiving-email-permissions.md#receiving-email-permissions-s3-iam-role) ke **editor Kebijakan** dan ganti data dalam teks merah dengan milik Anda. (Pastikan untuk menghapus kode contoh apa pun di editor.)
1. Pilih **Berikutnya**.
1. Tinjau dan buat kebijakan izin Anda untuk peran IAM dengan memilih **Buat kebijakan**.
1. Pilih tab browser Anda di mana Anda memiliki **aturan SES Create** — **Tambahkan halaman tindakan** terbuka dan lanjutkan dengan langkah-langkah yang tersisa untuk membuat aturan.
+ **Topik SNS** - Nama atau ARN dari topik Amazon SNS untuk memberi tahu saat email disimpan ke ember S3. Contoh topik SNS ARN adalah *arn:aws:sns:us-east- 1:123456789012:*. MyTopic Anda juga dapat membuat topik SNS saat mengatur tindakan dengan memilih **Buat Topik SNS**. Untuk informasi selengkapnya tentang topik SNS, lihat [Panduan Pengembang Layanan Pemberitahuan Sederhana Amazon](https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html).
**catatan**
Topik SNS yang Anda pilih harus berada di AWS wilayah yang sama dengan titik akhir SES yang Anda gunakan untuk menerima email.
Hanya gunakan enkripsi kunci KMS yang *dikelola pelanggan* dengan topik SNS yang Anda kaitkan dengan aturan tanda terima SES karena Anda akan diminta untuk mengedit kebijakan kunci KMS untuk memungkinkan SES mempublikasikan ke SNS. Hal ini berbeda dengan kebijakan kunci KMS *AWS terkelola* yang tidak dapat diedit oleh desain.
# Terbitkan ke topik tindakan Amazon SNS
Tindakan **SNS** mempublikasikan email menggunakan notifikasi Amazon SNS. Notifikasi menyertakan konten email yang lengkap. Tindakan ini memiliki opsi berikut.
+ **Topik SNS—**Nama atau ARN dari topik Amazon SNS yang akan digunakan untuk mempublikasikan email. Notifikasi Amazon SNS akan berisi salinan email yang mentah dan tidak dimodifikasi, yang umumnya dalam format Multipurpose Internet Mail Extensions (MIME). Untuk informasi lebih lanjut tentang format MIME, lihat [RFC 2045](https://tools.ietf.org/html/rfc2045).
**penting**
Jika Anda memilih untuk menerima email Anda melalui notifikasi Amazon SNS, ukuran maksimum email (termasuk header) adalah 150 KB. Email yang lebih besar akan terpental. Jika Anda menginginkan email yang lebih besar dari ini, simpan email ke bucket Amazon S3.
Contoh topik Amazon SNS ARN adalah *arn:aws:sns:us-east* - 1:123456789012:. MyTopic Anda juga dapat membuat topik Amazon SNS saat mengatur tindakan dengan memilih **Buat Topik SNS**. Untuk informasi lebih lanjut tentang topik Amazon SNS, lihat [Panduan Developer Amazon Simple Notification Service](https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html).
**catatan**
Topik Amazon SNS yang Anda pilih harus berada di AWS wilayah yang sama dengan titik akhir Amazon SES yang Anda gunakan untuk menerima email.
Hanya gunakan enkripsi kunci KMS yang *dikelola pelanggan* dengan topik SNS yang Anda kaitkan dengan aturan tanda terima SES karena Anda akan diminta untuk mengedit kebijakan kunci KMS untuk memungkinkan SES mempublikasikan ke SNS. Hal ini berbeda dengan kebijakan kunci KMS *AWS terkelola* yang tidak dapat diedit oleh desain.
+ **Pengodean—**Pengodean yang digunakan untuk email dalam notifikasi Amazon SNS. UTF-8 lebih mudah untuk digunakan, namun mungkin tidak mempertahankan semua karakter khusus ketika pesan dikodekan dengan format pengodean yang berbeda. Base64 mempertahankan semua karakter khusus. Untuk informasi tentang UTF-8 dan Base64, lihat [RFC 3629](https://tools.ietf.org/html/rfc3629) dan [RFC 4648](https://tools.ietf.org/html/rfc4648), secara berurutan.
Ketika Anda menerima email, Amazon SES mengeksekusi aturan dalam set aturan penerimaan yang aktif. Anda dapat mengonfigurasi aturan penerimaan untuk mengirimkan notifikasi menggunakan Amazon SNS. Aturan tanda penerimaan dapat mengirimkan dua tipe notifikasi yang berbeda:
+ **Notifikasi yang dikirim dari tindakan SNS** — Saat Anda menambahkan tindakan [SNS](#receiving-email-action-sns) untuk aturan penerimaan, SNS mengirimkan informasi tentang email serta konten email tersebut. Jika pesan berukuran 150KB atau lebih kecil, tipe notifikasi ini juga mencakup email dengan badan MIME yang lengkap.
+ **Pemberitahuan yang dikirim dari jenis tindakan lain** — Saat menambahkan jenis tindakan lain (termasuk [Bounce](receiving-email-action-bounce.md), [Lambda](receiving-email-action-lambda.md), Set [Aturan Hentikan, [WorkMail](receiving-email-action-workmail.md)](receiving-email-action-stop.md)atau tindakan) ke aturan tanda terima, Anda dapat menentukan topik Amazon SNS secara opsional. Jika Anda melakukannya, Anda akan menerima notifikasi saat tindakan ini dilakukan. Notifikasi ini berisi informasi tentang email, tetapi tidak berisi konten email.
**Topics**
+ [Isi notifikasi untuk menerima email Amazon SES](receiving-email-notifications-contents.md)
+ [Contoh notifikasi untuk menerima email Amazon SES](receiving-email-notifications-examples.md)
# Isi notifikasi untuk menerima email Amazon SES
Semua notifikasi untuk penerimaan email dipublikasikan ke topik Amazon Simple Notification Service (Amazon SNS) JavaScript dalam format Object Notation (JSON).
Misalnya notifikasi, lihat[Contoh notifikasi](receiving-email-notifications-examples.md).
**Contents**
+ [Objek JSON tingkat atas](#receiving-email-notifications-contents-top-level-json-object)
+ [Objek penerimaan](#receiving-email-notifications-contents-receipt-object)
+ [objek tindakan](#receiving-email-notifications-contents-action-object)
+ [Objek dkimVerdict](#receiving-email-notifications-contents-dkimverdict-object)
+ [Objek dmarcVerdict](#receiving-email-notifications-contents-dmarcverdict-object)
+ [Objek spamVerdict](#receiving-email-notifications-contents-spamverdict-object)
+ [Objek spfVerdict](#receiving-email-notifications-contents-spfverdict-object)
+ [Objek virusVerdict](#receiving-email-notifications-contents-virusverdict-object)
+ [objek surat](#receiving-email-notifications-contents-mail-object)
+ [Objek commonHeaders](#receiving-email-notifications-contents-mail-object-commonHeaders)
## Objek JSON tingkat atas
Objek JSON tingkat atas berisi beberapa bidang berikut.
| Nama Bidang | Deskripsi |
| --- | --- |
| notificationType | Tipe notifikasi. Untuk tipe notifikasi ini, nilainya selalu `Received`. |
| [`receipt`](#receiving-email-notifications-contents-receipt-object) | Objek yang berisi informasi tentang pengiriman email. |
| [`mail`](#receiving-email-notifications-contents-mail-object) | Objek yang berisi informasi tentang email yang terkait dengan notifikasi. |
| content | String yang berisi email mentah dan tidak dimodifikasi, yang umumnya dalam format Multipurpose Internet Mail Extensions (MIME). Untuk informasi lebih lanjut tentang format MIME, lihat [RFC 2045](https://tools.ietf.org/html/rfc2045). Bidang ini hanya ada jika notifikasi dipicu oleh tindakan SNS. Notifikasi yang dipicu oleh semua tindakan lain tidak menahan bidang ini. |
## Objek penerimaan
Objek `receipt` berisi bidang-bidang berikut.
| Nama Bidang | Deskripsi |
| --- | --- |
| [`action`](#receiving-email-notifications-contents-action-object) | Objek yang merangkum informasi tentang tindakan yang dieksekusi. Untuk daftar peluang nilai, lihat [objek tindakan](#receiving-email-notifications-contents-action-object). |
| [`dkimVerdict`](#receiving-email-notifications-contents-dkimverdict-object) | Objek yang menunjukkan apakah cek DomainKeys Identified Mail (DKIM) lulus. Untuk daftar peluang nilai, lihat [Objek dkimVerdict](#receiving-email-notifications-contents-dkimverdict-object). |
| dmarcPolicy | Mengindikasikan pengaturan autentikasi pesan, pelaporan & kesesuaian berbasis Domain (DMARC) untuk domain pengiriman. Bidang ini hanya muncul jika pesan gagal diautentikasi DMARC. Peluang nilai untuk kolom ini meliputi:[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/ses/latest/dg/receiving-email-notifications-contents.html) |
| [`dmarcVerdict`](#receiving-email-notifications-contents-dmarcverdict-object) | Objek yang mengindikasikan apakah pengecekan pada Pesan Autentikasi, Pelaporan & kesesuaian berbasis Domain (DMARC) sudah berlalu. Untuk daftar peluang nilai, lihat [Objek dmarcVerdict](#receiving-email-notifications-contents-dmarcverdict-object). |
| processingTimeMillis | String yang menentukan tanda titik, dalam milidetik, pada saat Amazon SES menerima pesan ketika Amazon SES tersebut memicu tindakan. |
| recipients | [Penerima (khususnya, amplop alamat RCPT TO) yang dicocokkan dengan aturan tanda terima aktif.](receiving-email-receipt-rules-console-walkthrough.md) Alamat yang tercantum di sini mungkin berbeda dari yang tercantum oleh bidang `destination` di bidang [objek surat](#receiving-email-notifications-contents-mail-object). |
| [`spamVerdict`](#receiving-email-notifications-contents-spamverdict-object) | Objek yang mengidikasikan apakah pesan adalah spam. Untuk daftar peluang nilai, lihat [Objek spamVerdict](#receiving-email-notifications-contents-spamverdict-object). |
| [`spfVerdict`](#receiving-email-notifications-contents-spfverdict-object) | Objek yang mengindikasikan apakah pemeriksaan Pengirim Kebijakan Kerangka Kerja (SPF) sudah berlalu. Untuk daftar peluang nilai, lihat [Objek spfVerdict](#receiving-email-notifications-contents-spfverdict-object). |
| timestamp | String yang menentukan tanggal dan waktu yang memenuhi syarat pada saat tindakan dipicu, di format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). |
| [Virus Putusan](#receiving-email-notifications-contents-virusverdict-object) | Objek yang menunjukkan apakah pesan berisi virus. Untuk daftar peluang nilai, lihat [Objek virusVerdict](#receiving-email-notifications-contents-virusverdict-object). |
### objek tindakan
Objek `action` berisi bidang-bidang berikut.
| Nama Bidang | Deskripsi |
| --- | --- |
| type | String yang mengindikasikan tipe tindakan yang dieksekusi. Peluang nilai adalah `S3`, `SNS`, `Bounce`, `Lambda`, `Stop`, dan `WorkMail`. |
| topicArn | String yang berisi Amazon Resource Name (ARN) dari topik Amazon SNS yang dipublikasikan oleh notifikasi. |
| bucketName | String yang berisi nama bucket Amazon S3 yang diterbitkan pesan. Hadir hanya untuk tipe tindakan S3. |
| objectKey | String dengan nama yang secara unik mengidentifikasi email dalam bucket Amazon S3. Ini sama dengan `messageId` di [objek surat](#receiving-email-notifications-contents-mail-object). Hadir hanya untuk tipe tindakan S3. |
| smtpReplyCode | String yang berisi kode balasan SMTP, seperti yang didefinisikan oleh [RFC 5321](https://tools.ietf.org/html/rfc5321). Hadir hanya untuk tipe tindakan pentalan. |
| statusCode | String dengan kode status yang ditingkatkan SMTP, seperti yang didefinisikan oleh [RFC 3463](https://tools.ietf.org/html/rfc3463). Hadir hanya untuk tipe tindakan pentalan. |
| message | String yang berisi teks yang dapat dibaca manusia untuk dimasukkan dalam pesan pentalan. Hadir hanya untuk tipe tindakan pentalan. |
| sender | String yang berisi alamat email dari pengirim email yang memantul. Ini adalah alamat dari mana pesan pentalan dikirim. Hadir hanya untuk tipe tindakan pentalan. |
| functionArn | String yang berisi ARN fungsi Lambda yang dipicu. Hadir hanya untuk tipe tindakan Lambda. |
| invocationType | String yang berisi tipe invokasi fungsi Lambda. Kemungkinan nilai adalah `RequestResponse` dan `Event`. Hadir hanya untuk tipe tindakan Lambda. |
| organizationArn | String yang berisi ARN dari organisasi Amazon WorkMail. Hadir hanya untuk tipe WorkMail tindakan. |
### Objek dkimVerdict
Objek `dkimVerdict` berisi bidang-bidang berikut.
| Nama Bidang | Deskripsi |
| --- | --- |
| status | String yang berisi DKIM verdict. Kemungkinan nilai adalah: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/ses/latest/dg/receiving-email-notifications-contents.html) |
### Objek dmarcVerdict
Objek `dmarcVerdict` berisi bidang-bidang berikut.
| Nama Bidang | Deskripsi |
| --- | --- |
| status | String yang berisi DMARC verdict. Kemungkinan nilai adalah: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/ses/latest/dg/receiving-email-notifications-contents.html) |
### Objek spamVerdict
Objek `spamVerdict` berisi bidang-bidang berikut.
| Nama Bidang | Deskripsi |
| --- | --- |
| status | String yang berisi hasil pemindaian spam. Kemungkinan nilai adalah: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/ses/latest/dg/receiving-email-notifications-contents.html) |
### Objek spfVerdict
Objek `spfVerdict` berisi bidang-bidang berikut.
| Nama Bidang | Deskripsi |
| --- | --- |
| status | String yang berisi SPF verdict. Kemungkinan nilai adalah: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/ses/latest/dg/receiving-email-notifications-contents.html) |
### Objek virusVerdict
Objek `virusVerdict` berisi bidang-bidang berikut.
| Nama Bidang | Deskripsi |
| --- | --- |
| status | String yang berisi hasil pemindaian virus. Kemungkinan nilai adalah: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/ses/latest/dg/receiving-email-notifications-contents.html) |
## objek surat
Objek `mail` berisi bidang-bidang berikut.
| Nama Bidang | Deskripsi |
| --- | --- |
| destination | Daftar lengkap untuk semua penerima alamat (termasuk penerima Kepada: dan CC:) dari header email MIME yang masuk. |
| messageId | String yang berisi ID unik yang ditetapkan ke email oleh Amazon SES. Jika email dikirim ke Amazon S3, ID pesan juga merupakan kunci objek Amazon S3 yang digunakan untuk menulis pesan ke bucket Amazon S3 Anda. |
| source | String yang berisi alamat email (khususnya, alamat envelope MAIL FROM) tempat email dikirimkan. |
| timestamp | String yang berisi waktu di mana email diterima, dalam ISO8601 format. |
| headers | Header Amazon SES dan header kustom Anda. Setiap header memiliki bidang berikut: `name` dan`value`. |
| [`commonHeaders`](#receiving-email-notifications-contents-mail-object-commonHeaders) | Header umum untuk semua email. Setiap header memiliki bidang berikut: `name` dan`value`. |
| headersTruncated | Menentukan apakah header dipotong dalam notifikasi, yang terjadi jika header lebih besar dari 10 KB. Kemungkinan nilai adalah `true` dan `false`. |
### Objek commonHeaders
Objek `commonHeaders` dapat memiliki bidang yang ditunjukkan dalam tabel berikut. Bidang yang ada dalam objek ini bervariasi tergantung pada bidang yang ada dalam email masuk.
| Nama Bidang | Deskripsi |
| --- | --- |
| messageId | ID dari pesan asli. |
| date | Tanggal dan waktu ketika Amazon SES menerima pesan. |
| to | ToHeader email. |
| cc | CCHeader email. |
| bcc | BCCHeader email. |
| from | FromHeader email. |
| sender | SenderHeader email. |
| returnPath | Return-PathHeader email. |
| replyTo | Reply-ToHeader email. |
| subject | SubjectHeader email. |
# Contoh notifikasi untuk menerima email Amazon SES
Bagian ini mencakup contoh tipe notifikasi berikut:
+ [Pemberitahuan yang dikirim sebagai hasil dari tindakan SNS.](#receiving-email-notifications-examples-sns-action)
+ [Notifikasi yang dikirim sebagai hasil dari tipe tindakan lain](#receiving-email-notifications-examples-alert)(sebuah *pemberitahuan peringatan*).
## Notifikasi tindakan SNS
Bagian ini berisi contoh notifikasi tindakan SNS. Tidak seperti notifikasi pemberitahuan yang ditampilkan sebelumnya, hal itu termasuk bagian `content` yang berisi email, yang umumnya dalam format Multipurpose Internet Mail Extensions (MIME).
```
{
"notificationType":"Received",
"receipt":{
"timestamp":"2015-09-11T20:32:33.936Z",
"processingTimeMillis":222,
"recipients":[
"recipient@example.com"
],
"spamVerdict":{
"status":"PASS"
},
"virusVerdict":{
"status":"PASS"
},
"spfVerdict":{
"status":"PASS"
},
"dkimVerdict":{
"status":"PASS"
},
"action":{
"type":"SNS",
"topicArn":"arn:aws:sns:us-east-1:012345678912:example-topic"
}
},
"mail":{
"timestamp":"2015-09-11T20:32:33.936Z",
"source":"61967230-7A45-4A9D-BEC9-87CBCF2211C9@example.com",
"messageId":"d6iitobk75ur44p8kdnnp7g2n800",
"destination":[
"recipient@example.com"
],
"headersTruncated":false,
"headers":[
{
"name":"Return-Path",
"value":"<0000014fbe1c09cf-7cb9f704-7531-4e53-89a1-5fa9744f5eb6-000000@amazonses.com>"
},
{
"name":"Received",
"value":"from a9-183.smtp-out.amazonses.com (a9-183.smtp-out.amazonses.com [54.240.9.183]) by inbound-smtp.us-east-1.amazonaws.com with SMTP id d6iitobk75ur44p8kdnnp7g2n800 for recipient@example.com; Fri, 11 Sep 2015 20:32:33 +0000 (UTC)"
},
{
"name":"DKIM-Signature",
"value":"v=1; a=rsa-sha256; q=dns/txt; c=relaxed/simple; s=ug7nbtf4gccmlpwj322ax3p6ow6yfsug; d=amazonses.com; t=1442003552; h=From:To:Subject:MIME-Version:Content-Type:Content-Transfer-Encoding:Date:Message-ID:Feedback-ID; bh=DWr3IOmYWoXCA9ARqGC/UaODfghffiwFNRIb2Mckyt4=; b=p4ukUDSFqhqiub+zPR0DW1kp7oJZakrzupr6LBe6sUuvqpBkig56UzUwc29rFbJF hlX3Ov7DeYVNoN38stqwsF8ivcajXpQsXRC1cW9z8x875J041rClAjV7EGbLmudVpPX 4hHst1XPyX5wmgdHIhmUuh8oZKpVqGi6bHGzzf7g="
},
{
"name":"From",
"value":"sender@example.com"
},
{
"name":"To",
"value":"recipient@example.com"
},
{
"name":"Subject",
"value":"Example subject"
},
{
"name":"MIME-Version",
"value":"1.0"
},
{
"name":"Content-Type",
"value":"text/plain; charset=UTF-8"
},
{
"name":"Content-Transfer-Encoding",
"value":"7bit"
},
{
"name":"Date",
"value":"Fri, 11 Sep 2015 20:32:32 +0000"
},
{
"name":"Message-ID",
"value":"<61967230-7A45-4A9D-BEC9-87CBCF2211C9@example.com>"
},
{
"name":"X-SES-Outgoing",
"value":"2015.09.11-54.240.9.183"
},
{
"name":"Feedback-ID",
"value":"1.us-east-1.Krv2FKpFdWV+KUYw3Qd6wcpPJ4Sv/pOPpEPSHn2u2o4=:AmazonSES"
}
],
"commonHeaders":{
"returnPath":"0000014fbe1c09cf-7cb9f704-7531-4e53-89a1-5fa9744f5eb6-000000@amazonses.com",
"from":[
"sender@example.com"
],
"date":"Fri, 11 Sep 2015 20:32:32 +0000",
"to":[
"recipient@example.com"
],
"messageId":"<61967230-7A45-4A9D-BEC9-87CBCF2211C9@example.com>",
"subject":"Example subject"
}
},
"content":"Return-Path: <61967230-7A45-4A9D-BEC9-87CBCF2211C9@example.com>\r\nReceived: from a9-183.smtp-out.amazonses.com (a9-183.smtp-out.amazonses.com [54.240.9.183])\r\n by inbound-smtp.us-east-1.amazonaws.com with SMTP id d6iitobk75ur44p8kdnnp7g2n800\r\n for recipient@example.com;\r\n Fri, 11 Sep 2015 20:32:33 +0000 (UTC)\r\nDKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/simple;\r\n\ts=ug7nbtf4gccmlpwj322ax3p6ow6yfsug; d=amazonses.com; t=1442003552;\r\n\th=From:To:Subject:MIME-Version:Content-Type:Content-Transfer-Encoding:Date:Message-ID:Feedback-ID;\r\n\tbh=DWr3IOmYWoXCA9ARqGC/UaODfghffiwFNRIb2Mckyt4=;\r\n\tb=p4ukUDSFqhqiub+zPR0DW1kp7oJZakrzupr6LBe6sUuvqpBkig56UzUwc29rFbJF\r\n\thlX3Ov7DeYVNoN38stqwsF8ivcajXpQsXRC1cW9z8x875J041rClAjV7EGbLmudVpPX\r\n\t4hHst1XPyX5wmgdHIhmUuh8oZKpVqGi6bHGzzf7g=\r\nFrom: sender@example.com\r\nTo: recipient@example.com\r\nSubject: Example subject\r\nMIME-Version: 1.0\r\nContent-Type: text/plain; charset=UTF-8\r\nContent-Transfer-Encoding: 7bit\r\nDate: Fri, 11 Sep 2015 20:32:32 +0000\r\nMessage-ID: <61967230-7A45-4A9D-BEC9-87CBCF2211C9@example.com>\r\nX-SES-Outgoing: 2015.09.11-54.240.9.183\r\nFeedback-ID: 1.us-east-1.Krv2FKpFdWV+KUYw3Qd6wcpPJ4Sv/pOPpEPSHn2u2o4=:AmazonSES\r\n\r\nExample content\r\n"
}
```
## Notifikasi pemberitahuan
Bagian ini berisi contoh notifikasi Amazon SNS yang dapat dipicu oleh tindakan S3. Pemberitahuan yang dipicu oleh tindakan Lambda, tindakan pantulan, tindakan berhenti, dan WorkMail tindakan serupa. Meskipun notifikasi berisi informasi tentang email, notifikasi tersebut tidak berisi isi email itu sendiri.
```
{
"notificationType": "Received",
"receipt": {
"timestamp": "2015-09-11T20:32:33.936Z",
"processingTimeMillis": 406,
"recipients": [
"recipient@example.com"
],
"spamVerdict": {
"status": "PASS"
},
"virusVerdict": {
"status": "PASS"
},
"spfVerdict": {
"status": "PASS"
},
"dkimVerdict": {
"status": "PASS"
},
"action": {
"type": "S3",
"topicArn": "arn:aws:sns:us-east-1:012345678912:example-topic",
"bucketName": "my-S3-bucket",
"objectKey": "\email"
}
},
"mail": {
"timestamp": "2015-09-11T20:32:33.936Z",
"source": "0000014fbe1c09cf-7cb9f704-7531-4e53-89a1-5fa9744f5eb6-000000@amazonses.com",
"messageId": "d6iitobk75ur44p8kdnnp7g2n800",
"destination": [
"recipient@example.com"
],
"headersTruncated": false,
"headers": [
{
"name": "Return-Path",
"value": "<0000014fbe1c09cf-7cb9f704-7531-4e53-89a1-5fa9744f5eb6-000000@amazonses.com>"
},
{
"name": "Received",
"value": "from a9-183.smtp-out.amazonses.com (a9-183.smtp-out.amazonses.com [54.240.9.183]) by inbound-smtp.us-east-1.amazonaws.com with SMTP id d6iitobk75ur44p8kdnnp7g2n800 for recipient@example.com; Fri, 11 Sep 2015 20:32:33 +0000 (UTC)"
},
{
"name": "DKIM-Signature",
"value": "v=1; a=rsa-sha256; q=dns/txt; c=relaxed/simple; s=ug7nbtf4gccmlpwj322ax3p6ow6yfsug; d=amazonses.com; t=1442003552; h=From:To:Subject:MIME-Version:Content-Type:Content-Transfer-Encoding:Date:Message-ID:Feedback-ID; bh=DWr3IOmYWoXCA9ARqGC/UaODfghffiwFNRIb2Mckyt4=; b=p4ukUDSFqhqiub+zPR0DW1kp7oJZakrzupr6LBe6sUuvqpBkig56UzUwc29rFbJF hlX3Ov7DeYVNoN38stqwsF8ivcajXpQsXRC1cW9z8x875J041rClAjV7EGbLmudVpPX 4hHst1XPyX5wmgdHIhmUuh8oZKpVqGi6bHGzzf7g="
},
{
"name": "From",
"value": "sender@example.com"
},
{
"name": "To",
"value": "recipient@example.com"
},
{
"name": "Subject",
"value": "Example subject"
},
{
"name": "MIME-Version",
"value": "1.0"
},
{
"name": "Content-Type",
"value": "text/plain; charset=UTF-8"
},
{
"name": "Content-Transfer-Encoding",
"value": "7bit"
},
{
"name": "Date",
"value": "Fri, 11 Sep 2015 20:32:32 +0000"
},
{
"name": "Message-ID",
"value": "<61967230-7A45-4A9D-BEC9-87CBCF2211C9@example.com>"
},
{
"name": "X-SES-Outgoing",
"value": "2015.09.11-54.240.9.183"
},
{
"name": "Feedback-ID",
"value": "1.us-east-1.Krv2FKpFdWV+KUYw3Qd6wcpPJ4Sv/pOPpEPSHn2u2o4=:AmazonSES"
}
],
"commonHeaders": {
"returnPath": "0000014fbe1c09cf-7cb9f704-7531-4e53-89a1-5fa9744f5eb6-000000@amazonses.com",
"from": [
"sender@example.com"
],
"date": "Fri, 11 Sep 2015 20:32:32 +0000",
"to": [
"recipient@example.com"
],
"messageId": "<61967230-7A45-4A9D-BEC9-87CBCF2211C9@example.com>",
"subject": "Example subject"
}
}
}
```
# Hentikan tindakan set aturan
Tindakan **Stop** mengakhiri evaluasi set aturan penerimaan dan secara opsional memberi tahu Anda melalui Amazon SNS. Tindakan ini memiliki opsi berikut.
+ **Topik SNS—**Nama atau ARN dari topik Amazon SNS yang akan memberi tahu ketika tindakan Berhenti dilakukan. Contoh topik Amazon SNS ARN adalah *arn:aws:sns:us-east* - 1:123456789012:. MyTopic Anda juga dapat membuat topik Amazon SNS saat mengatur tindakan dengan memilih **Buat Topik SNS**. Untuk informasi lebih lanjut tentang topik Amazon SNS, lihat [Panduan Developer Amazon Simple Notification Service](https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html).
**catatan**
Topik Amazon SNS yang Anda pilih harus berada di AWS Wilayah yang sama dengan titik akhir Amazon SES yang Anda gunakan untuk menerima email.
# Integrasikan dengan WorkMail tindakan Amazon
**WorkMail**Tindakan ini terintegrasi dengan Amazon WorkMail. Jika Amazon WorkMail melakukan semua pemrosesan email Anda, Anda biasanya tidak akan menggunakan tindakan ini secara langsung karena Amazon WorkMail menangani penyiapannya. Tindakan ini memiliki opsi berikut.
+ **Organisasi ARN—** ARN dari organisasi Amazon. WorkMail WorkMail Organisasi Amazon ARNs berada dalam bentuk`arn:aws:workmail:region:account_ID:organization/organization_ID`, di mana:
+ `region`adalah wilayah di mana Anda menggunakan Amazon SES dan Amazon WorkMail. (Anda harus menggunakannya dari Wilayah yang sama.) Contohnya adalah us-east-1.
+ `account_ID`adalah ID AWS akun. Anda dapat menemukan ID AWS akun Anda di halaman [Akun](https://console.aws.amazon.com/billing/home?#/account) Konsol AWS Manajemen.
+ `organization_ID`adalah pengidentifikasi unik yang WorkMail dihasilkan Amazon saat Anda membuat organisasi. Anda dapat menemukan ID organisasi di WorkMail konsol Amazon di halaman Pengaturan Organisasi organisasi Anda.
Contoh ARN WorkMail organisasi Amazon lengkap adalah *arn:aws:workmail:us-east* - 1:123456789012: organization/m-68755160c4cb4e29a2b2f8fb58f359d7. Untuk informasi tentang WorkMail organisasi Amazon, lihat [Panduan WorkMail Administrator Amazon](https://docs.aws.amazon.com/workmail/latest/adminguide/organizations_overview.html).
+ **Topik SNS-** Nama atau ARN dari topik Amazon SNS untuk memberi tahu kapan tindakan Amazon diambil. WorkMail Contoh topik Amazon SNS ARN adalah *arn:aws:sns:us-east* - 1:123456789012:. MyTopic Anda juga dapat membuat topik Amazon SNS saat mengatur tindakan dengan memilih **Buat Topik SNS**. Untuk informasi lebih lanjut tentang topik Amazon SNS, lihat [Panduan Developer Amazon Simple Notification Service](https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html).
**catatan**
Topik Amazon SNS yang Anda pilih harus berada di AWS Wilayah yang sama dengan titik akhir Amazon SES yang Anda gunakan untuk menerima email.
**catatan**
Amazon SES hanya mendukung WorkMail tindakan di wilayah WorkMail yang tersedia. Lihat [ WorkMail titik akhir dan kuota Amazon](https://docs.aws.amazon.com/general/latest/gr/workmail.html) di. Referensi Umum AWS