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

Penyewa

Bab ini menjelaskan cara menggunakan manajemen penyewa Amazon SES untuk mengisolasi, memantau, dan mengelola pengiriman email ke beberapa penyewa dalam akun SES Anda. Fitur ini membantu Vendor Perangkat Lunak Independen (ISV), perusahaan, dan organisasi yang mengirim email atas nama beberapa entitas hilir mempertahankan profil reputasi terpisah dan mencegah masalah dengan satu penyewa mempengaruhi orang lain.

Apa itu manajemen penyewa?

Manajemen penyewa adalah fitur yang memungkinkan Anda membuat wadah terisolasi yang disebut “penyewa” dalam akun SES Anda. Setiap penyewa dapat memiliki identitas email, set konfigurasi, templat, dan metrik reputasi sendiri, memastikan bahwa aktivitas email benar-benar terpisah antara pelanggan atau unit bisnis yang berbeda.

Manajemen penyewa mengatasi tantangan di mana praktik email salah satu pelanggan yang buruk sebelumnya dapat menjeda seluruh akun SES, memengaruhi semua pelanggan lainnya. Dengan isolasi penyewa, Anda dapat mengelola beberapa aliran email secara independen sambil mempertahankan pengawasan dan kontrol terpusat.

Penyewa berfungsi sebagai wadah logis yang mengelompokkan sumber daya SES terkait bersama-sama. Saat Anda mengirim email atas nama penyewa tertentu, SES melacak metrik reputasi, dan memberlakukan kebijakan di tingkat penyewa. Isolasi ini memastikan bahwa tingkat bouncing atau tingkat keluhan yang tinggi dari satu penyewa tidak memengaruhi pengiriman email yang dikirim oleh penyewa lain.

Manajemen penyewa sangat berharga untuk:

Cara kerja manajemen penyewa

Manajemen reputasi penyewa bekerja dengan membuat wadah logis untuk sumber daya pengiriman email Anda. Anda menetapkan sumber daya tertentu untuk setiap penyewa, termasuk identitas terverifikasi (domain dan alamat email), kumpulan konfigurasi, dan templat. Saat mengirim email atas nama penyewa, Anda menentukan penyewa dalam panggilan API atau header SMTP, dan SES memverifikasi bahwa sumber daya yang digunakan terkait dengan benar dengan penyewa tersebut.

Asosiasi sumber daya

Sumber daya di akun SES Anda dapat dikaitkan dengan penyewa dengan dua cara:

Saat Anda mengaitkan sumber daya dengan penyewa, penyewa tersebut memperoleh izin untuk menggunakan sumber daya tersebut untuk pengiriman email. Dengan setiap permintaan pengiriman, SES memvalidasi bahwa penyewa yang ditentukan memiliki izin untuk menggunakan identitas, set konfigurasi, dan templat dalam permintaan. Jika sumber daya tidak terkait dengan benar, permintaan kirim gagal.

Pemantauan dan penegakan reputasi

SES terus memantau metrik reputasi utama untuk setiap penyewa, termasuk tingkat bouncing, tingkat keluhan (termasuk yang berasal dari sistem Feedback Loop (FBL) penyedia kotak pesan), dan sinyal umpan balik pihak ketiga. Ketika metrik ini melebihi ambang batas yang ditentukan, SES menciptakan “temuan reputasi” yang dikategorikan sebagai:

Berdasarkan temuan ini, SES dapat secara otomatis menjeda penyewa yang bermasalah melalui kebijakan reputasi yang Anda konfigurasikan. Tiga tingkat penegakan tersedia:

