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 kotak pasir Amazon SES).

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: [e-mail]
  To: [e-mail]
  Return-Path: [e-mail]
  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': [
                '[e-mail]',
            ],
        },
        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='[e-mail]',
        ReturnPath='[e-mail]'
    )
# 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.