Mengirim email untuk pemilik identitas untuk otorisasi pengiriman Amazon SES - Layanan Email Sederhana Amazon
Menggunakan API Amazon SESMenggunakan antarmuka SMTP Amazon SES

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

Mengirim email untuk pemilik identitas untuk otorisasi pengiriman Amazon SES

Sebagai pengirim delegasi, Anda mengirim email dengan cara yang sama seperti yang dilakukan pengirim Amazon SES lainnya, kecuali bahwa Anda memberikan Amazon Resource Name (ARN) identitas yang telah diotorisasi pemilik identitas untuk Anda gunakan. Ketika Anda memanggil Amazon SES untuk mengirim email, Amazon SES memeriksa untuk melihat jika identitas yang Anda tentukan memiliki kebijakan yang mengotorisasi Anda untuk mengirimkannya.

Ada berbagai cara yang dapat Anda tentukan untuk ARN identitas ketika Anda mengirim email. Metode yang Anda gunakan tergantung jika Anda mengirim email dengan menggunakan operasi API Amazon SES atau antarmuka SMTP Amazon SES.

penting

  • Agar berhasil mengirim email, Anda harus terhubung ke titik akhir Amazon SES di AWS Wilayah tempat pemilik identitas memverifikasi identitasnya.

  • Selain itu, AWS akun pemilik identitas dan pengirim delegasi harus dihapus dari kotak pasir sebelum salah satu akun dapat mengirim email ke alamat yang tidak diverifikasi. Untuk informasi selengkapnya, lihat Minta akses produksi (Pindah dari kotak pasir Amazon SES).

  • Jika identitas yang telah Anda otorisasi untuk digunakan digandakan di wilayah sekunder sebagai bagian dari fitur titik akhir Global:

    • Pemilik identitas seharusnya memberi Anda ARN identitas yang memiliki parameter wilayah, seperti,us-east-1, diganti dengan tanda bintang * seperti pada contoh berikut,. arn:aws:ses:*:123456789012:identity/user@example.com

    • Pemilik identitas seharusnya telah membuat kebijakan otorisasi pengiriman untuk Anda di wilayah primer dan sekunder.

Menggunakan API Amazon SES

Seperti halnya pengirim email Amazon SES lainnya, jika Anda mengakses Amazon SES melalui Amazon SES API (baik secara langsung melalui HTTPS atau secara tidak langsung melalui AWS SDK), Anda dapat memilih di antara salah satu dari tiga tindakan pengiriman email:,, dan. SendEmail SendTemplatedEmail SendRawEmail Referensi API Layanan Email Sederhana Amazon menjelaskan detailnya APIs, tetapi kami memberikan gambaran umum tentang parameter otorisasi pengiriman di sini.

SendRawEmail

Jika Anda ingin menggunakannya SendRawEmail sehingga Anda dapat mengontrol format email Anda, Anda dapat menentukan identitas resmi yang didelegasikan dengan salah satu dari dua cara:

  • Teruskan parameter opsional ke API SendRawEmail. Parameter yang diperlukan dijelaskan di tabel berikut:

    Parameter

    Deskripsi

    SourceArn

    ARN identitas yang terkait dengan kebijakan otorisasi pengiriman yang mengizinkan Anda untuk mengirim alamat email yang ditentukan di parameter Source dari SendRawEmail.

    catatan

    Jika Anda hanya menentukan SourceArn, Amazon SES menetapkan alamat "Dari" dan alamat "Jalur Kembali" ke identitas yang Anda tentukan di SourceArn.

    FromArn

    ARN identitas yang terkait dengan kebijakan otorisasi pengiriman yang mengizinkan Anda untuk menentukan alamat "Dari" tertentu di header email mentah.

    ReturnPathArn

    ARN identitas yang terkait dengan kebijakan otorisasi pengiriman yang mengizinkan Anda untuk menggunakan alamat email yang ditentukan di parameter ReturnPath dari SendRawEmail.

  • Sertakan X-header di email. X-header adalah header kustom yang dapat Anda gunakan selain header email standar (seperti header Dari, Balas Ke, atau Subjek). Amazon SES mengenali tiga X-header yang dapat Anda gunakan untuk menentukan parameter otorisasi pengiriman:

    penting

    Jangan sertakan X-header ini di tanda tangan DKIM, karena header tersebut dihapus oleh Amazon SES sebelum mengirim email.

    X-Header

    Deskripsi

    X-SES-SOURCE-ARN

    Sesuai dengan SourceArn.

    X-SES-FROM-ARN

    Sesuai dengan FromArn.

    X-SES-RETURN-PATH-ARN

    Sesuai dengan ReturnPathArn.

    Amazon SES menghapus semua X-header dari email sebelum mengirimnya. Jika Anda menyertakan beberapa instans dari X-header, Amazon SES hanya menggunakan instans pertama.

    Contoh berikut menunjukkan email yang menyertakan X-header otorisasi pengiriman:

    X-SES-SOURCE-ARN: arn:aws:ses:us-east-1:123456789012:identity/example.com