Ketika metrik penyewa memicu temuan reputasi yang memenuhi ambang batas untuk penegakan berdasarkan kebijakan yang Anda pilih, sistem secara otomatis memperbarui status pengiriman penyewa ke “Dijeda” tanpa mempengaruhi kemampuan pengiriman penyewa lain. Saat penyewa dijeda, setiap upaya untuk mengirim email menggunakan penyewa tersebut akan gagal sampai Anda meninjau masalah dan mengaktifkan kembali pengiriman secara manual. Selain itu, Anda dapat menjeda kemampuan pengiriman penyewa secara manual bila diperlukan, dan membatalkan jeda saat siap untuk melanjutkan pengiriman.

Menyiapkan penyewa

Membuat penyewa

Menggunakan konsol:

Menggunakan AWS CLI:

aws sesv2 create-tenant \
    --tenant-name "MyTenant" \
    --region us-east-1

Menetapkan sumber daya ke penyewa

Setelah membuat penyewa, Anda harus menetapkan setidaknya satu identitas terverifikasi dan satu set konfigurasi sebelum penyewa dapat mengirim email.

Menggunakan konsol:

Menggunakan AWS CLI:

# Assign an identity to a tenant
aws sesv2 create-tenant-resource-association \
    --tenant-name "MyTenant" \
    --resource-arn "arn:aws:ses:us-east-1:123456789012:identity/example.com" \
    --region us-east-1

# Assign a configuration set to a tenant
aws sesv2 create-tenant-resource-association \
    --tenant-name "MyTenant" \
    --resource-arn "arn:aws:ses:us-east-1:123456789012:configuration-set/MyConfigSet" \
    --region us-east-1

Mengkonfigurasi kebijakan reputasi

Kebijakan reputasi menentukan kapan pengiriman email penyewa dijeda secara otomatis berdasarkan metrik reputasi. Saat Anda membuat penyewa, SES secara otomatis menetapkan kebijakan reputasi Standar. Gunakan langkah-langkah berikut jika Anda ingin mengubah ke kebijakan lain.

Menggunakan konsol:

Menggunakan AWS CLI:

update-reputation-entity-policy \
    --reputation-entity-type "RESOURCE" \
    --reputation-entity-reference "arn:aws:ses:us-east-1:123456789012:tenant/tenantId" \
    --reputation-entity-policy "arn:aws:ses:us-east-1:aws:reputation-policy/standard"

Mengirim email dengan penyewa

Saat mengirim email melalui penyewa, Anda harus menentukan penyewa dalam panggilan API atau header SMTP dan memastikan bahwa semua sumber daya yang digunakan dikaitkan dengan penyewa tersebut.

Menggunakan SendEmail API dengan penyewa

AWS CLI Contoh:

aws sesv2 send-email \
  --tenant-name "MyTenant" \
  --from-email-address "sender@example.com" \
  --destination "ToAddresses=recipient@example.com" \
  --content "Simple={Subject={Data='Test Subject',Charset=utf-8},Body={Text={Data='Test email body',Charset=utf-8}}}" \
  --configuration-set-name "MyConfigSet"

AWS SDK untuk Python Contoh:

import boto3

client = boto3.client('sesv2')
response = client.send_email(
    FromEmailAddress='sender@example.com',
    Destination={
        'ToAddresses': ['recipient@example.com']
    },
    Content={
        'Simple': {
            'Subject': {
                'Data': 'Test email'
            },
            'Body': {
                'Text': {
                    'Data': 'This is a test email sent using a tenant.'
                }
            }
        }
    },
    ConfigurationSetName='MyConfigurationSet',
     TenantName='MyTenant'
)

Menggunakan SMTP dengan penyewa

Saat menggunakan SMTP untuk mengirim email melalui penyewa, sertakan informasi penyewa dalam header email:

X-SES-TENANT: MyTenant

Header ini memberi tahu SES penyewa mana yang harus digunakan untuk operasi pengiriman email, memungkinkan SES menerapkan validasi sumber daya yang sesuai dan pelacakan reputasi.

Mengelola status penyewa

Melihat status penyewa dan metrik

Menggunakan konsol:

Menggunakan AWS CLI:

