Envío de correo electrónico al propietario de la identidad para la autorización de envío de Amazon SES - Amazon Simple Email Service

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Envío de correo electrónico al propietario de la identidad para la autorización de envío de Amazon SES

Como remitente delegado, envía correos electrónicos de la misma forma que lo hacen otros remitentes de Amazon SES, salvo que proporciona el Nombre de recurso de Amazon (ARN) de la identidad que el propietario de identidad lo ha autorizado a utilizar. Cuando llama a Amazon SES para enviar el correo electrónico, Amazon SES comprueba si la identidad que ha especificado tiene una política que lo autoriza a enviarlo.

Existen diferentes maneras en las que puede especificar el ARN de la identidad al enviar un correo electrónico. El método que puede utilizar depende de si envía el correo electrónico mediante las operaciones de la API de Amazon SES o la interfaz de SMTP de Amazon SES.

importante

Para enviar correctamente un correo electrónico, debe conectarse al punto de enlace de Amazon SES en la región de AWS en la que el propietario de identidad verificó la identidad.

Además de las cuentas de AWS, el propietario de identidad y del remitente delegado deben eliminarse del entorno de pruebas para que cualquiera de las cuentas pueda enviar correo electrónico a direcciones no verificadas. Para obtener más información, consulte Solicitar acceso a la producción (salir del entorno de pruebas de SES Amazon) .

Uso de la API de Amazon SES

Al igual que con cualquier remitente de correo electrónico de Amazon SES, si accede a Amazon SES a través de la API de Amazon SES (ya sea directamente a través de HTTPS o indirectamente a través de un SDK de AWS), puede elegir entre una de las tres acciones de envío de correo electrónico: SendEmail, SendTemplatedEmail y SendRawEmail. En la Referencia de la API de Amazon Simple Email Service se describen los detalles de estas API, pero aquí ofrecemos información general de los parámetros de la autorización de envío.

SendRawEmail

Si desea utilizar SendRawEmail para poder controlar el formato de sus mensajes de correo electrónico, puede especificar la identidad autorizada delegada de alguna de las dos formas siguientes:

  • Pasar parámetros opcionales a la API SendRawEmail. Los parámetros obligatorios se describen en la siguiente tabla:

    Parámetro

    Descripción

    SourceArn

    El ARN de la identidad que está asociada a la política de autorización de envío que le permite enviar para la dirección de correo electrónico especificada en el parámetro Source de SendRawEmail.

    nota

    Si solo especifica el SourceArn, Amazon SES establece la dirección del remitente (“From”) y la dirección de la ruta de retorno (“Return Path”) en la identidad especificada en SourceArn.

    FromArn

    El ARN de la identidad que está asociada a la política de autorización de envío que le permite especificar una dirección de remitente ("From") particular en el encabezado del correo electrónico sin procesar.

    ReturnPathArn

    El ARN de la identidad que está asociada a la política de autorización de envío que le permite utilizar la dirección de correo electrónico especificada en el parámetro ReturnPath de SendRawEmail.

  • Incluir encabezados X en el correo electrónico. Los encabezados X son encabezados personalizados que puede utilizar además de los encabezados de correo electrónico estándar (como los encabezados From, Reply-To o Subject). Amazon SES reconoce tres encabezados X que puede utilizar para especificar parámetros de autorización de envío:

    importante

    No incluya estos encabezados X en la firma DKIM, ya que Amazon SES los elimina antes de enviar el correo electrónico.

    Encabezado X

    Descripción

    X-SES-SOURCE-ARN

    Corresponde a SourceArn.

    X-SES-FROM-ARN

    Corresponde a FromArn.

    X-SES-RETURN-PATH-ARN

    Corresponde a ReturnPathArn.

    Amazon SES elimina todos los encabezados X del correo electrónico antes de enviarlo. Si se incluyen varias instancias de un encabezado X, Amazon SES solo utiliza la primera instancia.

    El siguiente ejemplo muestra un correo electrónico que incluya encabezados X de autorización de envío:

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

Si utiliza la operación SendEmail o SendTemplatedEmail, puede especificar la identidad autorizada delegada al transferir los parámetros opcionales que se indican a continuación. No puede utilizar el método de encabezado X cuando utiliza la operación SendEmail o SendTemplatedEmail.

Parámetro

Descripción

SourceArn

El ARN de la identidad que está asociada a la política de autorización de envío que le permite enviar para la dirección de correo electrónico especificada en el parámetro Source de SendEmail o SendTemplatedEmail.

ReturnPathArn

El ARN de la identidad que está asociada a la política de autorización de envío que le permite utilizar la dirección de correo electrónico especificada en el parámetro ReturnPath de SendEmail o SendTemplatedEmail.

En el siguiente ejemplo, se muestra cómo enviar un correo electrónico que incluye los atributos SourceArn y ReturnPathArn mediante la operación SendEmail o SendTemplatedEmail y el ‎SDK para 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'])

Uso de la interfaz de SMTP de Amazon SES

Cuando utilice la interfaz de SMTP de Amazon SES para el envío delegado, deberá incluir los encabezados X-SES-SOURCE-ARN, X-SES-FROM-ARN y X-SES-RETURN-PATH-ARN en el mensaje. Pase estos encabezados después enviar el comando DATA en la conversación SMTP.