X-SES-FROM-ARN: arn:aws:ses:us-east-1:123456789012:identity/example.com
X-SES-RETURN-PATH-ARN: arn:aws:ses:us-east-1:123456789012:identity/example.com

From: sender@example.com
To: recipient@example.com
Return-Path: feedback@example.com
Subject: subject
Content-Type: multipart/alternative;
	boundary="----=_boundary"

------=_boundary
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 7bit

body
------=_boundary
Content-Type: text/html; charset=UTF-8
Content-Transfer-Encoding: 7bit

body
------=_boundary--

SendEmail dan SendTemplatedEmail

Jika Anda menggunakan SendTemplatedEmail operasi SendEmail atau, Anda dapat menentukan identitas resmi yang didelegasikan dengan meneruskan parameter opsional di bawah ini. Anda tidak dapat menggunakan metode X-header ketika Anda menggunakan SendEmail atau SendTemplatedEmail operasi.

Parameter

Deskripsi

SourceArn

ARN identitas yang terkait dengan kebijakan otorisasi pengiriman yang memungkinkan Anda mengirim alamat email yang ditentukan dalam Source parameter salah satu atau. SendEmail SendTemplatedEmail

ReturnPathArn

ARN identitas yang terkait dengan kebijakan otorisasi pengiriman yang memungkinkan Anda untuk menggunakan alamat email yang ditentukan dalam ReturnPath parameter salah satu atau. SendEmail SendTemplatedEmail

Contoh berikut menunjukkan cara mengirim email yang menyertakan ReturnPathArn atribut SourceArn dan menggunakan SendTemplatedEmail operasi SendEmail atau dan SDK untuk Python.

import boto3
from botocore.exceptions import ClientError

# Create a new SES resource and specify a region.
client = boto3.client('ses',region_name="us-east-1")

# Try to send the email.
try:
    #Provide the contents of the email.
    response = client.send_email(
        Destination={
            'ToAddresses': [
                'recipient@example.com',
            ],
        },
        Message={
            'Body': {
                'Html': {
                    'Charset': 'UTF-8',
                    'Data': 'This email was sent with Amazon SES.',
                },
            },
            'Subject': {
                'Charset': 'UTF-8',
                'Data': 'Amazon SES Test',
            },
        },
        SourceArn='arn:aws:ses:us-east-1:123456789012:identity/example.com',
        ReturnPathArn='arn:aws:ses:us-east-1:123456789012:identity/example.com',
        Source='sender@example.com',
        ReturnPath='feedback@example.com'
    )
# Display an error if something goes wrong.	
except ClientError as e:
    print(e.response['Error']['Message'])
else:
    print("Email sent! Message ID:"),
    print(response['ResponseMetadata']['RequestId'])

Menggunakan antarmuka SMTP Amazon SES

Saat Anda menggunakan antarmuka SMTP Amazon SES untuk pengiriman delegasi, Anda harus menyertakan, X-SES-SOURCE-ARNX-SES-FROM-ARN, dan X-SES-RETURN-PATH-ARN header dalam pesan Anda. Teruskan header ini setelah Anda mengeluarkan perintah DATA di percakapan SMTP.