# Get tenant details
aws sesv2 get-tenant --tenant-name "MyTenant"

Menjeda dan menghentikan jeda penyewa

Anda dapat menjeda kemampuan pengiriman penyewa secara manual bila diperlukan, dan membatalkan jeda saat siap melanjutkan pengiriman.

Menggunakan konsol:

Menggunakan AWS CLI:

Untuk menjeda penyewa:

# Pause a tenant
aws sesv2 update-reputation-entity-customer-managed-status \
  --reputation-entity-type RESOURCE 
  --reputation-entity-reference "arn:aws:ses:us-east-1:593442965613:tenant/tenantId"
  --sending-status DISABLED

Untuk membatalkan jeda penyewa:

# Unpause a tenant
aws sesv2 update-reputation-entity-customer-managed-status \
  --reputation-entity-type RESOURCE 
  --reputation-entity-reference "arn:aws:ses:us-east-1:593442965613:tenant/tenantId"
  --sending-status ENABLED

Bekerja dengan temuan reputasi

Melihat temuan reputasi

Menggunakan konsol:

Menggunakan AWS CLI:

aws sesv2 list-recommendations \
   --filter='{ "RESOURCE_ARN":"arn:aws:ses:us-east-1:012345678901:tenant/tenantId"}'

Tanggapan mencakup rincian tentang semua temuan aktif:

{
    "Recommendations": [
        {
            "ResourceArn": "arn:aws:ses:us-east-1:012345678901:tenant/{tenant-name}/{tenant-id}",
            "Type": "BOUNCE",
            "Description": "The bounce rate exceeded 15.0% based on a representative volume of 664 emails from July 11, 2025 at 14:41 (UTC) to July 11, 2025 at 16:26 (UTC).",
            "Status": "OPEN",
            "CreatedTimestamp": "2025-07-11T16:16:14.029000+00:00",
            "LastUpdatedTimestamp": "2025-07-11T16:37:14.145000+00:00",
            "Impact": "HIGH"
        }
    ]
}

Memahami temuan reputasi

Temuan reputasi memberikan wawasan tentang potensi masalah dengan praktik pengiriman email penyewa Anda. Setiap temuan meliputi:

Temuan umum meliputi:

Menyelesaikan masalah reputasi

Ketika Anda menerima temuan reputasi, penting untuk menyelidiki akar penyebabnya dan segera mengambil tindakan korektif:

Pemantauan dan analitik

Menyiapkan CloudWatch metrik

SES menerbitkan metrik khusus penyewa ke Amazon. CloudWatch Metrik berikut tersedia untuk setiap penyewa:

Menyiapkan EventBridge notifikasi

Secara default, SES mengirimkan peristiwa ke bus peristiwa EventBridge default ketika temuan reputasi penyewa terdeteksi atau ketika perubahan status penyewa terjadi.

Anda dapat membuat aturan pada bus acara default untuk mengidentifikasi peristiwa tertentu untuk EventBridge dikirim ke satu atau lebih target tertentu.

Tipe-detail berikut tersedia:

Untuk perubahan status pengiriman penyewa:

Untuk temuan reputasi:

Contoh pola EventBridge aturan untuk temuan reputasi:

{
  "detail-type": "Advisor Recommendation Status Open",
  "source": "aws.ses",
  "account": "012345678901",
  "time": "2023-11-15T17:00:59Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:ses:us-east-1:012345678901:tenant/{tenant-name}/{tenant-id}"
  ],
  "detail": { 
       "version": "1.0.0",
       "data": "The bounce rate exceeded 15.0% based on a representative volume of 197 emails from July 11, 2025 at 14:43 (UTC) to July 11, 2025 at 16:13 (UTC).",
       "metadata":{"impact":"HIGH","type":"BOUNCE"}
  
    }
}

Contoh pola EventBridge aturan untuk mengirim perubahan status:

