Invio di e-mail per conto del proprietario di identità per l'autorizzazione all'invio Amazon SES - Amazon Simple Email Service
Utilizzo dell'API Amazon SESUtilizzo dell'interfaccia SMTP Amazon SES

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Invio di e-mail per conto del proprietario di identità per l'autorizzazione all'invio Amazon SES

Come mittente delegato, puoi inviare e-mail nello stesso modo di altri mittenti Amazon SES, a patto che fornisci l'ARN dell'identità che il proprietario di identità ti ha autorizzato a utilizzare. Quando chiami Amazon SES per inviare l'e-mail, Amazon SES verifica se l'identità che hai specificato disponga di una policy che ti autorizza all'invio per suo conto.

Ci sono diversi modi in cui puoi specificare l'ARN dell'identità quando invii un'e-mail. Il metodo che puoi utilizzare dipende se invii l'e-mail utilizzando le operazioni API Amazon SES o l'interfaccia SMTP Amazon SES.

Importante

Per inviare correttamente un'e-mail, devi connetterti all'endpoint Amazon SES nella Regione AWS in cui il proprietario di identità ha verificato l'identità.

Inoltre, gli account AWS del proprietario dell'identità e del mittente delegato devono essere rimossi dalla sandbox prima che gli account possano inviare e-mail a indirizzi non verificati. Per ulteriori informazioni, consultare Richiedi l'accesso alla produzione (uscita dalla SES sandbox di Amazon).

Utilizzo dell'API Amazon SES

Come per qualsiasi mittente di posta elettronica in Amazon SES, se effettui l'accesso ad Amazon SES tramite l'API Amazon SES (o direttamente tramite HTTPS o indirettamente attraverso un SDK AWS), puoi scegliere una tra le tre operazioni di invio di e-mail: SendEmail, SendTemplatedEmail e SendRawEmail. Nella Documentazione di riferimento per le API Amazon Simple Email Service vengono descritti i dettagli di queste API, ma di seguito forniamo una panoramica dei parametri di autorizzazione all'invio.

SendRawEmail

Se desideri utilizzare SendRawEmail per poter controllare il formato delle e-mail, puoi specificare l'identità autorizzata delegata in uno di questi due modi:

  • Passaggio dei parametri facoltativi all'API SendRawEmail. I parametri obbligatori sono descritti nella tabella seguente:

    Parametro

    Descrizione

    SourceArn

    ARN dell'identità associata con la policy di autorizzazione che ti consente di inviare per l'indirizzo e-mail specificato nel parametro Source di SendRawEmail.

    Nota

    Se specifichi solo SourceArn, Amazon SES imposta gli indirizzi "Da" e "Percorso di ritorno" sull'identità specificata in SourceArn.

    FromArn

    ARN dell'identità associata con la policy di autorizzazione che ti consente di specificare un particolare indirizzo mittente nell'intestazione dell'e-mail in formato RAW.

    ReturnPathArn

    ARN dell'identità associata con la policy di autorizzazione che ti consente di utilizzare l'indirizzo e-mail specificato nel parametro ReturnPath di SendRawEmail.

  • Inclusione dei campi X-header nell'e-mail. I campi X-header sono intestazioni personalizzate che puoi utilizzare in aggiunta alle intestazioni e-mail standard (ad esempio le intestazioni mittente, reply-to o oggetto). Amazon SES riconosce tre campi X-header che puoi utilizzare per specificare l'invio di parametri di autorizzazione:

    Importante

    Non includere questi campi X-header nella firma DKIM, perché vengono rimossi da Amazon SES prima di inviare l'e-mail.

    X-header

    Descrizione

    X-SES-SOURCE-ARN

    Corrisponde a SourceArn.

    X-SES-FROM-ARN

    Corrisponde a FromArn.

    X-SES-RETURN-PATH-ARN

    Corrisponde a ReturnPathArn.

    Amazon SES rimuove tutti i campi X-header dall'email prima di inviarla. Se includi più istanze di un campo X-header, Amazon SES utilizza solo la prima istanza.

    L'esempio seguente mostra un'e-mail che include l'invio di X-header di autorizzazione:

    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 e SendTemplatedEmail

Se utilizzi l'operazione SendEmail o SendTemplatedEmail, puoi specificare l'identità autorizzata delegata passando seguenti i parametri facoltativi. Non puoi utilizzare il metodo X-header quando utilizzi l'operazioneSendEmail o SendTemplatedEmail.

Parametro

Descrizione

SourceArn

ARN dell'identità associata alla policy di autorizzazione che ti consente di inviare per l'indirizzo e-mail specificato nel parametro Source di SendEmail o SendTemplatedEmail.

ReturnPathArn

ARN dell'identità associata con la policy di autorizzazione che ti consente di utilizzare l'indirizzo e-mail specificato nel parametro ReturnPath di SendEmail o SendTemplatedEmail.

L'esempio seguente mostra come inviare un'e-mail che includa gli attributi SourceArn e ReturnPathArn utilizzando il comando SendEmail o SendTemplatedEmail e l'SDK per 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'])

Utilizzo dell'interfaccia SMTP Amazon SES

Quando utilizzi l'interfaccia SMTP Amazon SES per l'invio dei delegati, devi includere le intestazioni X-SES-SOURCE-ARN, X-SES-FROM-ARN e X-SES-RETURN-PATH-ARN nel messaggio. Passa queste intestazioni dopo l'esecuzione del comando DATA nella conversazione SMTP.