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 Wilayah AWS tempat pemilik identitas memverifikasi identitas tersebut.

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

Menggunakan API Amazon SES

Seperti halnya pengirim email Amazon SES, jika Anda mengakses Amazon SES melalui Amazon SES API (baik secara langsung melalui HTTPS atau tidak langsung melaluiAWSSDK), Anda dapat memilih antara salah satu dari tiga tindakan pengiriman email:SendEmail,SendTemplatedEmail, danSendRawEmail. Referensi API Amazon Simple Email Service menjelaskan detail API ini, tetapi kami memberikan gambaran umum parameter otorisasi pengiriman di sini.

SendRawEmail

Jika Anda ingin menggunakanSendRawEmailsehingga Anda dapat mengendalikan format email Anda, Anda dapat menentukan identitas resmi yang didelegasi 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 menggunakanSendEmailatauSendTemplatedEmailoperasi, Anda dapat menentukan identitas resmi yang didelegasi dengan meneruskan parameter opsional di bawah ini. Anda tidak dapat menggunakan metode X-header ketika Anda menggunakanSendEmailatauSendTemplatedEmailoperasi.

Parameter

Deskripsi

SourceArn

ARN identitas yang terkait dengan kebijakan otorisasi pengiriman yang mengizinkan Anda untuk mengirim alamat email yang ditentukan diSourceparameter dari salah satuSendEmailatauSendTemplatedEmail.

ReturnPathArn

ARN identitas yang terkait dengan kebijakan otorisasi pengiriman yang mengizinkan Anda untuk menggunakan alamat email yang ditentukan diReturnPathparameter dari salah satuSendEmailatauSendTemplatedEmail.

Contoh berikut menunjukkan cara mengirim email yang mencakupSourceArndanReturnPathArnatribut menggunakan salah satuSendEmailatauSendTemplatedEmailoperasi danSDK for 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

Ketika Anda menggunakan antarmuka Amazon SES SMTP untuk pengiriman delegasi, Anda harus menyertakanX-SES-SOURCE-ARN,X-SES-FROM-ARN, danX-SES-RETURN-PATH-ARNheader dalam pesan Anda. Teruskan header ini setelah Anda mengeluarkan perintah DATA di percakapan SMTP.