{
        "detail-type": "Sending Status Disabled",
        "source": "aws.ses",
        "account": "012345678901",
        "time": "2025-07-24T12:44:28Z",
        "region": "us-east-1",
        "resources": [
            "arn:aws:ses:us-east-1:012345678901:tenant/{tenant-name}/{tenant-id}"
        ],
        "detail": {
            "version": "1.0.0",
            "data": {
                "origin": "CUSTOMER_MANAGED",
                "record": {
                    "status": "DISABLED",
                    "cause": "Status manually updated.",
                    "lastUpdatedTimestamp": [2025, 7, 24, 12, 44, 28, 995000000]
                }
            }
        }
    }

Deskripsi bidang:

Anda dapat menggunakan peristiwa ini untuk memantau perubahan status penyewa dan mengotomatiskan respons di aplikasi Anda. Misalnya, Anda mungkin ingin memicu peringatan saat penyewa dinonaktifkan atau melacak metrik kesehatan penyewa dari waktu ke waktu.

Integrasi dengan AWS Keamanan Per & caya

Ketika AWS Trust & Safety mendeteksi masalah yang biasanya mengakibatkan penegakan tingkat akun, sistem penyewa memungkinkan tanggapan yang lebih ditargetkan. Alih-alih menjeda seluruh akun Anda, Trust & Safety hanya dapat menjeda penyewa yang bermasalah sambil mengizinkan penyewa yang sesuai untuk terus mengirim.

Penegakan tingkat penyewa ini mengurangi dampak masalah reputasi dan membantu menjaga kelangsungan bisnis untuk aliran email Anda yang lain.

Anda akan menerima pemberitahuan ketika SES telah menonaktifkan pengiriman karena masalah tingkat keparahan tinggi yang memengaruhi reputasi penyewa dan telah meninjau akun Anda. Kasus akan dibuka untuk Anda di Pusat AWS Dukungan sehingga Anda dapat bekerja dengan Trust & Safety untuk menyelesaikan masalah dan memulihkan pengiriman untuk penyewa yang terkena dampak.

Praktik terbaik

Ikuti praktik terbaik berikut untuk mengelola reputasi penyewa secara efektif di Amazon SES:

Tenant-level daftar penindasan

Secara default, semua penyewa di akun Anda berbagi daftar penindasan tingkat akun. Ini berarti bahwa ketika penerima memantul atau mengeluh tentang email satu penyewa, alamat tersebut ditekan untuk setiap penyewa di akun. Tenant-level daftar penindasan menyelesaikan ini dengan memberi setiap penyewa daftar penindasan terisolasi sendiri.

Saat Anda mengaktifkan penindasan tingkat penyewa untuk penyewa, SES menyimpan daftar penindasan terpisah untuk penyewa tersebut. Bounce dan keluhan hanya memengaruhi penyewa yang mengirim email. Penyewa lain dapat terus mengirim ke penerima yang sama. Anda mengonfigurasi penindasan tingkat penyewa dengan menyet SuppressionScope el ke TENANT dan memilih mana SuppressedReasons (pantulan, keluhan, atau keduanya) untuk dilacak.

Untuk informasi lengkap tentang mengonfigurasi dan mengelola daftar penindasan tingkat penyewa, lihat. Menggunakan daftar penindasan tingkat penyewa di Amazon SES

Batasan

Saat menggunakan manajemen penyewa, perhatikan keterbatasan ini:

Harga

Ada biaya tambahan per penyewa per bulan berdasarkan jumlah email. Untuk informasi harga terperinci, lihat halaman harga SES.

Saat menggunakan CloudWatch dengan metrik penyewa, CloudWatch metrik standar untuk setiap penyewa disediakan tanpa biaya tambahan sebagai bagian dari pemantauan dasar. CloudWatch Fitur tambahan seperti dasbor khusus, alarm, atau pemantauan terperinci dapat dikenakan biaya standar CloudWatch.