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 di beberapa penyewa dalam akun SES Anda. Fitur ini membantu Vendor Perangkat Lunak Independen (ISVs), perusahaan, dan organisasi yang mengirim email atas nama beberapa entitas hilir mempertahankan profil reputasi yang terpisah dan mencegah masalah dengan satu penyewa memengaruhi 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 reputasinya sendiri, memastikan bahwa aktivitas email benar-benar terpisah antara pelanggan atau unit bisnis yang berbeda.

Manajemen penyewa mengatasi tantangan di mana praktik email yang buruk dari satu pelanggan sebelumnya dapat menjeda seluruh akun SES, yang memengaruhi semua pelanggan lain. 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 pentalan atau tingkat keluhan yang tinggi dari satu penyewa tidak memengaruhi pengiriman email yang dikirim oleh penyewa lain.

Manajemen penyewa sangat berharga untuk:

Bagaimana manajemen penyewa bekerja

Manajemen reputasi penyewa bekerja dengan membuat wadah logis untuk sumber daya pengiriman email Anda. Anda menetapkan sumber daya khusus untuk setiap penyewa, termasuk identitas terverifikasi (domain dan alamat email), set 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 penyewa tersebut dengan benar.

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 kirim, 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 rasio pentalan, tingkat keluhan (termasuk dari sistem Feedback Loop (FBL) penyedia kotak surat), 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 bermasalah melalui kebijakan reputasi yang Anda konfigurasikan. Tiga tingkat penegakan tersedia:

Ketika metrik penyewa memicu temuan reputasi yang memenuhi ambang batas penegakan berdasarkan kebijakan yang Anda pilih, sistem secara otomatis memperbarui status pengiriman penyewa ke “Dijeda” tanpa memengaruhi kemampuan pengiriman penyewa lain. Sementara penyewa dijeda, setiap upaya untuk mengirim email menggunakan penyewa itu akan gagal sampai Anda meninjau masalah dan mengaktifkan kembali pengiriman secara manual. Selain itu, Anda dapat menjeda kemampuan pengiriman penyewa secara manual saat 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 untuk 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 Anda dan memastikan bahwa semua sumber daya yang digunakan terkait 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 Contoh Python:

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 di header email:

X-SES-TENANT: MyTenant

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

Mengelola status penyewa

Melihat status dan metrik penyewa

Menggunakan konsol:

Menggunakan AWS CLI:

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

Penyewa yang berhenti sejenak dan tidak berhenti

Anda dapat menjeda kemampuan pengiriman penyewa secara manual saat diperlukan, dan membatalkan jeda saat siap untuk 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 menghentikan 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 tersebut 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 acara 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 dikirim EventBridge ke satu atau beberapa target yang ditentukan.

Jenis detail berikut tersedia:

Untuk penyewa mengirim perubahan status:

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 dalam aplikasi Anda. Misalnya, Anda mungkin ingin memicu peringatan saat penyewa dinonaktifkan atau melacak metrik kesehatan penyewa dari waktu ke waktu.

Integrasi dengan AWS Kepercayaan & Keamanan

Ketika AWS Trust & Safety mendeteksi masalah yang biasanya menghasilkan penegakan tingkat akun, sistem penyewa memungkinkan respons yang lebih bertarget. Alih-alih menjeda seluruh akun Anda, Trust & Safety hanya dapat menjeda penyewa bermasalah sambil mengizinkan penyewa yang patuh 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 menempatkan akun Anda dalam peninjauan. 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 ini untuk mengelola reputasi penyewa secara efektif di Amazon SES:

Batasan

Saat menggunakan manajemen penyewa, waspadai keterbatasan ini:

Harga

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

Saat menggunakan CloudWatch metrik penyewa, metrik standar CloudWatch 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