Amazon Simple Email Service · elija Email Addresses para ver la dirección de correo electrónico que verificó en Verificación de direcciones de correo electrónico en Amazon SES

Amazon Simple Email ServiceDeveloper Guide

Amazon Simple Email Service Developer Guide

Amazon Simple Email Service: Developer GuideCopyright © 2018 Amazon Web Services, Inc. and/or its affiliates. All rights reserved.

Amazon's trademarks and trade dress may not be used in connection with any product or service that is not Amazon's, in any mannerthat is likely to cause confusion among customers, or in any manner that disparages or discredits Amazon. All other trademarks notowned by Amazon are the property of their respective owners, who may or may not be affiliated with, connected to, or sponsored byAmazon.


Table of Contents¿Qué es Amazon SES? ...................................................................................................................... 1

¿Por qué utilizar Amazon SES? ................................................................................................... 1Amazon SES y otros servicios de AWS ......................................................................................... 1En esta guía .............................................................................................................................. 2

Inicio rápido ....................................................................................................................................... 3Paso 1: Inscribirse en AWS ......................................................................................................... 3Paso 2: verificar su dirección de correo electrónico .......................................................................... 3Paso 3: enviar su primer correo electrónico .................................................................................... 3Paso 4: considere cómo gestionar los rebotes y las reclamaciones .................................................... 3Paso 5: Salir del entorno de pruebas de Amazon SES ..................................................................... 4Pasos siguientes ........................................................................................................................ 4

Envío de correo electrónico ................................................................................................................. 5¿Cómo envío mensajes de correo con Amazon SES? ...................................................................... 5¿Por dónde empezar? ................................................................................................................. 6Conceptos ................................................................................................................................. 7

Amazon SES y capacidad de entrega ................................................................................... 7Proceso de envío de correo electrónico ............................................................................... 12Formato de correo electrónico y Amazon SES ...................................................................... 15

Introducción ............................................................................................................................. 18Uso de la consola de Amazon SES ..................................................................................... 18Uso del Simple Mail Transfer Protocol (SMTP) ...................................................................... 18Uso de un SDK de AWS ................................................................................................... 18Antes de empezar ............................................................................................................. 18Enviar un correo electrónico a través de la consola ................................................................ 19Enviar un correo electrónico mediante SMTP ........................................................................ 20Enviar un correo electrónico mediante un SDK de AWS ......................................................... 30

Configuración de correo electrónico ............................................................................................. 45Inscripción en AWS ........................................................................................................... 46Verificación de identidades ................................................................................................. 47Obtener sus claves de acceso de AWS ............................................................................... 64Descarga de un SDK de AWS ............................................................................................ 65Uso de un dominio MAIL FROM personalizado ..................................................................... 65Configuración de registros de SPF ...................................................................................... 71Obtención de sus credenciales de SMTP ............................................................................. 72Salir del entorno de pruebas .............................................................................................. 72

Envío de correo electrónico ........................................................................................................ 74Uso de la interfaz de SMTP ............................................................................................... 74Uso del API ................................................................................................................... 107Envío de correo electrónico personalizado .......................................................................... 115

Autenticación del correo electrónico ........................................................................................... 124Autenticación de correo electrónico con SPF ....................................................................... 124Autenticación de correo electrónico con DKIM ..................................................................... 126Conformidad con DMARC ................................................................................................ 135

Administrar sus límites de envío ................................................................................................ 136Monitoreo de sus límites de envío ..................................................................................... 137Aumento de sus límites de envío ....................................................................................... 139Qué ocurre si alcanza sus límites de envío ......................................................................... 140

Uso de autorización de envío ................................................................................................... 141Descripción general de autorización de envío ...................................................................... 142Políticas de autorización de envío ..................................................................................... 144Ejemplos de políticas de autorización de envío .................................................................... 149Tareas de propietario de identidad ..................................................................................... 154Tareas de remitente delegado ........................................................................................... 160

Uso de direcciones IP dedicadas ............................................................................................... 166

iii


Facilidad de configuración ................................................................................................ 167Reputación administrada por AWS ..................................................................................... 167Capacidad de predicción de los patrones de envío ............................................................... 167Volumen de correo electrónico saliente .............................................................................. 168Costos adicionales .......................................................................................................... 168Control sobre la reputación del remitente ............................................................................ 168Capacidad de aislar la reputación del remitente ................................................................... 168Direcciones IP conocidas y sin cambios ............................................................................. 168Solicitar y dejar de utilizar direcciones IP dedicadas ............................................................. 168Preparación de direcciones IP dedicadas ............................................................................ 171Creación de grupos de IP dedicadas ................................................................................. 172

Probar el envío de correo electrónico ......................................................................................... 173Consideraciones importantes ............................................................................................ 173Uso del simulador de bandeja de correo ............................................................................. 174Prueba de eventos de rechazo ......................................................................................... 175

Amazon SES y los protocolos de seguridad ................................................................................ 176Del remitente de correo electrónico a Amazon SES .............................................................. 176De Amazon SES al receptor ............................................................................................. 176

Recepción de correo electrónico ........................................................................................................ 178Conceptos de recepción de correo electrónico ............................................................................. 178

Control basado en destinatarios ........................................................................................ 178Control basado en dirección IP ......................................................................................... 179Proceso de recepción de correos electrónicos ..................................................................... 180

Introducción a la recepción de correo electrónico ......................................................................... 180Paso 1: Antes de comenzar .............................................................................................. 180Paso 2: comprobación de su dominio ................................................................................. 181Paso 3: configurar una regla de recepción .......................................................................... 182Paso 4: enviar un correo electrónico .................................................................................. 184Paso 5: ver el correo electrónico ....................................................................................... 185Paso 6: Eliminación ......................................................................................................... 185

Configuración de la recepción de correo electrónico ..................................................................... 186Consideración de su caso de uso ...................................................................................... 186Verificación de su dominio ................................................................................................ 188Publicación de un registro de MX ...................................................................................... 188Otorgar permisos ............................................................................................................ 189Creación de filtros de dirección IP ..................................................................................... 191Creación de un conjunto de reglas de recepción .................................................................. 192Creación de reglas de recepción ....................................................................................... 192

Administración de recepción de correo electrónico ....................................................................... 206Administración de conjuntos de reglas de recepción ............................................................. 206Administración de reglas de recepción ............................................................................... 209Administración de filtros de dirección IP ............................................................................. 211Visualización de métricas de error ..................................................................................... 212Uso de notificaciones ....................................................................................................... 213

Uso de conjuntos de configuración .................................................................................................... 224Administración de conjuntos de configuración .............................................................................. 224

Visualizar una lista de conjuntos de configuración ................................................................ 224Visualización de los detalles de un conjunto de configuración ................................................. 225Eliminación de un conjunto de configuración ....................................................................... 225

Administración de destinos de eventos ....................................................................................... 226Actualización de un destino de evento ............................................................................... 226Eliminación de un destino de evento .................................................................................. 226Habilitar o deshabilitar un destino de eventos ...................................................................... 226

Administración de grupos de IP ................................................................................................. 227Asignación de un grupo de IP a un conjunto de configuración ................................................ 227Modificación de asignaciones de grupo de IP ...................................................................... 228

Especificación de conjuntos de configuración en correo electrónico ................................................. 228

iv


Exportación de métricas de reputación ....................................................................................... 228Habilitar la exportación de métricas de reputación de un conjunto de configuración .................... 229Deshabilitar la exportación de métricas de reputación de un conjunto de configuración ............... 229

Monitoreo de la actividad de envío .................................................................................................... 230Monitoreo utilizando la consola ................................................................................................. 232Monitorear utilizando el API ...................................................................................................... 233

Llamada a la operación del API GetSendStatistics utilizando la AWS CLI .......................... 233Llamada a la operación GetSendStatistics mediante programación ................................... 233

Monitoreo utilizando notificaciones ............................................................................................. 236Consideraciones importantes ............................................................................................ 236Notificaciones a través de correo electrónico ....................................................................... 237Notificaciones a través de Amazon SNS ............................................................................. 239

Uso del monitoreo utilizando la publicación de eventos ................................................................. 259Cómo funciona la publicación de eventos ........................................................................... 259Cómo utilizar la publicación de eventos .............................................................................. 260Terminología de publicación de eventos ............................................................................. 260Configuración de publicación de eventos ............................................................................ 261Trabajo con datos de eventos ........................................................................................... 270Tutoriales ....................................................................................................................... 308Configuración de dominios personalizados de mensajes abiertos y en los que se ha hecho clic .... 346

Monitorear su reputación de remitente ............................................................................................... 350Uso del panel de reputación ..................................................................................................... 350Mensajes del panel de reputación ............................................................................................. 351

Mensajes de estado general ............................................................................................. 352Notificación de tasa de rebotes ......................................................................................... 353Notificación de tasa de reclamaciones ................................................................................ 354Notificación de organización antispam ................................................................................ 355Notificaciones de retroalimentación directa .......................................................................... 355Notificación de lista de bloqueo de dominios ....................................................................... 356Notificación de revisión interna .......................................................................................... 357Notificación de proveedor de bandeja de correo ................................................................... 359Notificaciones de retroalimentación de destinatario ............................................................... 359Notificación de cuenta relacionada ..................................................................................... 360Notificación de trampa de spam ........................................................................................ 361Notificación de sitio vulnerable .......................................................................................... 362Otras notificaciones ......................................................................................................... 363

Creación de alarmas mediante CloudWatch ................................................................................ 363Puesta en pausa automática del envío de correo electrónico ......................................................... 365

Poner en pausa automáticamente el envío de correo electrónico en su cuenta de Amazon SES .... 365Puesta en pausa automática del envío de correo electrónico para un conjunto de configuración .... 370

Control de acceso ........................................................................................................................... 377Creación de políticas de IAM para acceso a Amazon SES ............................................................ 377

Restringir la acción .......................................................................................................... 377Restricción de direcciones de correo electrónico .................................................................. 378Restricción del uso de API general .................................................................................... 379

Ejemplos de políticas de IAM para Amazon SES ......................................................................... 379Permitir el acceso completo a todas las acciones de Amazon SES ......................................... 379Permitir el acceso solo a acciones de envío de correo electrónico ........................................... 380Restricción del periodo de tiempo de envío ......................................................................... 380Restricción de las direcciones de destinatario ...................................................................... 381Restricción de la dirección de remitente ("From") ................................................................. 381Restricción del nombre de visualización del remitente de correo electrónico .............................. 382Restringir el destino de retroalimentación de rebotes y reclamaciones ..................................... 382

Registro de llamadas a API .............................................................................................................. 384Información de Amazon SES en CloudTrail ................................................................................. 384Entradas de archivos de registro de Amazon SES ....................................................................... 385

Uso de credenciales ........................................................................................................................ 393

v


Uso del API ................................................................................................................................... 396API de consulta ...................................................................................................................... 396

Solicitudes de consulta .................................................................................................... 396Autenticación de solicitudes .............................................................................................. 399Ejemplos de GET y POST ................................................................................................ 399Respuestas de consulta ................................................................................................... 400

Códigos de error del API .......................................................................................................... 401Ejemplos de código ......................................................................................................................... 405

Envío de correo electrónico mediante los SDK de AWS ................................................................ 405Envío de correo electrónico utilizando la interfaz de SMTP ............................................................ 416Envío de correo electrónico sin procesar mediante los SDK de AWS ............................................... 427Verificación de varias direcciones de correo electrónico ................................................................ 435Generar credenciales de SMTP ................................................................................................. 436

Regiones ....................................................................................................................................... 439Puntos de conexión de Amazon SES ......................................................................................... 439

Puntos de enlace de envío de correo electrónico ................................................................. 439Puntos de enlace de recepción de correo electrónico ........................................................... 440

Seleccionar una región ............................................................................................................ 440API de Amazon SES ....................................................................................................... 440Interfaz de SMTP de Amazon SES .................................................................................... 440Consola de Amazon SES ................................................................................................. 440

Entorno de pruebas y aumentos de límites de envío ..................................................................... 441Verificación ............................................................................................................................. 441

Verificación de dirección de correo electrónico ..................................................................... 441Verificación de dominio .................................................................................................... 441

Configuración de Easy DKIM .................................................................................................... 441Lista de supresión ................................................................................................................... 441Notificaciones de retroalimentación ............................................................................................ 442Credenciales SMTP ................................................................................................................. 442Dominios MAIL FROM personalizados ....................................................................................... 442Autorización de envío .............................................................................................................. 442Recepción de correos electrónicos ............................................................................................. 443

Límites ........................................................................................................................................... 444Límites relacionados con el envío de correo electrónico ................................................................ 444

Límites de envío ............................................................................................................. 444Límites de mensajes ........................................................................................................ 444Límites de remitentes y destinatarios ................................................................................. 445Límites relacionados con la publicación de evento de envío de correo electrónico ...................... 445Límites de plantilla de correo electrónico ............................................................................ 445Límites relacionados con Amazon EC2 ............................................................................... 446

Límites relacionados con la recepción de correo electrónico .......................................................... 446Límites generales .................................................................................................................... 447

Límites de API de Amazon SES ........................................................................................ 447prácticas recomendadas ................................................................................................................... 448

Métricas de éxito ..................................................................................................................... 448Tasa de rebotes .............................................................................................................. 448Reclamaciones ............................................................................................................... 449Calidad del mensaje ........................................................................................................ 450

Consejos y prácticas recomendadas .......................................................................................... 451Recomendaciones generales ............................................................................................ 451Consideraciones sobre dominios y direcciones de remitente ("From") ...................................... 451Autenticación .................................................................................................................. 452Creación y mantenimiento de sus listas .............................................................................. 452Conformidad ................................................................................................................... 452

Solución de problemas ..................................................................................................................... 454Problemas generales ............................................................................................................... 454

Los cambios que realizo no son visibles de inmediato .......................................................... 455

vi


Problemas de entrega .............................................................................................................. 455Problemas con correos electrónicos recibidos .............................................................................. 456Errores de envío de correo electrónico ....................................................................................... 456Problemas de verificación ......................................................................................................... 458

Problemas de verificación de correo electrónico ................................................................... 458Problemas comunes de verificación de dominio ................................................................... 459Cómo comprobar la configuración de la verificación de dominios ............................................ 460

Problemas de DKIM ................................................................................................................ 461Problemas de notificación ......................................................................................................... 462Eliminación de una dirección de correo electrónico de la lista de supresión ...................................... 462Aumento del desempeño .......................................................................................................... 463Problemas con las SMTP ......................................................................................................... 464Códigos de respuesta de SMTP ................................................................................................ 467

Eliminación de datos personales ....................................................................................................... 471Eliminar datos acerca del correo electrónico enviado .................................................................... 471

Quitar datos de eventos de almacenados ........................................................................... 472Eliminar datos sobre identidades ............................................................................................... 472Eliminar datos de autenticación de remitente ............................................................................... 473Eliminar datos relacionados con las reglas de recepción ............................................................... 473Eliminar datos relacionados con filtros de dirección IP .................................................................. 474Eliminar datos en plantillas de correo electrónico ......................................................................... 475Eliminación de datos en plantillas de correo electrónico de verificación personalizadas ....................... 475Eliminar todos los datos cerrando su cuenta de AWS ................................................................... 475

Preguntas frecuentes ....................................................................................................................... 477Preguntas frecuentes sobre cumplimiento ................................................................................... 477

Períodos de prueba ......................................................................................................... 477Suspensiones ................................................................................................................. 480Rebotes ......................................................................................................................... 482Reclamaciones ............................................................................................................... 485Trampas de spam ........................................................................................................... 490Investigaciones manuales ................................................................................................. 491

Preguntas frecuentes sobre la lista negra de IP ........................................................................... 493P1 preguntas frecuentes de listas negras ........................................................................... 493P2 preguntas frecuentes de listas negras ........................................................................... 493P3 preguntas frecuentes de listas negras ........................................................................... 494P4 preguntas frecuentes de listas negras ........................................................................... 494P5 preguntas frecuentes de listas negras ........................................................................... 494P6 preguntas frecuentes de listas negras ........................................................................... 495

Preguntas frecuentes sobre métricas de correo electrónico ............................................................ 496General ......................................................................................................................... 496Seguimiento de aperturas ................................................................................................. 497Seguimiento de clics ........................................................................................................ 498

Recursos ....................................................................................................................................... 500Apéndice ........................................................................................................................................ 502

Apéndice: campos de encabezado ............................................................................................. 502Apéndice: tipos de archivos adjuntos no admitidos ....................................................................... 503Apéndice: crear un panel de capacidad de entrega ...................................................................... 504

Parte 1: Crear un tema de Amazon SNS ............................................................................ 506Parte 2: Crear una cola de Amazon SQS ........................................................................... 506Parte 3: Crear un bucket de Amazon S3 ............................................................................ 507Parte 4: Crear una política y función de IAM ....................................................................... 507Parte 5: Configurar notificaciones de Amazon SES ............................................................... 509Parte 6: Crear una función de Lambda ............................................................................... 509Parte 7: Probar la función de Lambda ................................................................................ 511Parte 8: Configurar disparadores de CloudWatch ................................................................. 512

Historial de revisión ......................................................................................................................... 513

vii

Amazon Simple Email Service Developer Guide¿Por qué utilizar Amazon SES?

¿Qué es Amazon SES?Le damos la bienvenida a la Guía para desarrolladores de Amazon Simple Email Service (Amazon SES).Amazon SES es una plataforma de correo electrónico que ofrece un método sencillo y rentable de enviar yrecibir correos electrónicos a través de sus propios dominios y direcciones de correo electrónico.

Por ejemplo, puede enviar mensajes de correo electrónico de marketing como, por ejemplo, correoselectrónicos de transacciones tales como confirmaciones de pedidos y otros tipos de correspondenciatales como boletines. Al utilizar Amazon SES para recibir correo, puede desarrollar soluciones de softwarecomo, por ejemplo, agentes de respuesta automática de correo electrónico, sistemas de anulación desuscripción a correo electrónico y aplicaciones que generan tickets de soporte para clientes a partir decorreos electrónicos entrantes.

Como solo paga por lo que usa, puede enviar y recibir la cantidad de emails que desee. Para obtenerinformación sobre los aspectos destacados, preguntas frecuentes y los precios del servicio, visite la páginainformativa de Amazon SES.

¿Por qué utilizar Amazon SES?Construir una solución de correo electrónico a gran escala supone a menudo un reto complejo y caropara una empresa. Debe enfrentarse a muchos problemas de infraestructura, como la administración delservidor de correo electrónico, la configuración de la red o la reputación de la dirección IP. Además, lassoluciones de email de otros fabricantes requieren negociaciones de contractos y precios, así como costossignificativo por adelantado. Amazon SES elimina estos desafíos y permite a las empresas beneficiarsede los años de experiencia y la sofisticada infraestructura de email que Amazon.com ha construido paraatender a su propia base de clientes a gran escala.

Amazon SES y otros servicios de AWSAmazon SES se integra perfectamente con otros productos de AWS. Por ejemplo, puede hacer losiguiente:

• Añada capacidades de correo electrónico a cualquier aplicación que se ejecuta en una instancia AmazonElastic Compute Cloud (Amazon EC2) utilizando los AWS SDK o el API de Amazon SES. Si deseaenviar correo electrónico a través de Amazon SES desde una instancia Amazon EC2, puede comenzar autilizar Amazon SES de forma gratuita.

• Utilice AWS Elastic Beanstalk para crear aplicaciones habilitadas para correo electrónico como, porejemplo, un programa que utiliza Amazon SES para enviar un boletín a los clientes.

• Configure Amazon Simple Notification Service (Amazon SNS) para informarle de los correos electrónicosque han devuelto un rebote, una reclamación o que se han entregado correctamente al servidor decorreo del destinatario. Cuando utiliza Amazon SES para recibir correos electrónicos, el contenido decorreo electrónico se puede publicar en temas de Amazon SNS.

• Utilice la Consola de administración de AWS para configurar Easy DKIM, que es una manera deautenticar sus mensajes de correo electrónico. Aunque puede utilizar Easy DKIM con cualquierproveedor de DNS, es especialmente fácil configurar a la hora de gestionar su dominio con Route 53.

• Controle el acceso de los usuarios a su envío de correo electrónico mediante AWS Identity and AccessManagement (IAM).

• Almacene los mensajes de correo electrónico que recibe en Amazon Simple Storage Service (AmazonS3).

1

https://aws.amazon.com/ses/

https://aws.amazon.com/ses/

https://aws.amazon.com/ec2/

https://aws.amazon.com/ec2/

https://aws.amazon.com/tools/

https://aws.amazon.com/ses/pricing/

https://aws.amazon.com/elasticbeanstalk/

https://aws.amazon.com/sns/

https://aws.amazon.com/route53/

https://aws.amazon.com/iam/


https://aws.amazon.com/s3/


Amazon Simple Email Service Developer GuideEn esta guía

• Realice acciones sobre los correos electrónicos recibidos activando funciones de AWS Lambda.• Utilice AWS Key Management Service (AWS KMS) para cifrar opcionalmente el correo que reciba en el

bucket de Amazon S3.• Utilice AWS CloudTrail para registrar llamadas al API de Amazon SES que realiza mediante la consola o

el API de Amazon SES.• Publique sus eventos de envío de correo electrónico en Amazon CloudWatch o Amazon Kinesis Data

Firehose. Si publica sus eventos de envío de correo electrónico en Kinesis Data Firehose, puedeacceder a los mismos en Amazon Redshift, Amazon Elasticsearch Service o Amazon S3.

En esta guíaEsta guía contiene las siguientes secciones.

Sección Descripción

Envío de correo electrónico (p. 5) Describe cómo puede enviar correo electrónico a través deAmazon SES.

Recepción de correoelectrónico (p. 178)

Describe cómo puede recibir correo electrónico a través deAmazon SES.

Control de acceso (p. 377) Muestra cómo utilizar Amazon SES con AWS Identity andAccess Management (IAM) para especificar qué accionesdel API de Amazon SES puede realizar un usuario en cadarecurso de Amazon SES.

Registro de llamadas a API (p. 384) Proporciona una lista de API de Amazon SES que se puedenregistrar utilizando AWS CloudTrail.

Uso de credenciales (p. 393) Explica los tipos de credenciales que puede utilizar conAmazon SES y cuándo podría utilizarlos.

Uso del API (p. 396) Se describe cómo utilizar el API de consulta de Amazon SES.

Regiones (p. 439) Enumera los puntos de enlace SMTP y API de Amazon SESpara las regiones de AWS en las que Amazon SES estádisponible y contiene información que tiene que conoceral utilizar los puntos de enlace de Amazon SES en variasregiones.

Límites (p. 444) Ofrece una lista de límites dentro de Amazon SES.

Recursos (p. 500) Muestra una lista de los recursos que le podrían resultar útilescuando trabaje con Amazon SES

Apéndice (p. 502) Proporciona información adicional acerca de los campos deencabezado, tipos de adjuntos no admitidos y scripts.

2

https://aws.amazon.com/lambda/

https://aws.amazon.com/kms/

https://aws.amazon.com/cloudtrail/

https://aws.amazon.com/cloudwatch/

https://aws.amazon.com/firehose/

https://aws.amazon.com/firehose/

https://aws.amazon.com/redshift/

https://aws.amazon.com/elasticsearch-service/


Amazon Simple Email Service Developer GuidePaso 1: Inscribirse en AWS

Inicio rápido de Amazon SESEste procedimiento le guía a través de los pasos para inscribirse en AWS, verificar su dirección de correoelectrónico, enviar su primer correo electrónico, plantearse cómo gestionar los rebotes y las reclamacionesy cómo salir del entorno de pruebas de Amazon Simple Email Service (Amazon SES).

Utilice este procedimiento si:

• Solo está experimentando con Amazon SES.• Desea enviar algunos correos electrónicos de prueba sin necesidad de ninguna programación.• Desea realizar la configuración con el menor número de pasos posible.

Paso 1: Inscribirse en AWSPara poder utilizar Amazon SES, tiene que inscribirse en AWS. Al inscribirse en AWS, su cuenta de AWSse inscribe automáticamente en todos los servicios de AWS.

Para obtener instrucciones, consulte Inscripción en AWS (p. 46).

Paso 2: verificar su dirección de correo electrónicoPara poder enviar correo electrónico desde su dirección de correo electrónico a través de Amazon SES,tiene que demostrar a Amazon SES que la dirección de correo electrónico le pertenece verificándola.

Para obtener instrucciones, consulte Verificación de direcciones de correo electrónico en AmazonSES. (p. 47).

Paso 3: enviar su primer correo electrónicoPuede enviar un correo electrónico simplemente a través de la consola de Amazon SES. Como nuevousuario, su cuenta se encuentra en un entorno de prueba denominado el entorno de pruebas, por loque solo puede enviar correo electrónico desde y hacia las direcciones de correo electrónico que hayaverificado.

Para obtener instrucciones, consulte Enviar un correo electrónico a través de la consola de AmazonSES (p. 19).

Paso 4: considere cómo gestionar los rebotes y lasreclamaciones

Antes del paso siguiente, tiene que pensar cómo gestionar los rebotes y las reclamaciones. Si estáenviando a un número reducido de destinatarios, el proceso puede ser tan sencillo como examinar laretroalimentación de rebotes y reclamaciones que recibe por correo electrónico y, a continuación, eliminardichos destinatarios de su lista de correo.

3

Amazon Simple Email Service Developer GuidePaso 5: Salir del entorno de pruebas de Amazon SES

Paso 5: Salir del entorno de pruebas de AmazonSES

Para poder enviar correos electrónicos a direcciones de correo electrónico sin verificar y aumentar elnúmero de mensajes de correo electrónico que puede enviar al día y la velocidad a la que puede enviarlos,la cuenta tiene que salir del entorno de pruebas. Este proceso implica abrir un caso de SES Sending LimitsIncrease en el servicio de atención al cliente.

Para obtener más información sobre las restricciones del entorno de pruebas y cómo solicitar salir fuera delentorno de pruebas, consulte Salir del entorno de pruebas de Amazon SES (p. 72).

Pasos siguientes• Después de enviarse unos cuantos correos electrónicos de prueba a usted mismo, utilice el simulador

de bandeja de correo de Amazon SES para realizar pruebas adicionales, ya que los correos electrónicosque se envían al simulador de bandeja de correo no se tienen en cuenta en la cuota de envío ni en sustasas de rebotes y reclamaciones. Para obtener más información sobre el simulador de bandeja decorreo, consulte Probar el envío de correo electrónico en Amazon SES (p. 173).

• Monitoree su actividad de envío, como el número de mensajes de correo electrónico que ha enviado y elnúmero que han tenido rebotes o han recibido reclamaciones. Para obtener más información, consulteMonitoreo de la actividad de envío de Amazon SES (p. 230).

• Verifique dominios completos para que pueda enviar correo electrónico desde cualquier dirección decorreo electrónico de su dominio sin verificar las direcciones de manera individual. Para obtener másinformación, consulte Verificación de dominios en Amazon SES (p. 59).

• Aumente la posibilidad de que sus correos electrónicos se entreguen en las bandejas de entrada de losdestinatarios en lugar de las carpetas de spam autenticando sus correos electrónicos. Para obtener másinformación, consulte Autenticación del correo electrónico en Amazon SES (p. 124).

4

Amazon Simple Email Service Developer Guide¿Cómo envío mensajes de correo con Amazon SES?

Envío de correo electrónico conAmazon SES

Cuando envía un correo electrónico, lo envía a través de algún tipo de servidor de correo electrónicosaliente. Dicho servidor de correo electrónico puede facilitarlo su proveedor de servicios de Internet(ISP), el departamento de TI de su empresa o bien podría haberlo configurado usted mismo. El servidorde correo electrónico acepta su contenido de correo electrónico, le da formato para que cumpla conlos estándares de correo electrónico y, a continuación, envía el correo electrónico a Internet. El correoelectrónico podría pasar a través de otros servidores hasta que finalmente llega a un receptor (una entidadcomo, por ejemplo, un proveedor de servicios de Internet, que recibe el correo electrónico en nombredel destinatario). El receptor envía el correo electrónico a continuación al destinatario. En el diagramasiguiente se ilustra el proceso de envío de correo electrónico básico.

Cuando utiliza Amazon SES, Amazon SES se convierte en su servidor de correo electrónico saliente.También puede mantener su servidor de correo electrónico existente y configurarlo para enviar correoselectrónicos salientes a través de Amazon SES para que no tenga que cambiar ningún ajuste de correoelectrónico en sus clientes de correo electrónico. En el siguiente diagrama se muestra dónde encajaAmazon SES en el proceso de envío de correo electrónico.

Un remitente puede generar el contenido del correo electrónico de distintas maneras. Un remitente puedecrear el correo electrónico utilizando una aplicación cliente de correo electrónico o utilizar un programa quegenera automáticamente correos electrónicos, como una aplicación que envía confirmaciones de pedidoen respuesta a las transacciones de compra.

¿Cómo envío mensajes de correo con AmazonSES?

Existen varias maneras en las que puede enviar un correo electrónico a través de Amazon SES. Puedeutilizar la consola de Amazon SES o la interfaz de Simple Mail Transfer Protocol (SMTP), o bien, puedeabrir el API de Amazon SES.

• Consola de Amazon SES: este método es la forma más rápida de configurar el sistema y enviar varioscorreos electrónicos de prueba, pero una vez esté listo para comenzar la campaña de correo electrónico,la utilizará principalmente para monitorear la actividad de envío. Por ejemplo, puede ver rápidamente elnúmero de mensajes de correo electrónico que ha enviado y el número de rebotes y reclamaciones queha recibido.

• Interfaz de SMTP: existen dos formas de acceder a Amazon SES a través de la interfaz de SMTP. Laprimera forma, que no requiere codificación, consiste en configurar algún software habilitado para SMTPpara enviar correo electrónico a través de Amazon SES. Por ejemplo, puede configurar su cliente de

5

Amazon Simple Email Service Developer Guide¿Por dónde empezar?

correo electrónico o un programa de software para conectarse al punto de enlace de SMTP de AmazonSES en lugar de a su servidor de correo electrónico saliente actual.

El segundo método consiste en utilizar un lenguaje de programación compatible con SMTP como,por ejemplo, Java y acceder a la interfaz de SMTP de Amazon SES utilizando los tipos de datos y lasfunciones SMTP integradas del lenguaje.

• API de Amazon SES: puede llamar al API de consulta de Amazon SES directamente a través de HTTPSo puede utilizar el AWS Command Line Interface, el Herramientas de AWS para Windows PowerShello un SDK de AWS. Los SDK de AWS envuelven la funcionalidad de bajo nivel del API de Amazon SEScon tipos de datos de nivel superior y llamadas a funciones que se encargan de los detalles. Los SDKde AWS proporcionan no solo las operaciones de Amazon SES, sino además la funcionalidad básica deAWS como, por ejemplo, la autenticación de solicitudes, los reintentos de solicitud y el tratamiento deerrores.

¿Por dónde empezar?Si es la primera vez que usa Amazon SES, le recomendamos que empiece leyendo las siguientessecciones:

• Inicio rápido de Amazon SES (p. 3): muestra cómo realizar la configuración y enviar un correoelectrónico de prueba lo antes posible.

• Introducción al envío de correo electrónico con Amazon SES (p. 18): muestra cómo enviar uncorreo electrónico a través de la consola de Amazon SES, la interfaz de SMTP y un SDK de AWS. Losejemplos se ofrecen en C#, Java y PHP.

• Amazon SES y capacidad de entrega (p. 7): explica los conceptos de capacidad de entrega decorreo electrónico que debe conocer cuando utilice Amazon SES.

• Proceso de envío de correo electrónico de Amazon SES (p. 12): muestra lo que ocurre cuando seenvía un correo electrónico a través de Amazon SES.

• Formato de correo electrónico y Amazon SES (p. 15): revisa el formato de los correos electrónicos eidentifica la información que tiene que proporcionar a Amazon SES.

A continuación, puede obtener más información sobre el envío de correo electrónico con Amazon SES conmás detalle en las secciones que se muestran en la siguiente tabla:

Sección Descripción

Configuración de correoelectrónico (p. 45)

Muestra cómo inscribirse en AWS, obtener sus claves deacceso de AWS, descargar un SDK de AWS, verificar lasdirecciones de correo electrónico o dominios y salir delentorno de pruebas de Amazon SES.

Uso de la interfaz de SMTP (p. 74) Muestra cómo obtener sus credenciales de SMTP de AmazonSES, conectarse al punto de enlace de SMTP de AmazonSES y proporcionar ejemplos de cómo configurar clientes decorreo electrónico y paquetes de software para enviar correoelectrónico a través de Amazon SES. También se explicacómo configurar su servidor de correo electrónico existentepara enviar todos los correos electrónicos salientes a travésde Amazon SES.

Uso del API (p. 107) Muestra cómo enviar correos electrónicos con formato y sinprocesar mediante el API de Amazon SES. Explica cómoutilizar caracteres no estándar y enviar archivos adjuntos a

6

https://aws.amazon.com/cli/

https://aws.amazon.com/powershell/


Amazon Simple Email Service Developer GuideConceptos

Sección Descripcióntravés del estándar Multipurpose Internet Mail Extensions(MIME) al enviar mensajes de correo electrónico sin procesar.

Autenticación del correoelectrónico (p. 124)

Muestra cómo utilizar DKIM con Amazon SES para mostrar alos ISP que usted es el propietario del dominio desde el querealiza el envío.

Administrar sus límites deenvío (p. 136)

Explica los dos límites de envío de Amazon SES (la cuota deenvío y el ratio máximo de envío), cómo aumentarlos y loserrores que recibe cuando intenta superarlos.

Uso de autorización de envío (p. 141) Muestra cómo autorizar a otros usuarios a enviar correoselectrónicos a partir de sus identidades en su nombre.

Uso de direcciones IPdedicadas (p. 166)

Decide si desea utilizar direcciones IP compartidas oalquilar direcciones IP dedicadas para su envío de AmazonSES. Ofrece procedimientos para solicitar y abandonardirecciones IP dedicadas y para crear grupos de direccionesIP dedicadas.

Probar el envío de correoelectrónico (p. 173)

Explica cómo utilizar el simulador de bandeja de correo deAmazon SES para simular situaciones comunes de correoelectrónico sin que ello afecte a sus estadísticas de envío,tales como las métrica de rebotes y reclamaciones. Lassituaciones que puede probar son entrega con éxito, rebote,reclamación, fuera de la oficina (OOTO) y dirección en la listade supresión.

Conceptos de envío de correo electrónico deAmazon SES

Las siguientes secciones contienen información fundamental acerca de cómo envía Amazon SES sucorreo electrónico.

• Amazon SES y capacidad de entrega (p. 7)• Proceso de envío de correo electrónico de Amazon SES (p. 12)• Formato de correo electrónico y Amazon SES (p. 15)

Amazon SES y capacidad de entregaDesea que sus destinatarios lean sus correos electrónicos, los encuentren útiles y no los etiqueten comospam. En otras palabras, desea mejorar la capacidad de entrega del correo electrónico: el porcentajede sus correos electrónicos que llega a las bandejas de entrada de los destinatarios. Este tema revisaconceptos de capacidad de entrega de correo electrónico que debe conocer cuando utilice Amazon SES.

Para mejorar la capacidad de entrega de correo electrónico, necesita conocer los problemas de entregade correo electrónico, tomar medidas de forma proactiva para evitarlos, mantenerse informado acercadel estado de los mensajes de correo electrónico que envíe y, además, mejorar el programa de envío decorreo electrónico, si es necesario, para aumentar aún más la probabilidad de éxito de las entregas. En lassecciones siguientes se revisan los conceptos subyacentes a estos pasos y cómo Amazon SES le ayuda arealizar el proceso.

7

Amazon Simple Email Service Developer GuideAmazon SES y capacidad de entrega

Entender los problemas de entrega de correo electrónicoEn la mayoría de los casos, los mensajes se envían de forma correcta a los destinatarios que losesperan. En algunos casos, sin embargo, una entrega podría devolver un error o un destinatario podríano desea recibir el correo que está enviando. Los rebotes, las reclamaciones y la lista de supresión estánrelacionados con estos problemas de entrega y se describen en las siguientes secciones.

BounceSi el receptor de su destinatario (por ejemplo, un ISP) no consigue entregar su mensaje al destinatario,el receptor rebota el mensaje de vuelta a Amazon SES. Amazon SES le notifica seguidamente acercadel correo electrónico rebotado por correo electrónico o a través de Amazon Simple Notification Service(Amazon SNS), en función de cómo haya configurado su sistema. Para obtener más información, consulteMonitoreo utilizando notificaciones de Amazon SES (p. 236).

Hay rebotes permanentes y rebotes temporales, como se indica a continuación:

• Rebote permanente: un error permanente de entrega de correo electrónico. Por ejemplo, la bandeja deentrada no existe. Amazon SES no reintentará los rebotes permanentes, con la excepción de los erroresde búsqueda de DNS. Le recomendamos encarecidamente que no realice intentos de entrega repetidosa las direcciones de correo electrónico que presentan rebote permanente.

• Rebote temporal: un error temporal de entrega de correo electrónico. Por ejemplo, el buzón de correoestá lleno, hay demasiadas conexiones (también denominada limitación controlada) o se agota el tiempode espera de la conexión. Amazon SES vuelve a intentar los rebotes temporales varias veces. Si elcorreo electrónico todavía no se puede enviar, entonces Amazon SES deja de reintentarlo.

8


Amazon SES le notifica acerca de los rebotes permanentes y los rebotes temporales que ya no se volverána intentar. Sin embargo, solo los rebotes permanentes se tienen en cuentan en la tasa de rebote y lamétrica de rebote que recupera a través de la consola de Amazon SES o el API GetSendStatistics.

Los rebotes además pueden ser síncronos o asíncronos. Un rebote síncrono se produce mientras losservidores de correo electrónico del remitente y del receptor se están comunicando de forma activa. Unrebote asíncrono que se produce cuando un receptor acepta inicialmente un mensaje de correo electrónicopara su entrega y posteriormente no consigue entregarlo al destinatario.

Complaint

La mayoría de los programas cliente de correo electrónico ofrecen un botón "Marcar como spam", osimilar, que traslada el mensaje a una carpeta de spam y lo reenvía al ISP. Además, la mayoría de losISP mantienen una dirección de abuso (por ejemplo, [email protected]), donde los usuarios puedenreenviar mensajes de correo electrónico no deseados y solicitar al ISP que tome las medidas necesariaspara evitarlos. En ambos casos, el destinatario está realizando una reclamación. Si el ISP llega a laconclusión de que usted es un spammer y Amazon SES tiene configurado un bucle de retroalimentacióncon el ISP, entonces el ISP enviará la reclamación de vuelta a Amazon SES. Cuando Amazon SES recibedicha reclamación, se la reenvía a usted por correo electrónico o mediante una notificación de AmazonSNS, en función de cómo tenga configurado su sistema. Para obtener más información, consulte Monitoreoutilizando notificaciones de Amazon SES (p. 236). Le recomendamos encarecidamente que no realiceintentos de entrega repetidos a las direcciones de correo electrónico que generen reclamaciones.

Lista de supresión

La lista de supresión de Amazon SES es una lista de direcciones de correo electrónico de remitentes quehan provocado un rebote permanente recientemente para cualquier cliente de Amazon SES. Si intentaenviar un correo electrónico a través de Amazon SES a una dirección incluida en la lista de supresión,la llamada a Amazon SES tendrá éxito, pero Amazon SES tratará el correo como rebote permanente enlugar de intentar enviarlo. Al igual que con el rebote permanente, las devoluciones de la lista de supresiónse tienen en cuenta en la cuota de envío y en la tasa de mensajes devueltos. Una dirección de correoelectrónico puede permanecer en la lista de supresión durante un período máximo de 14 días. Si estáseguro de que la dirección de correo electrónico a la que está intentando enviar el mensaje es válida,puede enviar una solicitud de retirada de la lista de supresión. Para obtener más información, consulteEliminación de una dirección de correo electrónico de la lista de supresión de Amazon SES (p. 462).

Sea proactivoUno de los principales problemas del correo electrónico en Internet es el correo masivo no solicitado ospam. Los proveedores de servicios de Internet adoptan muchas medidas para impedir que sus clientesreciban spam. En consecuencia, Amazon SES toma medidas proactivas para reducir la probabilidadde que los ISP consideren que su correo electrónico sea spam. Amazon SES utiliza la verificación,la autenticación, los límites de envío y el filtrado de contenido. Amazon SES también mantiene unareputación de confianza con los proveedores de servicios de Internet y exige que envíe correo electrónicode alta calidad. Amazon SES realiza algunas de estas cosas automáticamente (como el filtrado decontenidos); en otros casos, facilita las herramientas (como la autenticación) o le guía en la direccióncorrecta (límites de envío). Las siguientes secciones brindan más información sobre cada concepto.

Verificación

Desgraciadamente, un spammer podría falsificar un encabezado de correo electrónico y suplantar ladirección de correo electrónico de origen para aparentar que el correo electrónico procede de una fuentediferente. Para mantener la confianza entre los ISP y Amazon SES, Amazon SES tiene que asegurarsede que sus remitentes sean quien dicen ser. Por tanto es necesario que verifique todas las direccionesde correo electrónico desde las que envía correos electrónicos a través de Amazon SES para proteger suidentidad de envío. Puede verificar las direcciones de correo electrónico utilizando la consola de AmazonSES o utilizando el API de Amazon SES. También puede verificar dominios completos. Para obtener

9


más información, consulte Verificación de direcciones de correo electrónico en Amazon SES. (p. 47) yVerificación de dominios en Amazon SES (p. 59).

Si su cuenta sigue estando en el entorno de pruebas de Amazon SES, también deberá verificar todaslas direcciones de destinatarios excepto las direcciones proporcionadas por el simulador de bandeja decorreo de Amazon SES. Para obtener información sobre cómo salir del entorno de pruebas, consulte Salirdel entorno de pruebas de Amazon SES (p. 72). Para obtener más información sobre el simulador debandeja de correo, consulte Probar el envío de correo electrónico en Amazon SES (p. 173).

Autenticación

Autenticación es otra forma en que puede indicar a los ISP que es quien dice ser. Para autenticar uncorreo electrónico, deberá aportar una prueba de que es el dueño de la cuenta y sus emails no se hanmodificado en tránsito. En algunos casos, los ISP rechazan reenviar el correo electrónico que no estáautenticado. Amazon SES admite dos métodos de autenticación: Sender Policy Framework (SPF) y correoidentificado con claves de dominio (DKIM). Para obtener más información, consulte Autenticación delcorreo electrónico en Amazon SES (p. 124).

Límites de envío

Si un ISP detecta picos repentinos e inesperados en el volumen o en la tasa de sus correos electrónicos,el ISP podría sospechar que se trata de un spammer y bloquear los mensajes de correo electrónico. Porlo tanto, cada cuenta de Amazon SES tiene un conjunto de límites de envío para regular el número demensajes de correo electrónico que puede enviar y la tasa a la que puede enviarlos. Estos límites deenvío le ayudan a aumentar gradualmente su actividad de envío para proteger su credibilidad con losproveedores de servicios de Internet.

Amazon SES tiene dos límites de envío: una cuota de envío (el número máximo de mensajes que puedeenviar en un periodo de 24 horas) y un ratio máximo de envío (el número máximo de mensajes de correoelectrónico que Amazon SES puede aceptar desde su cuenta por segundo, aunque la tasa real a laque Amazon SES acepta sus mensajes podría ser inferior al ratio máximo de envío). Si es un usuarionuevo, Amazon SES le permite enviar una pequeña cantidad de correo electrónico cada día. Si el correoelectrónico que envía es aceptable para los ISP, este límite aumentará gradualmente. Con el paso deltiempo, los límites de envío aumentarán de forma constante para que pueda enviar grandes cantidades decorreo electrónico a tasas más rápidas. También puede presentar un SES Sending Limits Increase casepara que se aumenten sus cuotas si necesita ampliar el número de forma rápida.

Para obtener más información sobre los límites de envío y cómo aumentarlos, consulte Administrar suslímites de envío de Amazon SES (p. 136).

Filtrado de contenido

Muchos proveedores de servicios de Internet utilizan el filtrado de contenido para determinar si los correoselectrónicos entrantes son spam. Los filtros de contenido buscan contenidos dudosos y bloquean el correoelectrónico si el correo electrónico encaja en el perfil de spam. Amazon SES utiliza también filtros decontenido. Cuando su aplicación envía una solicitud a Amazon SES, Amazon SES crea un mensaje decorreo electrónico en su nombre y, a continuación, analiza el encabezado del mensaje y el cuerpo paradeterminar si lleva contenido que los ISP puedan interpretar como spam. Si sus mensajes parecen spampara los filtros de contenido que utiliza Amazon SES, su reputación con Amazon SES se verá afectadanegativamente.

Amazon SES también analiza todos los mensajes para detectar la presencia de virus. Si un mensajecontiene un virus, Amazon SES no intenta entregar el mensaje al servidor de correo del destinatario.

Reputación

En lo referente al envío de correo electrónico, la reputación (que mide la confianza en que una dirección deIP, dirección de correo electrónico o dominio remitente no constituye una fuente de spam) es importante.

10

https://aws.amazon.com/ses/extendedaccessrequest/


Amazon SES mantiene una gran reputación con proveedores de servicios de Internet, de forma que losISP entreguen sus correos electrónicos a las bandejas de entrada de sus destinatarios. Del mismo modo,debe mantener una reputación de confianza con Amazon SES. La reputación se crea en Amazon SESenviando contenido de alta calidad. Al enviar contenido de alta calidad, su reputación pasa a ser de mayorconfianza con el tiempo y Amazon SES aumenta sus límites de envío. Los rebotes y las reclamacionesexcesivos afectan negativamente a su reputación y pueden provocar que Amazon SES reduzca sus límitesde envío o termine su cuenta de Amazon SES.

Una forma de ayudar a mantener su reputación consiste en utilizar el simulador de bandeja de correoal probar su sistema, en lugar de enviar a las direcciones de correo electrónico que haya creado ustedmismo. Los correos electrónicos enviados al simulador de bandeja de correo no cuentan para la métrica derebotes y reclamaciones. Para obtener más información sobre el simulador de bandeja de correo, consulteProbar el envío de correo electrónico en Amazon SES (p. 173).

Correo electrónico de alta calidad

El correo electrónico de alta calidad es aquel que los destinatarios consideran valioso y desean recibir. Elsignificado de “valioso” varía en función de cada destinatario y puede referirse a ofertas, confirmacionesde pedidos, recibos, boletines informativos, etc. En última instancia, su capacidad de entrega se basaen la calidad de los mensajes de correo electrónico que envíe dado que los ISP bloquean los correoselectrónicos que consideran de baja calidad (spam).

Manténgase informadoSi las entregas no se realizan correctamente, los destinatarios se quejan de sus correos electrónicoso Amazon SES entrega correctamente un correo electrónico al servidor de correo de un destinatario,Amazon SES le ayuda a localizar el problema mediante notificaciones y permitiéndole monitorizar confacilidad las estadísticas de uso.

Notificaciones

Cuando un correo electrónico rebota, el ISP notifica a Amazon SES y Amazon SES se lo notifica a usted.Amazon SES le notifica acerca de los rebotes permanentes y los rebotes temporales que Amazon SESya no volverá a intentar. Muchos proveedores de servicios de Internet además reenvían reclamacionesy Amazon SES configura bucles de retroalimentación de reclamaciones con los principales proveedoresde servicios de Internet para que no tenga que hacerlo. Amazon SES puede notificarle de rebotes,reclamaciones y entregas correctas de dos formas: puede configurar su cuenta para recibir notificacionesa través de Amazon SNS, o puede recibir las notificaciones por correo electrónico (solo rebotes yreclamaciones). Para obtener más información, consulte Monitoreo utilizando notificaciones de AmazonSES (p. 236).

Estadísticas de uso

Amazon SES ofrece estadísticas de uso para que pueda ver las entregas con error para determinar yresolver las causas. Puede ver sus estadísticas de uso mediante la consola de Amazon SES o llamandoal API de Amazon SES. Puede ver cuántas entregas, rebotes, reclamaciones y correos electrónicosrechazados infectados por virus tiene y también puede consultar los límites de envío para asegurarse deno rebasarlos.

Mejore su programa de envío de correo electrónicoSi obtiene un gran número de rebotes y reclamaciones, es hora de replantearse su estrategia de envío decorreos electrónicos. Recuerde que un número excesivo de rebotes, reclamaciones e intentos de enviarcorreo de baja calidad supondrán abuso y supondrán un riesgo de que se cierre su cuenta de AWS. Enúltima instancia, tiene que estar seguro de que utiliza Amazon SES para enviar correos electrónicos de altacalidad y enviar correos electrónicos únicamente a los destinatarios que desean recibirlos.

11

Amazon Simple Email Service Developer GuideProceso de envío de correo electrónico

Proceso de envío de correo electrónico de AmazonSESEste tema describe lo que ocurre cuando se envía un correo electrónico con Amazon SES y los diferentesresultados que pueden producirse después de que se envíe el correo electrónico. La siguiente figura esinformación general de alto nivel acerca del proceso de envío:

1. Una aplicación cliente, que actúa como un remitente de correo electrónico, realiza una solicitud aAmazon SES para enviar correo electrónico a uno o varios destinatarios.

2. Si la solicitud es válida, Amazon SES acepta el correo electrónico y lo envía a través de Internetal receptor del destinatario. Una vez que el mensaje se transfiere a Amazon SES, se suele enviarinmediatamente, con el primer intento de entrega normalmente en un plazo de milisegundos.

3. En este momento, existen diferentes posibilidades. Por ejemplo:

a. El ISP entrega correctamente el mensaje en la bandeja de entrada del destinatario.b. La dirección de correo electrónico del destinatario no existe, por lo que el ISP envía una

notificación de rebote a Amazon SES. Amazon SES, a continuación, reenvía la notificación alremitente.

c. El destinatario recibe el mensaje, pero lo considera spam y registra una reclamación en el ISP. ElISP, que tiene un bucle de retroalimentación configurado con Amazon SES, envía la reclamacióna Amazon SES, que a su vez la reenvía al remitente.

En las secciones siguientes se revisan los posibles resultados después de que un remitente envíe unasolicitud de correo electrónico a Amazon SES y después de que Amazon SES envíe un mensaje de correoelectrónico al destinatario.

Después de que un remitente envíe una solicitud de correoelectrónico a Amazon SESCuando el remitente realiza una solicitud a Amazon SES para enviar un correo electrónico, la llamadapuede tener éxito o producir un error. En las secciones siguientes se describe lo que ocurre en cada caso.

Solicitud de envío correctaSi la solicitud a Amazon SES se realiza correctamente, Amazon SES devuelve una respuesta de operacióncorrecta al remitente. Este mensaje incluye el ID de mensaje, una cadena de caracteres que identifica deforma única la solicitud. Puede utilizar el ID de mensajes para identificar el correo electrónico enviado opara realizar un seguimiento de los problemas detectados durante el envío. Amazon SES crea entoncesun mensaje de correo electrónico basado en los parámetros de solicitud, analiza el mensaje para detectar

12


contenido dudoso y virus y, a continuación, lo envía a través de Internet utilizando Simple Mail TransferProtocol (SMTP). Su mensaje suele enviarse inmediatamente; el primer intento de entrega suele hacerseefectivo en milisegundos.

Note

Si Amazon SES acepta la solicitud del remitente y, a continuación, determina que el mensajecontiene un virus, Amazon SES deja de procesar el mensaje y no intenta enviarlo al servidor decorreo del destinatario.

Solicitud de envío con error

Si la solicitud de envío de correo electrónico del remitente a Amazon SES produce un error, Amazon SESresponde al remitente con un error y anula el correo electrónico. La solicitud podría generar un error porvarios motivos. Por ejemplo, la solicitud podría no tener el formato correcto o es posible que el remitente nohaya verificado la dirección de correo electrónico.

El método a través del que puede determinar si la solicitud ha fallado depende de cómo llame a AmazonSES. Los siguientes son ejemplos de cómo se devuelven los errores y excepciones:

• Si llama a Amazon SES a través del API Query (HTTPS) (SendEmail o SendRawEmail), las accionesdevolverán un error. Para obtener más información, consulte Amazon Simple Email Service APIReference.

• Si utiliza un SDK de AWS para un lenguaje de programación que utilice excepciones, la llamada aAmazon SES lanzará una excepción MessageRejectedException. (El nombre de la excepción puedevariar ligeramente en función del SDK).

• Si utiliza la interfaz de SMTP, el remitente recibe un código de respuesta de SMTP, pero la forma en quese transmite el error depende del cliente del remitente. Algunos clientes podrían mostrar un código deerror, mientras que otros no.

Para obtener información acerca de los errores que pueden producirse al enviar un correo electrónico conAmazon SES, consulte Errores de envío de correo electrónico de Amazon SES (p. 456).

Después de que Amazon SES envía un correo electrónicoSi la solicitud del remitente a Amazon SES se realiza correctamente, el Amazon SES envía el correoelectrónico y se da uno de los siguientes resultados:

• Entrega correcta y el destinatario no se opone al correo electrónico: el ISP acepta el correo electrónico ylo entrega al destinatario. En la siguiente ilustración se muestra una entrega correcta.

• Rebote permanente: el correo electrónico es rechazado por el ISP debido a una condición persistenteo rechazado por Amazon SES porque la dirección de correo electrónico está en la lista de supresiónde Amazon SES. Una dirección de correo electrónico está en la lista de supresión de Amazon SES siha provocado recientemente un rebote permanente recientemente para cualquier cliente de AmazonSES. Un rebote permanente con un ISP puede ocurrir porque la dirección del destinatario no sea válida.Una notificación de rebote permanente se envía desde el ISP de nuevo a Amazon SES, que informaal remitente a través de correo electrónico o a través de Amazon Simple Notification Service (AmazonSNS), en función de la configuración del remitente. Amazon SES notifica al remitente de los rebotes dela lista de supresión por el mismo medio. La ruta de un rebote permanente de un ISP se muestra en lasiguiente ilustración.

13

https://docs.aws.amazon.com/ses/latest/APIReference/



• Rebote temporal: el ISP no puede entregar el correo electrónico al destinatario por un problematemporal, por ejemplo si el ISP está demasiado ocupado para gestionar la solicitud o si el buzón deldestinatario está lleno. Un rebote temporal también puede ocurrir si el dominio no existe. El ISP envíauna notificación de rebote temporal de vuelta a Amazon SES o, en el caso de un dominio inexistente,Amazon SES no puede encontrar un servidor de correo electrónico para el dominio. En cualquiercaso, Amazon SES vuelve a intentar el correo electrónico durante un periodo de tiempo prolongado. SiAmazon SES no puede entregar el correo electrónico en ese periodo de tiempo, le envía una notificaciónde rebote por correo electrónico o a través de Amazon SNS. Si Amazon SES puede entregar el correoelectrónico al destinatario durante un reintento, la entrega se realiza correctamente. En la siguienteilustración se muestra un rebote temporal. En este caso, Amazon SES vuelve a intentar enviar el correoelectrónico y el ISP puede finalmente entregarlo al destinatario.

• Reclamación: el ISP acepta el correo electrónico y se entrega al destinatario, pero el destinatarioconsidera que el correo electrónico es spam y hace clic en un botón como "Marcar como spam" ensu cliente de correo electrónico. Si Amazon SES tiene un bucle de retroalimentación configurado conel ISP, entonces se envía una notificación de reclamación a Amazon SES, que a su vez reenvía lanotificación de reclamación al remitente. La mayoría de los ISP no proporcionan la dirección de correoelectrónico del destinatario que presentó la reclamación, por lo que la reclamación de Amazon SESofrece al remitente una lista de destinatarios que podrían haber enviado la reclamación, en función delos destinatarios del mensaje original y el ISP desde el que Amazon SES recibió la reclamación. La rutade una reclamación se muestra en la siguiente ilustración.

• Respuesta automática: el ISP acepta el correo electrónico y lo envía al destinatario. El ISP envía acontinuación una respuesta automática, por ejemplo un mensaje de fuera de la oficina (OOTO) aAmazon SES. Amazon SES, reenvía la notificación de respuesta automática al remitente. En la figurasiguiente se muestra una respuesta automática.

Asegúrese de que su programa habilitado para Amazon SES no reintente el envío de mensajes quegeneren una respuesta automática.

Tip

Puede utilizar el simulador de bandeja de correo de Amazon SES para probar una entregacorrecta, rebote, reclamación, OOTO o lo que ocurre cuando una dirección está en la lista desupresión. Para obtener más información, consulte Probar el envío de correo electrónico enAmazon SES (p. 173).

14

Amazon Simple Email Service Developer GuideFormato de correo electrónico y Amazon SES

Formato de correo electrónico y Amazon SESCuando un cliente realiza una solicitud a Amazon SES, Amazon SES construye un mensaje de correoelectrónico que cumple la especificación de formato de mensajes de Internet (RFC 5322). Un correoelectrónico se compone de un encabezado, un cuerpo y un sobre, tal y como se describe a continuación.

• Encabezado: contiene instrucciones de enrutamiento e información sobre el mensaje. Algunos ejemplosson la dirección del remitente, la dirección del destinatario, el asunto y la fecha. El encabezado esanálogo a la información de la parte superior de una carta postal, aunque puede contener muchos otrostipos de información, como el formato del mensaje.

• Cuerpo: contiene el texto del propio mensaje.• Sobre: contiene la información de enrutamiento real que se comunica entre el cliente de correo

electrónico y el servidor de correo durante la sesión SMTP. Esta información de sobre de correoelectrónico es análoga a la información en un sobre postal. La información de enrutamiento del sobre decorreo electrónico suele ser la misma que la información de enrutamiento en el encabezado de correoelectrónico, pero no siempre. Por ejemplo, cuando se envía una copia oculta (CCO), la dirección dedestinatario real (tomada del sobre) no es la misma que la dirección de destinatario ("Para") que semuestra en el cliente de correo electrónico del destinatario, que se toma del encabezado.

A continuación se muestra un ejemplo sencillo de un correo electrónico. El encabezado va seguido deuna línea en blanco y, a continuación, del cuerpo del correo electrónico. El sobre no se muestra, ya quese comunica entre el cliente y el servidor de correo durante la sesión de SMTP, en lugar de una parte delpropio correo electrónico.

Received: from abc.smtp-out.amazonses.com (123.45.67.89) by in.example.com (87.65.43.210); Fri, 17 Dec 2010 14:26:22From: "Andrew" <[email protected]>;To: "Bob" <[email protected]>Date: Fri, 17 Dec 2010 14:26:21 -0800Subject: HelloMessage-ID: <[email protected]>Accept-Language: en-USContent-Language: en-USContent-Type: text/plain; charset="us-ascii"Content-Transfer-Encoding: quoted-printableMIME-Version: 1.0

Hello, I hope you are having a good day.

-Andrew

En las secciones siguientes se revisan los encabezados y los cuerpos de correo electrónico y se identificala información que tiene que proporcionar cuando utilice Amazon SES.

Encabezado de correo electrónicoHay un encabezado por mensaje de correo electrónico. Cada línea del encabezado contiene un camposeguido de dos puntos seguidos del cuerpo de campo. Al leer un correo electrónico en un cliente de correoelectrónico, el cliente de correo electrónico normalmente muestra los valores de los siguientes campos deencabezado:

• To: las direcciones de correo electrónico de los destinatarios del mensaje.• CC: las direcciones de correo electrónico de los destinatarios de copia del mensaje.• From: la dirección de correo electrónico desde la que se envía el correo electrónico.

15

https://www.ietf.org/rfc/rfc5322.txt


• Subject: un resumen del tema del mensaje.• Date: la hora y la fecha en la que se envía el correo electrónico.

Existen muchos campos de encabezado adicionales que proporcionan información de enrutamiento ydescriben el contenido del mensaje. Los clientes de correo electrónico habituales no suelen mostrar estoscampos al usuario. Para obtener una lista completa de los campos de encabezado que acepta AmazonSES, consulte Apéndice: campos de encabezado (p. 502). Cuando utiliza Amazon SES, necesitaespecialmente conocer la diferencia entre los campos de encabezado "From", "Reply-To" y "Return-Path".Como se ha indicado anteriormente, la dirección de remitente ("From") es la dirección de correo electrónicodel remitente del correo electrónico, mientras que "Reply-To" y "Return-Path" son lo siguiente:

• Reply-To: la dirección de correo electrónico a la que se enviarán las respuestas. De formapredeterminada, las respuestas se envían a la dirección de correo electrónico del remitente original.

• Return-Path: la dirección de correo electrónico a la que se deben enviar los rebotes y reclamaciones."Return-Path" se denomina en ocasiones "envelope from", "envelope sender" o "MAIL FROM".

Note

Cuando utiliza Amazon SES, le recomendamos que defina siempre el parámetro "Return-Path"para que pueda estar al tanto de los rebotes y tomar medidas correctivas si se producen.

Para asignar con facilidad un mensaje rebotado a su destinatario deseado, puede usar la ruta variablede retorno de sobres (VERP). Con VERP, se define una "Return-Path" distinta para cada destinatario, demodo que si el mensaje rebota, se sabe automáticamente qué destinatario lo ha rebotado, en lugar detener que abrir el mensaje de rebote y analizarlo.

Cuerpo del correo electrónicoEl cuerpo del correo electrónico contiene el texto del mensaje. El cuerpo se puede enviar en los siguientesformatos:

• HTML: si el cliente de correo electrónico del destinatario puede interpretar HTML, el cuerpo puede incluirtexto con formato y enlaces de hipertexto.

• Texto sin formato: si el cliente de correo electrónico del destinatario es de texto, el cuerpo no debecontener caracteres no imprimibles.

• Tanto HTML como texto sin formato: cuando utiliza ambos formatos para enviar el mismo contenido enun único mensaje, el cliente de correo electrónico del destinatario decide qué mostrar, en función de suscapacidades.

Si envía un mensaje de correo electrónico a un gran número de destinatarios, es razonable enviarlo tantoen HTML como en texto. Algunos destinatarios tendrán clientes de correo electrónico compatibles conHTML, de forma que puedan hacer clic en los enlaces incorporados en el mensaje. Los destinatarios queutilizan clientes de correo electrónico de texto tendrán que incluir direcciones URL que puedan copiar yabrir mediante un navegador web.

Información de correo electrónico que tiene que proporcionar aAmazon SESCuando envíe un correo electrónico con Amazon SES, la información de correo electrónico que debeproporcionar depende de cómo llame a Amazon SES. Puede proporcionar un nivel mínimo de informacióny hacer que Amazon SES se ocupe de todo el formato. O, si desea hacer algo más avanzado, como enviarun archivo adjunto, puede proporcionar el mensaje sin procesar usted mismo. En las secciones siguientesse revisa qué tiene que proporcionar cuando envíe un correo electrónico a través del API de Amazon SES,la interfaz SMTP de Amazon SES o la consola de Amazon SES.

16


API de Amazon SES

Si llama al API de Amazon SES directamente, llame al API SendEmail o bien a SendRawEmail. Lacantidad de información que tiene que proporcionar depende de que se llama al API.

• SendEmail API requiere que el usuario proporcione únicamente una dirección de origen, una direcciónde destino, un asunto del mensaje y un cuerpo del mensaje. Si lo desea, puede proporcionar lasdirecciones "Reply-To". Cuando llama a este API, Amazon SES crea automáticamente un mensaje decorreo electrónico Multipurpose Internet Mail Extensions (MIME) con formato multiparte optimizado parasu visualización en el software de cliente de correo electrónico. Para obtener más información, consulteEnvío de correo electrónico con formato utilizando el API de Amazon SES (p. 107).

• El API SendRawEmail le ofrece la flexibilidad para dar formato y enviar sus propios correos electrónicossin procesar mediante la especificación de los encabezados, las partes de MIME y los tipos decontenido. SendRawEmail suelen utilizarlo los usuarios avanzados. Tiene que proporcionar elcuerpo del mensaje y todos los campos de encabezado que se especifican como obligatorios en laespecificación de formato de mensajes de Internet (RFC 5322). Para obtener más información, consulteEnvío de correo electrónico sin procesar mediante el API de Amazon SES (p. 108).

Si utiliza un SDK de AWS para llamar al API de Amazon SES, proporciona esta información indicada másarriba a las funciones correspondiente (por ejemplo, SendEmail y SendRawEmail para Java).

Para obtener más información acerca del envío de correo electrónico utilizando el API de Amazon SES,consulte Uso del API de Amazon SES para enviar correo electrónico (p. 107).

Interfaz de SMTP de Amazon SES

Cuando acceda a Amazon SES a través de la interfaz de SMTP, su aplicación cliente de SMTP monta elmensaje, por lo que la información que necesita proporcionar depende de la aplicación que esté utilizando.Como mínimo, el intercambio SMTP entre un cliente y un servidor requiere una dirección de origen, unadirección de destino y datos de mensaje. Si utiliza la interfaz de SMTP y tiene habilitado el reenvío deretroalimentación, las notificaciones de rebotes, reclamaciones y entrega se envían a la dirección "MAILFROM". No se utiliza ninguna dirección "Reply-To" que especifique.

Para obtener más información acerca del envío de correo electrónico utilizando la interfaz SMTPde Amazon SES, consulte Uso de la interfaz de SMTP de Amazon SES para enviar correoelectrónico (p. 74).

Consola de Amazon SES

Cuando envíe un correo electrónico a través de la consola de Amazon SES, la cantidad de información quetiene que proporcionar depende de si opta por enviar un correo electrónico con o sin formato.

• Para enviar un correo electrónico con formato, tiene que proporcionar una dirección de origen,una dirección de destino, un asunto del mensaje y un cuerpo del mensaje. Amazon SES creaautomáticamente un mensaje de correo electrónico con formato MIME en varias partes optimizado parasu visualización en software de cliente de correo electrónico. También puede especificar un campoReply-To y Return-Path.

• Para enviar un mensaje de correo electrónico sin procesar, proporcione la dirección de origen, unadirección de destino y el contenido del mensaje, que debe contener el cuerpo del mensaje y todoslos campos de encabezado que se especifican como obligatorios en la especificación de formato demensajes de Internet (RFC 5322).

17



Amazon Simple Email Service Developer GuideIntroducción

Introducción al envío de correo electrónico conAmazon SES

Este tutorial de introducción ofrece instrucciones paso a paso para configurar Amazon Simple EmailService (Amazon SES) y enviar un correo electrónico. En primer lugar, revise la información en Antesde comenzar con Amazon SES (p. 18). A continuación, envíe un correo electrónico de una de lassiguientes maneras. También puede ver nuestro vídeo Getting Started with Amazon SES.

Para obtener más información sobre precios de correo electrónico de Amazon SES, consulte la páginaPricing de Amazon SES.

Uso de la consola de Amazon SESUtilice este método si desea empezar a enviar correos electrónicos de prueba a través de AmazonSES con una configuración mínima. Cuando esté listo para empezar la campaña de envío de correoelectrónico de producción, utilice uno de los otros métodos de envío y utilice la consola de Amazon SESprincipalmente para monitorear su actividad de envío.

Para comenzar este tutorial, acceda a Enviar un correo electrónico a través de la consola de AmazonSES (p. 19).

Uso del Simple Mail Transfer Protocol (SMTP)Utilice este método si desea enviar correo electrónico a través de la interfaz de SMTP de Amazon SES cono sin programación del siguiente modo:

• Habilite una aplicación para enviar correo electrónico a través de Amazon SES mediante la utilizaciónde un lenguaje de programación que admita SMTP. Los ejemplos se ofrecen en C#, Java y PHP. Paracomenzar este tutorial, acceda a Enviar un correo electrónico accediendo a la interfaz de SMTP deAmazon SES mediante programación (p. 21).

• Configure su servidor de correo electrónico para reenviar correo electrónico a Amazon SES o configuresu cliente de correo electrónico o paquete de software habilitado para SMTP para enviar correoelectrónico a través de Amazon SES. Se ofrecen ejemplos para los servidores de correo electrónico dePostfix, Sendmail y Exim, así como el cliente de correo electrónico Microsoft Outlook y el software deseguimiento de problemas Jira. Para comenzar este tutorial, acceda a Configuración de su servidor decorreo electrónico existente o aplicación habilitada para SMTP para enviar correo electrónico a través deAmazon SES (p. 30).

Para información de introducción a ambos métodos de envío de SMTP, consulte Enviar un correoelectrónico a través de Amazon SES mediante SMTP (p. 20).

Uso de un SDK de AWSUtilice este método para llamar al API de Amazon SES utilizando bibliotecas que gestionan los detallesde la interfaz de consulta de Amazon SES subyacente. Los ejemplos se ofrecen en C#, Java, PHP, Rubyy Python. Para comenzar este tutorial, acceda a Enviar un correo electrónico a través de Amazon SESmediante un SDK de AWS (p. 30).

Antes de comenzar con Amazon SESAntes de empezar, tiene que configurar Amazon SES. Tanto si envía un correo electrónico a través de laconsola de Amazon SES, la interfaz de SMTP o el API de Amazon SES, tiene que:

18

https://www.youtube.com/watch?v=EKnK54TAKWg

https://aws.amazon.com/ses/#pricing

Amazon Simple Email Service Developer GuideEnviar un correo electrónico a través de la consola

• Inscribirse en AWS: antes de poder usar Amazon SES u otros servicios de AWS, debe crear una cuentade AWS. Para obtener información, consulte Inscripción en AWS (p. 46).

• Verificar su dirección de correo electrónico o su dominio: para enviar correos electrónicos utilizandoAmazon SES, siempre tiene que verificar su dirección de remitente ("From") para mostrar que lepertenece. Si está en el entorno de pruebas, también tiene que verificar sus direcciones de destinatario("To"). Puede verificar las direcciones de correo electrónico o dominios completos. Para obtenerinformación, consulte Verificación de identidades en Amazon SES (p. 47).

Esta lista contiene las tareas de configuración que son obligatorias para todos los métodos de envío decorreo electrónico. Las tareas de configuración adicionales que son específicas del método de envíode correo electrónico se proporcionan en la sección de introducción correspondiente. Para ver una listacompleta de todas las tareas de configuración, consulte Configuración de correo electrónico con AmazonSES (p. 45).

Enviar un correo electrónico a través de la consola deAmazon SESLa forma más sencilla de enviar un correo electrónico con Amazon SES consiste en utilizar la consola deAmazon SES. Dado que la consola requiere que introduzca manualmente información, normalmente solola utiliza para enviar correos electrónicos de prueba. Después de comenzar a utilizar Amazon SES, lo másprobable es que envíe los correos electrónicos a través del API o de la interfaz SMTP de Amazon SES,pero la consola resulta útil para la monitorización de la actividad de envío.

Important

En este tutorial de introducción, envíese un correo electrónico a usted mismo para podercomprobar si lo recibe. Para más experimentación o pruebas de carga, utilice el simulador debandeja de correo de Amazon SES. Los correos electrónicos que envíe al simulador de bandejade correo no se contabilizan en su cuota de envío ni en sus tasas de rebotes y reclamaciones.Para obtener más información, consulte Probar el envío de correo electrónico en AmazonSES (p. 173).

Antes de seguir estos pasos, asegúrese de revisar las instrucciones de configuración en Antes decomenzar con Amazon SES (p. 18).

Para enviar un mensaje de correo electrónico desde la consola de Amazon SES

1. Inicie sesión en Consola de administración de AWS y abra la consola de Amazon SES en https://console.aws.amazon.com/ses/.

Note

Si no ha iniciado sesión actualmente en su cuenta de AWS, este enlace le llevará a unapágina de inicio de sesión. Después de iniciar sesión, se dirigirá a la consola de AmazonSES.

2. En el panel de navegación del lado izquierdo de la consola, de Amazon SES en Identity Management,elija Email Addresses para ver la dirección de correo electrónico que verificó en Verificación dedirecciones de correo electrónico en Amazon SES. (p. 47).

3. En la lista de identidades, marque la casilla junto a la dirección de correo electrónico que ha verificado.4. Elija Send a Test Email.5. Para Send Test Email, elija el Email Format. Las dos opciones son las siguientes:

• Formatted: se trata de la opción más sencilla. Seleccione esta opción si solo desea escribir el textode su mensaje en el cuadro de texto Body. Al enviar el correo electrónico, Amazon SES coloca eltexto en formato de correo electrónico para usted.

19

https://console.aws.amazon.com/ses/


Amazon Simple Email Service Developer GuideEnviar un correo electrónico mediante SMTP

• Raw: seleccione esta opción si desea enviar un mensaje más complejo, como, por ejemplo, unmensaje que incluya HTML o un archivo adjunto. Debido a esta flexibilidad, tiene que formatearel mensaje, tal y como se describe en Envío de correo electrónico sin procesar mediante el APIde Amazon SES (p. 108), por sí mismo y, a continuación, pegar todo el mensaje con formato,incluidos los encabezados, en el cuadro de texto Body. Puede utilizar el siguiente ejemplo, quecontiene HTML, para enviar un correo electrónico de prueba utilizando el formato de correoelectrónico Raw. Copie y pegue este mensaje en su totalidad en el cuadro de texto Body. Asegúresede que no haya ninguna línea en blanco entre el encabezado MIME-Version y el encabezadoContent-Type; una línea en blanco entre estas dos líneas hace que el correo electrónico tengaformato de texto sin formato en lugar de HTML.

Subject: Amazon SES Raw Email TestMIME-Version: 1.0Content-Type: text/html <!DOCTYPE html><html><body><h1>This text should be large, because it is formatted as a header in HTML.</h1><p>Here is a formatted link: <a href="https://docs.aws.amazon.com/ses/latest/DeveloperGuide/Welcome.html">Guía para desarrolladores de Amazon Simple Email Service</a>.</p></body></html>

6. En Send Test Email, rellene el resto de los campos. Si sigue estando en el entorno de pruebas deAmazon SES, asegúrese de que la dirección en el campo To es una dirección de correo electrónicoverificada. Para obtener más información, consulte Verificación de direcciones de correo electrónicoen Amazon SES. (p. 47).

7. Elija Send Test Email.8. Inicie sesión en el cliente de correo electrónico de la dirección a la que ha enviado el correo

electrónico. Encontrará el mensaje que ha enviado.

Enviar un correo electrónico a través de Amazon SESmediante SMTPPara enviar un correo electrónico a través de la interfaz de SMTP de Amazon SES, puede utilizar unlenguaje de programación, servidor de correo electrónico, o aplicación habilitado para SMTP. Antes deempezar, revise las instrucciones en Antes de comenzar con Amazon SES (p. 18). También tiene queobtener la siguiente información adicional:

• Su nombre de usuario y contraseña de SMTP de Amazon SES, que le permitirá conectarse al puntode enlace de SMTP de Amazon SES. Para obtener su nombre de usuario y contraseña de SMTP deAmazon SES, consulte Obtener sus credenciales de SMTP de Amazon SES (p. 75).

Important

Sus credenciales de SMTP son distintas de las credenciales de AWS. Para obtenermás información acerca de las credenciales, consulte Uso de credenciales con AmazonSES (p. 393).

• El nombre de host de SMTP de Amazon SES, que es email-smtp.us-east-1.amazonaws.com (para laregión us-east-1), email-smtp.us-west-2.amazonaws.com (para la región us-west-2) o email-smtp.eu-west-1.amazonaws.com (para la región eu-west-1).

• El número de puerto de la interfaz de SMTP de Amazon SES, que depende del método de conexión.Para obtener más información, consulte Conexión al punto de enlace de SMTP de AmazonSES (p. 80).

20


Después de recibir sus credenciales de SMTP, puede conectarse al punto de enlace de SMTP de AmazonSES y enviar correo electrónico. Este tutorial de introducción le muestra cómo enviar correo electrónico através de la interfaz de SMTP de Amazon SES a través de los siguientes métodos:

• Enviar un correo electrónico accediendo a la interfaz de SMTP de Amazon SES medianteprogramación (p. 21)

• Configuración de su servidor de correo electrónico existente o aplicación habilitada para SMTP paraenviar correo electrónico a través de Amazon SES (p. 30)

Para obtener más información sobre la interfaz SMTP de Amazon SES, consulte Uso de la interfaz deSMTP de Amazon SES para enviar correo electrónico (p. 74).

Enviar un correo electrónico accediendo a la interfaz de SMTP deAmazon SES mediante programaciónPuede acceder a la interfaz de SMTP de Amazon SES utilizando un lenguaje de programación habilitadopara SMTP. Usted proporciona el nombre de host y el número de puerto de SMTP de Amazon SES juntocon sus credenciales de SMTP y, a continuación, utiliza las funciones de SMTP genéricas del lenguaje deprogramación para enviar el correo electrónico.

Temas de esta sección:• Enviar un correo electrónico utilizando SMTP con C# (p. 21)• Enviar un correo electrónico utilizando SMTP con Java (p. 24)• Enviar un correo electrónico utilizando SMTP con PHP (p. 27)

Enviar un correo electrónico utilizando SMTP con C#

El siguiente procedimiento muestra cómo utilizar Microsoft Visual Studio para crear una aplicación deconsola de C# que envía un correo electrónico a través de Amazon SES. Los procedimientos de estasección se aplican a Visual Studio 2017, pero el proceso de creación de aplicaciones de la consola de C#es similar en todas las ediciones de Microsoft Visual Studio.

Antes de realizar el procedimiento siguiente, complete las tareas de configuración descritas en Antes decomenzar con Amazon SES (p. 18) y Enviar un correo electrónico a través de Amazon SES medianteSMTP (p. 20).

Important

En este tutorial de introducción, envíese un correo electrónico a usted mismo para podercomprobar si lo recibe. Para seguir experimentando o realizar pruebas de carga, utilice elsimulador de bandeja de correo de Amazon SES. Los correos electrónicos que envíe al simuladorde bandeja de correo no se contabilizan en su cuota de envío ni en sus tasas de rebotes yreclamaciones. Para obtener más información, consulte Probar el envío de correo electrónico enAmazon SES (p. 173).

Para enviar un correo electrónico utilizando la interfaz de SMTP de Amazon SES con C#

1. Cree un proyecto de consola en Visual Studio realizando los pasos siguientes:

a. Abra Microsoft Visual Studio.b. En el menú File, elija New, Project.c. En la ventana New Project, en el panel izquierdo, expanda Installed, expanda Templates y, a

continuación, expanda Visual C#.d. En Visual C#, elija Windows Classic Desktop.

21

https://www.visualstudio.com/


e. En el menú de la parte superior de la ventana, elija .NET Framework 4.5, tal y como se muestraen la siguiente imagen.

Note

Puede seleccionar una versión posterior de .NET Framework si es necesario.f. Elija Console App (.NET Framework).g. En el campo Name, escriba AmazonSESSample.h. Seleccione Aceptar.

2. En su proyecto de Visual Studio, reemplace todo el contenido de Program.cs por el siguiente código:

using System;using System.Net;using System.Net.Mail;

namespace AmazonSESSample{ class Program { static void Main(string[] args) { // Replace [email protected] with your "From" address. // This address must be verified with Amazon SES. const String FROM = "[email protected]"; const String FROMNAME = "Sender Name";

// Replace [email protected] with a "To" address. If your account // is still in the sandbox, this address must be verified. const String TO = "[email protected]";

// Replace smtp_username with your Amazon SES SMTP user name. const String SMTP_USERNAME = "smtp_username";

// Replace smtp_password with your Amazon SES SMTP user name. const String SMTP_PASSWORD = "smtp_password";

// (Optional) the name of a configuration set to use for this message. // If you comment out this line, you also need to remove or comment out // the "X-SES-CONFIGURATION-SET" header below. const String CONFIGSET = "ConfigSet";

// If you're using Amazon SES in a region other than US West (Oregon), // replace email-smtp.us-west-2.amazonaws.com with the Amazon SES SMTP // endpoint in the appropriate Region. const String HOST = "email-smtp.us-west-2.amazonaws.com"; // The port you will connect to on the Amazon SES SMTP endpoint. We // are choosing port 587 because we will use STARTTLS to encrypt // the connection. const int PORT = 587;

22


// The subject line of the email const String SUBJECT = "Amazon SES test (SMTP interface accessed using C#)"; // The body of the email const String BODY = "<h1>Amazon SES Test</h1>" + "<p>This email was sent through the "+ "<a href='https://aws.amazon.com/ses'>Amazon SES</a> SMTP interface " + "using the .NET System.Net.Mail library.</p>";

// Create and build a new MailMessage object MailMessage message = new MailMessage(); message.IsBodyHtml = true; message.From = new MailAddress(FROM,FROMNAME); message.To.Add(new MailAddress(TO)); message.Subject = SUBJECT; message.Body = BODY; // Comment or delete the next line if you are not using a configuration set message.Headers.Add("X-SES-CONFIGURATION-SET", CONFIGSET);

// Create and configure a new SmtpClient SmtpClient client = new SmtpClient(HOST, PORT); // Pass SMTP credentials client.Credentials = new NetworkCredential(SMTP_USERNAME, SMTP_PASSWORD); // Enable SSL encryption client.EnableSsl = true;

// Send the email. try { Console.WriteLine("Attempting to send email..."); client.Send(message); Console.WriteLine("Email sent!"); } catch (Exception ex) { Console.WriteLine("The email was not sent."); Console.WriteLine("Error message: " + ex.Message); }

// Wait for a key press so that you can see the console output Console.Write("Press any key to continue..."); Console.ReadKey(); } }}

3. En Program.cs, reemplace las siguientes direcciones de correo electrónico por sus propios valores:

Important

Las direcciones de correo electrónico distinguen entre mayúsculas y minúsculas. Asegúresede que las direcciones sean exactamente las mismas que las que haya verificado.

• [email protected]: reemplácelo por su dirección de correo electrónico de remitente ("From").Debe verificar esta dirección antes de ejecutar este programa. Para obtener más información,consulte Verificación de identidades en Amazon SES (p. 47).

• [email protected]: reemplácelo por su dirección de correo electrónico de remitente ("To").Si su cuenta está todavía en el entorno de pruebas, debe verificar esta dirección antes de utilizarla.Para obtener más información, consulte Salir del entorno de pruebas de Amazon SES (p. 72).

23


4. En Program.cs, reemplace las siguientes credenciales de SMTP por los valores que ha obtenido enObtener sus credenciales de SMTP de Amazon SES (p. 75):

Important


• YOUR_SMTP_USERNAME: reemplácelo por su nombre de usuario de SMTP. Tenga en cuenta quela credencial de nombre de usuario de SMTP es una cadena de 20 letras y números, no un nombreinteligible.

• YOUR_SMTP_PASSWORD: reemplácela por su contraseña SMTP.5. (Opcional) si desea utilizar un punto de enlace SMTP de Amazon SES en una región distinta de

EE.UU. Oeste (Oregón), cambie el valor de la variable HOST por el punto de enlace que deseautilizar. Para obtener una lista de puntos de enlace de Amazon SES, consulte Regiones y AmazonSES (p. 439).

6. Guarde Program.cs.7. Para crear el proyecto, elija Build y, a continuación, elija Build Solution.8. Para ejecutar el programa, elija Debug y, a continuación, elija Start Debugging.9. Revise la salida. Si el correo electrónico se ha enviado correctamente, la consola muestra "Email

sent!". De lo contrario, muestra un mensaje de error.10. Inicie sesión en el cliente de correo electrónico de la dirección del destinatario. Encontrará el mensaje

que ha enviado.

Enviar un correo electrónico utilizando SMTP con Java

Este ejemplo utiliza Eclipse IDE y el API JavaMail para enviar correo electrónico a través de Amazon SESutilizando la interfaz de SMTP.

Antes de realizar el procedimiento siguiente, complete las tareas de configuración descritas en Antes decomenzar con Amazon SES (p. 18) y Enviar un correo electrónico a través de Amazon SES medianteSMTP (p. 20).

Important


Para enviar un correo electrónico utilizando la interfaz de SMTP de Amazon SES con Java

1. En un navegador web, vaya a la página de JavaMail de Github. En Downloads, elija javax.mail.jar paradescargar la última versión de JavaMail.

Important

Este tutorial requiere JavaMail versión 1.5 o posterior. Estos procedimientos se han probadoutilizando JavaMail versión 1.6.1.

2. Cree un proyecto en Eclipse realizando los pasos siguientes:

a. Inicie Eclipse.

24

http://www.eclipse.org/

https://github.com/javaee/javamail/releases



b. En Eclipse, elija File, elija New y, a continuación, elija Java Project.c. En el cuadro de diálogo Create a Java Project, escriba un nombre de proyecto y, a continuación,

elija Next.d. En el cuadro de diálogo Java Settings, elija la pestaña Libraries.e. Elija Add External JARs.f. Busque la carpeta en la que ha descargado JavaMail. Elija el archivo javax.mail.jar y, a

continuación, elija Open.g. En el cuadro de diálogo Java Settings, elija Finish.

3. En Eclipse, en la ventana Package Explorer, amplíe su proyecto.4. En su proyecto, haga clic con el botón derecho en el directorio src, elija New y, a continuación, elija

Class.5. En el cuadro de diálogo New Java Class, en el campo Name, escriba AmazonSESSample y, a

continuación, elija Finish.6. Reemplace todo el contenido de AmazonSESSample.java por el siguiente código:

import java.util.Properties;

import javax.mail.Message;import javax.mail.Session;import javax.mail.Transport;import javax.mail.internet.InternetAddress;import javax.mail.internet.MimeMessage;

public class AmazonSESSample {

// Replace [email protected] with your "From" address. // This address must be verified. static final String FROM = "[email protected]"; static final String FROMNAME = "Sender Name"; // Replace [email protected] with a "To" address. If your account // is still in the sandbox, this address must be verified. static final String TO = "[email protected]"; // Replace smtp_username with your Amazon SES SMTP user name. static final String SMTP_USERNAME = "smtp_username"; // Replace smtp_password with your Amazon SES SMTP password. static final String SMTP_PASSWORD = "smtp_password"; // The name of the Configuration Set to use for this message. // If you comment out or remove this variable, you will also need to // comment out or remove the header below. static final String CONFIGSET = "ConfigSet"; // Amazon SES SMTP host name. This example uses the US West (Oregon) region. // See https://docs.aws.amazon.com/ses/latest/DeveloperGuide/regions.html#region-endpoints // for more information. static final String HOST = "email-smtp.us-west-2.amazonaws.com"; // The port you will connect to on the Amazon SES SMTP endpoint. static final int PORT = 587; static final String SUBJECT = "Amazon SES test (SMTP interface accessed using Java)"; static final String BODY = String.join( System.getProperty("line.separator"), "<h1>Amazon SES SMTP Email Test</h1>",

25


"<p>This email was sent with Amazon SES using the ", "<a href='https://github.com/javaee/javamail'>Javamail Package</a>", " for <a href='https://www.java.com'>Java</a>." );

public static void main(String[] args) throws Exception {

// Create a Properties object to contain connection configuration information. Properties props = System.getProperties(); props.put("mail.transport.protocol", "smtp"); props.put("mail.smtp.port", PORT); props.put("mail.smtp.starttls.enable", "true"); props.put("mail.smtp.auth", "true");

// Create a Session object to represent a mail session with the specified properties. Session session = Session.getDefaultInstance(props);

// Create a message with the specified information. MimeMessage msg = new MimeMessage(session); msg.setFrom(new InternetAddress(FROM,FROMNAME)); msg.setRecipient(Message.RecipientType.TO, new InternetAddress(TO)); msg.setSubject(SUBJECT); msg.setContent(BODY,"text/html"); // Add a configuration set header. Comment or delete the // next line if you are not using a configuration set msg.setHeader("X-SES-CONFIGURATION-SET", CONFIGSET); // Create a transport. Transport transport = session.getTransport(); // Send the message. try { System.out.println("Sending..."); // Connect to Amazon SES using the SMTP username and password you specified above. transport.connect(HOST, SMTP_USERNAME, SMTP_PASSWORD); // Send the email. transport.sendMessage(msg, msg.getAllRecipients()); System.out.println("Email sent!"); } catch (Exception ex) { System.out.println("The email was not sent."); System.out.println("Error message: " + ex.getMessage()); } finally { // Close and terminate the connection. transport.close(); } }}

7. En AmazonSESSample.java, reemplace las siguientes direcciones de correo electrónico por suspropios valores:

Important


26




8. En AmazonSESSample.java, reemplace las siguientes credenciales de SMTP por los valores que haobtenido en Obtener sus credenciales de SMTP de Amazon SES (p. 75):

Important


• YOUR_SMTP_USERNAME: reemplácelo por su credencial de nombre de usuario de SMTP. Tenga encuenta que la credencial de nombre de usuario de SMTP es una cadena de 20 letras y números, noun nombre inteligible.

• YOUR_SMTP_PASSWORD: reemplácelo por su contraseña de SMTP.9. (Opcional): si desea utilizar un punto de enlace SMTP de Amazon SES en una región distinta de

EE.UU. Oeste (Oregón), cambie el valor de la variable HOST por el punto de enlace que deseautilizar. Para obtener una lista de puntos de enlace de Amazon SES, consulte Regiones y AmazonSES (p. 439).

10. Guarde AmazonSESSample.java.11. Para crear el proyecto, elija Project y, a continuación, elija Build Project. (Si esta opción está

deshabilitada, entonces es posible que tenga habilitada la creación automática).12. Para iniciar el programa y enviar el correo electrónico, elija Run y, a continuación, vuelva a elegir Run.13. Revise la salida. Si el correo electrónico se ha enviado correctamente, la consola muestra "Email


que ha enviado.

Enviar un correo electrónico utilizando SMTP con PHP

Este ejemplo utiliza el paquete PHPMailer para enviar correo electrónico a través de Amazon SESutilizando la interfaz de SMTP.

Important

En este tutorial, envíese un correo electrónico a usted mismo para poder comprobar si lo recibe.Para seguir experimentando o realizar pruebas de carga, utilice el simulador de bandeja de correode Amazon SES. Los correos electrónicos que envíe al simulador de bandeja de correo no secontabilizan en su cuota de envío ni en sus tasas de rebotes y reclamaciones. Para obtener másinformación, consulte Probar el envío de correo electrónico en Amazon SES (p. 173).

Requisitos previos

Antes de empezar, lleva a cabo las tareas siguientes:

• Verifique su dirección de correo electrónico con Amazon SES: antes de poder enviar un correoelectrónico con Amazon SES, debe verificar que es propietario de la dirección de correo electrónicodel remitente. Si su cuenta está todavía en el entorno de pruebas Amazon SES, también tiene queverificar la dirección de correo electrónico del destinatario. La forma más sencilla de verificar direccionesde correo electrónico consiste en utilizar la consola de Amazon SES. Para obtener más información,consulte Verificación de direcciones de correo electrónico en Amazon SES. (p. 47).

27


• Consiga sus credenciales de SMTP: necesita un nombre de usuario y contraseña de SMTP de AmazonSES para acceder a la interfaz de SMTP de Amazon SES. Sus credenciales de SMTP no son lasmismas que las credenciales de AWS. Puede encontrar sus credenciales de SMTP accediendo a lapágina SMTP Settings de la consola de Amazon SES. Para obtener más información acerca de lascredenciales de SMTP, consulte Obtener sus credenciales de SMTP de Amazon SES (p. 75).

• Instale PHP: PHP está disponible en http://php.net/downloads.php. Después de instalar PHP, añadala ruta a PHP en sus variables de entorno para que pueda ejecutar PHP desde cualquier símbolo delsistema.

• Instale el administrador de dependencias Composer: el administrador de dependencias Composer lepermitirá descargar e instalar la clase PHPMailer y sus dependencias. Para instalar Composer, siga lasinstrucciones de instalación en https://getcomposer.org/download.

• Instale el paquete PHPMailer: una vez instalado Composer, abra el archivo composer.json en uneditor de texto. En la sección require, añada la línea siguiente: "phpmailer/phpmailer":"~5.2"y, a continuación, guarde el archivo. En la línea de comandos, cambie al directorio que contiene elarchivo composer.json y, a continuación, escriba php composer.phar update para descargar e instalarPHPMailer.

Procedimiento

El siguiente procedimiento muestra cómo enviar un correo electrónico a través de Amazon SES con PHP.

Para enviar un correo electrónico utilizando la interfaz de SMTP de Amazon SES con PHP

1. Cree un archivo denominado amazon-ses-smtp-sample.php. Abra el archivo con un editor detexto y pegue el código siguiente:

<?php

// Modify the path in the require statement below to refer to the // location of your Composer autoload.php file.require 'path_to_sdk_inclusion';

// Instantiate a new PHPMailer $mail = new PHPMailer;

// Tell PHPMailer to use SMTP$mail->isSMTP();

// Replace [email protected] with your "From" address. // This address must be verified with Amazon SES.$mail->setFrom('[email protected]', 'Sender Name');

// Replace [email protected] with a "To" address. If your account // is still in the sandbox, this address must be verified.// Also note that you can include several addAddress() lines to send// email to multiple recipients.$mail->addAddress('[email protected]', 'Recipient Name');

// Replace smtp_username with your Amazon SES SMTP user name.$mail->Username = 'smtp_username';

// Replace smtp_password with your Amazon SES SMTP password.$mail->Password = 'smtp_password'; // Specify a configuration set. If you do not want to use a configuration// set, comment or remove the next line.$mail->addCustomHeader('X-SES-CONFIGURATION-SET', 'ConfigSet'); // If you're using Amazon SES in a region other than US West (Oregon), // replace email-smtp.us-west-2.amazonaws.com with the Amazon SES SMTP

28

https://console.aws.amazon.com/ses/home?#smtp-settings:

https://php.net/downloads.php

https://getcomposer.org/download


// endpoint in the appropriate region.$mail->Host = 'email-smtp.us-west-2.amazonaws.com';

// The subject line of the email$mail->Subject = 'Amazon SES test (SMTP interface accessed using PHP)';

// The HTML-formatted body of the email$mail->Body = '<h1>Email Test</h1> <p>This email was sent through the <a href="https://aws.amazon.com/ses">Amazon SES</a> SMTP interface using the <a href="https://github.com/PHPMailer/PHPMailer"> PHPMailer</a> class.</p>';

// Tells PHPMailer to use SMTP authentication$mail->SMTPAuth = true;

// Enable TLS encryption over port 587$mail->SMTPSecure = 'tls';$mail->Port = 587;

// Tells PHPMailer to send HTML-formatted email$mail->isHTML(true);

// The alternative email body; this is only displayed when a recipient// opens the email in a non-HTML email client. The \r\n represents a // line break.$mail->AltBody = "Email Test\r\nThis email was sent through the Amazon SES SMTP interface using the PHPMailer class.";

if(!$mail->send()) { echo "Email not sent. " , $mail->ErrorInfo , PHP_EOL;} else { echo "Email sent!" , PHP_EOL;}?>

2. En amazon-ses-smtp-sample.php, reemplace lo siguiente por sus propios valores:

• [email protected]: reemplácelo por una dirección de correo electrónico que haya verificadocon Amazon SES. Para obtener más información, consulte Verificación de identidades (p. 47).Las direcciones de correo electrónico en Amazon SES distinguen entre mayúsculas y minúsculas.Asegúrese de que la dirección que introduce sea exactamente la misma que la que haya verificado.

• [email protected]: reemplácelo por la dirección del destinatario. Si su cuenta estátodavía en el entorno de pruebas, debe verificar esta dirección antes de utilizarla. Para obtener másinformación, consulte Salir del entorno de pruebas de Amazon SES (p. 72). Asegúrese de que ladirección que introduce sea exactamente la misma que la que haya verificado.

• smtp_username: reemplace por su credencial de nombre de usuario de SMTP, que obtuvo desdela página SMTP Settings de la consola de Amazon SES. Este no es el mismo que su ID de clave deacceso de AWS. Tenga en cuenta que la credencial de nombre de usuario de SMTP es una cadenade 20 letras y números, no un nombre inteligible.

• smtp_password: reemplace por su contraseña de SMTP, que obtuvo desde la página SMTPSettings de la consola de Amazon SES. Este no es el mismo que su clave de acceso secreta deAWS.

• (Opcional) email-smtp.us-west-2.amazonaws.com: si desea utilizar un punto de enlace deSMTP de Amazon SES en una región distinta de EE.UU. Oeste (Oregón), reemplace este valor porel punto de enlace de SMTP de Amazon SES en la región que desee utilizar. Para obtener una listade puntos de enlace de SMTP de Amazon SES, consulte Regiones y Amazon SES (p. 439).

3. Guarde amazon-ses-smtp-sample.php.4. Para ejecutar el programa, abra un símbolo del sistema en el mismo directorio como amazon-ses-

smtp-sample.php y, a continuación, escriba php amazon-ses-smtp-sample.php.

29




Amazon Simple Email Service Developer GuideEnviar un correo electrónico mediante un SDK de AWS

5. Revise la salida. Si el correo electrónico se ha enviado correctamente, la consola muestra "Emailsent!". De lo contrario, muestra un mensaje de error.

6. Inicie sesión en el cliente de correo electrónico de la dirección del destinatario. Encontrará el mensajeque ha enviado.

Configuración de su servidor de correo electrónico existente oaplicación habilitada para SMTP para enviar correo electrónico através de Amazon SESPuede configurar su servidor de correo, cliente de correo electrónico o paquete de software de envío decorreo electrónico para enviar mensajes a través de Amazon SES sin ningún tipo de programación.

En primer lugar, lea Enviar un correo electrónico a través de Amazon SES mediante SMTP (p. 20). Acontinuación, revise uno de los siguientes temas, que le muestra cómo configurar un servidor de correoelectrónico para reenviar correo electrónico a Amazon SES:

• Configuración de Postfix (p. 88)• Integración de Amazon SES con Sendmail (p. 91)• Integración de Amazon SES con Exim (p. 101)

Para obtener información sobre cómo configurar Microsoft Outlook, un cliente de correo electrónico,para enviar correo electrónico a través de Amazon SES, consulte Configuración de clientes de correoelectrónico para enviar a través de Amazon SES (p. 81).

Para obtener información sobre cómo configurar Jira, un paquete de software de seguimiento deproblemas a través de Amazon SES, consulte Envío de correo electrónico a través de Amazon SES desdepaquetes de software (p. 86).

Enviar un correo electrónico a través de Amazon SESmediante un SDK de AWSPara enviar un correo electrónico con el API de Amazon SES, puede utilizar la interfaz de consultasdirectamente o puede usar un SDK de AWS para gestionar los detalles de bajo nivel, como el montaje y elanálisis de respuestas y solicitudes HTTP.

Antes de enviar correo electrónico a través de un SDK de AWS, revise las instrucciones en Antes decomenzar con Amazon SES (p. 18). Para completar los tutoriales en este apartado también tendrá que:

• Descargar un SDK de AWS: descargue e instale un SDK de AWS. Para obtener más información,consulte Descarga de un SDK de AWS (p. 65).

• Conseguir sus credenciales de AWS: para acceder a Amazon SES mediante programación, necesita susclaves de acceso de AWS. Para obtener más información, consulte Obtener sus claves de acceso deAWS (p. 64).

• Crear un archivo de credenciales compartido: siga los procedimientos de Crear un archivo decredenciales compartidas (p. 31) para crear el archivo de credenciales compartidas.

Cuando haya completado los requisitos anteriores, consulte Enviar un correo electrónico a través deAmazon SES mediante programación utilizando un SDK de AWS (p. 31).

30


Crear un archivo de credenciales compartidasEl siguiente procedimiento muestra cómo crear un archivo de credenciales compartidas en su directorio deinicio. Para que el código de muestra de SDK funcione correctamente, debe crear este archivo.

1. En un editor de texto, cree un nuevo archivo. En el archivo, pegue el código siguiente:

[default]aws_access_key_id = YOUR_AWS_ACCESS_KEY_IDaws_secret_access_key = YOUR_AWS_SECRET_ACCESS_KEY

2. En el archivo de texto que acaba de crear, reemplace YOUR_AWS_ACCESS_KEY por su ID de clave deacceso de AWS y reemplace YOUR_AWS_SECRET_ACCESS_KEY por su clave de acceso secreta deAWS única.

3. Guarde el archivo. En la siguiente tabla se muestra la ubicación correcta y el nombre de archivo de susistema operativo.

Si utiliza... Guarde el archivo como...

Windows C:\Users\<suNombreDeUsuario>\.aws\credentials

Linux, macOS o Unix ~/.aws/credentials

Note

No incluya una extensión de archivo cuando guarde el archivo de credenciales.

Enviar un correo electrónico a través de Amazon SES medianteprogramación utilizando un SDK de AWSPuede utilizar un SDK de AWS para enviar correo electrónico a través de Amazon SES. Los SDK deAWS están disponibles para diversos lenguajes de programación; para obtener más información, consulteHerramientas para Amazon Web Services.

Note

Si aún no lo ha hecho, complete los requisitos enumerados en Enviar un correo electrónico através de Amazon SES mediante un SDK de AWS (p. 30) antes de intentar completar lostutoriales de esta sección.

Temas de esta sección:• Enviar un correo electrónico utilizando AWS SDK para .NET (p. 31)• Enviar un correo electrónico utilizando AWS SDK for Java (p. 35)• Enviar un correo electrónico utilizando AWS SDK para PHP (p. 38)• Enviar un correo electrónico utilizando AWS SDK parar Ruby (p. 40)• Enviar un correo electrónico utilizando el AWS SDK for Python (Boto) (p. 43)

Enviar un correo electrónico utilizando AWS SDK para .NETEl siguiente procedimiento muestra cómo enviar un correo electrónico a través de Amazon SES utilizandoVisual Studio y el AWS SDK para .NET.

Esta solución se ha probado utilizando los siguientes componentes:

31

https://aws.amazon.com/tools/#sdk



• Microsoft Visual Studio Community 2017, versión 15.4.0.• Microsoft .NET Framework versión 4.6.1.• El paquete AWSSDK.Core (versión 3.3.19), instalado utilizando NuGet.• El paquete AWSSDK.SimpleEmail (versión 3.3.6.1), instalado utilizando NuGet.

Note


Requisitos previos



• Obtenga sus credenciales de AWS: necesita un ID de clave de acceso y una clave de acceso secretade AWS para acceder a Amazon SES utilizando un SDK. Puede encontrar sus credenciales utilizandola página Security Credentials de la Consola de administración de AWS. Para obtener más informaciónacerca de las credenciales, consulte Uso de credenciales con Amazon SES (p. 393).

• Instale Visual Studio: Visual Studio está disponible en https://www.visualstudio.com/.• Cree un archivo de credenciales compartidas: para que el código de muestra de esta sección funcione

correctamente, debe crear un archivo de credenciales compartidas. Para obtener más información,consulte Crear un archivo de credenciales compartidas (p. 31).

Procedimiento

El siguiente procedimiento muestra cómo enviar un correo electrónico a través de Amazon SES utilizandoel AWS SDK para .NET.

Para enviar un correo electrónico utilizando AWS SDK para .NET

1. Cree un proyecto nuevo realizando los pasos siguientes:

a. Inicie Visual Studio.b. En el menú File, elija New, Project.c. En la ventana New Project, en el panel de la izquierda, expanda Installed y, a continuación,

expanda Visual C#.d. En el panel de la derecha, seleccione Console App (.NET Framework).e. En Name, escriba AmazonSESSample y después elija OK.

2. Utilice NuGet para incluir los paquetes de Amazon SES en su solución completando los pasossiguientes:

a. En el panel Solution Explorer, haga clic con el botón derecho en el proyecto y, a continuación,elija Manage NuGet Packages.

b. En la pestaña NuGet: AmazonSESSample, elija Browse.

32

https://console.aws.amazon.com/iam/home?#security_credential



c. En el cuadro de búsqueda, escriba AWSSDK.SimpleEmail.d. Elija el paquete AWSSDK.SimpleEmail y después elija Install.e. En la ventana Preview Changes, elija OK.

3. En la pestaña Program.cs, pegue el código siguiente:

using Amazon;using System;using System.Collections.Generic;using Amazon.SimpleEmail;using Amazon.SimpleEmail.Model;

namespace AmazonSESSample { class Program { // Replace [email protected] with your "From" address. // This address must be verified with Amazon SES. static readonly string senderAddress = "[email protected]";

// Replace [email protected] with a "To" address. If your account // is still in the sandbox, this address must be verified. static readonly string receiverAddress = "[email protected]";

// The configuration set to use for this email. If you do not want to use a // configuration set, comment out the following property and the // ConfigurationSetName = configSet argument below. static readonly string configSet = "ConfigSet";

// The subject line for the email. static readonly string subject = "Amazon SES test (AWS SDK for .NET)";

// The email body for recipients with non-HTML email clients. static readonly string textBody = "Amazon SES Test (.NET)\r\n" + "This email was sent through Amazon SES " + "using the AWS SDK for .NET."; // The HTML body of the email. static readonly string htmlBody = @"<html><head></head><body> <h1>Amazon SES Test (AWS SDK for .NET)</h1> <p>This email was sent with <a href='https://aws.amazon.com/ses/'>Amazon SES</a> using the <a href='https://aws.amazon.com/sdk-for-net/'> AWS SDK for .NET</a>.</p></body></html>";

static void Main(string[] args) { // Replace USWest2 with the AWS Region you're using for Amazon SES. // Acceptable values are EUWest1, USEast1, and USWest2. using (var client = new AmazonSimpleEmailServiceClient(RegionEndpoint.USWest2)) { var sendRequest = new SendEmailRequest { Source = senderAddress, Destination = new Destination { ToAddresses = new List<string> { receiverAddress } },

33


Message = new Message { Subject = new Content(subject), Body = new Body { Html = new Content { Charset = "UTF-8", Data = htmlBody }, Text = new Content { Charset = "UTF-8", Data = textBody } } }, // If you are not using a configuration set, comment // or remove the following line ConfigurationSetName = configSet }; try { Console.WriteLine("Sending email using Amazon SES..."); var response = client.SendEmail(sendRequest); Console.WriteLine("The email was sent successfully."); } catch (Exception ex) { Console.WriteLine("The email was not sent."); Console.WriteLine("Error message: " + ex.Message);

} }

Console.Write("Press any key to continue..."); Console.ReadKey(); } }}

4. En el editor de código, haga lo siguiente:

• Reemplace [email protected] por la dirección de correo electrónico del remitente. Estadirección debe verificarse. Para obtener más información, consulte the section called “Verificaciónde identidades” (p. 47).

• Reemplace [email protected] por la dirección de destino. Si su cuenta está todavía en elentorno de pruebas, esta dirección también se debe verificar.

• Reemplace ConfigSet por el nombre del conjunto de configuración que se va a usar al enviar estecorreo electrónico.

• Reemplace USWest2 por el nombre del punto de enlace de la región de AWS que va a usar paraenviar correo electrónico a través de Amazon SES. Se permiten los siguientes valores: USEast1,USWest2 y EUWest1.

Cuando termine, guarde Program.cs.5. Cree y ejecute la aplicación completando los pasos siguientes:

a. En el menú Build, elija Build Solution.b. En el menú Debug, elija Start Debugging. Aparece una ventana de consola.

34


6. Revise la salida de la consola. Si el correo electrónico se ha enviado correctamente, la consolamuestra "The email was sent successfully."

7. Si el correo electrónico se ha enviado correctamente, inicie sesión en el cliente de correo electrónicode la dirección del destinatario. Encontrará el mensaje que ha enviado.

Enviar un correo electrónico utilizando AWS SDK for Java

El siguiente procedimiento muestra cómo utilizar Eclipse IDE for Java EE Developers y AWS Toolkit forEclipse para crear un proyecto de AWS SDK y modificar el código Java para enviar un correo electrónico através de Amazon SES.

Important


Requisitos previos



• Obtenga sus credenciales de AWS: necesita un ID de clave de acceso y una clave de acceso secretade AWS para acceder a Amazon SES utilizando un SDK. Puede encontrar sus credenciales utilizandola página Security Credentials en la Consola de administración de AWS. Para obtener más informaciónacerca de las credenciales, consulte Uso de credenciales con Amazon SES (p. 393).

• Instale Eclipse: Eclipse está disponible en https://www.eclipse.org/downloads. El código en este tutorialse ha probado mediante Eclipse Neon.3 (versión 4.6.3), ejecutando la versión 1.8 de Java RuntimeEnvironment (JRE).

• Instale el AWS Toolkit for Eclipse: las instrucciones para añadir el AWS Toolkit for Eclipse a suinstalación de Eclipse están disponibles en https://aws.amazon.com/eclipse. El código de este tutorial seha probado utilizando la versión 2.3.1 del AWS Toolkit for Eclipse.

• Cree un archivo de credenciales compartidas: para que el código de muestra de esta sección funcionecorrectamente, debe crear un archivo de credenciales compartidas. Para obtener más información,consulte Crear un archivo de credenciales compartidas (p. 31).

Procedimiento

El siguiente procedimiento muestra cómo enviar un correo electrónico a través de Amazon SES utilizandoel AWS SDK for Java.

Para enviar un correo electrónico utilizando el AWS SDK for Java

1. Cree un proyecto en Java de AWS en Eclipse realizando los pasos siguientes:

a. Inicie Eclipse.

35

http://www.eclipse.org/

https://docs.aws.amazon.com/AWSToolkitEclipse/latest/GettingStartedGuide/

https://docs.aws.amazon.com/AWSToolkitEclipse/latest/GettingStartedGuide/


https://www.eclipse.org/downloads

https://aws.amazon.com/eclipse


b. En el menú File, elija New y, a continuación, elija Other. En la ventana New, expanda la carpetaAWS y, a continuación, elija AWS Java Project.

c. En el cuadro de diálogo New AWS Java Project, realice lo siguiente:

i. Para Project name, escriba un nombre de proyecto.ii. En AWS SDK for Java Samples, seleccione Amazon Simple Email Service JavaMail Sample.iii. Elija Finalizar.

2. En Eclipse, en la página Package Explorer, amplíe su proyecto.3. En su proyecto, expanda la carpeta src/main/java, la carpeta com.amazon.aws.samples y, a

continuación, haga doble clic en AmazonSESSample.java.4. Reemplace todo el contenido de AmazonSESSample.java por el siguiente código:

package com.amazonaws.samples;

import java.io.IOException;

import com.amazonaws.regions.Regions;import com.amazonaws.services.simpleemail.AmazonSimpleEmailService;import com.amazonaws.services.simpleemail.AmazonSimpleEmailServiceClientBuilder;import com.amazonaws.services.simpleemail.model.Body;import com.amazonaws.services.simpleemail.model.Content;import com.amazonaws.services.simpleemail.model.Destination;import com.amazonaws.services.simpleemail.model.Message;import com.amazonaws.services.simpleemail.model.SendEmailRequest;


// Replace [email protected] with your "From" address. // This address must be verified with Amazon SES. static final String FROM = "[email protected]";

// Replace [email protected] with a "To" address. If your account // is still in the sandbox, this address must be verified. static final String TO = "[email protected]";

// The configuration set to use for this email. If you do not want to use a // configuration set, comment the following variable and the // .withConfigurationSetName(CONFIGSET); argument below. static final String CONFIGSET = "ConfigSet";

// The subject line for the email. static final String SUBJECT = "Amazon SES test (AWS SDK for Java)"; // The HTML body for the email. static final String HTMLBODY = "<h1>Amazon SES test (AWS SDK for Java)</h1>" + "<p>This email was sent with <a href='https://aws.amazon.com/ses/'>" + "Amazon SES</a> using the <a href='https://aws.amazon.com/sdk-for-java/'>" + "AWS SDK for Java</a>";

// The email body for recipients with non-HTML email clients. static final String TEXTBODY = "This email was sent through Amazon SES " + "using the AWS SDK for Java.";

public static void main(String[] args) throws IOException {

try { AmazonSimpleEmailService client = AmazonSimpleEmailServiceClientBuilder.standard() // Replace US_WEST_2 with the AWS Region you're using for // Amazon SES. .withRegion(Regions.US_WEST_2).build(); SendEmailRequest request = new SendEmailRequest()

36


.withDestination( new Destination().withToAddresses(TO)) .withMessage(new Message() .withBody(new Body() .withHtml(new Content() .withCharset("UTF-8").withData(HTMLBODY)) .withText(new Content() .withCharset("UTF-8").withData(TEXTBODY))) .withSubject(new Content() .withCharset("UTF-8").withData(SUBJECT))) .withSource(FROM) // Comment or remove the next line if you are not using a // configuration set .withConfigurationSetName(CONFIGSET); client.sendEmail(request); System.out.println("Email sent!"); } catch (Exception ex) { System.out.println("The email was not sent. Error message: " + ex.getMessage()); } }}

5. En AmazonSESSample.java, reemplace lo siguiente por sus propios valores:

Important




• US_WEST_2: establézcalo en la región de AWS del punto de enlace de Amazon SES al que deseaconectarse. Tenga en cuenta que el estado del entorno de pruebas, los límites de envío y laconfiguración relacionada con la identidad de Amazon SES son específicos de una determinadaregión de AWS, así que asegúrese de seleccionar una región de AWS en la que configurar AmazonSES. En este ejemplo, estamos utilizando la región EE.UU. Oeste (Oregón). Ejemplos de otrasregiones que admite Amazon SES son US_EAST_1 y EU_WEST_1. Para obtener una lista completade las regiones de AWS que admite Amazon SES, consulte Regiones y Amazon SES (p. 439).

6. Guarde AmazonSESSample.java.7. Para crear el proyecto, elija Project y, a continuación, elija Build Project.

Note

Si esta opción está deshabilitada, la creación automática podría estar habilitada; en tal caso,omita este paso.

8. Para iniciar el programa y enviar el correo electrónico, elija Run y, a continuación, vuelva a elegir Run.9. Revise la salida del panel de consola en Eclipse. Si el correo electrónico se ha enviado correctamente,

la consola muestra "Email sent!". De lo contrario, muestra un mensaje de error.10. Si el correo electrónico se ha enviado correctamente, inicie sesión en el cliente de correo electrónico

de la dirección del destinatario. Encontrará el mensaje que ha enviado.

37


Enviar un correo electrónico utilizando AWS SDK para PHPEn este tema se muestra cómo utilizar la AWS SDK para PHP para enviar un correo electrónico a travésde Amazon SES.

Important


Requisitos previos




• Instale PHP: PHP está disponible en http://php.net/downloads.php. Este tutorial requiere PHP versión 5.5o posterior. Después de instalar PHP, añada la ruta a PHP en sus variables de entorno para que puedaejecutar PHP desde cualquier símbolo del sistema. El código de este tutorial se ha probado con PHP7.0.20.

• Instale el AWS SDK para PHP versión 3: para obtener las instrucciones de descarga e instalación,consulte la documentación de AWS SDK para PHP. El código de este tutorial se ha probado utilizando laversión 3.31.0 del SDK.


Procedimiento

El siguiente procedimiento muestra cómo enviar un correo electrónico a través de Amazon SES utilizandoel AWS SDK para PHP.

Para enviar un correo electrónico a través de Amazon SES utilizando el AWS SDK para PHP.

1. En un editor de texto, cree un archivo con el nombre amazon-ses-sample.php. Pegue el siguientecódigo:

<?php

// Replace path_to_sdk_inclusion with the path to the SDK as described in // https://docs.aws.amazon.com/aws-sdk-php/v3/guide/getting-started/basic-usage.htmldefine('REQUIRED_FILE','path_to_sdk_inclusion'); // Replace [email protected] with your "From" address. // This address must be verified with Amazon SES.define('SENDER', '[email protected]');

// Replace [email protected] with a "To" address. If your account

38

https://aws.amazon.com/sdk-for-php/


http://php.net/downloads.php

https://docs.aws.amazon.com/aws-sdk-php/v3/guide/getting-started/installation.html


// is still in the sandbox, this address must be verified.define('RECIPIENT', '[email protected]');

// Specify a configuration set. If you do not want to use a configuration// set, comment the following variable, and the // 'ConfigurationSetName' => CONFIGSET argument below.define('CONFIGSET','ConfigSet');

// Replace us-west-2 with the AWS Region you're using for Amazon SES.define('REGION','us-west-2');

define('SUBJECT','Amazon SES test (AWS SDK for PHP)');

define('HTMLBODY','<h1>AWS Amazon Simple Email Service Test Email</h1>'. '<p>This email was sent with <a href="https://aws.amazon.com/ses/">'. 'Amazon SES</a> using the <a href="https://aws.amazon.com/sdk-for-php/">'. 'AWS SDK for PHP</a>.</p>');define('TEXTBODY','This email was send with Amazon SES using the AWS SDK for PHP.');

define('CHARSET','UTF-8');

require REQUIRED_FILE;

use Aws\Ses\SesClient;use Aws\Ses\Exception\SesException;

$client = SesClient::factory(array( 'version'=> 'latest', 'region' => REGION));

try { $result = $client->sendEmail([ 'Destination' => [ 'ToAddresses' => [ RECIPIENT, ], ], 'Message' => [ 'Body' => [ 'Html' => [ 'Charset' => CHARSET, 'Data' => HTMLBODY, ], 'Text' => [ 'Charset' => CHARSET, 'Data' => TEXTBODY, ], ], 'Subject' => [ 'Charset' => CHARSET, 'Data' => SUBJECT, ], ], 'Source' => SENDER, // If you are not using a configuration set, comment or delete the // following line 'ConfigurationSetName' => CONFIGSET,]); $messageId = $result->get('MessageId'); echo("Email sent! Message ID: $messageId"."\n");

} catch (SesException $error) { echo("The email was not sent. Error message: ".$error->getAwsErrorMessage()."\n");}

39


?>

2. En amazon-ses-sample.php, reemplace lo siguiente por sus propios valores:

• path_to_sdk_inclusion: reemplace por la ruta necesaria para incluir el AWS SDK para PHP enel programa. Para obtener más información, consulte la documentación de AWS SDK para PHP.



• (Opcional) us-west-2: si desea utilizar Amazon SES en una región distinta de EE.UU. Oeste(Oregón), reemplácela por la región que desee utilizar. Para obtener una lista de las regiones en lasque está disponible Amazon SES, consulte Regiones y Amazon SES (p. 439).

3. Guarde amazon-ses-sample.php.4. Para ejecutar el programa, abra un símbolo del sistema en el mismo directorio como amazon-ses-

sample.php y, a continuación, escriba php amazon-ses-sample.php5. Revise la salida. Si el correo electrónico se ha enviado correctamente, la consola muestra "Email

sent!". De lo contrario, muestra un mensaje de error.Note

Si detecta un error "cURL error 60: SSL certificate problem" al ejecutar el programa,descargue el último paquete de CA tal como se describe en la documentación de AWS SDKpara PHP. A continuación, en amazon-ses-sample.php, añada las siguientes líneas a lamatriz SesClient::factory, reemplace path_of_certs por la ruta al paquete de CAque ha descargado y vuelva a ejecutar el programa.

'http' => [ 'verify' => 'path_of_certs\ca-bundle.crt']


Enviar un correo electrónico utilizando AWS SDK parar RubyEn este tema se muestra cómo utilizar la AWS SDK parar Ruby para enviar un correo electrónico a travésde Amazon SES.

Important


Requisitos previos


• Verifique su dirección de correo electrónico con Amazon SES: antes de poder enviar un correoelectrónico con Amazon SES, debe verificar que es propietario de la dirección de correo electrónico

40

https://docs.aws.amazon.com/aws-sdk-php/v3/guide/getting-started/basic-usage.html

https://docs.aws.amazon.com/aws-sdk-php/v3/guide/faq.html#what-do-i-do-about-a-curl-ssl-certificate-error

https://docs.aws.amazon.com/aws-sdk-php/v3/guide/faq.html#what-do-i-do-about-a-curl-ssl-certificate-error

https://aws.amazon.com/sdk-for-ruby/


del remitente. Si su cuenta está todavía en el entorno de pruebas Amazon SES, también tiene queverificar la dirección de correo electrónico del destinatario. La forma más sencilla de verificar direccionesde correo electrónico consiste en utilizar la consola de Amazon SES. Para obtener más información,consulte Verificación de direcciones de correo electrónico en Amazon SES. (p. 47).


• Instale Ruby: Ruby está disponible en https://www.ruby-lang.org/en/downloads/. El código de este tutorialse ha probado con Ruby 1.9.3. Después de instalar Ruby, añada la ruta a Ruby en sus variables deentorno para que pueda ejecutar Ruby desde cualquier símbolo del sistema.

• Instale el AWS SDK parar Ruby: para obtener instrucciones de descarga e instalación, consulte Installingthe AWS SDK parar Ruby en la AWS SDK parar Ruby Developer Guide. El código de muestra de estetutorial se ha probado utilizando la versión 2.9.36 del AWS SDK parar Ruby.


Procedimiento

El siguiente procedimiento muestra cómo enviar un correo electrónico a través de Amazon SES utilizandoel AWS SDK parar Ruby.

Para enviar un correo electrónico a través de Amazon SES utilizando el AWS SDK parar Ruby.

1. En un editor de texto, cree un archivo con el nombre amazon-ses-sample.rb. Pegue el códigosiguiente en el archivo:

require 'aws-sdk'

# Replace [email protected] with your "From" address.# This address must be verified with Amazon SES.sender = "[email protected]"

# Replace [email protected] with a "To" address. If your account # is still in the sandbox, this address must be verified.recipient = "[email protected]"

# Specify a configuration set. If you do not want to use a configuration# set, comment the following variable and the # configuration_set_name: configsetname argument below. configsetname = "ConfigSet" # Replace us-west-2 with the AWS Region you're using for Amazon SES.awsregion = "us-west-2"

# The subject line for the email.subject = "Amazon SES test (AWS SDK for Ruby)"

# The HTML body of the email.htmlbody = '<h1>Amazon SES test (AWS SDK for Ruby)</h1>'\ '<p>This email was sent with <a href="https://aws.amazon.com/ses/">'\ 'Amazon SES</a> using the <a href="https://aws.amazon.com/sdk-for-ruby/">'\ 'AWS SDK for Ruby</a>.'

# The email body for recipients with non-HTML email clients. textbody = "This email was sent with Amazon SES using the AWS SDK for Ruby."

# Specify the text encoding scheme.

41


https://www.ruby-lang.org/en/downloads/

https://docs.aws.amazon.com/sdk-for-ruby/v2/developer-guide/setup-install.html

https://docs.aws.amazon.com/sdk-for-ruby/v2/developer-guide/setup-install.html


encoding = "UTF-8"

# Create a new SES resource and specify a regionses = Aws::SES::Client.new(region: awsregion)

# Try to send the email.begin

# Provide the contents of the email. resp = ses.send_email({ destination: { to_addresses: [ recipient, ], }, message: { body: { html: { charset: encoding, data: htmlbody, }, text: { charset: encoding, data: textbody, }, }, subject: { charset: encoding, data: subject, }, }, source: sender, # Comment or remove the following line if you are not using # a configuration set configuration_set_name: configsetname, }) puts "Email sent!"

# If something goes wrong, display an error message.rescue Aws::SES::Errors::ServiceError => error puts "Email not sent. Error message: #{error}"

end

2. En amazon-ses-sample.rb, reemplace lo siguiente por sus propios valores:




3. Guarde amazon-ses-sample.rb.4. Para ejecutar el programa, abra un símbolo del sistema en el mismo directorio como amazon-ses-

sample.rb y escriba ruby amazon-ses-sample.rb5. Revise la salida. Si el correo electrónico se ha enviado correctamente, la consola muestra "Email

sent!". De lo contrario, muestra un mensaje de error.

42



Enviar un correo electrónico utilizando el AWS SDK for Python (Boto)

En este tema se muestra cómo utilizar el AWS SDK for Python (Boto) para enviar un correo electrónico através de Amazon SES.

Important


Requisitos previos




• Instale Python: Python está disponible en https://www.python.org/downloads/. El código de este tutorialse ha probado con Python 2.7.6 y Python 3.6.1. Después de instalar Python, añada la ruta a Python ensus variables de entorno para que pueda ejecutar Python desde cualquier símbolo del sistema.

• Instale el AWS SDK for Python (Boto): para obtener las instrucciones de descarga e instalación, consultela documentación de AWS SDK for Python (Boto). El código de muestra de este tutorial se ha probadoutilizando la versión 1.4.4 del SDK for Python.


Procedimiento

El siguiente procedimiento muestra cómo enviar un correo electrónico a través de Amazon SES utilizandoel SDK for Python.

Para enviar un correo electrónico a través de Amazon SES utilizando el SDK for Python.

1. En un editor de texto, cree un archivo con el nombre amazon-ses-sample.py. Pegue el códigosiguiente en el archivo:

import boto3from botocore.exceptions import ClientError

# Replace [email protected] with your "From" address.# This address must be verified with Amazon SES.SENDER = "Sender Name <[email protected]>"

43

https://aws.amazon.com/sdk-for-python/


https://www.python.org/downloads/

https://boto3.readthedocs.io/en/latest/guide/quickstart.html#installation


# Replace [email protected] with a "To" address. If your account # is still in the sandbox, this address must be verified.RECIPIENT = "[email protected]"

# Specify a configuration set. If you do not want to use a configuration# set, comment the following variable, and the # ConfigurationSetName=CONFIGURATION_SET argument below.CONFIGURATION_SET = "ConfigSet"

# If necessary, replace us-west-2 with the AWS Region you're using for Amazon SES.AWS_REGION = "us-west-2"

# The subject line for the email.SUBJECT = "Amazon SES Test (SDK for Python)"

# The email body for recipients with non-HTML email clients.BODY_TEXT = ("Amazon SES Test (Python)\r\n" "This email was sent with Amazon SES using the " "AWS SDK for Python (Boto)." ) # The HTML body of the email.BODY_HTML = """<html><head></head><body> <h1>Amazon SES Test (SDK for Python)</h1> <p>This email was sent with <a href='https://aws.amazon.com/ses/'>Amazon SES</a> using the <a href='https://aws.amazon.com/sdk-for-python/'> AWS SDK for Python (Boto)</a>.</p></body></html> """

# The character encoding for the email.CHARSET = "UTF-8"

# Create a new SES resource and specify a region.client = boto3.client('ses',region_name=AWS_REGION)

# Try to send the email.try: #Provide the contents of the email. response = client.send_email( Destination={ 'ToAddresses': [ RECIPIENT, ], }, Message={ 'Body': { 'Html': { 'Charset': CHARSET, 'Data': BODY_HTML, }, 'Text': { 'Charset': CHARSET, 'Data': BODY_TEXT, }, }, 'Subject': { 'Charset': CHARSET, 'Data': SUBJECT, }, },

44

Amazon Simple Email Service Developer GuideConfiguración de correo electrónico

Source=SENDER, # If you are not using a configuration set, comment or delete the # following line ConfigurationSetName=CONFIGURATION_SET, )# 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'])

2. En amazon-ses-sample.py, reemplace lo siguiente por sus propios valores:




3. Guarde amazon-ses-sample.py.4. Para ejecutar el programa, abra un símbolo del sistema en el mismo directorio como amazon-ses-

sample.py y, a continuación, escriba python amazon-ses-sample.py5. Revise la salida. Si el correo electrónico se ha enviado correctamente, la consola muestra "Email


que ha enviado.

Configuración de correo electrónico con AmazonSES

Para configurar correo electrónico con Amazon Simple Email Service (Amazon SES), debe realizar lassiguientes tareas:

• Antes de poder acceder a Amazon SES u otros servicios de AWS, tiene que configurar una cuenta deAWS. Para obtener más información, consulte Inscripción en AWS (p. 46).

• Antes de enviar correo electrónico a través de Amazon SES, tiene que verificar que usted es propietariode la dirección de remitente ("From"). Si su cuenta está todavía en el entorno de pruebas Amazon SES,también tiene que verificar sus direcciones de destinatario ("Para"). Puede verificar las direccionesde correo electrónico o dominios completos. Para obtener más información, consulte Verificación deidentidades en Amazon SES (p. 47).

Las siguientes tareas son opcionales en función de lo que desee hacer:

• Si desea acceder a Amazon SES a través del API de Amazon SES, ya sea por la interfaz de consulta(HTTPS) o indirectamente a través de un SDK de AWS, el AWS Command Line Interface o laHerramientas de AWS para Windows PowerShell, debe obtener sus claves de acceso de AWS. Paraobtener más información, consulte Obtener sus claves de acceso de AWS (p. 64).

45




Amazon Simple Email Service Developer GuideInscripción en AWS

• Si desea usar el API de Amazon SES sin gestionar los detalles de bajo nivel de la interfaz de consulta,puede utilizar un SDK de AWS. Para obtener más información, consulte Descarga de un SDK deAWS (p. 65).

• Si desea acceder a Amazon SES a través de su interfaz de SMTP, tendrá que obtener su nombrede usuario de SMTP y contraseña. Sus credenciales de SMTP son distintas de las credenciales deAWS. Para obtener más información, consulte Obtener sus credenciales de SMTP para AmazonSES (p. 72).

• Al inscribirse por primera vez en Amazon SES, su cuenta está en el entorno de pruebas de AmazonSES. En el entorno de pruebas, puede enviar correos electrónicos a través de los mismos métodos deenvío de correo electrónico que cualquier otro usuario de Amazon SES, salvo que solo puede enviar 200mensajes de correo electrónico en un periodo de 24 horas a una velocidad máxima de un mensaje decorreo electrónico por segundo y solo puede enviar correos electrónicos a aquellas direcciones que hayaverificado. Para aumentar sus límites de envío y para enviar correo electrónico a direcciones de correoelectrónico sin verificar, consulte Salir del entorno de pruebas de Amazon SES (p. 72).

• Si desea que sus correos electrónicos superen la autenticación basada en Domain-based MessageAuthentication, Reporting and Conformance (DMARC) en el marco de directivas de remitente (SPF),configure su identidad para enviar desde un dominio MAIL FROM personalizado tal y como se describeen Uso de un dominio MAIL FROM personalizado (p. 65).

Inscripción en AWSTiene que crear una cuenta de AWS antes de poder utilizar Amazon SES u otros servicios de AWS. Alcrear una cuenta de AWS, AWS inicia sesión automáticamente con su cuenta para todos los servicios.Solo se le cobrará por los servicios que utilice.

Note

Si va a enviar sus mensajes de correo electrónico desde una instancia Amazon EC2, ya seadirectamente o a través de AWS Elastic Beanstalk puede comenzar a utilizar Amazon SES deforma gratuita. Para obtener más información, consulte los Precios de Amazon SES.

Al inscribirse por primera vez en AWS, su envío de Amazon SES está en el entorno de pruebas deAmazon SES. En el entorno de pruebas, tiene acceso total al API de Amazon SES y a la interfaz de SMTP.Sin embargo, las siguientes restricciones se encuentran en vigor:

• Solo puede enviar correos electrónicos al proveedor de bandeja de correo de Amazon SES y a lasdirecciones de correo electrónico o dominios que haya verificado. Para obtener más información,consulte Verificación de identidades en Amazon SES (p. 47).

• Puede enviar un máximo de 200 mensajes por cada período de 24 horas.• Puede enviar un máximo de un mensaje por segundo.

Para obtener información sobre cómo salir del entorno de pruebas, consulte Salir del entorno de pruebasde Amazon SES (p. 72).

Para crear una cuenta de AWS

1. Acceda a https://aws.amazon.com/ses y elija Sign up now.2. Siga las instrucciones en pantalla.

Note

Incluso si su cuenta está fuera del entorno de pruebas de Amazon SES, tendrá que verificar sudirección de remitente ("From") para confirmar que es el propietario.

46


https://aws.amazon.com/ses

Amazon Simple Email Service Developer GuideVerificación de identidades

Verificación de identidades en Amazon SESEn Amazon SES, una identidad es una dirección de correo electrónico o un dominio que se utiliza paraenviar correo electrónico. Para poder enviar un correo electrónico mediante Amazon SES, debe verificarcada identidad que va a utilizar como dirección en los campos "From", "Source", "Sender", "Return-Path" para demostrar que es su propietario. Si su cuenta sigue estando en el entorno de pruebas deAmazon SES, también deberá verificar todas las direcciones de correo electrónico a las que envíecorreos electrónicos, excepto las proporcionadas por el simulador de bandeja de correo de AmazonSES (p. 173).

Puede verificar una identidad utilizando la consola de Amazon SES o la API de Amazon SES.

Verificación de direcciones de correo electrónico en AmazonSES.Amazon SES requiere que verifique sus identidades (los dominios o direcciones de correo electrónicodesde los que envía correos electrónicos) para confirmar que usted es propietario y para evitar su uso noautorizado. En esta sección se incluye información sobre la verificación de identidades de direcciones decorreo electrónico. Para obtener información sobre la verificación de identidades de dominio, consulte thesection called “Verificación de dominios” (p. 59).

Tenga en cuenta los factores siguientes al verificar direcciones de correo electrónico para su uso conAmazon SES:

• Debe verificar cada identidad que utilice como "From", "Source", "Sender" o "Return-Path". Sin embargo,puede añadir una etiqueta a una dirección de correo electrónico que ya se ha verificado sin realizarningún paso adicional de verificación (consulte la información que figura más adelante en esta lista).

• Las direcciones de correo electrónico distinguen entre mayúsculas y minúsculas. Si [email protected], no puede enviar correo electrónico desde [email protected] a menos queverifique también [email protected].

• Si verifica una dirección de correo electrónico y el dominio al que pertenece la dirección, la configuraciónde la dirección de correo electrónico prevalece sobre la del dominio. Por ejemplo, si se activa elcorreo identificado con claves de dominio (DKIM) para el dominio example.com, pero no [email protected], los correos electrónicos enviados desde [email protected] no estánfirmados con DKIM.

• Amazon SES tiene puntos de enlace en varias regiones de AWS, y el estado de verificación de ladirección de correo electrónico es independiente para cada región. Si desea enviar correo electrónicodesde la misma identidad en más de una región, debe verificar esa identidad en cada región. Paraobtener más información sobre el uso de Amazon SES en varias regiones, consulte Regiones (p. 439).

• En cada región de AWS, puede verificar hasta 10 000 identidades (dominios o direcciones de correoelectrónico en cualquier combinación).

• Puede añadir etiquetas a las direcciones de correo electrónico verificadas sin necesidad de realizarpasos de verificación adicionales. Para añadir una etiqueta a una dirección de correo electrónico, añadaun signo más (+) entre la cuenta y el signo "arroba" (@), seguido por una etiqueta de texto. Por ejemplo,si ya ha verificado [email protected], puede utilizar [email protected] como dirección"From" o "Return-Path" de sus correos electrónicos. Puede utilizar esta característica para implementarla ruta variable de retorno de sobres (VERP). A continuación, puede utilizar VERP para detectar yeliminar de sus listas de correo las direcciones de correo electrónico que generan errores de entrega.

• Puede personalizar los mensajes que se envían a las direcciones de correo electrónico que intentaverificar. Para obtener más información, consulte the section called “Uso de plantillas de correoelectrónico de verificación personalizado” (p. 51).

47


Verificación de una dirección de correo electrónico

Puede verificar direcciones de correo electrónico utilizando la consola de Amazon SES o la operaciónVerifyEmailIdentity de la API.

Verificación de una dirección de correo electrónico utilizando la consola de Amazon SES

Realice el procedimiento de esta sección para verificar una dirección de correo electrónico utilizando laconsola Amazon SES.

Para verificar una dirección de correo electrónico utilizando la consola de Amazon SES


2. En la consola, utilice el selector de regiones para elegir la región de AWS a la que pertenece la correoelectrónico que desea verificar, tal y como se muestra en la imagen siguiente.

Note

Para verificar una dirección de correo electrónico para su uso en más de una región, repita elprocedimiento de esta sección para cada región.

3. En el panel de navegación, en Identity Management, elija Email Addresses.4. Seleccione Verify a New Email Address.5. En el cuadro de diálogo Verify a New Email Address, escriba la dirección de correo electrónico en el

campo Email Address y, a continuación, elija Verify This Email Address.6. Compruebe la bandeja de entrada de la dirección de correo electrónico que está verificando. Recibirá

un mensaje con el asunto siguiente: "Amazon Web Services - Email Address Verification Request inregion Nombre-de-la-región", donde Nombre-de-la-región es el nombre de la región de AWSque seleccionó en el paso 2.

Haga clic en el enlace del mensaje.

Note

El enlace del mensaje de verificación caduca 24 horas después de su envío. Si hantranscurrido más de 24 horas desde que recibió el correo electrónico de verificación, repitalos pasos 1 a 5 para recibir un correo electrónico de verificación con un enlace válido.

7. En la consola de Amazon SES, en Identity Management, elija Email Addresses. En la lista dedirecciones de correo electrónico, localice la dirección de correo electrónico que está verificando. Si ladirección de correo electrónico está verificada, el valor de la columna Status es "verified".

48

https://docs.aws.amazon.com/ses/latest/APIReference/API_VerifyEmailIdentity.html




Verificación de una dirección de correo electrónico utilizando la API de Amazon SES

Utilice la operación VerifyEmailIdentity de la API para crear una identidad de correo electrónico nueva. Alejecutar esta operación, se envía un correo electrónico de verificación a la dirección especificada.

Para verificar una dirección de correo electrónico con la AWS CLI, escriba el comando siguiente en la líneade comandos: aws ses verify-email-identity --email-address [email protected]

En el comando anterior, sustituya [email protected] por la dirección de correo electrónico que deseaverificar.

Si desea ver un script que se puede utilizar para verificar varias identidades de correo electrónicoen una sola operación, consulte the section called “Verificación de varias direcciones de correoelectrónico” (p. 435).

Solución de problemas de verificación de direcciones de correo electrónico

Si ha intentado verificar una dirección de correo electrónico, pero no ha recibido un correo electrónico deverificación de AWS, siga estos pasos de resolución de problemas:

• Compruebe la carpeta de correo no deseado de su cliente de correo electrónico.• Asegúrese de que su cliente de correo electrónico no aplique reglas que muevan automáticamente

ciertos mensajes a una carpeta distinta de la bandeja de entrada.• En su cliente de correo electrónico, añada [email protected] a su libreta de direcciones o lista

de remitentes seguros. También puede pedir al administrador del sistema que añada a la lista blanca elcorreo procedente de [email protected].

• Con una dirección de correo electrónico que utilice otro proveedor de servicios de correo electrónico(por ejemplo, una dirección de correo electrónico personal), envíe un mensaje a la dirección quedesea verificar. Asegúrese de que la dirección que desea verificar recibe el mensaje. Este paso esespecialmente importante si ha configurado recientemente su propio dominio. Algunas veces, losdominios nuevos no están configurados correctamente para recibir mensajes de correo electrónicoentrantes.

También puede probar a verificar una dirección de correo electrónico que sabe que puede recibir correoelectrónico, como, por ejemplo, una dirección de correo electrónico personal. Si recibe la verificación ensu dirección de correo electrónico personal, esto que puede indicar que existe un problema en el otrodominio.

Si estas pruebas demuestran que no se recibe correo electrónico en la dirección que ha intentadoverificar, consulte al administrador del sistema o al proveedor de servicios de correo electrónico paraobtener ayuda adicional.

Listado de las identidades de correo electrónico en Amazon SES

Es posible visualizar una lista de las identidades de correo electrónico mediante la consola o la operaciónListIdentities de la API de Amazon SES.

Visualización de una lista de identidades de correo electrónico en Amazon SES

Es posible utilizar la consola y la API de Amazon SES para ver una lista de direcciones de correoelectrónico verificadas o pendientes de verificación, así como de las que no han superado el proceso deverificación.

Para ver una lista de las direcciones de correo electrónico verificadas


49


https://docs.aws.amazon.com/ses/latest/APIReference/API_ListIdentities.html




2. En la consola, utilice el selector de regiones para elegir la región de AWS cuyas identidades de correoelectrónico desea mostrar, tal y como se muestra en la imagen siguiente.

Note

Estos procedimientos solo muestran una lista de direcciones de correo electrónico para laregión de AWS seleccionada.

3. En el panel de navegación, en Identity Management, elija Email Addresses.

Se muestra la página Email Addresses con una lista que contiene las direcciones de correo electrónicoverificadas, las que están pendientes de verificación y las que no han superado el proceso deverificación. Haga clic en una dirección de correo electrónico para ver información adicional sobre ella.

Visualización de una lista de identidades de correo electrónico mediante la API de Amazon SES

Utilice la operación ListIdentities de la API para ver una lista de todas las identidades de correo electrónico,sea cual sea su estado. También puede utilizar la operación GetIdentityVerificationAttributes paradeterminar el estado de verificación de una identidad determinada.

Para ver una lista de identidades mediante la AWS CLI, escriba el comando siguiente en la línea decomandos: aws ses list-identities

Cuando se ejecuta la operación ListIdentities, devuelve una lista de todas las identidades deAmazon SES de la cuenta, sea cual sea su estado de verificación. Para ver el estado de verificación deuna o varias identidades, utilice la operación GetIdentityVerificationAttributes. Para determinarel estado de verificación de una identidad utilizando la AWS CLI, escriba el comando siguiente en la líneade comandos: aws ses get-identity-verification-attributes --identities "[email protected]"

Sustituya [email protected] en el comando anterior por la identidad cuyo estado de verificacióndesea determinar. También puede utilizar este comando para determinar el estado de verificación devarias identidades con una sola llamada a la API. Por ejemplo, para determinar el estado del dominioexample.com y la dirección de correo electrónico [email protected], escriba el comando siguiente:aws ses get-identity-verification-attributes --identities "example.com" "[email protected]"

Eliminación de una identidad de correo electrónico en Amazon SES

Si ya no necesita utilizar una dirección de correo electrónico verificada, puede eliminarla mediante laconsola o la operación DeleteIdentity de la API de Amazon SES.

Warning

Esta acción no se puede deshacer. Sin embargo, puede repetir el proceso de verificación parauna identidad que se ha eliminado anteriormente.

50


https://docs.aws.amazon.com/ses/latest/APIReference/API_GetIdentityVerificationAttributes.html

https://docs.aws.amazon.com/ses/latest/APIReference/API_DeleteIdentity.html


Eliminación de una identidad de correo electrónico en Amazon SES

Para eliminar direcciones de correo electrónico verificadas


2. En la consola, utilice el selector de regiones para elegir la región de AWS a la que pertenece laidentidad de correo electrónico que desea eliminar, tal y como se muestra en la imagen siguiente.

Note

Estos procedimientos únicamente eliminan la dirección de correo electrónico en la región deAWS seleccionada. Para eliminar una dirección de correo electrónico que se ha verificado enmás de una región, repita el procedimiento de esta sección para cada región.

3. Seleccione cada dirección de correo electrónico que desea quitar y, a continuación, elija Remove.

Eliminación de una identidad de correo electrónico mediante la API de Amazon SES

Utilice la operación DeleteIdentity de la API para eliminar identidades de dominio y de dirección de correoelectrónico.

Para eliminar una identidad con la AWS CLI, escriba el comando siguiente en la línea de comandos: awsses delete-identity --identity "[email protected]"

Sustituya [email protected] en el comando anterior por la identidad que desea eliminar.

Uso de plantillas de correo electrónico de verificación personalizado

Cuando intenta verificar una dirección de correo electrónico, Amazon SES envía un correo electrónico aesa dirección similar al del ejemplo que se muestra en la siguiente imagen.

51





Varios clientes de Amazon SES crean aplicaciones (como conjuntos de aplicaciones de marketing porcorreo electrónico o sistemas de tramitación de incidencias) que envían correo electrónico a través deAmazon SES en nombre de sus propios clientes. Para los usuarios finales de estas aplicaciones, elproceso de verificación del correo electrónico puede ser confuso: el correo electrónico de verificaciónutiliza la información de marca de Amazon SES, en lugar de la información de marca de la aplicación, y losusuarios finales nunca se registran en Amazon SES directamente.

Si su caso de uso de Amazon SES requiere que las direcciones de correo electrónico de sus clientesse verifiquen para poder usarlas con Amazon SES, puede crear mensajes de correo electrónico deverificación personalizados. Estos mensajes de correo electrónico personalizados ayudan a reducir laconfusión de los clientes y aumentan la velocidad a las que sus clientes realizan el proceso de registro.

Temas de esta sección:• Creación de una plantilla de correo electrónico de verificación personalizado (p. 52)• Edición de una plantilla de correo electrónico de verificación personalizado (p. 53)• Envío de plantillas de correo electrónico de verificación personalizado (p. 54)• Preguntas frecuentes sobre el correo electrónico de verificación personalizado (p. 54)

Creación de una plantilla de correo electrónico de verificación personalizado

Para crear un mensaje de correo electrónico de verificación personalizado, use la operación de APICreateCustomVerificationEmailTemplate. Esta operación toma los siguientes parámetros deentrada:

Atributo Descripción

TemplateName El nombre de la plantilla. El nombre que especifique debe ser único.

FromEmailAddress La dirección de correo electrónico desde la que se envía el correoelectrónico de verificación. La dirección o el dominio que especifiquedeben verificarse para su uso con su cuenta de Amazon SES.

Note

El atributo FromEmailAddress no admite nombres devisualización (también conocidos como nombres de "remitentedescriptivo").

TemplateSubject La línea de asunto del correo electrónico de verificación.

TemplateContent El cuerpo del mensaje de correo electrónico. El cuerpo del mensaje decorreo electrónico pueden contener HTML, con algunas limitaciones. Paraobtener más información, consulte Preguntas frecuentes sobre el correoelectrónico de verificación personalizado (p. 54).

SuccessRedirectionURL La dirección URL a la que se envía a los usuarios si sus direcciones decorreo se verifican correctamente.

FailureRedirectionURL La dirección URL a la que se envía a los usuarios si sus direcciones decorreo no se verifican correctamente.

Puede utilizar los SDK de AWS o la AWS CLI para crear una plantilla de correo electrónico de verificaciónpersonalizado con la operación CreateCustomVerificationEmailTemplate. Para obtener másinformación acerca de los SDK de AWS, consulte Herramientas para Amazon Web Services. Para obtenermás información sobre la AWS CLI, consulte Interfaz de línea de comandos de AWS.

52


https://aws.amazon.com/cli


La siguiente sección incluye procedimientos para crear un correo electrónico de verificación personalizadomediante la AWS CLI. Para estos procedimientos se presupone que ha instalado y configurado la AWSCLI. Para obtener más información acerca de cómo instalar y configurar el AWS CLI, consulte la Guía delusuario de AWS Command Line Interface.

Note

To complete the procedure in this section, you must use version 1.14.6 or later of the AWSCLI. For best results, upgrade to the latest version of the AWS CLI. For more information aboutupdating the AWS CLI, see Installing the AWS Command Line Interface in the AWS CommandLine Interface Guía del usuario.

1. En un editor de texto, cree un nuevo archivo. Pegue el siguiente contenido en el editor:

{ "TemplateName": "SampleTemplate", "FromEmailAddress": "[email protected]", "TemplateSubject": "Please confirm your email address", "TemplateContent": "<html> <head></head> <body style="font-family:sans-serif;"> <h1 style="text-align:center">Ready to start sending email with ProductName?</h1> <p>We here at Example Corp are happy to have you on board! There's just one last step to complete before you can start sending email. Just click the following link to verify your email address. Once we confirm that you're really you, we'll give you some additional information to help you get started with ProductName.</p> </body> </html>", "SuccessRedirectionURL": "https://www.example.com/verifysuccess", "FailureRedirectionURL": "https://www.example.com/verifyfailure"}

Important

Para que el ejemplo anterior sea más fácil de leer, el atributo TemplateContent contienesaltos de línea. Si pega el ejemplo anterior en el archivo de texto, elimine los saltos de líneaantes de continuar.

Reemplace los valores de TemplateName, FromEmailAddress, TemplateSubject,TemplateContent, SuccessRedirectionURL y FailureRedirectionURL por sus propiosvalores. Guarde el archivo como customverificationemail.json.

2. En la línea de comandos, escriba el siguiente comando para crear la plantilla de correo electrónicode verificación personalizado: aws ses create-custom-verification-email-template --cli-input-json file://customverificationemail.json

3. Si lo desea, puede confirmar que la plantilla se ha creado escribiendo el siguiente comando: aws seslist-custom-verification-email-templates

Edición de una plantilla de correo electrónico de verificación personalizado

Puede editar una plantilla de correo electrónico de verificación personalizado mediante la operaciónUpdateCustomVerificationEmailTemplate. Esta operación acepta los mismos parámetrosde entrada que la operación CreateCustomVerificationEmailTemplate (es decir, losatributos TemplateName, FromEmailAddress, TemplateSubject, TemplateContent,SuccessRedirectionURL y FailureRedirectionURL). Sin embargo, con la operaciónUpdateCustomVerificationEmailTemplate, ninguno de estos atributos son obligatorios. Cuandopasa un valor para TemplateName que es igual al nombre de una plantilla de correo electrónico de

53

https://docs.aws.amazon.com/cli/latest/userguide/


https://docs.aws.amazon.com/cli/latest/userguide/installing.html


verificación personalizado, los atributos que especifique sobrescriben los que se encuentran originalmenteen la plantilla.

Envío de plantillas de correo electrónico de verificación personalizado

Después de crear al menos una plantilla de correo electrónico de verificación personalizado, puedeenviarla a sus clientes llamando a la operación de API SendCustomVerificationEmail. Puede llamar a laoperación SendCustomVerificationEmail mediante cualquiera de los SDK de AWS o la AWS CLI. Laoperación SendCustomVerificationEmail toma los siguientes parámetros de entrada:

Atributo Descripción

EmailAddress La dirección de correo electrónico que se va a verificar.

TemplateName El nombre de la plantilla de correo electrónico de verificaciónpersonalizado que se envía a la dirección de correo electrónico que va averificar.

ConfigurationSetName (Opcional) El nombre del conjunto de configuración que se va a usar alenviar el correo electrónico de verificación.

Suponga, por ejemplo, que sus clientes se registran en el servicio mediante un formulario de suaplicación. Cuando el cliente completa el formulario y lo envía, su aplicación llama a la operaciónSendCustomVerificationEmail, pasando la dirección de correo electrónico del cliente y el nombre dela plantilla que desee utilizar.

El cliente recibe un correo electrónico que utiliza la plantilla de correo electrónico personalizado que hacreado. Amazon SES añade automáticamente un enlace único para el destinatario, así como una breverenuncia de responsabilidades. En la siguiente imagen se muestra un correo electrónico de verificaciónde ejemplo que utiliza la plantilla creada en Creación de una plantilla de correo electrónico de verificaciónpersonalizado (p. 52).

Preguntas frecuentes sobre el correo electrónico de verificación personalizado

Esta sección contiene respuestas a preguntas frecuentes acerca de la característica de plantilla de correoelectrónico de verificación personalizado.

P1. ¿Cuántas plantillas de correo electrónico de verificación personalizado puedo crear?

Puede crear hasta 50 plantillas de correo electrónico de verificación personalizado para cada cuenta deAmazon SES.

P2. ¿Cómo se muestran los mensajes de correo electrónico de verificación personalizados a losdestinatarios?

Los mensajes de correo electrónico de verificación personalizados incluyen el contenido que especificóal crear la plantilla, seguido de un enlace en el que los destinatarios deben hacer clic para verificar susdirecciones de correo electrónico.

54

http://docs.aws.amazon.com/ses/latest/APIReference/API_SendCustomVerificationEmail.html


P3. ¿Puedo obtener una vista previa del correo electrónico de verificación personalizado?

Para obtener una vista previa de un correo electrónico de verificación personalizado, utilice la operaciónSendCustomVerificationEmail para enviar un correo electrónico de verificación a una dirección desu propiedad. Si no hace clic en el enlace de verificación, Amazon SES no crea una nueva identidad. Sihace clic en el enlace de verificación, tiene la opción de eliminar la identidad recién creada mediante laoperación DeleteIdentity.

P4. ¿Puedo incluir imágenes en mis plantillas de correo electrónico de verificación personalizado?

Puede incrustar imágenes en el código HTML para las plantillas a través de la codificación Base64.Cuando incrusta imágenes de esta forma, Amazon SES las convierte automáticamente en archivosadjuntos. Puede codificar una imagen en la línea de comandos ejecutando uno de los siguientescomandos:

• Linux, macOS, or Unix: base64 -i imagefile.png | tr -d '\n' > output.txt• Windows: certutil -encode imagefile.png output.tmp && findstr /v /c:- output.tmp > output.txt && del

output.tmp

Reemplace imagefile.png por el nombre del archivo que desea codificar. En ambos de los comandosanteriores, la imagen codificada en Base64 se almacena en output.txt.

Note

Si ha codificado la imagen mediante la línea de comandos de Windows, debe abrir output.txten un editor de texto y eliminar los saltos de línea del archivo antes de continuar.

Puede incrustar la imagen codificada en Base64 incluyendo lo siguiente en el código HTML de la plantilla:<img src="data:image/png;base64,base64EncodedImage"/>

En el ejemplo anterior, sustituya png por el tipo de archivo de la imagen codificada (por ejemplo, jpg ogif) y sustituya base64EncodedImage por la imagen codificada en Base64 (es decir, el contenido deoutput.txt de uno de los comandos anteriores).

P5. ¿Existe algún límite en el contenido que puedo incluir en las plantillas de correo electrónico deverificación personalizado?

Las plantillas de correo electrónico de verificación personalizado no pueden tener más de 10 MB. Además,las plantillas de correo electrónico de verificación personalizado que contienen HTML solo pueden utilizarlas etiquetas y atributos que se muestran en la siguiente tabla:

Etiqueta HTML Atributos permitidos

abbr class, id, style, title

acronym class, id, style, title

address class, id, style, title

area class, id, style, title

b class, id, style, title

bdo class, id, style, title

big class, id, style, title

blockquote cite, class, id, style, title

body class, id, style, title

55



br class, id, style, title

button class, id, style, title

caption class, id, style, title

center class, id, style, title

cite class, id, style, title

code class, id, style, title

col class, id, span, style, title, width

colgroup class, id, span, style, title, width

dd class, id, style, title

del class, id, style, title

dfn class, id, style, title

dir class, id, style, title

div class, id, style, title

dl class, id, style, title

dt class, id, style, title

em class, id, style, title

fieldset class, id, style, title

font class, id, style, title

form class, id, style, title

h1 class, id, style, title






head class, id, style, title

hr class, id, style, title

html class, id, style, title

i class, id, style, title

img align, alt, class, height, id, src,style, title, width

56



input class, id, style, title

ins class, id, style, title

kbd class, id, style, title

label class, id, style, title

legend class, id, style, title

li class, id, style, title

map class, id, style, title

menu class, id, style, title

ol class, id, start, style, title, type

optgroup class, id, style, title

option class, id, style, title

p class, id, style, title

pre class, id, style, title

q cite, class, id, style, title

s class, id, style, title

samp class, id, style, title

select class, id, style, title

small class, id, style, title

span class, id, style, title

strike class, id, style, title

strong class, id, style, title

sub class, id, style, title

sup class, id, style, title

table class, id, style, summary, title,width

tbody class, id, style, title

td abbr, axis, class, colspan, id,rowspan, style, title, width

textarea class, id, style, title

tfoot class, id, style, title

th abbr, axis, class, colspan, id,rowspan, scope, style, title, width

57



thead class, id, style, title

tr class, id, style, title

tt class, id, style, title

u class, id, style, title

ul class, id, style, title, type

var class, id, style, title

P6. ¿Cuántas direcciones de correo electrónico verificadas pueden existir en mi cuenta?

Su cuenta de Amazon SES puede tener hasta 10 000 identidades verificadas en cada región de AWS.En Amazon SES las identidades incluyen dominios y direcciones de correo electrónico verificados. Si haverificado los dominios o las direcciones de correo electrónico para su propio envío de correo electrónico,estas identidades se incluyen en el límite de 10 000 de su identidad.

P7. ¿Puedo crear plantillas de correo electrónico de verificación personalizado mediante laconsola de Amazon SES?

Actualmente, solo es posible crear, editar y eliminar los mensajes de correo electrónico de verificaciónpersonalizados mediante la API de Amazon SES.

P8. ¿Puedo realizar un seguimiento de los eventos "open" y "click" que se producen cuando losclientes reciben mensajes de correo electrónico de verificación personalizados?

Los mensajes de correo electrónico de verificación personalizados no pueden incluir un seguimiento de loseventos "open" o "click".

P9. ¿Pueden los mensajes de correo electrónico de verificación personalizados incluirencabezados personalizados?

Los mensajes de correo electrónico de verificación personalizados no pueden incluir encabezadospersonalizados.

P10. ¿Puedo eliminar el texto que aparece en la parte inferior de los mensajes de correoelectrónico de verificación personalizados?

El siguiente texto se añade automáticamente al final de cada mensaje de correo de verificaciónpersonalizado y no se puede eliminar:

If you did not request to verify this email address, please disregard this message. If you have any concerns,please forward this message to the following email address along with your questions or comments.

El enlace dirección de correo electrónico de este texto hace referencia a [email protected],un buzón de entrada supervisado activamente por el equipo de Amazon SES.

P11. ¿Están los mensajes de correo electrónico de verificación personalizados firmados conDKIM?

Para que los mensajes de correo electrónico de verificación se firmen con DKIM, la dirección de correoelectrónico que especifique en el atributo FromEmailAddress al crear la plantilla de correo electrónicode verificación debe configurarse para generar una firma DKIM. Para obtener más información sobre

58

mailto:[email protected]



cómo configurar DKIM para los dominios y direcciones de correo electrónico, consulte the section called“Autenticación de correo electrónico con DKIM” (p. 126).

P12. ¿Por qué no aparecen las operaciones del API de la plantilla de correo electrónico deverificación personalizada en el SDK o en la CLI?

Si no puede utilizar las operaciones de la plantilla de correo electrónico de verificación personalizada enuna SDK o en la AWS CLI, es posible que esté utilizando una versión más antigua del SDK o de la CLI.Las operaciones de la plantilla de correo electrónico de verificación personalizada están disponibles en lossiguientes SDK y CLI:

• Versión 1.14.6 o posterior de la AWS Command Line Interface• Versión 3.3.205.0 o posterior del AWS SDK para .NET• Versión 1.3.20170531.19 o posterior del AWS SDK para C++• Versión 1.12.43 o posterior del AWS SDK for Go• Versión 1.11.245 o posterior del AWS SDK for Java• Versión 2.166.0 o posterior del AWS SDK for JavaScript• Versión 3.45.2 o posterior del AWS SDK para PHP• Versión 1.5.1 o posterior del AWS SDK for Python (Boto)• Version 1.5.0 o posterior de la gema aws-sdk-ses en el AWS SDK parar Ruby

Verificación de dominios en Amazon SESAmazon SES debe verificar su dirección de correo electrónico o dominio, para confirmar que es de supropiedad e impedir que otras personas los utilicen. Al verificar un dominio completo, está verificando todaslas direcciones de correo electrónico de dicho dominio, por lo que no tiene que verificar las direcciones decorreo electrónico desde dicho dominio individualmente. Por ejemplo, si verifica el dominio example.com,puede enviar correo electrónico desde [email protected], [email protected] o desde cualquierotro usuario de example.com.

Puede administrar sus dominios verificados utilizando la consola de Amazon SES, el API de AmazonSES. Para obtener una descripción completa de las acciones del API relacionadas con la verificación dedominios, acceda a la Amazon Simple Email Service API Reference. En esta sección, que demuestra lasacciones utilizando la consola de Amazon SES, contiene los siguientes temas:

• Verificación de un dominio con Amazon SES (p. 60)• Listado de las identidades de dominio en Amazon SES (p. 61)• Eliminación de una identidad de dominio en Amazon SES (p. 62)• Revocación de verificación de dominio de Amazon SES (p. 62)• Registros TXT de verificación de dominio de Amazon SES (p. 62)

A continuación se indican algunas notas importantes sobre la verificación de dominio:

• Amazon SES tiene puntos de enlace en varias regiones de AWS y la verificación de dominio se aplicaa cada región de AWS por separado. Debe realizar el procedimiento de verificación de todo el dominiopara cada región en la que desee enviar desde un determinado dominio. Si desea verificar el mismodominio en varias regiones y su proveedor de DNS no le permite tener varios registros TXT con el mismonombre, consulte las soluciones a problemas que se indican en Problemas comunes de verificación dedominio (p. 459).

• Si verifica un dominio con Amazon SES, puede enviar desde cualquier subdominio de dicho dominio sinverificar específicamente el subdominio. Por ejemplo, si verifica example.com, no es necesario verificara.example.com o a.b.example.com. Tal como se especifica en RFC 1034, cada etiqueta DNS puede

59


https://tools.ietf.org/html/rfc1034#section-3.6


tener hasta 63 caracteres y el nombre de dominio completo no debe superar una longitud total de 255caracteres.

• Si verifica un dominio, subdominio o dirección de correo electrónico que compartan un dominio raíz,la configuración de identidad verificada (como las notificaciones de retroalimentación y Easy DKIM) seaplican al nivel más detallado que haya verificado. Es decir:• La configuración de dirección de correo electrónico verificada anula la configuración de dominio

verificado.• La configuración de subdominio verificado anula la configuración de dominio verificado, las

configuraciones de subdominio de nivel inferior anulan las configuraciones de subdominio de nivelsuperior.

Por ejemplo, imagine que verifica [email protected], a.b.example.com, b.example.com yexample.com. Esta es la configuración de identidad verificada que se utilizará en los siguientes casos:• Los correos electrónicos enviados desde [email protected] (una dirección que no se ha verificado

específicamente) utilizarán la configuración para example.com.• Los correos electrónicos enviados desde [email protected] (una dirección que se ha

verificado específicamente) utilizarán la configuración para [email protected].• Los correos electrónicos enviados desde [email protected] (una dirección que no se ha verificado

específicamente) utilizarán la configuración para b.example.com.• Los nombres de dominio no distinguen entre mayúsculas y minúsculas. Si verifica example.com, puede

enviar desde EXAMPLE.com también.• En cada región de AWS, puede verificar hasta 10 000 identidades (dominios y direcciones de correo

electrónico en cualquier combinación).

Verificación de un dominio con Amazon SES

En el siguiente procedimiento se muestra cómo verificar un dominio utilizando la consola de AmazonSES. Si desea utilizar el API de Amazon SES en su lugar, consulte el Amazon Simple Email Service APIReference.

Para verificar un dominio

1. Acceda a su lista de dominios verificados en la consola de Amazon SES o siga estas instruccionespara acceder a la misma:

a. Inicie sesión en Consola de administración de AWS y abra la consola de Amazon SES en https://console.aws.amazon.com/ses/.

b. En el panel de navegación, en Identity Management, elija Domains.2. Elija Verify a New Domain.3. En el cuadro de diálogo Verify a New Domain, introduzca el nombre de dominio. Si desea configurar

la firma de DKIM para este dominio, seleccione la opción Generate DKIM Settings. (Para obtener másinformación acerca de la forma de DKIM, consulte Autenticación de correo electrónico con DKIM enAmazon SES (p. 126)). Elija Verify This Domain.

4. En el cuadro de diálogo Verify a New Domain, verá un Domain Verification Record Set que contieneun nombre Name, un tipo Type y un valor Value. (Esta información también estará disponible eligiendoel nombre de dominio después de cerrar el cuadro de diálogo).

Para completar la verificación de dominio, añada un registro TXT con el Name y Value mostrado parael servidor DNS de su dominio. Para obtener más información sobre los registros TXT de AmazonSES y orientación general sobre cómo añadir un registro TXT a un servidor DNS, consulte RegistrosTXT de verificación de dominio de Amazon SES (p. 62). En particular:

• Si su proveedor de DNS no permite guiones bajos en los nombres de registro, puede omitir_amazonses desde el valor Name.

60



https://console.aws.amazon.com/ses/home?#verified-senders-domain:




• Para ayudarle a identificar fácilmente este registro con la configuración DNS de su dominio, puedeutilizar en Value opcionalmente el prefijo amazonses:

• Algunos proveedores de DNS anexan automáticamente el nombre de dominio a los nombres deregistro DNS. Para evitar la duplicación del nombre de dominio, puede agregar un punto al finaldel nombre de dominio en el registro DNS. Esto indica que el nombre de registro es completo y elproveedor de DNS no tiene que anexar un nombre de dominio adicional.

5. Si Route 53 proporciona el servicio DNS para el dominio que está verificando e inicia sesión en laConsola de administración de AWS en la misma cuenta que utiliza para Route 53, entonces AmazonSES le ofrecerá la opción de actualizar su servidor DNS de inmediato desde la consola de AmazonSES. Si no va a utilizar Route 53, Amazon SES tiene que verificar que un registro TXT con el Name yValue especificados se ha añadido al servidor DNS de su dominio. Esto puede tardar hasta 72 horas.

Cuando se ha completado la verificación, el estado del dominio en la consola de Amazon SEScambiará de "verificación pendiente" a "verificado" y recibirá un correo electrónico de confirmacióncorrecta desde Amazon SES en la dirección de correo electrónico asociada a su cuenta de AWS.

6. A partir de ahora, puede utilizar Amazon SES para enviar correo electrónico desde cualquier direcciónen el dominio verificado. Para enviar un correo electrónico de prueba, marque la casilla junto a undominio verificado y, a continuación, elija Send a Test Email.

Si la configuración DNS no se ha actualizado correctamente, recibirá un correo electrónico de error deverificación de dominio de Amazon SES y el dominio mostrará un estado de "error" en la pestaña Domains.Si esto ocurre, lea nuestra página de resolución de problemas en Problemas de verificación de direcciónde correo electrónico y dominios de Amazon SES (p. 458). Cuando haya comprobado que su registroTXT está correctamente, elija el enlace "retry" que aparece junto a la notificación de estado con "error".Esto reiniciará el proceso de verificación del dominio.

Listado de las identidades de dominio en Amazon SESPara ver los dominios verificados, siga el procedimiento siguiente.

Para ver los dominios verificados


61




b. En el panel de navegación, en Identity Management, elija Domains.2. En la lista de dominios verificados, puede ampliar uno o varios dominios para ver los detalles.

Eliminación de una identidad de dominio en Amazon SES

Para quitar un dominio verificado, siga este procedimiento.

Para quitar un dominio verificado



b. En el panel de navegación, en Identity Management, elija Domains.2. Marque la casilla junto a cada dominio que desee quitar y, a continuación, seleccione Remove.3. Ya no podrá enviar correo electrónico desde el dominio quitado.

Revocación de verificación de dominio de Amazon SES

Amazon SES revisa periódicamente el estado de verificación del dominio y revoca la verificación cuandoesta deja de ser válida. Si Amazon SES no puede detectar la información de registro TXT necesaria paraconfirmar la propiedad de un dominio, recibirá un correo electrónico Amazon SES Domain VerificationREVOCATION WARNING de Amazon SES.

Si restaura la información de registro TXT al servidor DNS de su dominio en un plazo de 72 horas, recibiráun correo electrónico Amazon SES Domain Verification REVOCATION CANCELLATION desde AmazonSES.

Note

Puede revisar la información de registro TXT necesaria en la consola de Amazon SES utilizandolas siguientes instrucciones. En el panel de navegación, en Identity Management, elija Domains.En la lista de dominios, elija (no solo amplíe) el dominio para mostrar la configuración deverificación del dominio, que incluye el nombre de registro TXT y su valor.

Si no restaura la información de registro TXT al servidor DNS de su dominio en un plazo de 72 horas,recibirá un correo electrónico Amazon SES Domain Verification REVOCATION de Amazon SES, eldominio se quitará de la lista Verified Senders en la pestaña Domains y ya no podrá enviar desde eldominio.

Para volver a verificar un dominio para el que se ha anulado la verificación, debe reiniciar el procedimientode verificación desde el principio, como si el dominio se revocado fuera un dominio completamente nuevo.

Registros TXT de verificación de dominio de Amazon SES

Su dominio está asociado a un conjunto de registros de sistema de nombres de dominio (DNS) queadministra a través de su proveedor de DNS. Un registro TXT es un tipo de registro DNS que proporcionainformación adicional acerca de su dominio. Cada registro TXT consta de un nombre y un valor.

Cuando se inicia la verificación de dominio mediante la consola o el API de Amazon SES, Amazon SES leofrece el nombre y valor que utilizar para el registro TXT. Por ejemplo, si su dominio es example.com, laconfiguración de registro TXT que genera Amazon SES tendrá un aspecto similar al siguiente ejemplo:

62







Nombre Tipo Valor

_amazonses.example.com TXT pmBGN/7MjnfhTKUZ06Enqq1PeGUaOkw8lGhcfwefcHU=

Añadir un registro TXT a su servidor DNS del dominio utilizando los valores Name y Value especificados.La verificación de dominio de Amazon SES se completa cuando Amazon SES detecta la existencia delregistro TXT en la configuración de DNS de su dominio.

Si su proveedor de DNS no permite guiones bajos en los nombres de registro DNS, puedeomitir _amazonses en el valor Name. En ese caso, en el ejemplo anterior, el nombre deregistro TXT sería example.com en lugar de _amazonses.example.com. Para que el registrosea más fácil de reconocer y de mantener, también puede utilizar opcionalmente el prefijoValue con amazonses:. En el ejemplo anterior, el valor del registro TXT sería por tantoamazonses:pmBGN/7MjnfhTKUZ06Enqq1PeGUaOkw8lGhcfwefcHU=.

Note

Amazon SES anteriormente permitía que los nombres de registro TXT contuvieran amazonsessin guion bajo. Si ya ha verificado un dominio y su registro TXT contiene amazonses sin un guionbajo, su dominio seguirá verificado; no es necesario que haga nada. Sin embargo, los nuevosdominios que verifique exigirán que amazonses en el nombre de registro TXT vaya precedido deun guion bajo o _amazonses se elimina del nombre de registro TXT en su totalidad.

Puede encontrar información de resolución de problemas e instrucciones sobre cómo comprobar suconfiguración de verificación de dominio en Problemas de verificación de dirección de correo electrónico ydominios de Amazon SES (p. 458).

Añadir un registro TXT al servidor DNS de su dominio

El procedimiento para añadir registros TXT al servidor DNS de su dominio depende de quien proporcionesu servicio DNS. El proveedor de DNS podría ser Amazon Route 53 u otro registrador de nombres dedominio como GoDaddy. En esta sección se proporcionan procedimientos para agregar un registro TXT aRoute 53, así como procedimientos genéricos que se aplican a otros proveedores de DNS.

Procedimientos para Amazon Route 53

Al iniciar el proceso de verificación de un nuevo dominio (p. 60) para usarlo con Amazon SES, puedeagregar automáticamente el registro TXT de verificación de dominio a su configuración de Route 53. Sinembargo, si decide agregar el registro TXT automáticamente, puede agregarlo a su configuración de Route53 manualmente siguiendo el procedimiento que se describe en esta sección.

Para añadir un registro TXT al registro de DNS de dominio administrado por Route 53

1. Abra la consola de Amazon SES en https://console.aws.amazon.com/ses/.2. En Identity Management (Administración de identidades), elija Domains (Dominios).3. Elija el dominio que desea verificar.4. Amplíe la sección Verification (Verificación). Copie el valor que se muestra junto a TXT Value (Valor de

TXT).5. Abra la consola de Route 53 en https://console.aws.amazon.com/route53/.6. En el panel de navegación, elija Hosted Zones.7. Seleccione el dominio al que desea agregar un registro TXT y, a continuación, elija Go to Record Sets

(Ir a conjuntos de registros).8. Luego, Create Record Set.9. En el panel Create Record Set (Crear conjunto de registros), seleccione las siguientes opciones:

63


https://console.aws.amazon.com/route53/

Amazon Simple Email Service Developer GuideObtener sus claves de acceso de AWS

a. En Name (Nombre), escriba _amazonses.b. En Type (Tipo), seleccione TXT – Text (TXT: texto).c. En TTL (Seconds) (TTL [segundos]), escriba 1800.d. En Value (Valor), pegue el valor de registro TXT que copió de la consola de Amazon SES.e. Seleccione Create.

10. En la página Domains (Dominios) en la consola de Amazon SES, compruebe el valor dela columna Status (Estado) junto al dominio que acaba de intentar verificar. Si el estado es"pending verification" (verificación pendiente), espere unos minutos más y, a continuación, elijarefresh (actualizar) ( ). Repita este proceso hasta que el valor de la columna de estado sea"verified" (verificado).

Procedimientos genéricos para otros proveedores de DNS

Los procedimientos para agregar registros TXT a las configuraciones DNS varían de proveedor a otro.Para conocer los pasos específicos, consulte la documentación de su proveedor de DNS. El procedimientode esta sección ofrece información general básica de los pasos que debe seguir para agregar un registroTXT a la configuración de DNS de su dominio.

Para añadir un registro TXT al servidor DNS de su dominio (procedimiento general)

1. Vaya a la página web de su proveedor de DNS. Si no está seguro de qué proveedor de DNS sirve a sudominio, puede buscar un servicio Whois gratuito.

2. En el sitio web del proveedor, inicie sesión en su cuenta.3. Busque la página para actualizar los registros DNS de su dominio. Esta página a menudo tiene un

nombre como, por ejemplo, DNS Records, DNS Zone File o Advanced DNS. Si no está seguro,consulte la documentación del proveedor.

4. Añada un registro TXT con el nombre y valor proporcionado por Amazon SES.

Important

Algunos proveedores de DNS añaden automáticamente el nombre de dominio al final de losregistros DNS. Añadir un registro que ya contiene el nombre de dominio (como, por ejemplo_amazonses.example.com) podría dar lugar a la duplicación del nombre de dominio (como,por ejemplo _amazonses.example.com.example.com). Para evitar la duplicación del nombrede dominio, añada un punto al final del nombre de dominio en el registro DNS. Esto indicará asu proveedor de DNS que el nombre de registro es completo (es decir, ya no está relacionadocon el nombre de dominio) y evitará que el proveedor de DNS anexe un nombre de dominioadicional.

5. Guarde los cambios. Las actualizaciones de registro DNS pueden tardar hasta 48 horas en surtirefecto, pero suelen hacerlo a menudo mucho antes. Puede comprobar que el registro TXT estápublicado correctamente utilizando el procedimiento en Cómo comprobar la configuración de laverificación de dominios (p. 460).

Obtener sus claves de acceso de AWSDespués de haberse inscrito en Amazon SES tendrá que obtener sus claves de acceso de AWS sidesea acceder a Amazon SES a través del API de Amazon SES, ya sea directamente por la interfaz deconsulta (HTTPS) o indirectamente a través de un SDK de AWS, el AWS Command Line Interface o laHerramientas de AWS para Windows PowerShell. Las claves de acceso de AWS constan de un ID declave de acceso y una clave de acceso secreta.

Para obtener información sobre cómo obtener sus claves de acceso de AWS, consulte AWS SecurityCredentials en la AWS General Reference.

64

http://www.google.com/search?aq=f&hl=en&q=whois+free&btnG=Search




https://docs.aws.amazon.com/general/latest/gr/aws-security-credentials.html


Amazon Simple Email Service Developer GuideDescarga de un SDK de AWS

Descarga de un SDK de AWSSi desea usar la API de Amazon SES sin tratar con detalles de bajo nivel, como el ensamblaje desolicitudes HTTP sin procesar, puede utilizar un SDK de AWS. Los SDK de AWS ofrecen funciones y tiposde datos que incorporan la funcionalidad de Amazon SES y otros servicios de AWS. Para descargar unSDK de AWS, consulte SDK.

La sección de introducción de esta guía proporciona ejemplos de cómo enviar un correo electrónicomediante los SDK de AWS para diversos lenguajes de programación. Para obtener más información,consulte Enviar un correo electrónico a través de Amazon SES mediante un SDK de AWS (p. 30).

Uso de un dominio MAIL FROM personalizado conAmazon SESCuando se envía un correo electrónico, tiene dos direcciones que indican su origen: una dirección deprocedencia From en el encabezado de correo electrónico y una dirección MAIL FROM que el servidor decorreo de envío especifica al servidor de correo electrónico receptor para indicar el origen del mensaje. Ladirección MAIL FROM recibe a veces el nombre de envelope sender, envelope from, bounce address oReturn Path.

Cuando los destinatarios ven un correo electrónico en su bandeja de entrada, ven la dirección From delcorreo electrónico. En cambio, la dirección MAIL FROM, que utilizan los servidores de correo electrónicopara devolver mensajes de rebote y otras notificaciones de error, solo suelen verla los destinatarios siinspeccionan los encabezados de correo electrónico en el origen de mensaje sin procesar. Amazon SESestablece el dominio MAIL FROM en un valor predeterminado, a menos que decida utilizar el suyo propio.

Razones para utilizar un dominio MAIL FROM personalizadoDe forma predeterminada, los mensajes que envíe a través de Amazon SES utilizan amazonses.com (o unsubdominio del mismo) como dominio MAIL FROM. La autenticación de marco de directivas de remitente(SPF) valida correctamente estos mensajes ya que el dominio MAIL FROM predeterminado coincide con elservidor de correo de envío, Amazon SES. Aunque este nivel de autenticación es suficiente para muchosremitentes, es posible que desee establecer el dominio MAIL FROM en un dominio de su propiedadpara permitir que sus correos electrónicos se autentiquen con Domain-based Message Authentication,Reporting and Conformance (DMARC) a través de SPF, lo que requiere una comprobación adicional paraalineación de dominio de SPF. DMARC permite que el dominio de un remitente indique, utilizando unregistro de DNS, que sus correos electrónicos están protegidos mediante SPF, DomainKeys Identified Mail(DKIM) o ambos.

Existen dos maneras de conseguir la validación de DMARC: utilizando SPF y utilizando DKIM. A menosque use su propio dominio MAIL FROM, no puede conseguir la validación DMARC mediante SPF, ya quela validación requiere que el dominio de la dirección From coincida con el dominio MAIL FROM. Al utilizarsu propio dominio MAIL FROM, dispone de la flexibilidad necesaria para utilizar SPF, DKIM o ambospara conseguir la validación de DMARC. Para obtener más información, consulte Autenticación de correoelectrónico con SPF (p. 124).

Elección de un dominio MAIL FROMSi elige utilizar su propio dominio MAIL FROM con Amazon SES, el dominio que use debe cumplir lossiguientes requisitos:

• El dominio MAIL FROM debe ser un subdominio de la identidad verificada (dirección de correoelectrónico o dominio) desde el que enviará los mensajes de correo electrónico. Por ejemplo,mail.example.com es un dominio MAIL FROM válido para la dirección de correo electró[email protected] o el dominio example.com.

65


Amazon Simple Email Service Developer GuideUso de un dominio MAIL FROM personalizado

• En la mayoría de los casos, el dominio MAIL FROM no debe ser un dominio desde el que envíe correoelectrónico. Si debe utilizar el dominio MAIL FROM en una dirección From, deshabilite el reenvíode retroalimentación de correo electrónico (p. 238) y reciba sus rebotes a través de notificacionesde Amazon SNS o asegúrese de que su dominio MAIL FROM no sea el destino del reenvío deretroalimentación. Para determinar el destino de la retroalimentación de reenvío de correo electrónico,consulte Destino de reenvío de retroalimentación de correo electrónico (p. 239).

• El dominio MAIL FROM no debe ser un dominio que utilice para recibir correo electrónico.

Proceso de configuraciónPara definir el dominio MAIL FROM para una identidad verificada, configure la identidad verificadautilizando la consola de Amazon SES o el API y publique un registro de MX (y, de forma opcional, unregistro SPF) en el servidor DNS de su dominio MAIL FROM. Si en algún momento que desea volver autilizar el dominio MAIL FROM de Amazon SES predeterminado, puede eliminar su dominio MAIL FROMde la configuración de identidad verificada. Estos procedimientos se describen en las siguientes secciones:

• Configuración de un dominio MAIL FROM (p. 66)• Eliminación de un dominio MAIL FROM (p. 68)• Edición de un dominio MAIL FROM (p. 69)

Para obtener una descripción de los estados de configuración de dominio MAIL FROM personalizados,consulte Estados de configuración de dominio MAIL FROM (p. 70).

Configuración de un dominio MAIL FROM con Amazon SESEste tema contiene los procedimientos para configurar un dominio MAIL FROM mediante la consola deAmazon SES.

Note

Puede usar la misma dirección MAIL FROM en varias regiones de AWS. Para obtener másinformación, consulte Regiones y Amazon SES (p. 439).

Configuración del dominio MAIL FROM

Los siguientes procedimientos muestran cómo utilizar la consola de Amazon SES para configurar undominio o dirección de correo electrónico verificados para enviar correos electrónicos a través de undominio MAIL FROM especificado. También puede configurar un dominio MAIL FROM mediante laoperación de API SetIdentityMailFromDomain. Para obtener más información, consulte AmazonSimple Email Service API Reference.

Para configurar una dirección de correo electrónico verificada para utilizar un dominio MAIL FROMespecificado


2. En el panel de navegación, en Identity Management, elija Email Addresses.3. En la lista de direcciones de correo electrónico verificadas, confirme que el estado de la dirección de

correo electrónico para la que desea definir el dominio MAIL FROM es verified. Si el estado es failure,elija retry y, a continuación, haga clic en el enlace dentro del correo electrónico de verificación quereciba en su cliente de correo electrónico. De lo contrario, elija la dirección de correo electrónico yvaya al paso siguiente.

4. En el panel de detalles de la dirección de correo electrónico verificada, expanda MAIL FROM Domain.5. Elija Set MAIL FROM Domain.

66






6. En el cuadro de diálogo Set MAIL FROM Domain, escriba el nombre del dominio MAIL FROM quedesea utilizar. Tenga en cuenta que debe ser un subdominio del dominio de la dirección de correoelectrónico verificada, como mail.example.com.

7. En Behavior if MX record not found, elija una de las siguientes opciones:

• Utilice region.amazonses.com como MAIL FROM: si el registro MX del dominio MAIL FROMpersonalizado no se ha configurado correctamente, Amazon SES utilizará un subdominio deamazonses.com. El subdominio varía en función de la región de AWS en la que utiliza AmazonSES.

• Rechazar mensaje: si el registro MX del dominio MAIL FROM personalizado no está correctamenteconfigurado, Amazon SES devolverá un error MailFromDomainNotVerified. Los mensajes decorreo electrónico que intente enviar desde esta dirección se rechazarán automáticamente.

8. Elija Set MAIL FROM Domain. Aparece una ventana que contiene los registros MX y SPF que debeañadir a la configuración de DNS del dominio. Anote estos valores y vaya al paso siguiente.

9. Publique el registro MX en el servidor DNS del dominio MAIL FROM personalizado.

Important

Si la configuración de DNS del dominio MAIL FROM contiene varios registros MX, laconfiguración de MAIL FROM personalizada con Amazon SES producirá un error.

a. Si Route 53 proporciona el servicio DNS para su dominio MAIL FROM y ha iniciado sesión enla Consola de administración de AWS en la misma cuenta que utiliza para Route 53, entonceselija Publish Records Using Route 53. El registro MX adecuado se aplica automáticamente a laconfiguración de DNS de su dominio.

b. Si su dominio MAIL FROM no utiliza Route 53, entonces debe publicar el registro MX mostradoen el servidor DNS del dominio MAIL FROM usted mismo. El procedimiento para añadir unregistro MX al servidor DNS del dominio varía en función del servicio de alojamiento web o de suproveedor de DNS; consulte la documentación para obtener más información.

Después de que Amazon SES detecte el registro, los mensajes de correo electrónico queenvíe desde esta dirección de correo electrónico verificada utilizarán el dominio MAIL FROMespecificado. Hasta entonces, Amazon SES utilizará el dominio MAIL FROM predeterminado orechazará el mensaje, en función de las preferencias que haya especificado anteriormente eneste procedimiento. Amazon SES puede tardar hasta 72 horas en detectar el registro MX.

10. Publique un registro SPF en el servidor DNS del dominio MAIL FROM para mostrar la recepción de losservidores de correo electrónico para los que ha permitido a Amazon SES enviar correo electrónicoen nombre de su dominio. Para obtener más información, consulte Autenticación de correo electrónicocon SPF en Amazon SES (p. 124).

Para configurar un dominio verificado para utilizar un dominio MAIL FROM especificado


2. En el panel de navegación, en Identity Management, elija Domains.3. En la lista de direcciones de dominios verificados, confirme que el estado del dominio para la que

desea definir el dominio MAIL FROM es verified. Si el estado es failure, elija retry y, a continuación,añada el registro TXT mostrado en su servidor de DNS, tal como se describe en Registros TXT deverificación de dominio de Amazon SES (p. 62). De lo contrario, elija la dirección del dominio ycontinúe con este procedimiento.

4. En el panel de detalles de la dirección de dominio verificada, expanda MAIL FROM Domain.5. Elija Set MAIL FROM Domain.6. En el cuadro de diálogo Set MAIL FROM Domain, escriba el nombre del dominio MAIL FROM

que desea utilizar. Tenga en cuenta que debe ser un subdominio del dominio verificado, comomail.example.com.

67




7. En Behavior if MX record not found, elija una de las siguientes opciones:

• Utilice region.amazonses.com como MAIL FROM: si el registro MX del dominio MAIL FROMpersonalizado no se ha configurado correctamente, Amazon SES utilizará un subdominio deamazonses.com. El subdominio varía en función de la región de AWS en la que utiliza AmazonSES.

• Rechazar mensaje: si el registro MX del dominio MAIL FROM personalizado no está correctamenteconfigurado, Amazon SES devolverá un error MailFromDomainNotVerified. Los mensajes decorreo electrónico que intente enviar desde esta dirección se rechazarán automáticamente.

8. Elija Set MAIL FROM Domain.9. A continuación, publique un registro MX para el servidor DNS del dominio MAIL FROM personalizado.

Important

Para configurar correctamente un dominio MAIL FROM personalizado con Amazon SES,debe publicar exactamente un registro MX en el servidor DNS de su dominio MAIL FROM. Siel dominio MAIL FROM tiene varios registros MX, la configuración MAIL FROM personalizadacon Amazon SES devolverá un error.


b. Si su dominio MAIL FROM no utiliza Route 53, entonces debe publicar el registro MX mostradoen el servidor DNS del dominio MAIL FROM usted mismo. El procedimiento para añadir unregistro MX al servidor DNS del dominio varía en función del servicio de alojamiento web o de suproveedor de DNS; consulte la documentación para obtener más información.


10. Publique un registro SPF en el servidor DNS del dominio MAIL FROM para mostrar la recepción de losservidores de correo electrónico para los que ha permitido a Amazon SES enviar correo electrónicoen nombre de su dominio. Para obtener más información, consulte Autenticación de correo electrónicocon SPF en Amazon SES (p. 124).

Eliminación de un dominio MAIL FROM con Amazon SESSi desea utilizar el dominio MAIL FROM de Amazon SES predeterminado, puede eliminar la configuracióndel dominio MAIL FROM personalizada de la identidad verificada.

Los siguientes procedimientos muestran cómo utilizar la consola de Amazon SES para eliminarun dominio MAIL FROM personalizado desde la configuración de un dominio o una dirección decorreo electrónico verificados. Si desea utilizar el API de Amazon SES en su lugar, consulte el APISetIdentityMailFromDomain en la Amazon Simple Email Service API Reference.

Para eliminar un dominio MAIL FROM personalizado de la configuración de una dirección decorreo electrónico verificada


2. En el panel de navegación, en Identity Management, elija Email Addresses.3. En la lista de direcciones de correo electrónico verificadas, elija la dirección de correo electrónico

verificada para la que desea eliminar el dominio MAIL FROM personalizado.

68





4. En el panel de detalles de la dirección de correo electrónico verificada, expanda MAIL FROM Domain.5. Elija Remove MAIL FROM Domain.6. Elija Yes, Remove MAIL FROM Domain.7. (Opcional) Inicie sesión en su servicio de DNS y elimine el registro de MX que publicó al configurar el

dominio MAIL FROM con Amazon SES.8. (Opcional) Elimine el registro SPF que publicó al configurar el dominio MAIL FROM personalizado con

Amazon SES.

Para eliminar un dominio MAIL FROM personalizado de la configuración de un dominio verificado


2. En el panel de navegación, en Identity Management, elija Domains.3. En la lista de dominios verificados, elija el dominio verificado para el que desea eliminar el dominio

MAIL FROM personalizado.4. En el panel de detalles de la dirección de dominio verificada, expanda MAIL FROM Domain.5. Elija Remove MAIL FROM Domain.6. Elija Yes, Remove MAIL FROM Domain.7. (Opcional) Inicie sesión en su servicio de DNS y elimine el registro de MX que publicó al configurar el

dominio MAIL FROM con Amazon SES.8. (Opcional) Elimine el registro SPF que publicó al configurar el dominio MAIL FROM personalizado con

Amazon SES.

Edición de un dominio MAIL FROM con Amazon SESLos siguientes procedimientos muestran cómo utilizar la consola de Amazon SES para editarla configuración de dominio MAIL FROM personalizado del dominio o de la dirección de correoelectrónico verificados. Si desea utilizar el API de Amazon SES en su lugar, consulte el APISetIdentityMailFromDomain en la Amazon Simple Email Service API Reference.

Para editar la configuración de MAIL FROM de una dirección de correo electrónico verificada


2. En el panel de navegación, en Identity Management, elija Domains.3. En la lista de direcciones de correo electrónico verificadas, elija la dirección de correo electrónico para

la que desea configurar el dominio MAIL FROM.4. En el panel de detalles de la dirección de correo electrónico verificada, expanda MAIL FROM Domain.5. Elija Edit MAIL FROM Domain.6. En el cuadro de diálogo Edit MAIL FROM Domain, edite la configuración y, a continuación, elija Save

MAIL FROM Domain.7. Si ha cambiado el nombre de dominio MAIL FROM al editar la configuración, deberá publicar un

registro MX en el servidor DNS del nuevo dominio MAIL FROM.


b. Si su dominio MAIL FROM no utiliza Route 53, entonces debe publicar el registro MX mostradoen el servidor DNS del dominio MAIL FROM usted mismo. El procedimiento para añadir un

69







registro MX al servidor DNS del dominio varía en función del servicio de alojamiento web o de suproveedor de DNS; consulte la documentación para obtener más información.


8. (Opcional) Si ha cambiado el nombre de dominio de MAIL FROM y desea que las comprobaciones delmarco de directivas de remitente (SPF) se superen correctamente, deberá publicar un registro SPF enel servidor de DNS de su dominio MAIL FROM para mostrar a los servidores de correo receptores queha autorizado a Amazon SES enviar correo electrónico en nombre de su dominio. Para obtener másinformación, consulte Autenticación de correo electrónico con SPF en Amazon SES (p. 124).

Para editar la configuración de MAIL FROM de un dominio verificado


2. En el panel de navegación, en Identity Management, elija Domains.3. En la lista de dominios verificados, elija el dominio para el que desea configurar el dominio MAIL

FROM.4. En el panel de detalles de la dirección de dominio verificada, expanda MAIL FROM Domain.5. Elija Edit MAIL FROM Domain.6. En el cuadro de diálogo Edit MAIL FROM Domain, edite la configuración y, a continuación, elija Save

MAIL FROM Domain.7. Si ha cambiado el nombre de dominio MAIL FROM al editar la configuración, deberá publicar un

registro MX en el servidor DNS del nuevo dominio MAIL FROM.

a. Si Route 53 proporciona el servicio DNS para su dominio MAIL FROM y ha iniciado sesión enla Consola de administración de AWS en la misma cuenta que utiliza para Route 53, entonceselija Publish Records Using Route 53 si desea publicar el registro MX o el registro SPF desde elinterior de la consola de Amazon SES.

b. Si su dominio no utiliza Route 53, entonces debe publicar el registro MX mostrado en el servidorDNS del dominio MAIL FROM usted mismo. El procedimiento para añadir un registro MX enel servidor DNS de su dominio depende de quién proporciona su servicio DNS; consulte ladocumentación para su servicio de DNS. Después de que Amazon SES detecte el registro, losmensajes de correo electrónico que envíe desde este dominio verificado utilizarán el dominioMAIL FROM especificado. Hasta entonces, Amazon SES utilizará el dominio MAIL FROMpredeterminado o rechazará el mensaje, en función de las preferencias que haya especificadoanteriormente en este procedimiento. Amazon SES puede tardar hasta 72 horas en detectar elregistro MX.

8. (Opcional) Si ha cambiado el nombre de dominio de MAIL FROM y desea que las comprobaciones delmarco de directivas de remitente (SPF) se superen correctamente, deberá publicar un registro SPF enel servidor de DNS de su dominio MAIL FROM para mostrar a los servidores de correo receptores queha autorizado a Amazon SES enviar correo electrónico en nombre de su dominio. Para obtener másinformación, consulte Autenticación de correo electrónico con SPF en Amazon SES (p. 124).

Estados de configuración de dominio MAIL FROM con AmazonSESDespués de configurar una identidad para utilizar un dominio MAIL FROM personalizado, el estado dela configuración es "pendiente" mientras Amazon SES intenta detectar el registro MX necesarios en su

70



Amazon Simple Email Service Developer GuideConfiguración de registros de SPF

configuración de DNS. El estado cambia a continuación, en función de si Amazon SES detecta el registroMX. En la siguiente tabla se describen los comportamientos de envío de correo electrónico y las accionesde Amazon SES asociadas a cada estado. Cada vez que el estado cambia, Amazon SES envía unanotificación a la dirección de correo electrónico asociada a su cuenta de AWS.

Estado Comportamiento de envío de correo electrónico Acciones deAmazon SES

Pendiente Utiliza una configuración alternativa de MAIL FROMpersonalizada

Amazon SESintenta detectarel registro MXnecesario durante72 horas. Si notiene éxito, elestado cambia a"Failed".

Correcto Utiliza dominio MAIL FROM personalizado Amazon SEScompruebacontinuamente queel registro MX estáen vigor.

TemporaryFailure Utiliza una configuración alternativa de MAIL FROMpersonalizada

Amazon SESintenta detectarel registro MXnecesario durante72 horas. Si notiene éxito, elestado cambiaa "Failed"; encaso de éxito, elestado cambia a"Success".

Error Utiliza una configuración alternativa de MAIL FROMpersonalizada

Amazon SES yano intenta detectarel registro MXnecesario. Parautilizar un dominioMAIL FROMpersonalizado,debe reiniciarel proceso deconfiguración enConfiguración deun dominio MAILFROM (p. 66).

Configuración de registros de SPF para Amazon SESUn registro SPF indica a los ISP que ha autorizado a Amazon SES a enviar correo para su dominio.Cuando utiliza Amazon SES, su decisión sobre si desea publicar un registro SPF depende de si su correoelectrónico solo requiere que su correo electrónico supere una comprobación SPF por parte del servidor decorreo electrónico receptor o si desea que su correo electrónico cumpla requisitos adicionales necesariospara transferir la autenticación Domain-based Message Authentication, Reporting and Conformance

71

Amazon Simple Email Service Developer GuideObtención de sus credenciales de SMTP

(DMARC) basada en SPF. Para obtener más información, consulte Autenticación de correo electrónico conSPF en Amazon SES (p. 124).

Obtener sus credenciales de SMTP para Amazon SESPara utilizar la interfaz SMTP de Amazon SES, primero debe crear un nombre de usuario y contraseñade SMTP. Para obtener sus credenciales SMTP, consulte Obtener sus credenciales de SMTP de AmazonSES (p. 75).

Important

Su nombre de usuario y contraseña de SMTP no son los mismos que su ID de clave de accesoy clave de acceso secreta de AWS. No intente usar sus credenciales de AWS para autenticarseen el punto de enlace SMTP de Amazon SES. Para obtener más información acerca de lascredenciales, consulte Uso de credenciales con Amazon SES (p. 393).

Salir del entorno de pruebas de Amazon SESPara ayudarle a evitar fraudes y abusos y para ayudarle a proteger su reputación como remitente,aplicamos determinadas restricciones a las cuentas nuevas de Amazon SES.

Colocamos todas las cuentas nuevas en el entorno de pruebas de Amazon SES. Mientras su cuenta seencuentre en el entorno de pruebas, puede utilizar todas las características de Amazon SES. Sin embargo,cuando su cuenta está en el entorno de pruebas, aplicamos las siguientes restricciones a la misma:

• Solo puede enviar correo a direcciones de correo electrónico y dominios verificados o al simulador debandeja de correo de Amazon SES (p. 173).

• Solo puede enviar correo desde direcciones de correo electrónico y dominios verificados.

Note

Esta restricción se aplica incluso cuando su cuenta no está en el entorno de pruebas.• Puede enviar un máximo de 200 mensajes por cada período de 24 horas.• Puede enviar un máximo de un mensaje por segundo.

Complete los procedimientos de esta sección para solicitar que su cuenta se elimine del entorno depruebas.

Para solicitar que su cuenta se elimine del entorno de pruebas de Amazon SES


2. Abra un SES Sending Limits Increase case en el servicio de atención al cliente.3. En el formulario, complete las secciones siguientes:

• Region (Región): elija la región de AWS que utiliza para enviar correo electrónico a través deAmazon SES. El estado de su entorno de pruebas y los límites de envío son independientes paracada región de AWS. Para obtener más información, consulte Regiones y Amazon SES (p. 439).

Note

Si utiliza Amazon SES en más de una región, complete un formulario independiente paracada una de las regiones en las que desee eliminar su cuenta del entorno de pruebas.

• Limit (Límite): elija Desired Daily Sending Quota (Cuota de envío diaria deseada) o DesiredMaximum Send Rate (Ratio máximo de envío deseado). Los límites de envío se describen enAdministrar sus límites de envío de Amazon SES (p. 136).

72




Amazon Simple Email Service Developer GuideSalir del entorno de pruebas

Note

Los usuarios de Amazon SES suelen solicitar que sus cuentas se eliminen del entornode pruebas y solicitan un aumento del límite de envío al mismo tiempo. Por este motivo,ambas solicitudes utilizan el mismo formulario. Si desea que su cuenta se quite del entornode pruebas, pero no necesita un aumento del límite de envío, tendrá que seleccionar unade estas opciones.

• New limit value (Nuevo valor de límite): escriba su cuota de envío deseada o ratio de envíodeseada. Solicite solo la cantidad que crea que va a necesitar. Recuerde que no se garantiza quereciba la cantidad que solicite y que mientras mayor sea el límite que solicite, mayor justificacióndebe proporcionar.

Note

Si desea quitar su cuenta del entorno de pruebas, pero no desea un aumento del límite deenvío, especifique una cuota de envío diaria de 200 o un ratio máximo de envío de 1, enfunción del valor que haya elegido en Limit (Límite). Estos son los límites que Amazon SESaplica de forma predeterminada a todas las cuentas en el entorno de pruebas.

• Mail Type (Tipo de correo): elija el tipo de correo electrónico que desea enviar. Si envía variostipos de correo electrónico, seleccione el tipo que se aplique a la mayor parte del envío de correoelectrónico.

• Website URL (URL del sitio web): escriba la dirección URL de su sitio web. Esta información nosayuda a entender mejor el tipo de contenido que desea enviar.

• My email sending complies with the AWS Service Terms and AUP (Mi envío de correo electrónicocumple las Condiciones de servicio de AWS y AUP): elija la opción que se aplica a su caso de uso.

• I only send to recipients who have specifically requested my mail (Solo envío a destinatarios que hansolicitado específicamente mi correo): elija la opción que se aplica a su caso de uso.

• I have a process to handle bounces and complaints (Tengo un proceso para gestionar rebotes yreclamaciones): elija la opción que se aplica a su caso de uso.

• Use Case Description (Utilizar descripción de caso): describa cómo utilizará Amazon SES paraenviar correo electrónico. Para ayudarnos a procesar su solicitud más rápidamente, incluya lasrespuestas a las siguientes preguntas:• ¿Cómo va a crear o adquirir su lista de correo?• ¿Cómo gestionará los rebotes y las reclamaciones?• ¿Cómo pueden los destinatarios cancelar la suscripción a su lista de correo y cómo va a

responder a estas solicitudes?• ¿Cómo eligió aumentar la cantidad que especificó en esta solicitud?

Cuando haya terminado, elija Submit. Concédanos un día laborable para revisar su solicitud. Cuandohayamos terminado de revisar su solicitud, actualizaremos su caso en el Centro de soporte.

Hay dos formas de determinar si su cuenta ha salido del entorno de pruebas:

• La correspondencia en su caso SES Sending Limits Increase indica que se ha concedido la solicitud.• Puede utilizar Amazon SES para enviar un mensaje de correo electrónico desde una dirección de correo

electrónico verificada a una dirección que no se ha verificado. Si recibe un error MessageRejected(MensajeRechazado), que indica que su dirección de correo electrónico no se ha verificado, entonces sucuenta sigue estando en el entorno de pruebas.

Una vez que su cuenta está fuera del entorno de pruebas, ya no tiene que verificar las direcciones odominios para sus destinatarios. Sin embargo, debe seguir verificando todas las identidades que utilicecomo direcciones "From" o "Return-Path".

73

Amazon Simple Email Service Developer GuideEnvío de correo electrónico

Envío de correo electrónico con Amazon SESPuede enviar un correo electrónico con Amazon Simple Email Service (Amazon SES) utilizando la consolade Amazon SES la interfaz Simple Mail Transfer Protocol (SMTP) de Amazon SES o el API de AmazonSES. Normalmente, la consola se utiliza para enviar correos electrónicos de prueba y para administrar suactividad de envío. Para enviar correos electrónicos masivos, se utiliza la interfaz de SMTP o el API. Paraobtener información acerca de los precios de correo electrónico de Amazon SES, consulte Amazon SESPricing.

• Si desea utilizar un paquete de software habilitado para SMTP, aplicación o lenguaje de programaciónpara enviar correo electrónico a través de Amazon SES o integrar Amazon SES con su actual servidorde correo electrónico, utilice la interfaz de SMTP de Amazon SES. Para obtener más información,consulte Uso de la interfaz de SMTP de Amazon SES para enviar correo electrónico (p. 74).

• Si desea llamar a Amazon SES mediante solicitudes HTTP sin procesar, utilice el API de AmazonSES. Para obtener más información, consulte Uso del API de Amazon SES para enviar correoelectrónico (p. 107).

Antes de enviar correos electrónicos, consulte Configuración de correo electrónico con AmazonSES (p. 45).

Important

Cuando envíe un correo electrónico a varios destinatarios (los destinatarios "To", "CC" y "BCC") yla llamada a Amazon SES devuelva un error, se rechaza todo el correo electrónico y ninguno delos destinatarios recibirá el correo electrónico. Por lo tanto, recomendamos que envíe un correoelectrónico a un destinatario cada vez.

Uso de la interfaz de SMTP de Amazon SES paraenviar correo electrónicoPara enviar correo electrónico de producción a través de Amazon SES, puede utilizar la interfaz de SimpleMail Transfer Protocol (SMTP) o bien el API de Amazon SES. Para obtener más información acerca delAPI de Amazon SES, consulte Uso del API de Amazon SES para enviar correo electrónico (p. 107). Enesta sección se describe la interfaz de SMTP.

Amazon SES envía correo electrónico a través de SMTP, el protocolo de correo electrónico más comúnen Internet. Puede enviar correo electrónico a través de Amazon SES utilizando una amplia variedad desoftware y lenguajes de programación habilitados para SMTP para conectarse a la interfaz de SMTP deAmazon SES. En esta sección se explica cómo obtener sus credenciales de SMTP de Amazon SES, cómoenviar correo electrónico a través de la interfaz de SMTP y cómo configurar varios servidores de correoelectrónico y programas de software para utilizar Amazon SES a fin de enviar correo electrónico.

Note

Para soluciones a problemas comunes que podría encontrar cuando utilice Amazon SES a travésde su interfaz SMTP, consulte Problemas de SMTP con Amazon SES (p. 464).

Para enviar correo electrónico a través de la interfaz SMTP de Amazon SES, necesitará lo siguiente:

• Una cuenta de AWS. Para obtener más información, consulte Inscripción en AWS (p. 46).• El nombre de host de la interfaz de SMTP (es decir, punto de enlace). Para obtener una lista de puntos

de enlace de SMTP de Amazon SES, consulte Conexión al punto de enlace de SMTP de AmazonSES (p. 80).

• El número de puerto de la interfaz de SMTP. El número de puerto varía según el método deconexión. Para obtener más información, consulte Conexión al punto de enlace de SMTP de AmazonSES (p. 80).

74

https://aws.amazon.com/ses/pricing


Amazon Simple Email Service Developer GuideUso de la interfaz de SMTP

• Un nombre de usuario y contraseña de SMTP. Puede usar el mismo conjunto de credenciales de SMTPen todas las regiones de AWS.

Important

Su nombre de usuario y contraseña de SMTP no son idénticos a sus claves de acceso deAWS o a las credenciales que utiliza para iniciar sesión en la consola de Amazon SES. Paraobtener información acerca de cómo generar su nombre de usuario y una contraseña de SMTP,consulte Obtener sus credenciales de SMTP de Amazon SES (p. 75).

• Software cliente que permite las comunicaciones mediante Transport Layer Security (TLS). Para obtenermás información, consulte Conexión al punto de enlace de SMTP de Amazon SES (p. 80).

• Una dirección de correo electrónico que ha verificado con Amazon SES. Para obtener más información,consulte Verificación de identidades en Amazon SES (p. 47).

• Mayores límites de envío, si desea enviar grandes cantidades de correo electrónico. Para obtener másinformación, consulte Administrar sus límites de envío de Amazon SES (p. 136).

A continuación, puede enviar correo electrónico haciendo lo siguiente:

• Para configurar un cliente de correo electrónico para enviar correo electrónico a través de Amazon SES,incluido un ejemplo para Microsoft Outlook, consulte Configuración de clientes de correo electrónico paraenviar a través de Amazon SES (p. 81).

• Para configurar el software habilitado para SMTP para enviar correo electrónico a través de la interfaz deSMTP de Amazon SES, incluido un ejemplo para el software de seguimiento de problemas Jira, consulteEnvío de correo electrónico a través de Amazon SES desde paquetes de software (p. 86).

• Para programar una aplicación para enviar correo electrónico a través de Amazon SES, consulte Envíode correo electrónico a través de Amazon SES desde su aplicación (p. 87).

• Para configurar su servidor de correo electrónico existente para enviar todo su correo saliente através de Amazon SES, consulte Integración de Amazon SES con su servidor de correo electrónicoexistente (p. 87).

• Para interactuar con la interfaz de SMTP de Amazon SES mediante la línea de comandos, que puedeser útil para pruebas, consulte Uso de la línea de comandos para enviar correo electrónico a través de lainterfaz de SMTP de Amazon SES (p. 102).

Para ver una lista de códigos de respuesta de SMTP, consulte Códigos de respuesta del SMTP devueltospor Amazon SES. (p. 467).

Información de correo electrónico que hay que facilitarCuando acceda a Amazon SES a través de la interfaz de SMTP, su aplicación cliente de SMTP monta elmensaje, por lo que la información que necesita proporcionar depende de la aplicación que esté utilizando.Como mínimo, el intercambio SMTP entre un cliente y un servidor requiere una dirección de origen, unadirección de destino y datos de mensaje.

Si utiliza la interfaz de SMTP y tiene habilitado el reenvío de retroalimentación, las notificaciones derebotes, reclamaciones y entrega se envían a la dirección "MAIL FROM". No se utiliza ninguna dirección"Reply-To" que especifique.

Obtener sus credenciales de SMTP de Amazon SESNecesita un nombre de usuario y una contraseña de SMTP de Amazon SES para acceder a la interfaz deSMTP de Amazon SES. Puede usar el mismo conjunto de credenciales de SMTP en todas las regiones deAWS.

75


Important

Su nombre de usuario y contraseña de SMTP son distintos de su ID de clave de acceso y clavede acceso secreta de AWS. Para obtener más información acerca de las credenciales, consulteUso de credenciales con Amazon SES (p. 393).

Hay dos formas de generar credenciales de SMTP. Puede utilizar la consola de Amazon SES o puedegenerar sus credenciales de SMTP a partir de sus credenciales de AWS.

Utilice la consola de Amazon SES para generar sus credenciales de SMTP si:

• Desea obtener sus credenciales de SMTP utilizando el método más sencillo.• No tiene que automatizar la generación de credenciales SMTP utilizando código o un script.

Genere sus credenciales de SMTP a partir de sus credenciales de AWS si:

• Dispone de un usuario de AWS Identity and Access Management (IAM) existente que ha creadoutilizando la interfaz de IAM y desea que dicho usuario pueda enviar correos electrónicos utilizando lainterfaz SMTP de Amazon SES.

• Desea automatizar la generación de credenciales SMTP utilizando código o un script.

Para obtener información sobre cada método, consulte Obtención de credenciales de SMTP de AmazonSES utilizando la consola de Amazon SES (p. 76) y Obtención de las credenciales de SMTP deAmazon SES convirtiendo las credenciales de AWS (p. 77).

Obtención de credenciales de SMTP de Amazon SES utilizando la consola deAmazon SES

Al generar credenciales de SMTP a través de la consola de Amazon SES, dicha consola crea un usuariode IAM con las políticas adecuadas para llamar a Amazon SES y le proporciona las credenciales de SMTPasociadas a dicho usuario.

Note

Un usuario de IAM puede crear credenciales de SMTP de Amazon SES, pero la política deusuario de IAM puede concederles permiso para utilizar el propio IAM, dado que las credencialesde SMTP de Amazon SES se crean mediante IAM. Su política de IAM debe permitirle realizar lassiguientes acciones de IAM: iam:ListUsers, iam:CreateUser, iam:CreateAccessKey eiam:PutUserPolicy. Si intenta crear credenciales SMTP de Amazon SES utilizando la consolay su usuario de IAM no tiene estos permisos, aparecerá un error que indica que su cuenta "noestá autorizada para realizar iam:ListUsers".

Para crear sus credenciales de SMTP


2. En el panel de navegación, seleccione SMTP Settings.3. En el panel de contenido, elija Create My SMTP Credentials.4. En Create User for SMTP (Crear usuario para SMTP), escriba un nombre para el usuario de SMTP.

También puede utilizar el valor predeterminado que se proporciona en este campo. Cuando hayaterminado, elija Create.

76





5. Elija Show User SMTP Credentials. Sus credenciales de SMTP se muestran en la pantalla. Copieestas credenciales y guárdelas en un lugar seguro. También puede elegir Download Credentials paradescargar un archivo que contenga sus credenciales.

Important

Esta es la única vez que puede ver sus credenciales de SMTP. Le recomendamos quedescargue estas credenciales y las guarde en un lugar donde no se eliminen. Si pierde estascredenciales, tiene que reiniciar el proceso de creación de su usuario de SMTP.

6. Elija Close Window.

Si desea eliminar sus credenciales de SMTP, vaya a la consola de IAM en https://console.aws.amazon.com/iam/ y elimine el nombre de usuario de IAM que se corresponde con suscredenciales de SMTP. Para obtener más información, consulte la guía Using IAM.

Si desea cambiar su contraseña de SMTP, vaya a la consola de IAM y elimine su usuario de IAM existentey, a continuación, vaya a la consola de Amazon SES para volver a generar sus credenciales de SMTP.

Obtención de las credenciales de SMTP de Amazon SES convirtiendo lascredenciales de AWSSi tiene un usuario de IAM que haya configurado utilizando la interfaz de IAM, puede obtener lascredenciales de SMTP de Amazon SES a partir de sus credenciales de AWS.

Important

No utilice las credenciales temporales de AWS para obtener credenciales de SMTP. La interfaz deSMTP de Amazon SES no es compatible con las credenciales de SMTP que se han generado apartir de credenciales de seguridad temporales.

Para habilitar el usuario de IAM a fin de enviar correo electrónico a través de la interfaz SMTP de AmazonSES, tiene que hacer los siguientes dos pasos:

• Obtenga las credenciales de SMTP del usuario a partir de sus credenciales de AWS utilizando elalgoritmo proporcionado en esta sección. Dado que parte de las credenciales de AWS, el nombre de

77

https://console.aws.amazon.com/iam/


https://docs.aws.amazon.com/IAM/latest/UserGuide/Using_DeletingUserFromAccount.html


usuario de SMTP es el mismo que el ID de clave de acceso de AWS, por lo que solo tiene que generarla contraseña de SMTP.

Important

Si genera credenciales de SMTP utilizando la consola de Amazon SES, el nombre de usuariode SMTP no es el mismo que el ID de clave de acceso de AWS. El nombre de usuario deSMTP y el ID de clave de acceso de AWS solo son los mismos si genera la contraseña deSMTP mediante programación, tal y como se describe en esta sección.

• Aplique la siguiente política al usuario de IAM:

{ "Statement": [{ "Effect":"Allow", "Action":"ses:SendRawEmail", "Resource":"*"}]}

Para obtener más información sobre el uso de Amazon SES con IAM, consulte Control del acceso aAmazon SES (p. 377).

Note

Aunque puede generar credenciales de SMTP de Amazon SES para cualquier usuario de IAM,le recomendamos que cree un usuario de IAM independiente cuando genere las credenciales deSMTP. Para obtener información sobre por qué es una práctica recomendable crear usuarios parafines específicos, acceda a Prácticas recomendadas de IAM.

El siguiente pseudocódigo muestra el algoritmo que convierte una clave de acceso secreta de AWS en unacontraseña de SMTP de Amazon SES.

key = AWS Secret Access Key;message = "SendRawEmail";versionInBytes = 0x02;signatureInBytes = HmacSha256(message, key);signatureAndVer = Concatenate(versionInBytes, signatureInBytes);smtpPassword = Base64(signatureAndVer);

Puede utilizar OpenSSL para generar una contraseña de SMTP a partir de una clave de acceso secretade IAM existente. OpenSSL es una utilidad de código abierto, y es compatible con todos los sistemasoperativos. Se incluye de forma predeterminada en la mayoría de las versiones de Linux, macOS y Unix, ytambién está disponible en Windows. Para obtener más información acerca de OpenSSL, consulte https://www.openssl.org. Para generar su contraseña de SMTP mediante OpenSSL, escriba lo siguiente en lalínea de comandos. Reemplace $AWS_SECRET_ACCESS_KEY por la clave de acceso secreta de su usuariode IAM.

(echo -en "\x02"; echo -n 'SendRawEmail' \ | openssl dgst -sha256 -hmac $AWS_SECRET_ACCESS_KEY -binary) \ | openssl enc -base64

Algunos lenguajes de programación incluyen bibliotecas que puede utilizar para convertir una clave deacceso secreta de IAM en una contraseña de SMTP. En esta sección se incluyen ejemplos de código queconvierten una clave de acceso secreta de AWS a una contraseña de SMTP de Amazon SES medianteJava o Python. También incluye un script Bash que puede utilizar para generar su contraseña de SMTP siOpenSSL está instalado en su equipo.

Antes de ejecutar estos ejemplos, guarde la clave de acceso secreta de AWS que desea convertir en unavariable de entorno llamada AWS_SECRET_ACCESS_KEY. Estos ejemplos de código pasan su contraseña

78

https://docs.aws.amazon.com/IAM/latest/UserGuide/IAMBestPractices.html

https://www.openssl.org



de SMTP convertida como salida. Esta contraseña y el nombre de usuario de SMTP (que es el mismo quesu ID de clave de acceso de AWS) son sus credenciales de SMTP de Amazon SES.

Bash

#!/usr/bin/env bash

# These variables are required to calculate the SMTP password.VERSION='\x02'MESSAGE='SendRawEmail'

# Check to see if OpenSSL is installed. If not, exit with errors.if ! [[ -x "$(command -v openssl)" ]]; then echo "Error: OpenSSL isn't installed." >&2 exit 1# If OpenSSL is installed, check to see that the environment variable has a# length greater than 0. If not, exit with errors.elif [[ -z "${AWS_SECRET_ACCESS_KEY}" ]]; then echo "Error: Couldn't find environment variable AWS_SECRET_ACCESS_KEY." >&2 exit 1fi

# If we made it this far, all of the required elements exist.# Calculate the SMTP password.(echo -en $VERSION; echo -n $MESSAGE \ | openssl dgst -sha256 -hmac $AWS_SECRET_ACCESS_KEY -binary) \ | openssl enc -base64

Java

import javax.crypto.Mac;import javax.crypto.spec.SecretKeySpec;import javax.xml.bind.DatatypeConverter;

public class SesSmtpCredentialGenerator { // Put your AWS secret access key in this environment variable. private static final String KEY_ENV_VARIABLE = "AWS_SECRET_ACCESS_KEY"; // Used to generate the HMAC signature. Do not modify. private static final String MESSAGE = "SendRawEmail"; // Version number. Do not modify. private static final byte VERSION = 0x02;

public static void main(String[] args) { // Get the AWS secret access key from environment variable AWS_SECRET_ACCESS_KEY. String key = System.getenv(KEY_ENV_VARIABLE); if (key == null) { System.out.println("Error: Cannot find environment variable AWS_SECRET_ACCESS_KEY."); System.exit(0); } // Create an HMAC-SHA256 key from the raw bytes of the AWS secret access key. SecretKeySpec secretKey = new SecretKeySpec(key.getBytes(), "HmacSHA256");

try { // Get an HMAC-SHA256 Mac instance and initialize it with the AWS secret access key. Mac mac = Mac.getInstance("HmacSHA256"); mac.init(secretKey);

// Compute the HMAC signature on the input data bytes. byte[] rawSignature = mac.doFinal(MESSAGE.getBytes());

79


// Prepend the version number to the signature. byte[] rawSignatureWithVersion = new byte[rawSignature.length + 1]; byte[] versionArray = {VERSION}; System.arraycopy(versionArray, 0, rawSignatureWithVersion, 0, 1); System.arraycopy(rawSignature, 0, rawSignatureWithVersion, 1, rawSignature.length);

// To get the final SMTP password, convert the HMAC signature to base 64. String smtpPassword = DatatypeConverter.printBase64Binary(rawSignatureWithVersion); System.out.println(smtpPassword); } catch (Exception ex) { System.out.println("Error generating SMTP password: " + ex.getMessage()); } }}

Python

import os #required to fetch environment variblesimport hmac #required to compute the HMAC keyimport hashlib #required to create a SHA256 hashimport base64 #required to encode the computed keyimport sys #required for system functions (exiting, in this case)

# Fetch the environment variable called AWS_SECRET_ACCESS_KEY, which contains# the secret access key for your IAM user.key = os.getenv('AWS_SECRET_ACCESS_KEY',0)

# These varibles are used when calculating the SMTP password. You shouldn't# change them.message = 'SendRawEmail'version = '\x02'

# See if the environment variable exists. If not, quit and show an error.if key == 0: sys.exit("Error: Can't find environment variable AWS_SECRET_ACCESS_KEY.")

# Compute an HMAC-SHA256 key from the AWS secret access key.signatureInBytes = hmac.new(key.encode('utf-8'),message.encode('utf-8'),hashlib.sha256).digest()# Prepend the version number to the signature.signatureAndVersion = version.encode('utf-8') + signatureInBytes# Base64-encode the string that contains the version number and signature.smtpPassword = base64.b64encode(signatureAndVersion)# Decode the string and print it to the console.print(smtpPassword.decode('utf-8'))

Conexión al punto de enlace de SMTP de Amazon SESLa siguiente tabla muestra los puntos de enlace de SMTP de Amazon SES para las regiones en las queAmazon SES está disponible.

Nombre de la región Punto de conexión SMTP

US East (N. Virginia) email-smtp.us-east-1.amazonaws.com

EE.UU. Oeste (Oregón) email-smtp.us-west-2.amazonaws.com

80


Nombre de la región Punto de conexión SMTP

UE (Irlanda) email-smtp.eu-west-1.amazonaws.com

El punto de enlace de SMTP de Amazon SES requiere que todas las conexiones se cifren utilizandoTransport Layer Security (TLS). (Tenga en cuenta que TLS se denomina en ocasiones con el nombre desu protocolo predecesor, SSL). Amazon SES admite dos mecanismos para establecer la conexión cifradapor TLS: STARTTLS y TLS Wrapper. Consulte la documentación de su software para determinar si escompatible con STARTTLS, TLS Wrapper o ambos.

Important

Amazon Elastic Compute Cloud (Amazon EC2) limita el tráfico de correo electrónico a través delpuerto 25 de forma predeterminada. Para evitar tiempos de espera al enviar correo electrónicoa través del punto de enlace de SMTP desde EC2, utilice un puerto diferente (587 o 2587) orellene una Solicitud de eliminación de limitaciones de envío de correo electrónico para eliminar lalimitación.

STARTTLS

STARTTLS es un medio para actualizar una conexión sin cifrar a una conexión cifrada. Existen versionesde STARTTLS para diversos protocolos; la versión de SMTP se define en RFC 3207.

Para configurar una conexión STARTTLS, el cliente de SMTP se conecta con el punto de enlace de SMTPde Amazon SES en el puerto 25, 587 o 2587, emite un comando EHLO y espera a que el servidor anuncieque es compatible con la extensión de SMTP STARTTLS. A continuación, el cliente emite el comandoSTARTTLS, iniciando la negociación de TLS. Cuando se completa la negociación, el cliente emite uncomando EHLO sobre la nueva conexión cifrada y la sesión de SMTP continúa con normalidad.

TLS Wrapper

TLS Wrapper (también conocido como SMTPS o protocolo Handshake) es un medio de iniciar unaconexión cifrada sin establecer primero una conexión sin cifrar. Con TLS Wrapper, el punto de enlacede SMTP de Amazon SES no realiza la negociación de TLS: es responsabilidad del cliente conectarseal punto de enlace mediante TLS y seguir utilizando TLS para toda la conversación. TLS Wrapper es unprotocolo más antiguo, pero muchos clientes siguen siendo compatibles.

Para configurar una conexión de TLS Wrapper, el cliente de SMTP se conecta al punto de enlace de SMTPde Amazon SES en el puerto 465 o 2465. El servidor presenta su certificado, el cliente emite un comandoEHLO y la sesión de SMTP continúa con normalidad.

Configuración de clientes de correo electrónico para enviar através de Amazon SESUna vez que obtenga su nombre de usuario y contraseña de SMTP (p. 75), ya puede utilizar la interfazde SMTP de Amazon SES para enviar correo electrónico.

Los siguientes procedimientos muestran cómo configurar Mozilla Thunderbird para enviar correoelectrónico por medio de Amazon SES. Es posible que pueda configurar otros clientes de correoelectrónico para enviar correo electrónico mediante Amazon SES. Para obtener más información, consultela documentación del cliente de correo electrónico.

Note

Estos procedimientos le muestran cómo configurar Mozilla Thunderbird para enviar correoelectrónico por medio de Amazon SES. Sin embargo, no puede utilizar Thunderbird para recibir

81

https://aws-portal.amazon.com/gp/aws/html-forms-controller/contactus/ec2-email-limit-rdns-request


https://www.mozilla.org/thunderbird/


correo electrónico que se envíe a sus direcciones de correo electrónico de Amazon SES. Paraobtener más información sobre cómo recibir correo electrónico con Amazon SES, consulteRecepción de correo electrónico (p. 178).

Configuración de Mozilla Thunderbird para enviar correo electrónico medianteAmazon SES

Los procedimientos de esta sección le muestran cómo configurar Mozilla Thunderbird para enviar correoelectrónico a través de Amazon SES. Estos procedimientos se han probado con Mozilla Thunderbirdversión 52.5 en Windows, macOS y Linux. Los procedimientos pueden diferir ligeramente para otrasversiones de Thunderbird.

Parte 1: Crear carpetas locales

Amazon SES no incluye carpetas basadas en el servidor para guardar elementos como el correoelectrónico enviado y los borradores. Por este motivo, tiene que crear estas carpetas en su equipo.Configurará Thunderbird para guardar el correo electrónico en estas carpetas en una sección posterior.

Para crear las carpetas Correo enviado y Borradores

1. En la esquina inferior izquierda de la ventana de Thunderbird, haga clic en el icono Offline Mode

( ) para habilitar el modosin conexión. Si Thunderbird le pregunta si desea descargar mensajes para su uso sin conexión, elijaLater.

2. En el panel de navegación situado a la izquierda de la ventana de Thunderbird, haga clic con el botónderecho en un área en blanco y, a continuación, elija New Folder.

3. En la ventana New Folder, complete las secciones siguientes:

• En Name, escriba Correo enviado.• En Create as a subfolder of, elija Local Folders.

4. Repita los pasos 2 y 3 para crear una carpeta adicional, pero esta vez asigne el nombre Borradoresa la carpeta.

Parte 2: Configurar el servidor SMTP

Para poder enviar correo electrónico a través de Amazon SES, tiene que configurar Thunderbird de modoque se conecte al punto de enlace SMTP de Amazon SES.

Para configurar el servidor SMTP

1. En Thunderbird, realice uno de los pasos siguientes:

• Si utiliza Windows: elija el icono Menu( ), seleccione Options y después elijaAccount Settings.

• Si utiliza Linux o macOS: elija el icono Menu( ), seleccione Preferences y despuéselija Account Settings.

2. En la ventana Account Settings, en la columna de la izquierda, elija Outgoing Server (SMTP).3. Elija Add (Añadir).4. En la ventana SMTP Server, complete las secciones siguientes:

• En Description, escriba Amazon SES.

82

https://www.mozilla.org/thunderbird/


• En Server Name, especifique el punto de enlace SMTP de la región de AWS en la que utilizaAmazon SES. Para obtener una lista de puntos de enlace , consulte the section called “Puntos deenlace de envío de correo electrónico” (p. 439).

• En Port, escriba 587.• En Connection security, elija STARTTLS.• En Authentication method, elija Normal password.• En User Mame, escriba el nombre de usuario de SMTP.

Note

El nombre de usuario de SMTP no es el mismo que su ID de acceso de clave de AWS.Para obtener más información, consulte Obtener sus credenciales de SMTP de AmazonSES (p. 75).

Cuando haya terminado, seleccione OK.5. En la ventana Account Settings, elija Account Actions y después Add Mail Account.6. En la ventana Mail Account Setup, complete las secciones siguientes:

• En Your name, escriba el nombre que desee que aparezca en los mensajes enviados desde estacuenta.

• En Email address, escriba la dirección de correo electrónico que va a utilizar para enviar correoelectrónico con Amazon SES.

• Deje el campo Password en blanco y desactive la casilla situada junto a Remember password.

Cuando termine, seleccione Advanced config. Vuelve a la ventana Account Settings (Configuración decuenta).

Note

Solo puede realizar este paso si Thunderbird está en modo sin conexión.7. En la ventana Account Settings, en la columna de la izquierda, seleccione la cuenta que ha creado en

el paso anterior.8. En Outgoing Server (SMTP), elija el servidor SMTP que ha creado en el paso 4.

Parte 3: Configurar Thunderbird para guardar el correo enviado y los borradores en su equipo

Esta sección contiene procedimientos para guardar el correo enviado y los borradores en su equipo.

Para configurar Thunderbird para guardar el correo enviado y los borradores en su equipo

1. En la ventana Account Settings, bajo su cuenta, elija Server Settings.2. En Server Settings, desactive las casillas de verificación situadas junto a los siguientes elementos:

• Check for new messages at startup• Check for new messages every 10 minutes• Allow immediate server notifications when new messages arrive

3. En la ventana Account Settings, bajo su cuenta, elija Copies & Folders.4. En When sending messages, automatically, elija Other y después elija la carpeta Correo enviado que

creó en el paso 3.

83


5. En Message Archives, desactive la casilla situada junto a Keep message archives in.

6. En Drafts and Templates, elija Other y después seleccione la carpeta Borradores que creó en el paso4.

Parte 4: Probar la funcionalidad de envío de correo electrónico

Realice los procedimientos de esta sección para asegurarse de que Thunderbird está configuradocorrectamente para enviar correo electrónico a través de Amazon SES.

Para probar el envío de correo electrónico en Thunderbird

1. En la esquina inferior izquierda de la pantalla, elija el icono Offline mode

( ) para deshabilitar elmodo sin conexión.

2. En la ventana de Thunderbird, elija Write. Envíese un mensaje de prueba a usted mismo o a otradirección de correo electrónico que se haya verificado con Amazon SES.

Cuando envíe el correo electrónico, es posible que se le pida que escriba una contraseña. Introduzcasu contraseña de SMTP de Amazon SES y, a continuación, active la casilla situada junto a UsePassword Manager to remember this password.

Note

Su contraseña de SMTP no es la misma que su ID de clave de acceso de AWS. Para obtenermás información, consulte Obtener sus credenciales de SMTP de Amazon SES (p. 75).

84


La primera vez que envíe un correo electrónico con esta configuración, Thunderbird puede mostrar unmensaje que indica que no se ha podido conectar con el servidor. Si aparece este mensaje, haga clicen Retry.

(Opcional) Parte 5: Especificar un conjunto de configuración al enviar correo electrónico

Puede configurar Thunderbird de forma que le permita especificar un conjunto de configuración cuandoenvíe un nuevo mensaje.

Warning

Puede modificar las opciones de configuración ocultas en Thunderbird durante esteprocedimiento. El cambio de estas opciones puede hacer que Thunderbird deje de funcionar.Proceda con precaución.

Para añadir un encabezado de conjunto de configuración

1. En Thunderbird, elija el icono Menu( ), seleccione Options ydespués elija Options.

2. En la ventana Options, elija Advanced. En la pestaña General, seleccione Config Editor.3. En la ventana about:config, haga clic con el botón derecho en cualquier lugar de la lista de opciones

de configuración, seleccione New y después elija String.4. En Enter the preference name, escriba mail.compose.other.header y, a continuación, elija OK.5. En mail.compose.other.header, escriba X-SES-CONFIGURATION-SET y, a continuación, elija OK.6. Cierre la ventana about:config y después cierre la ventana Options.7. Cuando envíe un correo electrónico, escriba la dirección del destinatario en el campo To. Haga clic en

la línea en blanco situada debajo de la dirección de correo electrónico del destinatario. Haga clic en elmenú To y después elija X-SES-CONFIGURATION-SET.

8. En la línea X-SES-CONFIGURATION-SET, escriba el nombre del conjunto de configuración quedesea utilizar. Complete el resto de las secciones del correo electrónico como lo haría normalmente.

85


Envío de correo electrónico a través de Amazon SES desdepaquetes de softwareExiste una serie de paquetes de software comerciales y de código abierto que admiten el envío de correoelectrónico a través de SMTP. Estos son algunos ejemplos:

• Plataformas de blog• Agregadores RSS• Software de administración de listas• Sistemas de flujo de trabajo

Puede configurar cualquier software habilitado para SMTP de este tipo para enviar correo electrónico através de la interfaz de SMTP de Amazon SES. Para obtener instrucciones sobre cómo configurar SMTPpara un determinado paquete de software, consulte la documentación de dicho software.

El siguiente procedimiento muestra cómo configurar el envío de Amazon SES en JIRA, una conocidasolución de seguimiento de problemas. Con esta configuración, JIRA puede notificar a los usuarios porcorreo electrónico cuando haya un cambio en el estado de un problema de software.

Para configurar JIRA para enviar correo electrónico utilizando Amazon SES

1. Con su navegador web, inicie sesión en JIRA con credenciales de administrador.2. En la ventana del navegador, elija Administration.3. En el menú System, elija Mail.4. En la página Mail administration, elija Mail Servers.5. Elija Configure new SMTP mail server.6. En el formulario Add SMTP Mail Server, rellene los campos siguientes:

a. Name: un nombre descriptivo para este servidor.b. From address: la dirección desde la que se enviará el correo electrónico. Tendrá que verificar

esta dirección de correo electrónico con Amazon SES antes de poder enviar desde ella. Paraobtener más información sobre la verificación, consulte Verificación de identidades en AmazonSES (p. 47).

c. Email prefix: una cadena que JIRA añade a cada línea de asunto antes del envío.d. Protocol: elija SMTP.

Note

Si no puede conectar a Amazon SES utilizando esta configuración, pruebeSECURE_SMTP.

e. Host Name: consulte Conexión al punto de enlace de SMTP de Amazon SES (p. 80) para unlistado de puntos de enlace SMTP de Amazon SES. Por ejemplo, si desea utilizar el punto deenlace de Amazon SES en la región EE.UU. Oeste (Oregón), el nombre del host sería email-smtp.us-west-2.amazonaws.com.

f. SMTP Port: 25, 587 o 2587 (para conectarse utilizando STARTTLS) o 465 o 2465 (paraconectarse utilizando TLS Wrapper).

g. TLS: seleccione esta casilla de verificación.h. Username: su nombre de usuario de SMTP.i. Password: su contraseña de SMTP.

La configuración de TLS Wrapper se muestra a continuación.

86


7. Elija Test Connection. Si el correo electrónico de prueba que envía JIRA a través de Amazon SESllega correctamente, su configuración está completa.

Envío de correo electrónico a través de Amazon SES desde suaplicaciónMuchos lenguajes de programación admiten el envío de correo electrónico a través de SMTP. Estacapacidad podría estar integrada en el propio lenguaje de programación o podría estar disponible comocomplemento o biblioteca. Puede aprovechar esta capacidad enviando correo electrónico a través deAmazon SES desde dentro de los programas de aplicación que escriba.

Para ver ejemplos de C# y Java, consulte Enviar un correo electrónico accediendo a la interfaz de SMTPde Amazon SES mediante programación (p. 21) en la sección Introducción.

Integración de Amazon SES con su servidor de correoelectrónico existenteSi actualmente administra su propio servidor de correo electrónico, puede utilizar el punto de enlace deSMTP de Amazon SES para enviar todo su correo electrónico saliente a Amazon SES. No es necesariomodificar sus clientes de correo electrónico y aplicaciones existente; la transición a Amazon SES serátransparente para ellos.

Diversos agentes de transferencia de correo (MTA) admiten el envío de correo electrónico a través derelés de SMTP. En esta sección se proporciona información general sobre cómo configurar algunos MTAconocidos para enviar correos electrónicos a través de la interfaz de SMTP de Amazon SES.

El punto de enlace de SMTP de Amazon SES requiere que todas las conexiones se cifren utilizandoTransport Layer Security (TLS).

Temas• Integración de Amazon SES con Postfix (p. 88)

87


• Integración de Amazon SES con Sendmail (p. 91)• Integración de Amazon SES con Microsoft Exchange (p. 94)• Integración de Amazon SES con Microsoft Windows Server IIS SMTP (p. 100)• Integración de Amazon SES con Exim (p. 101)

Integración de Amazon SES con Postfix

Postfix es una alternativa al agente de transferencia de mensajes (MTA) de Sendmail de uso extendido.Para obtener más información acerca de Postfix, visite http://www.postfix.org. Los procedimientos de estetema funcionarán con Linux, macOS, or Unix.

Requisitos previos

Debe realizar las siguientes tareas para poder completar los procedimientos de esta sección:

• Desinstale Sendmail, si ya está instalado en el sistema. El procedimiento para completar este paso varíaen función del sistema operativo que use.

• Instale Postfix. El procedimiento para completar este paso varía en función del sistema operativo queuse.

• Instale un paquete de autenticación SASL. El procedimiento para completar este paso varía en funcióndel sistema operativo que use. Por ejemplo, si utiliza un sistema basado en RedHat, debe instalarel paquete cyrus-sasl-plain. Si utiliza un sistema basado en Debian o Ubuntu, debe instalar elpaquete libsasl2-modules.

• Verifique la dirección de correo electrónico o el dominio que usará para enviar correo electrónico. Si sucuenta sigue estando en el entorno de pruebas, también tendrá que verificar todas las direcciones alas que tiene previsto enviar correo electrónico. Para obtener más información, consulte Verificación dedirecciones de correo electrónico en Amazon SES. (p. 47).

• Si va a enviar correo electrónico a través de Amazon SES desde una instancia Amazon EC2, asigne unadirección IP elástica a la instancia Amazon EC2 para que el ISP receptor acepte su correo electrónico.Para obtener más información, consulte Amazon EC2 Elastic IP Addresses.

Configuración de Postfix

Realice los procedimientos siguientes para configurar su servidor de correo electrónico para enviar correoelectrónico a través de Amazon SES mediante Postfix.

Para configurar Postfix

1. En la línea de comando, escriba el comando siguiente:

sudo postconf -e "relayhost = [email-smtp.us-west-2.amazonaws.com]:587" \"smtp_sasl_auth_enable = yes" \"smtp_sasl_security_options = noanonymous" \"smtp_sasl_password_maps = hash:/etc/postfix/sasl_passwd" \"smtp_use_tls = yes" \"smtp_tls_security_level = encrypt" \"smtp_tls_note_starttls_offer = yes"

Note

Si usa Amazon SES en una región de AWS distinta de EE.UU. Oeste (Oregón), reemplaceemail-smtp.us-west-2.amazonaws.com en el comando anterior por el punto deenlace de SMTP de la región correspondiente. Para obtener más información, consulteRegiones (p. 439).

88

http://www.postfix.org

https://aws.amazon.com/articles/1346


2. En un editor de texto, abra el archivo /etc/postfix/master.cf.3. En master.cf, busque la siguiente línea:

-o smtp_fallback_relay=

Coloque un signo de almohadilla (#) al principio de la línea para comentarla. Guarde y cierremaster.cf.

4. En un editor de texto, abra el archivo /etc/postfix/sasl_passwd. Si el archivo no existe todavía,créelo.

5. Añada la línea siguiente a /etc/postfix/sasl_passwd:

[email-smtp.us-west-2.amazonaws.com]:587 SMTPUSERNAME:SMTPPASSWORD

Note

Sustituya SMTPUSERNAME y SMTPPASSWORD por su nombre de usuario y contraseña deSMTP, respectivamente. Su nombre de usuario y contraseña de SMTP no son los mismosque su ID de clave de acceso y clave de acceso secreta de AWS. Para obtener másinformación acerca de las credenciales, consulte the section called “Obtener sus credencialesde SMTP” (p. 75).Si usa Amazon SES en una región de AWS distinta de EE.UU. Oeste (Oregón), reemplaceemail-smtp.us-west-2.amazonaws.com en el ejemplo anterior por el punto deenlace SMTP de la región correspondiente. Para obtener más información, consulteRegiones (p. 439).

Guarde y cierre sasl_passwd.6. En el símbolo del sistema, escriba el siguiente comando para crear un archivo de base de datos

hashmap que contenga sus credenciales de SMTP:

sudo postmap hash:/etc/postfix/sasl_passwd

7. (Opcional) Los archivos /etc/postfix/sasl_passwd y /etc/postfix/sasl_passwd.dbque ha creado en los pasos anteriores no están cifrados. Dado que estos archivos contienen suscredenciales de SMTP, le recomendamos que modifique la propiedad y los permisos de los archivospara restringir el acceso a ellos. Para restringir el acceso a estos archivos:

a. Escriba el siguiente comando en el símbolo del sistema para cambiar la propiedad de losarchivos:

sudo chown root:root /etc/postfix/sasl_passwd /etc/postfix/sasl_passwd.db

b. En el símbolo del sistema, escriba el comando siguiente para cambiar los permisos de losarchivos, de forma que solo el usuario raíz pueda leerlos o escribir en ellos:

sudo chmod 0600 /etc/postfix/sasl_passwd /etc/postfix/sasl_passwd.db

8. Indique a Postfix dónde debe buscar el certificado de la entidad de certificación (se necesita paraverificar el certificado de servidor de Amazon SES). El comando que utilice en este paso variará enfunción de su sistema operativo.

• Si utiliza Amazon Linux, Red Hat Enterprise Linux o una distribución relacionada, escriba elcomando siguiente:

sudo postconf -e 'smtp_tls_CAfile = /etc/ssl/certs/ca-bundle.crt'

89


• Si utiliza Ubuntu o una distribución relacionada, escriba el comando siguiente:

sudo postconf -e 'smtp_tls_CAfile = /etc/ssl/certs/ca-certificates.crt'

• Si utiliza macOS, puede generar el certificado desde el llavero del sistema. Para generar elcertificado, escriba el comando siguiente en la línea de comandos:

sudo security find-certificate -a -p /System/Library/Keychains/SystemRootCertificates.keychain > /etc/ssl/certs/ca-bundle.crt

Una vez generado el certificado, escriba el comando siguiente:

sudo postconf -e 'smtp_tls_CAfile = /etc/ssl/certs/ca-bundle.crt'

9. Escriba el comando siguiente para iniciar el servidor Postfix (o para volver a cargar la configuración siel servidor ya se está ejecutando):

sudo postfix start; sudo postfix reload

10. Envíe un correo electrónico de prueba escribiendo lo siguiente en una línea de comandos y pulsandoIntro después de cada línea. Reemplace [email protected] por la dirección de correoelectrónico del remitente ("From"). La dirección From debe verificarse para su uso con Amazon SES.Reemplace [email protected] por la dirección de destino. Si la cuenta está todavía en elentorno de pruebas, la dirección del destinatario también se debe verificar. Por último, la línea final delmensaje debe contener un único punto (.) sin ningún otro contenido.

sendmail -f [email protected] [email protected]: Sender Name <[email protected]>Subject: Amazon SES Test This message was sent using Amazon SES. .

11. Compruebe el buzón de correo asociado a la dirección del destinatario. Si el correo electrónicono llega, busque en la carpeta de correo no deseado. Si sigue sin encontrar el correo electrónico,compruebe el registro de correo del sistema que ha utilizado para enviarlo (normalmente se encuentraen /var/log/maillog) para obtener más información.

Ejemplo de uso avanzado

Este ejemplo muestra cómo enviar un correo electrónico que utiliza un conjunto de configuración (p. 224)y que utiliza la codificación multiparte de MIME para enviar una versión en texto sin formato y una versiónHTML del mensaje, junto con un archivo adjunto. También incluye una etiqueta de enlace (p. 499), quese puede utilizar para categorizar eventos de clic. El contenido del correo electrónico se especifica en unarchivo externo para que no tenga que escribir los comandos manualmente en la sesión de Postfix.

Para enviar correo electrónico MIME multiparte utilizando Postfix

1. En un editor de texto, cree un nuevo archivo denominado mime-email.txt.2. En el archivo de texto, pegue el contenido siguiente, reemplazando los valores en rojo por los valores

adecuados para su cuenta:

X-SES-CONFIGURATION-SET:ConfigSetFrom:Sender Name <[email protected]>Subject:Amazon SES TestMIME-Version: 1.0Content-Type: multipart/mixed; boundary="YWVhZDFlY2QzMGQ2N2U0YTZmODU"

90


--YWVhZDFlY2QzMGQ2N2U0YTZmODUContent-Type: multipart/alternative; boundary="3NjM0N2QwMTE4MWQ0ZTg2NTYxZQ"

--3NjM0N2QwMTE4MWQ0ZTg2NTYxZQContent-Type: text/plain; charset=UTF-8Content-Transfer-Encoding: quoted-printable

Amazon SES Test

This message was sent from Amazon SES using the SMTP interface.

For more information, see:http://docs.aws.amazon.com/ses/latest/DeveloperGuide/send-email-smtp.html

--3NjM0N2QwMTE4MWQ0ZTg2NTYxZQContent-Type: text/html; charset=UTF-8Content-Transfer-Encoding: quoted-printable

<html> <head></head> <body> <h1>Amazon SES Test</h1> <p>This message was sent from Amazon SES using the SMTP interface.</p> <p>For more information, see <a ses:tags="samplekey0:samplevalue0;samplekey1:samplevalue1;" href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/send-email-smtp.html"> Using the Amazon SES SMTP Interface to Send Email</a> in the <em>Amazon SES Developer Guide</em>.</p> </body></html>--3NjM0N2QwMTE4MWQ0ZTg2NTYxZQ----YWVhZDFlY2QzMGQ2N2U0YTZmODUContent-Type: application/octet-streamMIME-Version: 1.0Content-Transfer-Encoding: base64Content-Disposition: attachment; filename="customers.txt"

SUQsRmlyc3ROYW1lLExhc3ROYW1lLENvdW50cnkKMzQ4LEpvaG4sU3RpbGVzLENhbmFkYQo5MjM4OSxKaWUsTGl1LENoaW5hCjczNCxTaGlybGV5LFJvZHJpZ3VleixVbml0ZWQgU3RhdGVzCjI4OTMsQW5heWEsSXllbmdhcixJbmRpYQ==--YWVhZDFlY2QzMGQ2N2U0YTZmODU--

Guarde y cierre el archivo .3. En la línea de comando, escriba el comando siguiente. Sustituya [email protected] por su

dirección de correo electrónico y sustituya [email protected] por la dirección de correoelectrónico del destinatario.

sendmail -f [email protected] [email protected] < mime-email.txt

Si el comando se ejecuta correctamente, sale sin proporcionar ninguna salida.4. Compruebe en su bandeja de entrada si hay correo electrónico. Si el mensaje no se ha entregado,

compruebe el registro de correo del sistema.

Integración de Amazon SES con Sendmail

Sendmail se lanzó a principios de los años ochenta y desde entonces se ha mejorado continuamente. Setrata de un agente de transferencia de mensajes (MTA) flexible y configurable con una gran comunidad deusuarios.

91


Sendmail fue adquirida por Proofpoint en 2013, pero Proofpoint sigue ofreciendo una versión de códigoabierto de Sendmail. Puede descargar la versión de código abierto de Sendmail en el sitio web deProofpoint.

Las instrucciones de esta sección le muestran cómo configurar Sendmail para enviar correo electrónicoa través de Amazon SES. Estas instrucciones se probaron en una instancia Amazon EC2 de 64 bitsutilizando la siguiente imagen de máquina de Amazon (AMI):

• Amazon Linux AMI 2015.09.2 (ami-8fcee4e5)

Para obtener más información sobre el lanzamiento una instancia Amazon EC2, que incluye la selecciónde una AMI, consulte las imágenes de máquina de Amazon (AMI).

Requisitos previos

Antes de realizar uno de los siguientes procedimientos, verifique lo siguiente:

• El paquete Sendmail está instalado en su equipo y puede enviar un correo electrónico correctamentemediante Sendmail sin Amazon SES.

Note

Para saber si un paquete está instalado en un equipo que ejecute Red Hat Linux, escribarpm -qa | grep <package>, donde <package> es el nombre del paquete. Para ver si unpaquete está instalado en un equipo que ejecute Ubuntu Linux, escriba dpkg -s <package>.

• Además del paquete Sendmail, los siguientes paquetes se instalan en su equipo: sendmail-cf, m4 ycyrus-sasl-plain.

• Ha verificado su dirección de remitente ("From") y, si su cuenta sigue estando en el entorno de pruebas,también ha verificado sus direcciones de destinatario ("To"). Para obtener más información, consulteVerificación de direcciones de correo electrónico en Amazon SES. (p. 47).

• (Opcional) Si va a enviar correo electrónico a través de Amazon SES desde una instancia Amazon EC2,es posible que tenga que asignar una dirección IP elástica a la instancia Amazon EC2 para que el ISPreceptor acepte su correo electrónico. Para obtener más información, consulte Amazon EC2 Elastic IPAddresses.

• (Opcional) Si va a enviar correo electrónico a través de Amazon SES desde una instancia Amazon EC2,puede rellenar una Solicitud para eliminar limitaciones de envío de correo electrónico para eliminar lasrestricciones de límite de envío adicionales que se aplican al puerto 25 de forma predeterminada.

Para configurar Sendmail para enviar correo electrónico a través del punto de enlace de AmazonSES en EE.UU. Oeste (Oregón) utilizando STARTTLS

1. Abra el archivo /etc/mail/authinfo para su edición. Si el archivo no existe, créelo.

Important

Estas instrucciones suponen que desea utilizar Amazon SES en la región de AWS EE.UU.Oeste (Oregón). Si desea utilizar una región diferente, reemplace todas las instancias deemail-smtp.us-west-2.amazonaws.com en estas instrucciones con el punto de enlace SMTPde la región deseada. Para obtener una lista de puntos de enlace SMTP, consulte Regiones yAmazon SES (p. 439).

2. Añada la línea siguiente a /etc/mail/authinfo, donde:

• U:root: no modificar.• I:USERNAME: reemplace USERNAME por el nombre de usuario de Amazon SES que obtuvo

siguiendo las instrucciones de Obtener sus credenciales de SMTP de Amazon SES (p. 75). NOes el mismo que su ID de clave de acceso de AWS.

92

https://www.proofpoint.com/us/open-source-email-solution

https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-launch-instance_linux.html





• P:PASSWORD: reemplace PASSWORD por la contraseña de Amazon SES que obtuvo siguiendolas instrucciones de Obtener sus credenciales de SMTP de Amazon SES (p. 75). NO es lamisma que su clave secreta de AWS.

• M:LOGIN: reemplace LOGIN por el método de autenticación que desea utilizar. Por ejemplo, PLAIN,DIGEST-MD5, etc.

AuthInfo:email-smtp.us-west-2.amazonaws.com "U:root" "I:USERNAME" "P:PASSWORD" "M:LOGIN"

Si Sendmail no puede autenticar con el punto de enlace de SMTP de Amazon SES porque el nombrede host no coincide, pruebe a añadir la línea adicional especificada en Problemas de SMTP conAmazon SES (p. 464).

3. Guarde el archivo authinfo.4. En el símbolo del sistema, escriba el siguiente comando para generar /etc/mail/authinfo.db:

sudo makemap hash /etc/mail/authinfo.db < /etc/mail/authinfo

5. Abra el archivo /etc/mail/access e incluya soporte para desvío al punto de enlace de SMTP de AmazonSES añadiendo la línea siguiente. Si Sendmail no puede autenticar con el punto de enlace de SMTPde Amazon SES porque el nombre de host no coincide, pruebe a añadir la línea adicional especificadaen Problemas de SMTP con Amazon SES (p. 464).

Connect:email-smtp.us-west-2.amazonaws.com RELAY

Guarde el archivo.6. En el símbolo del sistema, escriba el siguiente comando para regenerar /etc/mail/access.db:

sudo makemap hash /etc/mail/access.db < /etc/mail/access

7. Guarde una copia de seguridad de /etc/mail/sendmail.mc y /etc/mail/sendmail.cf.8. Añada el siguiente grupo de líneas al archivo /etc/mail/sendmail.mc antes de cualquier definición de

MAILER(). Si añade una línea FEATURE() después de una definición de MAILER(), cuando ejecutem4 en un paso siguiente, recibirá el siguiente error: "ERROR: FEATURE() should be beforeMAILER().":

Important

Si utiliza una región de AWS que no sea EE.UU. Oeste (Oregón), reemplace el valorSMART_HOST por el punto de enlace de SMTP de Amazon SES de la región que estéutilizando y asegúrese de utilizar el carácter ` y el apóstrofo exactamente tal y como semuestra.

define(`SMART_HOST', èmail-smtp.us-west-2.amazonaws.com')dnldefine(`RELAY_MAILER_ARGS', `TCP $h 25')dnldefine(`confAUTH_MECHANISMS', `LOGIN PLAIN')dnlFEATURE(àuthinfo', `hash -o /etc/mail/authinfo.db')dnlMASQUERADE_AS(`YOUR_DOMAIN')dnlFEATURE(masquerade_envelope)dnlFEATURE(masquerade_entire_domain)dnl

9. En el texto que acaba de añadir a sendmail.mc, en la línea que empieza por MASQUERADE_AS,reemplace YOUR_DOMAIN por el nombre de dominio desde el que está enviando su correoelectrónico. Al añadir esta máscara, hace que el correo electrónico de este host parezca que se haenviado desde su dominio. De lo contrario, el correo electrónico aparecerá como si se enviara desdeel nombre de host del servidor de correo y puede recibir un error de "Dirección de correo electrónicono verificada" cuando se intenta enviar un correo electrónico.

93


10. Guarde el archivo sendmail.mc.11. En el símbolo del sistema, escriba el siguiente comando para poder escribir en sendmail.cf:

sudo chmod 666 /etc/mail/sendmail.cf

12. En el símbolo del sistema, escriba el siguiente comando para regenerar sendmail.cf:

sudo m4 /etc/mail/sendmail.mc > /etc/mail/sendmail.cf

Note

Si detecta errores como "Command not found" y "No such file or directory", asegúrese dehaber instalado los paquetes m4 y sendmail-cf tal como se ha especificado en la sección derequisitos previos con anterioridad.

13. En el símbolo del sistema, escriba el siguiente comando para restablecer los permisos de sendmail.cfa solo lectura:

sudo chmod 644 /etc/mail/sendmail.cf

14. En el símbolo del sistema, escriba el siguiente comando para reiniciar Sendmail:

sudo /etc/init.d/sendmail restart

15. Envíe un correo electrónico de prueba haciendo lo siguiente:

a. En el símbolo del sistema, escriba lo siguiente. Tenga en cuenta que debe [email protected] por su dirección de correo electrónico "From", que debe haber verificado conAmazon SES. Reemplace [email protected] por su dirección "To". Si su cuenta está todavía en elentorno de pruebas, la dirección "To" también se debe verificar.

sudo /usr/sbin/sendmail -f [email protected] [email protected]

b. Pulse <Intro>. Escriba el cuerpo del mensaje, pulsando <Intro> después de cada línea.c. Cuando termine de escribir el correo electrónico, pulse CTRL+D para enviarlo.

16. Compruebe el cliente de correo electrónico del destinatario para el correo electrónico. Si no puedeencontrar el correo electrónico, mire en la carpeta de correo no deseado en el cliente de correoelectrónico del destinatario. Si todavía no puede encontrar el correo electrónico, vea el registro deSendmail en el servidor de correo electrónico. El registro se suele encontrar en /var/spool/mail/<usuario>.

Integración de Amazon SES con Microsoft Exchange

Puede configurar Microsoft Exchange para enviar correo electrónico a través de Amazon SES. Lossiguientes procedimientos le muestran cómo integrar Microsoft Exchange con Amazon SES utilizando laGUI de Microsoft Exchange o Windows PowerShell.

Important

Siga solo uno de los siguientes procedimientos (GUI de Microsoft Exchange o WindowsPowerShell). Si sigue ambos procedimientos, obtendrá un error que indica que tiene dosconectores de envío con el mismo nombre.

Estas instrucciones se han escrito usando Microsoft Exchange 2013.

Para integrar Microsoft Exchange con Amazon SES utilizando la GUI de Microsoft Exchange

1. Vaya al centro de administración de Microsoft Exchange (normalmente https://<CASServerName>/ecp) e inicie sesión como usuario que forme parte del grupo de administradores de Exchange.

2. En el menú de la izquierda, elija mail flow.

94


3. Elija send connectors.

4. Elija el signo más (+).5. Introduzca un nombre para el conector de envío (por ejemplo, SES).6. En Type, seleccione Internet.

95


7. Seleccione Siguiente.8. Seleccione Route mail through smart hosts.

96


9. Elija el signo más y, a continuación, introduzca el punto de enlace de Amazon SES que utilizará (porejemplo, email-smtp.us-west-2.amazonaws.com). Para obtener una lista de puntos de enlace deAmazon SES, consulte Regiones y Amazon SES (p. 439).

10. Seleccione Save. El punto de enlace que ha introducido aparecerá en el recuadro SMART HOST.11. Seleccione Siguiente.12. Seleccione Basic authentication, a continuación seleccione Offer basic authentication only after

starting TLS y, a continuación, introduzca su nombre de usuario y contraseña de SMTP de AmazonSES.

Important

Su nombre de usuario y contraseña de SMTP no son los mismos que su ID de clave deacceso y clave de acceso secreta de AWS. No intente usar sus credenciales de AWS paraautenticarse en el punto de enlace de SMTP. Para obtener más información acerca de lascredenciales, consulte Uso de credenciales con Amazon SES (p. 393).

13. Seleccione Siguiente.14. Elija el signo más (+).15. Compruebe que Type es SMTP, FQDN es * y Cost es 1.

97


16. Elija Save y, a continuación, elija Next.17. Elija el signo más (+).18. Seleccione todos los servidores de transporte a los que desea aplicar esta regla y elija Add. Cuando

haya añadido todos los servidores a los cuales desea enviar correo electrónico a través de AmazonSES, elija ok.

98


19. Verifique que se hayan añadido los servidores y, a continuación, elija finish.

Ahora debería ver un conector de envío para Amazon SES con un estado habilitado. Todo el correosaliente fluirá ahora a través de Amazon SES.

Para integrar Microsoft Exchange con Amazon SES utilizando Windows PowerShell

1. Abra el shell de administración de Exchange e introduzca $creds = Get-Credential. Apareceráun cuadro de diálogo de solicitud de credenciales de Windows PowerShell.

2. En el cuadro de diálogo, introduzca su nombre de usuario y contraseña de SMTP de Amazon SES y, acontinuación, seleccione OK.

Important

Su nombre de usuario y contraseña de SMTP no son los mismos que su ID de clave deacceso y clave de acceso secreta de AWS. No intente usar sus credenciales de AWS para

99


autenticarse en el punto de enlace de SMTP. Para obtener más información acerca de lascredenciales, consulte Uso de credenciales con Amazon SES (p. 393).

3. En el símbolo del sistema, escriba la siguiente línea, reemplazando ENDPOINT por un punto deenlace de SMTP de Amazon SES (por ejemplo, email-smtp.us-west-2.amazonaws.com). Para obteneruna lista de puntos de enlace de Amazon SES, consulte Regiones y Amazon SES (p. 439).

New-SendConnector -Name "SES" -AddressSpaces "*;1" -SmartHosts"ENDPOINT" -SmartHostAuthMechanism BasicAuthRequireTLS -Usage Internet -AuthenticationCredential $creds

La línea de comandos debería mostrar ahora un conector de envío para Amazon SES con un estadohabilitado. Todo el correo saliente fluirá ahora a través de Amazon SES.

Integración de Amazon SES con Microsoft Windows Server IIS SMTP

Puede configurar el servidor SMTP de IIS de Microsoft Windows Server para enviar correo electrónico através de Amazon SES. Estas instrucciones se han escrito utilizando Microsoft Windows Server 2012 enuna instancia Amazon EC2. Puede utilizar la misma configuración en Microsoft Windows Server 2008 yMicrosoft Windows Server 2008 R2.

Para integrar el servidor SMTP de ISS de Microsoft Windows Server IIS con Amazon SES

1. En primer lugar, configure Microsoft Windows Server 2012 con las siguientes instrucciones.

a. En la consola de administración de Amazon EC2, lance una nueva instancia Amazon EC2 basede Microsoft Windows Server 2012.

b. Conéctese a la instancia e inicie sesión en ella utilizando el Escritorio remoto siguiendo lasinstrucciones de Getting Started with Amazon EC2 Windows Instances.

c. Lanzar el panel de Server Manager.d. Instale la función Web Server. Asegúrese de incluir las herramientas de Compatibilidad con la

administración de IIS 6 (una opción en la casilla de verificación Web Server).e. Instale la característica SMTP Server.

2. A continuación, configurar el servicio de SMTP IIS con las siguientes instrucciones.

a. Vuelva al panel de Server Manager.b. En el menú Tools, elija Internet Information Services (IIS) 6.0 Manager.c. Haga clic con el botón derecho en SMTP Virtual Server #1 y, a continuación, seleccione

Properties.d. En la pestaña Access, en Relay Restrictions, elija Relay.e. En el cuadro de diálogo Relay Restrictions, elija Add.f. En Single Computer, introduzca 127.0.0.1 para la dirección IP. Ahora ha concedido acceso para

que este servidor retransmita correo electrónico a Amazon SES a través del servicio SMTP de IIS.

En este procedimiento, suponemos que sus correos electrónicos se generan en este servidor. Sila aplicación que genera el correo electrónico se ejecuta en un servidor independiente, tiene queconceder acceso de retransmisión para dicho servidor en SMTP de IIS.

100

https://console.aws.amazon.com/ec2/home

https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/EC2Win_GetStarted.html


Note

Para ampliar el relé de SMTP a subredes privadas, para Relay Restriction, utilice SingleComputer 127.0.0.1 y Group of Computers 172.1.1.0 - 255.255.255.0 (en la secciónde máscara de red). Para Connection, use Single Computer 127.0.0.1 y Group ofComputers 172.1.1.0 - 255.255.255.0 (en la sección de máscara de red).

3. Por último, configurar el servidor para enviar correo electrónico a través de Amazon SES utilizando lassiguientes instrucciones.

a. Vuelva al cuadro de diálogo SMTP Virtual Server #1 Properties y, a continuación, elija la pestañaDelivery.

b. En la pestaña Delivery, elija Outbound Security.c. Seleccione Basic Authentication y, a continuación, introduzca su nombre de usuario y contraseña

de SMTP de Amazon SES. Puede obtener estas credenciales desde la consola de AmazonSES utilizando el procedimiento descrito en Obtener sus credenciales de SMTP de AmazonSES (p. 75).

Important

Su nombre de usuario y contraseña de SMTP no son los mismos que su ID de clave deacceso y clave de acceso secreta de AWS. No intente usar sus credenciales de AWSpara autenticarse en el punto de enlace de SMTP. Para obtener más información acercade las credenciales, consulte Uso de credenciales con Amazon SES (p. 393).

d. Asegúrese de que TLS encryption está seleccionado.e. Vuelva a la pestaña Delivery.f. Elija Outbound Connections.g. En el cuadro de diálogo Outbound Connections, asegúrese de que el puerto sea 25 o 587.h. Seleccione Advanced.i. Para el nombre de Smart host, introduzca el punto de enlace de Amazon SES que utilizará (por

ejemplo, email-smtp.us-west-2.amazonaws.com). Para obtener una lista de puntos de enlace deAmazon SES, consulte Regiones y Amazon SES (p. 439).

j. Vuelva al panel de Server Manager.k. En el panel de Server Manager, haga clic con el botón derecho en SMTP Virtual Server # 1 y, a

continuación, reinicie el servicio para recoger la nueva configuración.l. Envíe un correo electrónico a través de este servidor. Puede examinar los encabezados de

mensaje para confirmar que se ha entregado a través de Amazon SES.

Integración de Amazon SES con Exim

Exim es un MTA que se desarrolló originalmente para sistemas similares a Unix. Se trata de un programade correo electrónico con fines generales que es muy flexible y configurable.

Para obtener más información sobre Exim, consulte http://www.exim.org.

Para configurar la integración con el punto de enlace de la EE.UU. Oeste (Oregón) de AmazonSES utilizando STARTTLS

1. Abra el archivo /etc/exim/exim.conf para editarlo. Si el archivo no existe, créelo.

Important

Estas instrucciones suponen que desea utilizar Amazon SES en la región de AWS EE.UU.Oeste (Oregón). Si desea utilizar una región diferente, reemplace todas las instancias deemail-smtp.us-west-2.amazonaws.com en estas instrucciones con el punto de enlace SMTP101

http://www.exim.org


de la región deseada. Para obtener una lista de puntos de enlace SMTP, consulte Regiones yAmazon SES (p. 439).

2. En /etc/exim/exim.conf, realice los cambios siguientes:

a. En la sección routers, después de la línea begin routers, añada lo siguiente:

send_via_ses:driver = manualroutedomains = ! +local_domainstransport = ses_smtproute_list = * email-smtp.us-west-2.amazonaws.com;

b. En la sección transports, después de la línea begin transports, añada lo siguiente:

ses_smtp:driver = smtpport = 587hosts_require_auth = *hosts_require_tls = *

c. En la sección authenticators, después de la línea begin authenticators, añada lo siguiente,reemplazando USERNAME y PASSWORD por su nombre de usuario y contraseña de SMTP:

Important

Utilice su nombre de usuario y contraseña de SMTP, no su ID de clave de acceso deAWS y clave de acceso secreta. Sus credenciales de SMTP y sus credenciales de AWSno son las mismas. Para obtener información acerca de cómo obtener sus credencialesde SMTP, consulte Obtener sus credenciales de SMTP de Amazon SES (p. 75).

ses_login:driver = plaintextpublic_name = LOGINclient_send = : USERNAME : PASSWORD

3. Guarde el archivo /etc/exim/exim.conf.

Cuando haya terminado de actualizar la configuración, reinicie Exim. En la línea de comando, escriba elcomando siguiente y pulse INTRO.

sudo /etc/init.d/exim restart

Note

Este comando podría no ser exactamente el mismo en su servidor en particular.

Cuando haya completado este procedimiento, su correo electrónico saliente se enviará a través deAmazon SES. Para probar la configuración, envíe un mensaje de correo electrónico a través de suservidor de Exim y, a continuación, verifique que llega a su destino. Si el mensaje no se entrega, entoncescompruebe el registro de correo de su sistema para buscar errores. En muchos sistemas, se trata delarchivo /var/log/exim/main.log.

Uso de la línea de comandos para enviar correo electrónico através de la interfaz de SMTP de Amazon SESPuede interactuar con la interfaz de SMTP de Amazon SES desde la línea de comandos mediante unautilidad común denominada OpenSSL. En la mayoría de los casos, solo utilizará OpenSSL para probarsu capacidad para conectarse a la interfaz de SMTP. Sin embargo, también puede utilizar OpenSSL paraescribir sus propias aplicaciones para enviar correo electrónico utilizando Amazon SES.

102


OpenSSL es una utilidad de código abierto, y es compatible con todos los sistemas operativos. Seincluye de forma predeterminada en la mayoría de las versiones de Linux y macOS, y se puede compilarpara ejecutarla en Windows. Para obtener más información acerca de OpenSSL, consulte https://www.openssl.org.

Requisitos previos

Para conectarse a la interfaz de SMTP de Amazon SES con OpenSSL, primero debe obtener suscredenciales de SMTP.

Important

Sus credenciales de SMTP son distintas de las credenciales estándar de AWS. Para obtener másinformación sobre cómo obtener sus credenciales de SMTP, consulte the section called “Obtenersus credenciales de SMTP” (p. 75).

Después de obtener sus credenciales de SMTP, debe codificarlas con la codificación base64.

Para codificar su nombre de usuario y contraseña de SMTP en base64

1. En la línea de comandos, escriba el comando siguiente para codificar su nombre de usuario de SMTP,sustituyendo SMTPUsername por su nombre de usuario de SMTP:

echo -n "SMTPUsername" | openssl enc -base64

Anote el resultado de este comando.2. En la línea de comandos, escriba el comando siguiente para codificar su contraseña de SMTP,

sustituyendo SMTPPassword por su contraseña de SMTP:

echo -n "SMTPPassword" | openssl enc -base64

Anote el resultado de este comando.

Prueba de la conexión a la interfaz de SMTP de Amazon SES

Existen dos maneras de conectarse a la interfaz de SMTP de Amazon SES con OpenSSL: utilizarSTARTTLS en el puerto 587, y utilizar SSL en el puerto 465. Ambas opciones ofrecen las mismasposibilidades. Si no está seguro de qué opción elegir, le recomendamos que utilice STARTTLS en el puerto587.

STARTTLS (puerto 587)

Para conectarse a la interfaz de SMTP mediante STARTTLS

• En la línea de comandos, escriba el comando siguiente para conectarse al servidor SMTP deAmazon SES:

openssl s_client -crlf -quiet -starttls smtp -connect email-smtp.us-west-2.amazonaws.com:587

Note

Sustituya email-smtp.us-west-2.amazonaws.com por la dirección URL delpunto de enlace de SMTP de Amazon SES para su región de AWS. Para obtener másinformación, consulte Regiones (p. 439).

103




Si la conexión se realiza correctamente, aparecerá un resultado similar al siguiente:

depth=1 C = US, O = Symantec Corporation, OU = Symantec Trust Network, CN = Symantec Class 3 Secure Server CA - G4250 Ok

La conexión se cierra automáticamente después de unos 10 segundos de inactividad.

SSL (puerto 465)

Para conectarse a la interfaz de SMTP mediante SSL

• En la línea de comandos, escriba el comando siguiente para conectarse al servidor SMTP deAmazon SES:

openssl s_client -crlf -quiet -connect email-smtp.us-west-2.amazonaws.com:465

Note


Si la conexión se realiza correctamente, aparecerá un resultado similar al siguiente:

depth=1 C = US, O = Symantec Corporation, OU = Symantec Trust Network, CN = Symantec Class 3 Secure Server CA - G4220 email-smtp.amazonaws.com ESMTP SimpleEmailService-2638499997 QSByYW5kb20gc3RyaW5n

La conexión se cierra automáticamente después de unos 10 segundos de inactividad.

Uso de OpenSSL para enviar correo electrónico utilizando la interfaz de SMTP deAmazon SES

Cuando un remitente de correo electrónico (un cliente) se conecta a un servidor SMTP, el cliente emiteun conjunto estándar de solicitudes y el servidor responde a cada solicitud con una respuesta estándar.Esta serie de solicitudes y respuestas se denomina conversación de SMTP. Cuando se conecte al servidorSMTP de Amazon SES con OpenSSL, el servidor esperará que se produzca una conversación de SMTP.

En este ejemplo, añadirá todas las solicitudes de cliente a un archivo de texto y, a continuación, utilizaráese archivo como entrada para uno de los comandos de OpenSSL que se muestran en la sección anterior.

STARTTLS (puerto 587)

Para enviar un correo electrónico desde la línea de comandos utilizando la interfaz de SMTP

1. En un editor de texto, cree un nuevo archivo. Pegue el código siguiente en el archivo.

EHLO example.comAUTH LOGINBase64EncodedSMTPUserNameBase64EncodedSMTPPasswordMAIL FROM: [email protected] TO: [email protected]

104


DATAX-SES-CONFIGURATION-SET: ConfigSetFrom: Sender Name <[email protected]>To: [email protected]: Amazon SES SMTP Test

This message was sent using the Amazon SES SMTP interface..QUIT

2. Realice los cambios siguientes en el archivo que creó en el paso anterior:

• Sustituya example.com por su dominio de origen.• Sustituya Base64EncodedSMTPUserName por su nombre de usuario de SMTP codificado en

base64.• Sustituya Base64EncodedSMTPPassword por su contraseña de SMTP codificada en base64.• Sustituya [email protected] por la dirección de correo electrónico desde la que está

enviando. Esta identidad debe verificarse.• Sustituya [email protected] por la dirección de correo electrónico de destino. Si su

cuenta de Amazon SES todavía está en el entorno de pruebas, esta dirección debe verificarse.• Sustituya ConfigSet por el nombre del conjunto de configuración que desea aplicar a este

correo electrónico.Note

Si no desea utilizar un conjunto de configuración, elimine toda la línea que comienzapor "X-SES-CONFIGURATION-SET".

3. Guarde el archivo como input.txt.4. En la línea de comando, escriba el comando siguiente:

openssl s_client -crlf -quiet -starttls smtp -connect email-smtp.us-west-2.amazonaws.com:587 < input.txt

Note


Si el mensaje se envía, verá un resultado similar al siguiente:

250 Ok 01010160d7de98d8-21e57d9a-JZho-416c-bbe1-8ebaAexample-000000

La cadena de números y texto que sigue a 250 Ok es el ID de mensaje del correo electrónico.Note

La conexión puede permanecer abierta después de que se envíe el mensaje. En tal caso,se cerrará automáticamente después de unos 10 segundos de inactividad.

SSL (puerto 465)

Para enviar un correo electrónico desde la línea de comandos utilizando la interfaz de SMTP


EHLO example.com

105


AUTH LOGINBase64EncodedSMTPUserNameBase64EncodedSMTPPasswordMAIL FROM: [email protected] TO: [email protected]: ConfigSetFrom: Sender Name <[email protected]>To: [email protected]: Amazon SES SMTP Test

This message was sent using the Amazon SES SMTP interface..QUIT

2. Realice los cambios siguientes en el archivo que creó en el paso anterior:

• Sustituya example.com por su dominio de origen.• Sustituya Base64EncodedSMTPUserName por su nombre de usuario de SMTP codificado en

base64.• Sustituya Base64EncodedSMTPPassword por su contraseña de SMTP codificada en base64.• Sustituya [email protected] por la dirección de correo electrónico desde la que está

enviando. Esta identidad debe verificarse.• Sustituya [email protected] por la dirección de correo electrónico de destino. Si su

cuenta de Amazon SES todavía está en el entorno de pruebas, esta dirección debe verificarse.• Sustituya ConfigSet por el nombre del conjunto de configuración que desea aplicar a este

correo electrónico.

Note

Si no desea utilizar un conjunto de configuración, elimine toda la línea que comienzapor "X-SES-CONFIGURATION-SET".

3. Guarde el archivo como input.txt.4. En la línea de comando, escriba el comando siguiente:

openssl s_client -crlf -quiet -connect email-smtp.us-west-2.amazonaws.com:465 < input.txt

Note


Si el mensaje se envía, verá un resultado similar al siguiente:

250 Ok 01010160d7de98d8-21e57d9a-JZho-416c-bbe1-8ebaAexample-000000

La cadena de números y texto que sigue a 250 Ok es el ID de mensaje del correo electrónico.

Note

La conexión puede permanecer abierta después de que se envíe el mensaje. En tal caso,se cerrará automáticamente después de unos 10 segundos de inactividad.

106

Amazon Simple Email Service Developer GuideUso del API

Uso del API de Amazon SES para enviar correoelectrónicoPara enviar correo electrónico de producción a través de Amazon SES, puede utilizar la interfaz deSimple Mail Transfer Protocol (SMTP) o bien el API de Amazon SES. Para obtener más informaciónsobre la interfaz SMTP, consulte Uso de la interfaz de SMTP de Amazon SES para enviar correoelectrónico (p. 74). Esta sección describe cómo enviar correo electrónico utilizando el API.

El API de Amazon SES tiene una interfaz de consultas a través de HTTPS. Consulte Regiones y AmazonSES (p. 439) para ver una lista de puntos de enlace de API de Amazon SES. Cuando envíe un correoelectrónico a través del API, puede proporcionar información limitada y hacer que Amazon SES agrupeel correo electrónico por usted o bien puede agrupar el correo usted mismo, a fin de ejercer un controlcompleto sobre el contenido y el formato. Para obtener más información sobre el API, consulte la AmazonSimple Email Service API Reference. Puede llamar al API de las formas siguientes:

• Realizar solicitudes de respuesta y respuestas sin procesar: se trata del método más avanzado, ya queestá llamando al API directamente. Para obtener información acerca de cómo realizar solicitudes deconsulta y respuestas, consulte API de consulta de Amazon SES (p. 396).

• Usar un SDK de AWS: los SDK de AWS facilitan el acceso a las API de varios servicios de AWS,incluido Amazon SES. Cuando utiliza un SDK, se encarga de la autenticación, la firma de solicitudes, lalógica de reintentos, el control de errores y otras funciones de bajo nivel para que pueda centrarse encrear aplicaciones que satisfagan a sus clientes.

• Utilizar una interfaz de línea de comando: la AWS Command Line Interface es la herramienta de línea decomando para Amazon SES. También ofrecemos las Herramientas de AWS para Windows PowerShellpara aquellos que realizan scripts en el entorno de PowerShell.

Independientemente de si accede al API de Amazon SES directa o indirectamente a través de un SDKde AWS, la AWS Command Line Interface o las Herramientas de AWS para Windows PowerShell el APIde Amazon SES ofrece dos formas distintas de enviar un correo electrónico, en función de la cantidad decontrol que desee sobre la composición del mensaje de correo electrónico:

• Formateado: Amazon SES compone y envía un mensaje de correo electrónico con el formato adecuado.Solo hay que suministrar las direcciones "De:" y "Para:", un asunto y el cuerpo del mensaje. AmazonSES se encarga de todo lo demás. Para obtener más información, consulte Envío de correo electrónicocon formato utilizando el API de Amazon SES (p. 107).

• Sin procesar: puede componer manualmente y enviar un mensaje de correo electrónico, especificandosus propios encabezados de correo electrónico y tipos de MIME. Si tiene experiencia en dar formato asu propio correo electrónico, esta interfaz le ofrece un mayor control sobre la composición del mensaje.Para obtener más información, consulte Envío de correo electrónico sin procesar mediante el API deAmazon SES (p. 108).

Envío de correo electrónico con formato utilizando el API deAmazon SESPuede enviar un mensaje con formato mediante la Consola de administración de AWS o mediante unallamada al API de Amazon SES a través de una aplicación directamente o indirectamente a través de unSDK de AWS, la AWS Command Line Interface o las Herramientas de AWS para Windows PowerShell.

El API de Amazon SES proporciona la acción SendEmail, que le permite componer y enviar un correoelectrónico con formato. SendEmail requiere una dirección de remitente "From:", una dirección dedestinatario "To:", un asunto de mensaje y un cuerpo de mensaje (texto, HTML o ambos). Para obteneruna descripción completa de SendEmail, acceda al Amazon Simple Email Service API Reference.

107



https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html




Note

La cadena de la dirección de correo electrónico debe ser un ASCII de 7 bits. Si desea enviar a odesde direcciones de correo electrónico que contengan caracteres unicode en la parte de dominiode una dirección, debe cifrar el dominio utilizando Punycode. Para obtener más información,consulte RFC 3492.

Si desea ver un ejemplo de cómo componer un mensaje con formato mediante el AWS SDK for Java oel AWS SDK para .NET, consulte Enviar un correo electrónico utilizando AWS SDK for Java (p. 35) oEnviar un correo electrónico utilizando AWS SDK para .NET (p. 31), respectivamente.

Para obtener consejos sobre cómo incrementar la velocidad de envío de correo electrónico al realizarvarias llamadas a SendEmail, consulte Aumento del desempeño con Amazon SES (p. 463).

Envío de correo electrónico sin procesar mediante el API deAmazon SESPuede utilizar la operación SendRawEmail de Amazon SES para enviar mensajes muy personalizados asus destinatarios.

Esta sección incluye procedimientos para la construcción y el envío de correos electrónicos sin procesar através del API de Amazon SES.

Acerca de los campos de encabezados de correo electrónicoSimple Mail Transfer Protocol (SMTP) especifica la forma en que se envían los mensajes de correoelectrónico definiendo el sobre del correo y algunos de sus parámetros, pero no se preocupa del contenidodel mensaje. En lugar de ello, el formato de mensajes de Internet (RFC 5322) define cómo se construye elmensaje.

Con la especificación de formato de mensajes de Internet, todos los mensajes de correo electrónico secomponen de un encabezado y de un cuerpo. El encabezado se compone de metadatos de mensaje y elcuerpo contiene el mensaje propiamente dicho. Para obtener más información acerca los encabezados ycuerpos de correo electrónico, consulte Formato de correo electrónico y Amazon SES (p. 15).

Uso de MIMEEl protocolo SMTP está diseñado para enviar mensajes de correo electrónico compuestos por caracteresASCII de 7 bits. Aunque esto funciona bien para muchos casos de uso, es insuficiente para codificacionesde texto no ASCII (como Unicode), contenido binario o archivos adjuntos. El estándar Multipurpose InternetMail Extensions (MIME) se ha desarrollado para superar estas limitaciones, haciendo que sea posibleenviar muchas otras clases de contenido utilizando SMTP.

El estándar MIME funciona desglosando el cuerpo del mensaje en varias partes y, a continuación,especificando lo que hay que hacer con cada parte. Por ejemplo, una parte del cuerpo de un mensaje decorreo electrónico podría ser texto sin formato, mientras que otra podría ser HTML. Además, MIME permitea los mensajes de correo electrónico contener uno o más archivos adjuntos. Los destinatarios del mensajepueden ver los archivos adjuntos desde sus clientes de correo electrónico o pueden guardar los archivosadjuntos.

El encabezado del mensaje y el contenido están separados por una línea en blanco. Cada parte del correoelectrónico está separada por un límite, una cadena de caracteres que indica el inicio y el final de cadaparte.

El mensaje multiparte del siguiente ejemplo contiene un texto y una parte HTML. También contiene unarchivo adjunto.

From: "Sender Name" <[email protected]>To: [email protected]

108

https://tools.ietf.org/html/rfc3492



Subject: Customer service contact infoContent-Type: multipart/mixed; boundary="a3f166a86b56ff6c37755292d690675717ea3cd9de81228ec2b76ed4a15d6d1a"

--a3f166a86b56ff6c37755292d690675717ea3cd9de81228ec2b76ed4a15d6d1aContent-Type: multipart/alternative; boundary="sub_a3f166a86b56ff6c37755292d690675717ea3cd9de81228ec2b76ed4a15d6d1a"

--sub_a3f166a86b56ff6c37755292d690675717ea3cd9de81228ec2b76ed4a15d6d1aContent-Type: text/plain; charset=iso-8859-1Content-Transfer-Encoding: quoted-printable

Please see the attached file for a list of customers to contact.

--sub_a3f166a86b56ff6c37755292d690675717ea3cd9de81228ec2b76ed4a15d6d1aContent-Type: text/html; charset=iso-8859-1Content-Transfer-Encoding: quoted-printable

<html><head></head><body><h1>Hello!</h1><p>Please see the attached file for a list of customers to contact.</p></body></html>

--sub_a3f166a86b56ff6c37755292d690675717ea3cd9de81228ec2b76ed4a15d6d1a--

--a3f166a86b56ff6c37755292d690675717ea3cd9de81228ec2b76ed4a15d6d1aContent-Type: text/plain; name="customers.txt"Content-Description: customers.txtContent-Disposition: attachment;filename="customers.txt"; creation-date="Sat, 05 Aug 2017 19:35:36 GMT";Content-Transfer-Encoding: base64

SUQsRmlyc3ROYW1lLExhc3ROYW1lLENvdW50cnkKMzQ4LEpvaG4sU3RpbGVzLENhbmFkYQo5MjM4OSxKaWUsTGl1LENoaW5hCjczNCxTaGlybGV5LFJvZHJpZ3VleixVbml0ZWQgU3RhdGVzCjI4OTMsQW5heWEsSXllbmdhcixJbmRpYQ==

--a3f166a86b56ff6c37755292d690675717ea3cd9de81228ec2b76ed4a15d6d1a--

El tipo de contenido del mensaje es multipart/mixed, lo que indica que el mensaje tiene muchaspartes (en este ejemplo, un cuerpo y un archivo adjunto) y el cliente de recepción debe gestionar cadaparte por separado. Anidadas en la sección del cuerpo, existe una segunda parte que utiliza el tipo decontenido multipart/alternative. Este tipo de contenido indica que cada parte contiene otrasversiones alternativas del mismo contenido (en este caso, una versión de texto y una versión en HTML).Cuando se envía, si el cliente de correo electrónico del destinatario puede mostrar HTML, entonces semuestra la versión HTML del texto del cuerpo. Si el cliente de correo electrónico del destinatario no puedemostrar HTML, entonces se muestra la versión de texto sin formato. Ambas versiones del mensaje tambiéncontendrán un archivo adjunto (en este caso, un archivo de texto breve que contiene algunos nombres declientes).

Al anidar una parte de MIME dentro de otra parte, como en este ejemplo, la parte anidada debe utilizar unparámetro boundary que es distinto del parámetro boundary en la parte principal. Estos límites debenser cadenas de caracteres únicas. Para definir un límite entre las partes de MIME, escriba dos guiones (--)seguidos de la cadena límite. Al final de una parte MIME, coloque dos guiones tanto al comienzo como alfinal de la cadena límite.

Codificación MIME

Debido a la restricción ASCII de 7 bits de SMTP, cualquier contenido que incluya caracteres de 8 bitsse debe convertir primero a ASCII de 7 bits antes de enviarlo. MIME define un campo de encabezadoContent-Transfer-Encoding para este fin.

109


Convencionalmente, el esquema de codificación más común es base64, donde el contenido binario de 8bits se codifica con un conjunto bien definido de caracteres ASCII de 7 bits. Tras la recepción, el clientede correo electrónico inspecciona el campo encabezado Content-Transfer-Encoding y puede realizar deinmediato una operación de descifrado en base64 del contenido para devolverlo de este modo a su formaoriginal. En la mayoría de clientes de correo electrónico, el cifrado y el descifrado se realizan de formaautomática y el usuario no tiene que ser consciente de ello.

En el ejemplo anterior, el archivo adjunto "customers.txt" debe descifrarse del formato base64 para leerlo.Algunos clientes de correo electrónico codificarán todas las partes de MIME en formato base64, incluso siestuviesen originalmente en texto sin formato. Esto no suele ser un problema, ya que los clientes de correoelectrónico llevan a cabo el cifrado y el descifrado automáticamente.

Note

Para ver una lista de tipos MIME que acepta Amazon SES, consulte Apéndice: tipos de archivosadjuntos no admitidos (p. 503).

Si desea que ciertas partes de un mensaje, como algunos encabezados, contengan caracteres que nosean ASCII de 7 bits, debe utilizar la sintaxis de palabras cifradas MIME (RFC 2047) en lugar de unacadena literal. La sintaxis de palabras cifradas MIME utiliza el siguiente formato: =?charset?encoding?encoded-text?=. Para obtener más información, consulte RFC 2047. Si desea enviar a o desde direccionesde correo electrónico que contengan caracteres unicode en la parte de dominio de una dirección, debecifrar el dominio utilizando Punycode. Para obtener más información, consulte RFC 3492.

Envío de un correo electrónico sin procesar mediante el API de Amazon SESEl API de Amazon SES proporciona la acción SendRawEmail, que le permite componer y enviar unmensaje de correo electrónico en el formato que especifique. Para obtener una descripción completa deSendRawEmail, consulte el Amazon Simple Email Service API Reference.

Note

Para obtener consejos sobre cómo incrementar la velocidad de envío de correo electrónicoal realizar varias llamadas a SendRawEmail, consulte Aumento del desempeño con AmazonSES (p. 463).

El cuerpo del mensaje debe contener un mensaje de correo electrónico sin procesar con el formatocorrecto, con campos de encabezado adecuados y con codificación del cuerpo del mensaje. Aunque esposible construir el mensaje sin procesar manualmente dentro de una aplicación, es mucho más sencillohacerlo a través de las bibliotecas de correo existentes.

Java

El siguiente ejemplo de código muestra cómo utilizar la biblioteca JavaMail y el AWS SDK for Javapara componer y enviar correo electrónico sin procesar.

import java.io.ByteArrayOutputStream;import java.io.IOException;import java.io.PrintStream;import java.nio.ByteBuffer;import java.util.Properties;

// JavaMail libraries. Download the JavaMail API from // https://javaee.github.io/javamail. After you download the jar file, // include it in the build path for your project. import javax.activation.DataHandler;import javax.activation.DataSource;import javax.activation.FileDataSource;import javax.mail.Message;import javax.mail.MessagingException;import javax.mail.Session;import javax.mail.internet.AddressException;import javax.mail.internet.InternetAddress;

110




https://javaee.github.io/javamail/

https://aws.amazon.com/sdk-for-java


import javax.mail.internet.MimeBodyPart;import javax.mail.internet.MimeMessage;import javax.mail.internet.MimeMultipart;import javax.mail.internet.MimeUtility;

// AWS SDK libraries. Download the AWS SDK for Java // from https://aws.amazon.com/sdk-for-javaimport com.amazonaws.regions.Regions;import com.amazonaws.services.simpleemail.AmazonSimpleEmailService;import com.amazonaws.services.simpleemail.AmazonSimpleEmailServiceClientBuilder;import com.amazonaws.services.simpleemail.model.RawMessage;import com.amazonaws.services.simpleemail.model.SendRawEmailRequest;


// Replace [email protected] with your "From" address. // This address must be verified with Amazon SES. private static String SENDER = "Sender Name <[email protected]>";

// Replace [email protected] with a "To" address. If your account // is still in the sandbox, this address must be verified. private static String RECIPIENT = "[email protected]";

// Specify a configuration set. If you do not want to use a configuration // set, comment the following variable, and the // ConfigurationSetName=CONFIGURATION_SET argument below. private static String CONFIGURATION_SET = "ConfigSet";

// The subject line for the email. private static String SUBJECT = "Customer service contact info";

// The full path to the file that will be attached to the email. // If you are using Windows, escape backslashes as shown in this variable. private static String ATTACHMENT = "C:\\Users\\sender\\customers-to-contact.xlsx";

// The email body for recipients with non-HTML email clients. private static String BODY_TEXT = "Hello,\r\n" + "Please see the attached file for a list " + "of customers to contact.";

// The HTML body of the email. private static String BODY_HTML = "<html>" + "<head></head>" + "<body>" + "<h1>Hello!</h1>" + "<p>Please see the attached file for a " + "list of customers to contact.</p>" + "</body>" + "</html>";

public static void main(String[] args) throws AddressException, MessagingException, IOException { String DefaultCharSet = MimeUtility.getDefaultJavaCharset(); Session session = Session.getDefaultInstance(new Properties()); // Create a new MimeMessage object. MimeMessage message = new MimeMessage(session); // Add subject, from and to lines. message.setSubject(SUBJECT, "UTF-8"); message.setFrom(new InternetAddress(SENDER)); message.setRecipients(Message.RecipientType.TO, InternetAddress.parse(RECIPIENT));

111


// Create a multipart/alternative child container. MimeMultipart msg_body = new MimeMultipart("alternative"); // Create a wrapper for the HTML and text parts. MimeBodyPart wrap = new MimeBodyPart(); // Define the text part. MimeBodyPart textPart = new MimeBodyPart(); // Encode the text content and set the character encoding. This step is // necessary if you're sending a message with characters outside the // ASCII range. textPart.setContent(MimeUtility .encodeText(BODY_TEXT,DefaultCharSet,"B"), "text/plain; charset=UTF-8"); textPart.setHeader("Content-Transfer-Encoding", "base64"); // Define the HTML part. MimeBodyPart htmlPart = new MimeBodyPart(); // Encode the HTML content and set the character encoding. htmlPart.setContent(MimeUtility .encodeText(BODY_HTML,DefaultCharSet,"B"),"text/html; charset=UTF-8"); htmlPart.setHeader("Content-Transfer-Encoding", "base64"); // Add the text and HTML parts to the child container. msg_body.addBodyPart(textPart); msg_body.addBodyPart(htmlPart); // Add the child container to the wrapper object. wrap.setContent(msg_body); // Create a multipart/mixed parent container. MimeMultipart msg = new MimeMultipart("mixed"); // Add the parent container to the message. message.setContent(msg); // Add the multipart/alternative part to the message. msg.addBodyPart(wrap); // Define the attachment MimeBodyPart att = new MimeBodyPart(); DataSource fds = new FileDataSource(ATTACHMENT); att.setDataHandler(new DataHandler(fds)); att.setFileName(fds.getName()); // Add the attachment to the message. msg.addBodyPart(att);

// Try to send the email. try { System.out.println("Attempting to send an email through Amazon SES " +"using the AWS SDK for Java...");

// Instantiate an Amazon SES client, which will make the service // call with the supplied AWS credentials. AmazonSimpleEmailService client = AmazonSimpleEmailServiceClientBuilder.standard() // Replace US_WEST_2 with the AWS Region you're using for // Amazon SES. .withRegion(Regions.US_WEST_2).build(); // Print the raw email content on the console PrintStream out = System.out; message.writeTo(out);

// Send the email.

112


ByteArrayOutputStream outputStream = new ByteArrayOutputStream(); message.writeTo(outputStream); RawMessage rawMessage = new RawMessage(ByteBuffer.wrap(outputStream.toByteArray()));

SendRawEmailRequest rawEmailRequest = new SendRawEmailRequest(rawMessage) .withConfigurationSetName(CONFIGURATION_SET); client.sendRawEmail(rawEmailRequest); System.out.println("Email sent!"); // Display an error if something goes wrong. } catch (Exception ex) { System.out.println("Email Failed"); System.err.println("Error message: " + ex.getMessage()); ex.printStackTrace(); } }}

Python

El siguiente ejemplo de código muestra cómo utilizar los paquetes Python email.mime y el AWS SDKfor Python (Boto) para componer y enviar un correo electrónico sin procesar.

import osimport boto3from botocore.exceptions import ClientErrorfrom email.mime.multipart import MIMEMultipartfrom email.mime.text import MIMETextfrom email.mime.application import MIMEApplication





# The subject line for the email.SUBJECT = "Customer service contact info"

# The full path to the file that will be attached to the email.ATTACHMENT = "path/to/customers-to-contact.xlsx"

# The email body for recipients with non-HTML email clients.BODY_TEXT = "Hello,\r\nPlease see the attached file for a list of customers to contact."

# The HTML body of the email.BODY_HTML = """\<html><head></head><body><h1>Hello!</h1><p>Please see the attached file for a list of customers to contact.</p>

113

https://docs.python.org/2/library/email.mime.html

https://aws.amazon.com/sdk-for-python



</body></html>"""

# The character encoding for the email.CHARSET = "utf-8"


# Create a multipart/mixed parent container.msg = MIMEMultipart('mixed')# Add subject, from and to lines.msg['Subject'] = SUBJECT msg['From'] = SENDER msg['To'] = RECIPIENT

# Create a multipart/alternative child container.msg_body = MIMEMultipart('alternative')

# Encode the text and HTML content and set the character encoding. This step is# necessary if you're sending a message with characters outside the ASCII range.textpart = MIMEText(BODY_TEXT.encode(CHARSET), 'plain', CHARSET)htmlpart = MIMEText(BODY_HTML.encode(CHARSET), 'html', CHARSET)

# Add the text and HTML parts to the child container.msg_body.attach(textpart)msg_body.attach(htmlpart)

# Define the attachment part and encode it using MIMEApplication.att = MIMEApplication(open(ATTACHMENT, 'rb').read())

# Add a header to tell the email client to treat this part as an attachment,# and to give the attachment a name.att.add_header('Content-Disposition','attachment',filename=os.path.basename(ATTACHMENT))

# Attach the multipart/alternative child container to the multipart/mixed# parent container.msg.attach(msg_body)

# Add the attachment to the parent container.msg.attach(att)#print(msg)try: #Provide the contents of the email. response = client.send_raw_email( Source=SENDER, Destinations=[ RECIPIENT ], RawMessage={ 'Data':msg.as_string(), }, ConfigurationSetName=CONFIGURATION_SET )# 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'])

114

Amazon Simple Email Service Developer GuideEnvío de correo electrónico personalizado

Envío de correo electrónico personalizado utilizando elAPI de Amazon SESPuede utilizar la operación del API CreateTemplate para crear plantillas de correo electrónico. Estasplantillas incluyen una línea de asunto y el texto y partes en HTML del cuerpo del correo electrónico.Las secciones de asunto y cuerpo también podrían contener valores únicos personalizados para cadadestinatario.

Existen unos límites y otras consideraciones al utilizar estas características:

• Puede crear hasta 10 000 plantillas de correo electrónico por cada cuenta de Amazon SES.• Cada plantilla puede tener un tamaño de hasta 500 KB, incluidos el texto y las partes en HTML.• Puede incluir un número ilimitado de variables de sustitución en cada plantilla.• Puede enviar correo electrónico a un máximo de 50 destinos en cada llamada a la operaciónSendBulkTemplatedEmail. Un destino incluye una lista de destinatarios, así como destinatario CCy BCC. Tenga en cuenta que el número de destinos con los que puede ponerse en contacto en unaúnica llamada al API podría estar limitado por el ratio máximo de envío de su cuenta. Para obtener másinformación, consulte Administrar sus límites de envío de Amazon SES (p. 136).

Esta sección incluye procedimientos para la creación de plantillas de correo electrónico y para el envío decorreos electrónicos personalizados.

Parte 1: Configurar las notificaciones de eventos de errores depresentaciónSi envía un correo electrónico que contiene contenido de personalización no válido, Amazon SES puedeaceptar inicialmente el mensaje, pero puede no ser capaz de enviarlo. Por este motivo, si tiene previstoenviar correo electrónico personalizado, debe configurar Amazon SES para enviar notificaciones deeventos de errores de presentación a través de Amazon SNS. Cuando reciba una notificación de eventode error de presentación, puede identificar qué mensaje incluía el contenido no válido, solucionar losproblemas y enviar el mensaje de nuevo.

Es absolutamente recomendable que realice el procedimiento de esta sección, aunque sea opcional.

Para configurar notificaciones de eventos de errores de presentación

1. Crear un tema de Amazon SNS. Para ver los procedimientos, consulte Creación de un tema en laGuía para desarrolladores de Amazon Simple Notification Service.

2. Suscríbase al tema de Amazon SNS Por ejemplo, si desea recibir notificaciones de errores depresentación por correo electrónico, suscriba un punto de enlace de correo electrónico (es decir, sudirección de correo electrónico) al tema.

Para ver los procedimientos, consulte Suscripción a un tema en la Guía para desarrolladores deAmazon Simple Notification Service.

3. Realice los procedimientos de the section called “Configuración de un destino de AmazonSNS” (p. 267) para configurar los conjuntos de configuración para publicar eventos de errores depresentación en su tema de Amazon SNS.

Parte 2: Crear una plantilla de correo electrónicoLas instrucciones de esta sección suponen que está utilizando el AWS CLI y que ha lo configurado parainteractuar con su cuenta de AWS. Para obtener más información acerca de cómo instalar y configurar elAWS CLI, consulte la Guía del usuario de AWS Command Line Interface.

115

https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html

https://docs.aws.amazon.com/sns/latest/dg/SubscribeTopic.html



Para crear la plantilla


{ "Template": { "TemplateName": "MyTemplate", "SubjectPart": "Greetings, {{name}}!", "HtmlPart": "<h1>Hello {{name}},</h1><p>Your favorite animal is {{favoriteanimal}}.</p>", "TextPart": "Dear {{name}},\r\nYour favorite animal is {{favoriteanimal}}." }}

Este código contiene las siguientes propiedades:

• TemplateName: el nombre de la plantilla. Cuando envíe el correo electrónico, consulte este nombre.• SubjectPart: la línea de asunto del correo electrónico. Esta propiedad podría contener etiquetas de

sustitución. Estas etiquetas utilizan el siguiente formato: {{tagname}}. Cuando envíe el correoelectrónico, puede especificar un valor para tagname para cada destino.

El ejemplo anterior incluye dos etiquetas: {{name}} y {{favoriteanimal}}.• HtmlPart: el cuerpo HTML del correo electrónico. Esta propiedad podría contener etiquetas de

sustitución.• TextPart: el cuerpo de texto del correo electrónico. Los destinatarios cuyos clientes de correo

electrónico no muestran el correo electrónico en HTML ven esta versión del correo electrónico. Estapropiedad podría contener etiquetas de sustitución.

2. Personalice el ejemplo anterior para adaptarse a sus necesidades y, a continuación, guarde el archivocomo mytemplate.json.

3. En la línea de comando, escriba el siguiente comando para crear una nueva plantilla utilizando laoperación del API CreateTemplate: aws ses create-template --cli-input-json file://mytemplate.json

Parte 3: Enviar el correo electrónico personalizadoDespués de crear una plantilla de correo electrónico, puede utilizarla para enviar correo electrónico.Existen dos operaciones del API que puede utilizar para enviar mensajes de correo utilizando plantillas:SendTemplatedEmail y SendBulkTemplatedEmail. La operación SendTemplatedEmail resultaútil para enviar un correo electrónico personalizado a un único destino (una colección de destinatarios"To", "CC" y "BCC" que recibirán el mismo correo electrónico). La operación SendBulkTemplatedEmailresulta útil para enviar correos electrónicos únicos a varios destinos en una única llamada al API deAmazon SES. Esta sección proporciona ejemplos de cómo utilizar el AWS CLI para enviar correoelectrónico a través de estas operaciones.

Envío de correo electrónico con plantilla a un destino únicoPuede utilizar la operación SendTemplatedEmail para enviar un correo electrónico a un destino único.Todos los destinatarios del objeto Destination recibirán el mismo correo electrónico.

Para enviar un correo electrónico con plantilla a un destino único


{ "Source": "[email protected]", "Template": "MyTemplate", "ConfigurationSetName": "ConfigSet", "Destination": {

116


"ToAddresses": [ "[email protected]" ] }, "TemplateData": "{ \"name\":\"Alejandro\", \"favoriteanimal\": \"alligator\" }"}


• Source: la dirección de correo electrónico del remitente.• Template: el nombre de la plantilla que aplicar al correo electrónico.• ConfigurationSetName: el nombre del conjunto de configuración que se va a usar al enviar el correo

electrónico.

Note

Le recomendamos que utilice un conjunto de configuración que esté configuradopara publicar eventos de errores de presentación en Amazon SNS. Para obtener másinformación, consulte the section called “Parte 1: Configurar las notificaciones” (p. 115).

• Destination: las direcciones de destinatario. Puede incluir varias direcciones "To", "CC" y "BCC".Cuando utiliza la operación SendTemplatedEmail, todos los destinatarios reciben el mismomensaje de correo electrónico.

• TemplateData: un objeto JSON que contiene pares de clave-valor. Las claves corresponden alas variables de la plantilla (por ejemplo, {{name}}). Los valores representan el contenido quesustituye las variables en el correo electrónico.

2. Cambie los valores del código anterior según sus necesidades y guarde el archivo comomyemail.json.

3. En la línea de comandos, escriba el siguiente comando para enviar el correo electrónico: aws sessend-templated-email --cli-input-json file://myemail.json

Envío de correo electrónico con plantilla a varios destinos

Puede utilizar la operación SendBulkTemplatedEmail para enviar un correo electrónico a variosdestinos en una llamada única al API. Amazon SES envía un correo electrónico único al destinatario odestinatarios en cada objeto Destination.

Para enviar un correo electrónico con plantilla a varios destinos


{ "Source":"[email protected]", "Template":"MyTemplate", "ConfigurationSetName": "ConfigSet", "Destinations":[ { "Destination":{ "ToAddresses":[ "[email protected]" ] }, "ReplacementTemplateData":"{ \"name\":\"Anaya\", \"favoriteanimal\":\"angelfish\" }" }, { "Destination":{ "ToAddresses":[ "[email protected]" ]

117


}, "ReplacementTemplateData":"{ \"name\":\"Liu\", \"favoriteanimal\":\"lion\" }" }, { "Destination":{ "ToAddresses":[ "[email protected]" ] }, "ReplacementTemplateData":"{ \"name\":\"Shirley\", \"favoriteanimal\":\"shark\" }" }, { "Destination":{ "ToAddresses":[ "[email protected]" ] }, "ReplacementTemplateData":"{}" } ], "DefaultTemplateData":"{ \"name\":\"friend\", \"favoriteanimal\":\"unknown\" }"}


• Source: la dirección de correo electrónico del remitente.• Template: el nombre de la plantilla que aplicar al correo electrónico.• ConfigurationSetName: el nombre del conjunto de configuración que se va a usar al enviar el correo

electrónico.

Note

Le recomendamos que utilice un conjunto de configuración que esté configuradopara publicar eventos de errores de presentación en Amazon SNS. Para obtener másinformación, consulte the section called “Parte 1: Configurar las notificaciones” (p. 115).

• Destinos: una matriz que contiene uno o varios destinos.• Destination: las direcciones de destinatario. Puede incluir varias direcciones "To", "CC" y "BCC".

Cuando utiliza la operación SendBulkTemplatedEmail, todos los destinatarios dentro delmismo objeto Destination reciben el mismo mensaje de correo electrónico.

• ReplacementTemplateData: un objeto JSON que contiene pares de clave-valor. Las clavescorresponden a las variables de la plantilla (por ejemplo, {{name}}). Los valores representan elcontenido que sustituye las variables en el correo electrónico.

• DefaultTemplateData: un objeto JSON que contiene pares de clave-valor. Las claves correspondena las variables de la plantilla (por ejemplo, {{name}}). Los valores representan el contenido quesustituye las variables en el correo electrónico. Esta objeto contiene datos alternativos. Si un objetoDestination contiene un objeto JSON vacío en la propiedad ReplacementTemplateData, seutilizan los valores de la propiedad DefaultTemplateData.

2. Cambie los valores del código anterior según sus necesidades y guarde el archivo comomybulkemail.json.

3. En la línea de comandos, escriba el siguiente comando para enviar el correo masivo: aws ses send-bulk-templated-email --cli-input-json file://mybulkemail.json

Personalización avanzada del correo electrónicoLa característica de plantillas de Amazon SES se basa en el sistema de plantillas de Handlebars. Puedeutilizar Handlebars para crear plantillas que incluyan características avanzadas, como atributos anidados,

118


iteración de matrices, instrucciones condicionales básicas y la creación de funciones parciales insertadas.En esta sección se proporcionan ejemplos de estas características.

Handlebars incluye características adicionales además de las documentadas en esta sección. Paraobtener más información, consulte Built-In Helpers en handlebarsjs.com.

Temas• Análisis de atributos anidados (p. 119)• Recorrido de listas en iteración (p. 119)• Uso de instrucciones condicionales básicas (p. 121)• Creación de funciones parciales insertadas (p. 123)

Análisis de atributos anidadosHandlebars admite rutas anidadas, lo que facilita la organización de datos de clientes complejos y lareferencia a esos datos en sus plantillas de correo electrónico.

Por ejemplo, puede organizar los datos de los destinatarios en varias categorías generales. Dentro de cadauna de estas categorías, puede incluir información detallada. El siguiente ejemplo de código muestra unejemplo de esta estructura para un único destinatario:

{ "meta":{ "userId":"51806220607" }, "contact":{ "firstName":"Anaya", "lastName":"Iyengar", "city":"Bengaluru", "country":"India", "postalCode":"560052" }, "subscription":[ { "interest":"Sports" }, { "interest":"Travel" }, { "interest":"Cooking" } ]}

En sus plantillas de correo electrónico, puede hacer referencia a atributos anidados proporcionando elnombre del atributo principal, seguido de un punto (.), seguido del nombre del atributo para el que deseaincluir el valor. Por ejemplo, si utiliza la estructura de datos que se muestra en el ejemplo anterior y deseaincluir el nombre de cada destinatario en la plantilla de correo electrónico, incluya el siguiente texto en suplantilla de correo electrónico: Hello {{Contact.FirstName}}!

Handlebars puede analizar rutas que tengan varios niveles anidados, lo que le proporciona flexibilidad a lahora de estructurar los datos de la plantilla.

Recorrido de listas en iteraciónLa función auxiliar each recorre en iteración los elementos de una matriz. El código siguiente es unejemplo de una plantilla de correo electrónico que utiliza la función auxiliar each para crear una relacióndetallada de los intereses de cada destinatario.

119

http://handlebarsjs.com/builtin_helpers.html

http://handlebarsjs.com


{ "Template": { "TemplateName": "Preferences", "SubjectPart": "Subscription Preferences for {{contact.firstName}} {{contact.lastName}}", "HtmlPart": "<h1>Your Preferences</h1> <p>You have indicated that you are interested in receiving information about the following subjects:</p> <ul> {{#each subscription}} <li>{{interest}}</li> {{/each}} </ul> <p>You can change these settings at any time by visiting the <a href=https://www.example.com/prefererences/i.aspx?id={{meta.userId}}> Preference Center</a>.</p>", "TextPart": "Your Preferences\n\nYou have indicated that you are interested in receiving information about the following subjects:\n {{#each subscription}} - {{interest}}\n {{/each}} \nYou can change these settings at any time by visiting the Preference Center at https://www.example.com/prefererences/i.aspx?id={{meta.userId}}" }}

Important

En el ejemplo de código anterior, los valores de los atributos HtmlPart y TextPart incluyensaltos de línea para facilitar la lectura del ejemplo. El archivo JSON de la plantilla no puedecontener saltos de línea dentro de estos valores. Si ha copiado y pegado este ejemplo ensu propio archivo JSON, elimine los saltos de línea y espacios adicionales de las seccionesHtmlPart y TextPart antes de continuar.

Después de crear la plantilla, puede utilizar la operación SendTemplatedEmail oSendBulkTemplatedEmail para enviar correo electrónico a los destinatarios a través de esta plantilla.Siempre y cuando los destinatarios tengan al menos un valor en el objeto Interests, reciben un correoelectrónico que incluye una relación detallada de sus intereses. El siguiente ejemplo muestra un archivoJSON que se puede utilizar para enviar correo electrónico a varios destinatarios mediante la plantillaanterior:

{ "Source":"Sender Name <[email protected]>", "Template":"Preferences", "Destinations":[ { "Destination":{ "ToAddresses":[ "[email protected]" ] }, "ReplacementTemplateData":"{\"meta\":{\"userId\":\"51806220607\"},\"contact\":{\"firstName\":\"Anaya\",\"lastName\":\"Iyengar\"},\"subscription\":[{\"interest\":\"Sports\"},{\"interest\":\"Travel\"},{\"interest\":\"Cooking\"}]}" }, { "Destination":{ "ToAddresses":[ "[email protected]" ]

120


}, "ReplacementTemplateData":"{\"meta\":{\"userId\":\"1981624758263\"},\"contact\":{\"firstName\":\"Shirley\",\"lastName\":\"Rodriguez\"},\"subscription\":[{\"interest\":\"Technology\"},{\"interest\":\"Politics\"}]}" } ], "DefaultTemplateData":"{\"meta\":{\"userId\":\"\"},\"contact\":{\"firstName\":\"Friend\",\"lastName\":\"\"},\"subscription\":[]}"}

Cuando envíe un correo electrónico a los destinatarios indicados en el ejemplo anterior mediante laoperación SendBulkTemplatedEmail, recibirán un mensaje similar al ejemplo que se muestra en lasiguiente imagen:

Uso de instrucciones condicionales básicas

Esta sección se basa en el ejemplo descrito en la sección anterior. El ejemplo de la sección anterior utilizala función auxiliar each para recorrer en iteración una lista de intereses. Sin embargo, los destinatariospara los que no se especifican intereses reciben un correo electrónico que contiene una lista vacía.Mediante la función auxiliar {{if}}, puede formatear el correo electrónico de forma distinta si undeterminado atributo está presente en la plantilla de datos. El código siguiente utiliza la función auxiliar{{if}} para mostrar la lista con viñetas de la sección anterior si la matriz Subscription contiene algúnvalor. Si la matriz está vacía, se muestra un bloque de texto diferente.

{ "Template": { "TemplateName": "Preferences2", "SubjectPart": "Subscription Preferences for {{contact.firstName}} {{contact.lastName}}", "HtmlPart": "<h1>Your Preferences</h1> <p>Dear {{contact.firstName}},</p> {{#if subscription}} <p>You have indicated that you are interested in receiving information about the following subjects:</p> <ul> {{#each subscription}} <li>{{interest}}</li> {{/each}} </ul> <p>You can change these settings at any time by visiting the <a href=https://www.example.com/prefererences/i.aspx?id={{meta.userId}}> Preference Center</a>.</p> {{else}} <p>Please update your subscription preferences by visiting the <a href=https://www.example.com/prefererences/i.aspx?id={{meta.userId}}> Preference Center</a>. {{/if}}", "TextPart": "Your Preferences\n\nDear {{contact.firstName}},\n\n

121


{{#if subscription}} You have indicated that you are interested in receiving information about the following subjects:\n {{#each subscription}} - {{interest}}\n {{/each}} \nYou can change these settings at any time by visiting the Preference Center at https://www.example.com/prefererences/i.aspx?id={{meta.userId}}. {{else}} Please update your subscription preferences by visiting the Preference Center at https://www.example.com/prefererences/i.aspx?id={{meta.userId}}. {{/if}}" }}

Important

En el ejemplo de código anterior, los valores de los atributos HtmlPart y TextPart incluyensaltos de línea para facilitar la lectura del ejemplo. El archivo JSON de la plantilla no puedecontener saltos de línea dentro de estos valores. Si ha copiado y pegado este ejemplo ensu propio archivo JSON, elimine los saltos de línea y espacios adicionales de las seccionesHtmlPart y TextPart antes de continuar.

El siguiente ejemplo muestra un archivo JSON que se puede utilizar para enviar correo electrónico a variosdestinatarios mediante la plantilla anterior:

{ "Source":"Sender Name <[email protected]>", "Template":"Preferences2", "Destinations":[ { "Destination":{ "ToAddresses":[ "[email protected]" ] }, "ReplacementTemplateData":"{\"meta\":{\"userId\":\"51806220607\"},\"contact\":{\"firstName\":\"Anaya\",\"lastName\":\"Iyengar\"},\"subscription\":[{\"interest\":\"Sports\"},{\"interest\":\"Cooking\"}]}" }, { "Destination":{ "ToAddresses":[ "[email protected]" ] }, "ReplacementTemplateData":"{\"meta\":{\"userId\":\"1981624758263\"},\"contact\":{\"firstName\":\"Shirley\",\"lastName\":\"Rodriguez\"}}" } ], "DefaultTemplateData":"{\"meta\":{\"userId\":\"\"},\"contact\":{\"firstName\":\"Friend\",\"lastName\":\"\"},\"subscription\":[]}"}

En este ejemplo, el destinatario cuyos datos de la plantilla incluyen una lista de intereses recibe el mismocorreo electrónico que el ejemplo mostrado en la sección anterior. Sin embargo, el destinatario cuyos datosde la plantilla no incluyen intereses, recibe un correo electrónico similar al ejemplo que se muestra en lasiguiente imagen:

122


Creación de funciones parciales insertadas

Puede utilizar funciones parciales insertadas para simplificar las plantillas que incluyen cadenas repetidas.Por ejemplo, podría crear una función parcial insertada que incluyera el nombre del destinatario y, si estádisponible, sus apellidos añadiendo el siguiente código al principio de la plantilla:

{{#* inline \"fullName\"}}{{firstName}}{{#if lastName}} {{lastName}}{{/if}}{{/inline}}\n

Note

El carácter de nueva línea (\n) es necesario para separar el bloque {{inline}} del contenidode la plantilla. La nueva línea no se muestra en el resultado final.

Después de crear la función parcial fullName, puede incluirla en cualquier lugar de la plantilla añadiendodelante del nombre de la función parcial un signo mayor que (>) seguido de un espacio, como en elsiguiente ejemplo: {{> fullName}}. Las funciones parciales insertadas no se transfieren entre lasdistintas partes del correo electrónico. Por ejemplo, si desea utilizar la misma función parcial insertada enla versión HTML y de texto del correo electrónico, debe definirla en las secciones HtmlPart y TextPart.

También puede utilizar funciones parciales insertadas cuando recorre en iteración matrices. Puede utilizarel siguiente código para crear una plantilla que utilice la función parcial insertada fullName. En esteejemplo, la función parcial insertada se aplica tanto al nombre del destinatario como a una matriz de otrosnombres:

{ "Template": { "TemplateName": "Preferences3", "SubjectPart": "{{firstName}}'s Subscription Preferences", "HtmlPart": "{{#* inline \"fullName\"}} {{firstName}}{{#if lastName}} {{lastName}}{{/if}} {{/inline~}}\n <h1>Hello {{> fullName}}!</h1> <p>You have listed the following people as your friends:</p> <ul> {{#each friends}} <li>{{> fullName}}</li> {{/each}}</ul>", "TextPart": "{{#* inline \"fullName\"}} {{firstName}}{{#if lastName}} {{lastName}}{{/if}} {{/inline~}}\n Hello {{> fullName}}! You have listed the following people as your friends:\n {{#each friends}} - {{> fullName}}\n {{/each}}" }}

Important

En el ejemplo de código anterior, los valores de los atributos HtmlPart y TextPart incluyensaltos de línea para facilitar la lectura del ejemplo. El archivo JSON de la plantilla no puede

123

Amazon Simple Email Service Developer GuideAutenticación del correo electrónico

contener saltos de línea dentro de estos valores. Si ha copiado y pegado este ejemplo en supropio archivo JSON, elimine los saltos de línea y espacios adicionales de estas secciones.

Autenticación del correo electrónico en AmazonSES

Amazon Simple Email Service (Amazon SES) utiliza el Simple Mail Transfer Protocol (SMTP) para enviarcorreo electrónico. Dado que SMTP no ofrece por sí solo ninguna autenticación, los spammers puedenenviar mensajes de correo electrónico que declaren proceder de otra persona, ocultando así su verdaderoorigen. Mediante la falsificación de encabezados de correo electrónico y la suplantación de direccionesIP de origen, los spammers pueden engañar a los destinatarios diciéndoles que los mensajes de correoelectrónico que están recibiendo son auténticos.

La mayoría de los ISP que reenvían tráfico de correo electrónico adoptan medidas a fin de evaluar si elcorreo electrónico es legítimo. Una de las medidas que adoptan los ISP consiste en determinar si un correoelectrónico está autenticado. La autenticación requiere que los remitentes verifiquen que son el propietariode la cuenta desde la que están enviando el correo. En algunos casos, los ISP rechazan reenviar el correoelectrónico que no está autenticado. Para garantizar una capacidad de entrega óptima, le recomendamosque autentique su correo electrónico.

En las siguientes secciones se describen dos mecanismos de autenticación que utilizan los ISP,Sender Policy Framework (SPF) y Correo identificado con claves de dominio (DKIM), asimismo ofreceninstrucciones sobre cómo usar estos estándares con Amazon SES.

• Para obtener más información acerca de SPF, que proporciona una forma de rastrear un mensaje decorreo electrónico hasta el sistema desde el que se envió, consulte Autenticación de correo electrónicocon SPF en Amazon SES (p. 124).

• Para obtener más información acerca de DKIM, una norma que le permite firmar los mensajes de correoelectrónico para mostrar a los ISP que sus mensajes son legítimos y no han sido modificados en tránsito,consulte Autenticación de correo electrónico con DKIM en Amazon SES (p. 126).

• Para obtener información sobre cómo cumplir con Domain-based Message Authentication, Reportingand Conformance (DMARC), que se basa en SPF y DKIM, consulte Conformidad con DMARC utilizandoAmazon SES (p. 135).

Autenticación de correo electrónico con SPF enAmazon SESEl marco de directivas de remitente (SPF) es un estándar de validación de correo electrónico, definido enRFC 7208, diseñado para combatir la suplantación de correo electrónico. SPF permite a los propietarios dedominio para especificar qué servidores de correo electrónico están autorizados a enviar correo electrónicopara su dominio. Para indicar la conformidad con SPF, el propietario del dominio publica una lista deservidores de correo electrónico autorizados en un registro DNS en el servidor DNS del dominio. Cuandoun servidor de correo electrónico receptor recibe un correo electrónico que contiene el dominio en ladirección MAIL FROM, comprueba los registros DNS del dominio para comparar el servidor de correo deenvío con los servidores de correo electrónico autorizados y toma medidas sobre el correo electrónicosegún corresponda.

Un registro SPF indica a los ISP que ha autorizado a Amazon SES a enviar correo electrónico para sudominio. Cuando utiliza Amazon SES, su decisión sobre si desea publicar un registro SPF dependede si su correo electrónico solo requiere que su correo electrónico supere una comprobación SPF porparte del servidor de correo electrónico receptor o si desea que su correo electrónico cumpla requisitos

124


Amazon Simple Email Service Developer GuideAutenticación de correo electrónico con SPF

adicionales necesarios para transferir la autenticación Domain-based Message Authentication, Reportingand Conformance (DMARC) basada en SPF. Puede utilizar DKIM para conseguir la validación de DMARC,pero es recomendable utilizar tanto DKIM y SPF para la máxima capacidad de entrega.

• Para superar una comprobación de SPF: cuando utilice Amazon SES, hay dos configuraciones con lasque puede transferir una comprobación de SPF. La primera configuración consiste en utilizar el dominioMAIL FROM predeterminado de Amazon SES y no publicar un registro de SPF. Esta configuraciónle permite superar una comprobación SPF porque, de forma predeterminada, Amazon SES utiliza supropio dominio MAIL FROM para enviar los mensajes de correo electrónico. En este caso, se superarála comprobación de SPF porque el dominio MAIL FROM predeterminado es amazonses.com (o unsubdominio del mismo) y el servidor de correo de envío es Amazon SES.

La otra configuración que permite superar una comprobación de SPF consiste en configurar AmazonSES para utilizar su propio dominio MAIL FROM, en cuyo caso deberá publicar un registro SPF, ya queel dominio MAIL FROM y el dominio del servidor de correo de envío, Amazon SES, son diferentes. Lasinstrucciones para configurar su dominio para enviar correos electrónicos a través de un dominio MAILFROM personalizado se ofrecen en Uso de un dominio MAIL FROM personalizado (p. 65).

• Para superar una validación de DMARC basada en SPF: si desea que la validación de DMARC tengaéxito basada en SPF, debe configurar un dominio MAIL FROM personalizado (p. 65) y publicarun registro de SPF. Tenga en cuenta que el modo de conformidad en la política de DMARC debe serrelajado, que es la opción predeterminada. Para obtener más información sobre las políticas de DMARC,consulte https://dmarc.org/.

Añadir un registro de SPFEl procedimiento para añadir un registro TXT a la configuración DNS de su dominio depende de quiénproporciona su servicio DNS, pero para obtener instrucciones generales, consulte Adding a TXT Record toYour Domain's DNS Server en Registros TXT de verificación de dominio de Amazon SES (p. 62). Paraobtener información específica de registros de SPF, vaya a http://www.openspf.net y RFC 7208.

Añadir un registro de SPF nuevo

Si su dominio MAIL FROM personalizado no dispone de un registro SPF existente, publique un registroTXT con el siguiente valor. El nombre del registro puede estar vacío o ser @, en función de su servicio deDNS.

Important

Si utiliza "-all", tal y como se muestra en el ejemplo, los ISP podrían bloquear el correo electrónicodesde direcciones IP que no estén incluidas en el registro de SPF. Su registro de SPF debe,por tanto, incluir todas las direcciones IP que utilice para enviar correo electrónico. Como ayudapara la depuración, puede utilizar "~all" en su lugar. Al utilizar "~all", los ISP suelen aceptarnormalmente correo electrónico de direcciones IP que no se encuentran en el registro de SPF,pero es posible que lo marquen. Para mejorar la capacidad de entrega, utilice "-all" y añada unregistro para cada dirección IP. Para ver ejemplos de cómo autorizar varias direcciones IP, vaya ahttp://www.openspf.org/SPF_Record_Syntax.

"v=spf1 include:amazonses.com -all"

Añadir a un registro de SPF existente

Si su dominio ya tiene un registro de SPF, entonces debe añadir el siguiente mecanismo de SPF al registroexistente.

include:amazonses.com

125

https://dmarc.org/

http://www.openspf.net


http://www.openspf.org/SPF_Record_Syntax

Amazon Simple Email Service Developer GuideAutenticación de correo electrónico con DKIM

Autenticación de correo electrónico con DKIM enAmazon SESCorreo identificado con claves de dominio (DKIM) es un estándar que permite a los remitentes firmar susmensajes de correo electrónico y a los proveedores de servicios de Internet utilizar estas firmas paraverificar que estos mensajes son legítimos y no los ha modificado un tercero en tránsito.

Un mensaje de correo electrónico que se envía mediante DKIM incluye un campo de encabezado DKIM-Signature que contiene una representación firmada criptográficamente de todos o parte del mensaje. UnISP que recibe el mensaje puede descifrar la firma criptográfica utilizando una clave pública, publicadaen el registro DNS del remitente, para asegurarse de que el mensaje es auténtico. Para obtener másinformación acerca de DKIM, consulte http://www.dkim.org.

Las firmas DKIM son opcionales. Puede decidir firmar su correo electrónico utilizando una firma DKIM paramejorar la capacidad de entrega con proveedores de servicios de Internet conformes con DKIM. AmazonSES le ofrece dos opciones para firmar sus mensajes con una firma DKIM:

• Para configurar su dominio para que Amazon SES añada automáticamente una firma DKIM a todos losmensajes enviados desde el dominio, consulte Easy DKIM en Amazon SES (p. 126).

• Para añadir su propia firma DKIM a cualquier mensaje de correo electrónico que envíe a través del APISendRawEmail, consulte Firma DKIM manual en Amazon SES (p. 134).

Easy DKIM en Amazon SESEasy DKIM es una característica de Amazon SES que firma todos los mensajes que envíe desde undominio o dirección de correo electrónico verificada con una firma DKIM que utiliza una clave DKIM de1024 bits. Puede utilizar la consola de Amazon SES para configurar los ajustes de Easy DKIM y habilitaro deshabilitar la firma DKIM automática para sus mensajes de correo electrónico. Debe poder editar losregistros DNS de su dominio para configurar Easy DKIM. Con los registros DNS adecuados en vigor,puede habilitar la firma de Easy DKIM de cualquier dominio o dirección de correo electrónico verificada.

Se aplican las siguientes reglas:

• Al igual que con otros ajustes de identidad verificados, si verifica un dominio, subdominio y dirección decorreo electrónico que comparten un dominio raíz, la configuración de Easy DKIM se aplica al nivel másdetallado que haya verificado. Es decir:• La configuración de dirección de correo electrónico verificada anula la configuración de dominio

verificado.• La configuración de subdominio verificado anula la configuración de dominio verificado, las

configuraciones de subdominio de nivel inferior anulan las configuraciones de subdominio de nivelsuperior.

• Si verifica un dominio raíz y no verifica un determinado subdominio, entonces dicho subdominio utilizala configuración de Easy DKIM de dicho dominio raíz. Es decir, si el dominio raíz tiene Easy DKIMconfigurado y habilitado, los correos electrónicos del subdominio también están firmados por DKIMautomáticamente.

Una vez que configura Easy DKIM, los mensajes se firman automáticamente con DKIMindependientemente de si llama a Amazon SES a través de la interfaz de SMTP o del API (SendEmail oSendRawEmail). Tenga en cuenta que solo tiene que configurar Easy DKIM para el dominio que utiliza enla dirección de remitente ("From"), no para el dominio en una dirección de "Return-Path" o "Reply-To"

Si verifica un nuevo dominio, puede configurar Easy DKIM en ese momento. Si ya tiene un dominio o unadirección de correo electrónico verificados, puede añadir la capacidad Easy DKIM al mismo cuando lodesee.

126

http://www.dkim.org


Note

Amazon SES tiene puntos de enlace en varias regiones de AWS y la configuración de Easy DKIMse aplica a cada región de AWS por separado. Debe realizar el procedimiento de configuración deEasy DKIM para cada región en la que desea utilizar Easy DKIM. Para obtener más informaciónsobre el uso de Amazon SES en varias regiones de AWS, consulte Regiones y AmazonSES (p. 439).

Este tema contiene las siguientes secciones:

• Para configurar Easy DKIM mientras verifica un nuevo dominio, consulte Configuración de Easy DKIMpara un nuevo dominio (p. 127).

• Para configurar Easy DKIM en un dominio o dirección de correo electrónico que ya haya verificado,consulte Cómo configurar Easy DKIM para una identidad verificada existente (p. 129).

Configuración de Easy DKIM para un nuevo dominio

Si utiliza la consola de administración de AWS para verificar un nuevo dominio, también puede configurarEasy DKIM al mismo tiempo.

Estas instrucciones son solo para nuevos dominios. Si desea configurar Easy DKIM en un dominio odirección de correo electrónico que ya haya verificado, consulte Cómo configurar Easy DKIM para unaidentidad verificada existente (p. 129).

Para configurar Easy DKIM para un nuevo dominio



b. En el panel de navegación, en Identities, haga clic en Domains.2. Haga clic en Verify a New Domain.3. En el cuadro de diálogo Verify a New Domain, introduzca su nombre de dominio, seleccione la casilla

de verificación Generate DKIM settings y, a continuación, haga clic en Verify This Domain.

En el cuadro de diálogo resultante, verá todos los registros DNS que necesita para configurar laverificación de dominio y Easy DKIM. Esta información también estará disponible haciendo clic en elnombre de dominio después de cerrar el cuadro de diálogo.

127





4. Para completar la verificación de dominio, debe actualizar la configuración DNS de su dominio conla información de registro TXT en Domain Verification Record en el cuadro de diálogo Verify a NewDomain. Tenga en cuenta que algunos proveedores de nombres de dominio utilizan el término Hosten lugar de Name. Si su proveedor de DNS no permite guiones bajos en los nombres de registro,puede omitir _amazonses desde el valor Name del registro de verificación de dominio. Para ayudarlea identificar fácilmente este registro con la configuración DNS de su dominio, puede utilizar en Valueopcionalmente el prefijo amazonses:

Resalte y copie registros individuales o seleccione Download Record Set as CSV para descargartodos los registros.

Important

Los proveedores de DNS podrían añadir el nombre de dominio al final de los registrosDNS. Añadir un registro que ya contiene el nombre de dominio (como, por ejemplo_amazonses.example.com) podría dar lugar a la duplicación del nombre de dominio (como,por ejemplo _amazonses.example.com.example.com). Para evitar la duplicación del nombrede dominio, añada un punto al final del nombre de dominio en el registro DNS. Esto indicará asu proveedor de DNS que el nombre de registro es completo (es decir, ya no está relacionadocon el nombre de dominio) y evitará que el proveedor de DNS anexe un nombre de dominioadicional.

5. Para configurar DKIM, debe actualizar la configuración de DNS de su dominio con la información deregistro de CNAME del cuadro de diálogo. Tenga en cuenta que no puede omitir el guion bajo de_domainkey porque el guion bajo es obligatorio según RFC 4871.

Resalte y copie registros CNAME individuales o seleccione Download Record Set as CSV paradescargar todos los registros.

a. Si Route 53 proporciona el servicio DNS para el dominio que está verificando y ha iniciado sesiónen la consola de Amazon SES con la misma dirección de correo electrónico y contraseña queutiliza para Route 53, entonces tendrá la opción de actualizar de inmediato su configuración deDNS, tanto para la verificación de dominio como para DKIM desde la consola de Amazon SES.

b. Si no utiliza Route 53, tendrá que actualizar la configuración de DNS de acuerdo con elprocedimiento establecido por su proveedor de servicios de DNS. (Consulte a su administradordel sistema si no está seguro de quién proporciona el servicio DNS). Amazon Web Services

128



detectará en última instancia que ha actualizado sus registros de DNS; este proceso de detecciónpodría tardar hasta 72 horas.

Cuando se ha completado la verificación, el Status del dominio en la consola de Amazon SEScambiará de verificación pendiente a verificado y recibirá un correo electrónico de confirmaciónAmazon SES Domain Verification SUCCESS de Amazon Web Services. (Los correos electrónicos deAWS se envían a la dirección de correo electrónico que ha utilizado cuando se ha suscrito en AmazonSES).

Cuando Amazon SES ha detectado correctamente los cambios en sus registros DNS, el DKIMVerification Status para ese dominio en la consola de Amazon SES cambiará de in progress a successy recibirá un correo electrónico de confirmación Amazon SES DKIM Setup Successful de AmazonWeb Services.

6. Ahora puede utilizar Amazon SES para enviar correo electrónico firmado mediante una firma DKIMdesde cualquier dirección válida en el dominio verificado. Para enviar un correo electrónico deprueba utilizando la consola de Amazon SES, marque el recuadro junto al dominio verificado y, acontinuación, haga clic en Send a Test Email. Vea los encabezados de correo electrónico en el correoelectrónico que recibe. Los proveedores de correo electrónico normalmente ofrecen esta capacidada través de una opción tal como Show original o View message source. Busque un encabezadodenominado DKIM-Signature con la etiqueta "d" definida para su dominio. Tenga en cuenta quecuando DKIM está habilitado, habrá dos encabezados DKIM-Signature añadidos al mensaje: unencabezado para su dominio y un encabezado con d=amazonses.com. (Amazon SES añade unafirma para amazonses.com automáticamente si tiene DKIM habilitado o no. Puede omitirla.) Porejemplo, para un dominio denominado ses-example.com, el encabezado de firma DKIM que estábuscando tendría un aspecto similar a:

DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/simple;s=xtk53kxcy4p3t6ztbrffs6d54rsrrhh6; d=ses-example.com;t=1366720445;h=From:To:Subject:MIME-Version:Content-Type:Content-Transfer-Encoding:Date:Message-ID;bh=lcj/Sl5qKl6K6zwFUwb7Flgnngl892pW574kmS1hrS0=;b=nhVMQLmSh7/DM5PW7xPV4K/PN4iVY0a5OF4YYk2L7jgUq9hHQlckopxe82TaAr64eVTcBhHHj9Bwtzkmuk88g4G5UUN8J+AAsd/JUNGoZOBS1OofSkuAQ6cGfRGanF68Ag7nmmEjEi+JL5JQh//u+EKTH4TVb4zdEWlBuMlrdTg=

Important

La forma de actualizar la configuración de DNS depende de quién proporciona su servicio DNS.El servicio DNS puede proporcionarlo un registrador de nombres de dominio como GoDaddy oNetwork Solutions o un servicio independiente como Amazon Route 53.

¿Qué ocurre si falla Easy DKIM?

Si su configuración de DNS no se actualiza correctamente, primero recibirá un correo electrónico AmazonSES DKIM FAILURE de Amazon Web Services y verá un estado failed en el área Domains al hacer clic enla pestaña DKIM.

Note

Si esto ocurre, Amazon SES seguirá enviando su correo electrónico, pero no estará firmadoutilizando una firma DKIM.

Cómo configurar Easy DKIM para una identidad verificada existenteSi ya ha verificado un dominio o dirección de correo electrónico, puede utilizar la Consola deadministración de AWS para configurar Easy DKIM para dicha identidad en cualquier momento.

129


Estas instrucciones son para añadir la firma DKIM en un dominio que ya se ha verificado. Si estáverificando un nuevo dominio y desea configurar Easy DKIM al mismo tiempo, consulte Configuración deEasy DKIM para un nuevo dominio (p. 127).

Important

Easy DKIM solo funciona con nombres de dominio completo (FQDN). Si desea configurar EasyDKIM para example.com y newyork.example.com, tendría que configurar Easy DKIM para cadauno de estos FQDN por separado.

Para configurar Easy DKIM para un dominio verificado existente



b. En el panel de navegación, en Identities, haga clic en Domains.2. En el panel de contenido, haga clic en el dominio verificado en el que desea configurar Easy DKIM.3. En la página Details del dominio, expanda DKIM.

4. Haga clic en Generate DKIM Settings.

130





Se mostrarán sus registros de DKIM.

5. Para configurar DKIM, debe actualizar la configuración de DNS de su dominio con la información deregistro de CNAME mostrada. Puede copiar los registros o hacer clic en el enlace Download RecordSet as CSV.

a. Si Route 53 proporciona el servicio DNS para el dominio que está verificando e inicia sesiónen la consola de Amazon SES con la misma dirección de correo electrónico y contraseña queutiliza para Route 53, entonces Amazon SES le ofrecerá la opción de actualizar de inmediato suconfiguración de DNS para Easy DKIM. Si desea hacerlo, haga clic en el botón Use Route 53.

A continuación, haga clic en Create Record Sets en el cuadro de diálogo Use Route 53 paracompletar el proceso.

b. Si no utiliza Route 53, tendrá que actualizar la configuración de DNS de acuerdo con elprocedimiento establecido por su proveedor de servicios de DNS. (Consulte a su administradordel sistema si no está seguro de quién proporciona el servicio DNS). Amazon Web Servicesdetectará en última instancia que ha actualizado sus registros de DNS; este proceso de detecciónpodría tardar hasta 72 horas.

6. Cuando Amazon SES ha detectado correctamente los cambios en sus registros DNS, el DKIMVerification Status para ese dominio en la consola de Amazon SES cambiará de in progress a successy recibirá un correo electrónico de confirmación Amazon SES DKIM Setup Successful de AmazonWeb Services. (Los correos electrónicos de Amazon Web Services se envían a la dirección de correoelectrónico que ha utilizado cuando se ha suscrito en Amazon SES).

7. (Este paso solo es necesario si la configuración de DKIM se inició antes del 13-09-16, 02:00 PDT)Para firmar los mensajes con una firma DKIM, debe habilitar Easy DKIM para la identidad de envíoverificada correspondiente de la siguiente manera:

a. En el panel de navegación, en Identities, haga clic en Email Addresses o bien en Domains, enfunción de si desea habilitar la firma de Easy DKIM para una dirección de correo electrónico o undominio.

b. Haga clic en la dirección de correo electrónico o en el dominio en el que desea habilitar la firma deEasy DKIM.

c. En la página Details de la dirección de correo electrónico o dominio, expanda DKIM.d. En el campo DKIM:, haga clic en enable.

8. Ahora puede utilizar Amazon SES para enviar correo electrónico firmado mediante una firma DKIMdesde cualquier dirección válida en el dominio verificado. Para enviar un correo electrónico deprueba utilizando la consola de Amazon SES, marque el recuadro junto al dominio verificado y, acontinuación, haga clic en Send a Test Email. Vea los encabezados de correo electrónico en el correo

131


electrónico que recibe. Los proveedores de correo electrónico normalmente ofrecen esta capacidada través de una opción tal como Show original o View message source. Busque un encabezadodenominado DKIM-Signature con la etiqueta "d" definida para su dominio. Tenga en cuenta quecuando DKIM está habilitado, habrá dos encabezados DKIM-Signature añadidos al mensaje: unencabezado para su dominio y un encabezado con d=amazonses.com. (Amazon SES añade unafirma para amazonses.com automáticamente si tiene DKIM habilitado o no. Puede omitirla.) Porejemplo, para un dominio denominado ses-example.com, el encabezado de firma DKIM que estábuscando tendría un aspecto similar a:

DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/simple;s=xtk53kxcy4p3t6ztbrffs6d54rsrrhh6; d=ses-example.com;t=1366720445;h=From:To:Subject:MIME-Version:Content-Type:Content-Transfer-Encoding:Date:Message-ID;bh=lcj/Sl5qKl6K6zwFUwb7Flgnngl892pW574kmS1hrS0=;b=nhVMQLmSh7/DM5PW7xPV4K/PN4iVY0a5OF4YYk2L7jgUq9hHQlckopxe82TaAr64eVTcBhHHj9Bwtzkmuk88g4G5UUN8J+AAsd/JUNGoZOBS1OofSkuAQ6cGfRGanF68Ag7nmmEjEi+JL5JQh//u+EKTH4TVb4zdEWlBuMlrdTg=

Important

La forma de actualizar la configuración de DNS depende de quién proporciona su servicio DNS.El servicio DNS puede proporcionarlo un registrador de nombres de dominio como GoDaddy oNetwork Solutions o un servicio independiente como Route 53.

¿Qué ocurre si falla Easy DKIM?

Si su configuración de DNS no se actualiza correctamente, primero recibirá un correo electrónico AmazonSES DKIM FAILURE de Amazon Web Services y verá un estado failed en el área Domains al hacer clic enla pestaña DKIM.

Note

Si esto ocurre, Amazon SES seguirá enviando su correo electrónico, pero no estará firmadoutilizando una firma DKIM.

Deshabilitar Easy DKIM en Amazon SESSi desea que Amazon SES deje temporalmente de firmar sus mensajes mediante DKIM, puededeshabilitar Easy DKIM para su dirección de correo electrónico o dominio. Puede volver a habilitarla encualquier momento.

Para deshabilitar la firma de Easy DKIM


2. En el panel de navegación, en Identities, haga clic en Email Addresses o bien en Domains, en funciónde si desea deshabilitar la firma de Easy DKIM para una dirección de correo electrónico o un dominio.

3. Haga clic en la dirección de correo electrónico o en el dominio en el que desea deshabilitar la firma deEasy DKIM.

4. En la página Details de la dirección de correo electrónico o dominio, expanda DKIM.5. En el campo DKIM:, haga clic en disable. Amazon SES dejará firmar con DKIM los correos

electrónicos que se envían desde esta identidad.Note

Si no ve la opción disable como en la figura siguiente, entonces DKIM ya está deshabilitado.

132




Note

Si desea deshabilitar la firma DKIM permanentemente de cualquier dirección de correo electrónicoen dicho dominio, también debe eliminar los registros CNAME de su DNS.

Revocación de registros de DKIM en Amazon SES

Amazon Web Services revisa periódicamente los registros DNS de DKIM y revoca la firma DKIM en casosen la que deja de ser válida. Si Amazon Web Services no puede detectar la información de registro deCNAME necesaria para confirmar la propiedad de un dominio, recibirá un correo electrónico AmazonSES DKIM REVOCATION WARNING de Amazon Web Services. Amazon SES sigue enviando su correoelectrónico, pero no estará firmado utilizando una firma DKIM.

Si restaura la información de registro de CNAME con su configuración de DNS en un plazo de cinco días,recibirá un correo electrónico Amazon SES DKIM REVOCATION CANCELLATION de Amazon WebServices. Amazon SES volverá a firmar el correo electrónico con una firma DKIM a partir de una identidadverificada para la que ha habilitado Easy DKIM.

Si no restaura la información de registro de CNAME a su configuración de DNS en un plazo de cinco días,recibirá un correo electrónico Amazon SES DKIM REVOCATION de Amazon Web Services y los correoselectrónicos que envíe a través de Amazon SES no estarán firmados mediante una firma DKIM.

Para configurar Easy DKIM en un dominio en el que se ha revocado la firma DKIM, debe reiniciar elprocedimiento desde el principio, como si configurase Easy DKIM por primera vez.

Otras formas de administrar Easy DKIM en Amazon SES

También puede administrar Easy DKIM con el API de Amazon SES. Están disponibles las siguientesacciones:

• VerifyDomainDkim

• SetIdentityDkimEnabled

• GetIdentityDkimAttributes

Puede utilizar estas acciones del API para escribir una aplicación front-end personalizada para trabajar conEasy DKIM. Para obtener una descripción completa de las acciones del API relacionadas con Easy DKIM,consulte la Amazon Simple Email Service API Reference.

133



Creación de registros DNS para firma DKIM en Amazon SES

A diferencia de la consola de Amazon SES, el API de Amazon SES no genera registros DNS formadospor completo para su uso con DKIM. En su lugar, devuelven tokens de DKIM, cadenas de caracteres querepresentan la identidad de su dominio.

Si no está utilizando la consola de Amazon SES, tendrá que crear sus propios registros CNAME utilizandolos tokens de DKIM devueltos por el API.

Para crear registros DNS para firma DKIM

1. Obtenga los tokens de DKIM para su dominio. Para ello, si está utilizando el API de Amazon SES,llame a VerifyDomainDkim para generar los tokens. Si ya tiene una identidad verificada de DKIM,llame a GetIdentityDkimAttributes para obtener los tokens.

2. En la salida del API, recibirá tres tokens de DKIM similares a lo siguiente:

vvjuipp74whm76gqoni7qmwwn4w4qusjiainivf6sf3frqe7jn4obpuxjpwpolz6ipb3k5nvt2nhjpik2oywrqplteh7oodxnad7hsl4mixg2uavzneazxv5sxi2

3. Utilice estos tokens para construir tres registros CNAME. Para un dominio denominado example.com,los registros deben aparecer similares a estos:

vvjuipp74whm76gqoni7qmwwn4w4qusjiainivf6sf._domainkey.example.com CNAME vvjuipp74whm76gqoni7qmwwn4w4qusjiainivf6sf.dkim.amazonses.com3frqe7jn4obpuxjpwpolz6ipb3k5nvt2nhjpik2oy._domainkey.example.com CNAME 3frqe7jn4obpuxjpwpolz6ipb3k5nvt2nhjpik2oy.dkim.amazonses.comwrqplteh7oodxnad7hsl4mixg2uavzneazxv5sxi2._domainkey.example.com CNAME wrqplteh7oodxnad7hsl4mixg2uavzneazxv5sxi2.dkim.amazonses.com

A partir de ahora, puede actualizar su DNS con estos registros. Amazon Web Services detectará en últimainstancia que ha actualizado sus registros de DNS; este proceso de detección podría tardar hasta 72horas. Tras una detección correcta, recibirá un correo electrónico de confirmación Amazon SES DKIMSetup Successful de Amazon Web Services. (Los correos electrónicos de Amazon Web Services se envíana la dirección de correo electrónico que ha utilizado cuando se ha suscrito en Amazon SES).

Firma DKIM manual en Amazon SESSi prefiere no utilizar Easy DKIM, puede seguir firmando sus mensajes de correo electrónico medianteuna firma DKIM y enviarlos mediante Amazon SES. Para ello, debe utilizar el API SendRawEmail y firmarautomáticamente el contenido de su mensaje de acuerdo con las especificaciones facilitadas en http://www.dkim.org. Si utiliza este enfoque, debe ser consciente de que Amazon SES no valida la firma DKIMque ha construido. Si hay algún error en la firma, tendrá que corregirla por sí mismo. Si firma con DKIM suspropios mensajes de correo electrónico, le recomendamos que utilice claves de al menos 1024 bits.

Tanto si firma o no sus mensajes con DKIM, Amazon SES añade automáticamente un encabezado DKIMcon d=amazonses.com, que puede omitir. Si firma con DKIM sus mensajes, se espera que haya dosencabezados DKIM: uno para su dominio y otro para amazonses.com.

Important

Para garantizar la máxima capacidad de entrega, no firme ninguno de los siguientes encabezadoscon una firma DKIM:

• Message-ID• Fecha

134

http://www.dkim.org

http://www.dkim.org

Amazon Simple Email Service Developer GuideConformidad con DMARC

• Return-Path• Bounces-To

Note

Si utiliza la interfaz de SMTP de Amazon SES para enviar correo electrónico y el software clienterealiza automáticamente la firma DKIM, debe asegurarse de que su cliente no firme ninguno delos encabezados anteriores. Le recomendamos que compruebe la documentación de su softwarepara averiguar exactamente qué encabezados están firmados con DKIM.Para obtener más información sobre la interfaz SMTP de Amazon SES, consulte Uso de lainterfaz de SMTP de Amazon SES para enviar correo electrónico (p. 74).

Conformidad con DMARC utilizando Amazon SESDomain-based Message Authentication, Reporting and Conformance (DMARC) es un protocolo deautenticación de correo electrónico que utiliza Sender Policy Framework (SPF) y Correo identificado conclaves de dominio (DKIM) para detectar la suplantación de correo electrónico. Para cumplir con DMARC,los mensajes deben autenticarse mediante SPF, DKIM o ambos.

Este tema contiene información que le ayudará a configurar Amazon SES a fin de que los mensajes queenvíe cumplan los requisitos de SPF y DKIM. Si cumple los requisitos de estos sistemas de autenticación,sus mensajes de correo electrónico cumplirán los requisitos de DMARC. Para obtener más informaciónsobre la especificación, consulte http://www.dmarc.org.

Conformidad con DMARC a través de SPFPara que un correo electrónico cumpla los requisitos de DMARC basado en SPF, se deben cumplir estasdos condiciones:

• El correo electrónico debe superar una comprobación SPF.• El dominio en la dirección de remitente ("From") del encabezado de correo electrónico debe

corresponder al dominio MAIL FROM que el servidor de correo de envío especifica al servidor de correoelectrónico receptor. Si la política de DMARC para SPF del dominio especifica una conformidad estricta,los dominios From y MAIL FROM deben coincidir exactamente. Si la política de DMARC para SPF deldominio especifica una conformidad laxa, el dominio MAIL FROM puede ser un subdominio del dominioen el encabezado From.

Para cumplir estos requisitos, siga los pasos que se describen a continuación:

• Configure un dominio MAIL FROM personalizado realizando los procedimientos que se describen en thesection called “Uso de un dominio MAIL FROM personalizado” (p. 65).

• Asegúrese de que el dominio de envío use una política laxa para SPF. Si no ha cambiado el tipo deconformidad de política de su dominio, se utilizará una política laxa de forma predeterminada.

Note

Puede determinar la conformidad con DMARC para SPF del dominio escribiendo el siguientecomando en la línea de comandos y reemplazando example.com por su dominio:

nslookup -type=TXT _dmarc.example.com

En el resultado de este comando, bajo Non-authoritative answer, busque un registro queempiece por v=DMARC1. Si este registro incluye la cadena aspf=r o si la cadena aspf noaparece, entonces el dominio usa la conformidad laxa para SPF. Si el registro incluye la cadenaaspf=s, entonces el dominio usa la conformidad estricta para SPF. El administrador del

135

http://www.dmarc.org

Amazon Simple Email Service Developer GuideAdministrar sus límites de envío

sistema tendrá que eliminar esta etiqueta del registro TXT DMARC en la configuración de DNSdel dominio.Otra opción consiste en usar una herramienta de búsqueda de DMARC por Internet, comoDMARC Inspector desde el sitio web de dmarcian o la herramienta DMARC Check del sitio webProofpoint, para determinar la conformidad de la política para SPF del dominio.

Conformidad con DMARC a través de DKIMPara que un correo electrónico cumpla los requisitos de DMARC basado en DKIM, se deben cumplir estasdos condiciones:

• El mensaje debe tener una firma DKIM válida.• La dirección From del encabezado de correo electrónico debe coincidir con el dominio d= en la firma

DKIM. Si la política de DMARC del dominio especifica una conformidad estricta para DKIM, estosdominios deben coincidir exactamente. Si la política de DMARC del dominio especifica una conformidadlaxa para DKIM, el dominio d= puede ser un subdominio del dominio From.

Para cumplir estos requisitos, siga los pasos que se describen a continuación:

• Configure Easy DKIM realizando los procedimientos que se describen en the section called “EasyDKIM” (p. 126). Cuando se utiliza Easy DKIM, Amazon SES firma automáticamente los mensajes decorreo electrónico.

Note

En lugar de utilizar Easy DKIM, también puede firmar manualmente sus mensajes (p. 134).Sin embargo, en tal caso, debe prestar especial atención, ya que Amazon SES no valida lafirma DKIM que usted crea. Por este motivo, le recomendamos que utilice Easy DKIM.

• Asegúrese de que el dominio de envío use una política laxa para DKIM. Si no ha cambiado el tipo deconformidad de política de su dominio, se utilizará una política laxa de forma predeterminada.

Note

Puede determinar la conformidad con DMARC para DKIM del dominio escribiendo el siguientecomando en la línea de comandos y reemplazando example.com por su dominio:

nslookup -type=TXT _dmarc.example.com

En el resultado de este comando, bajo Non-authoritative answer, busque un registro queempiece por v=DMARC1. Si este registro incluye la cadena adkim=r o si la cadena adkimno aparece, entonces el dominio usa la conformidad laxa para DKIM. Si el registro incluye lacadena adkim=s, entonces el dominio usa la conformidad estricta para DKIM. El administradordel sistema tendrá que eliminar esta etiqueta del registro TXT DMARC en la configuración deDNS del dominio.Otra opción consiste en usar una herramienta de búsqueda de DMARC por Internet, comoDMARC Inspector desde el sitio web de dmarcian o la herramienta DMARC Check del sitio webProofpoint, para determinar la conformidad de la política para DKIM del dominio.

Administrar sus límites de envío de Amazon SESSu cuenta de Amazon Simple Email Service (Amazon SES) tiene un conjunto de límites de envío pararegular el número de mensajes de correo electrónico que puede enviar y la tasa a la que puede enviarlos.Los límites de envío benefician a todos los clientes de Amazon SES ya que les ayudan a mantener larelación de confianza entre Amazon SES y los proveedores de servicios de Internet (ISP). Los límites de

136

https://dmarcian.com/dmarc-inspector/

https://stopemailfraud.proofpoint.com/dmarc/

https://dmarcian.com/dmarc-inspector/

https://stopemailfraud.proofpoint.com/dmarc/

Amazon Simple Email Service Developer GuideMonitoreo de sus límites de envío

envío le ayudan a aumentar gradualmente su actividad de envío y a reducir la probabilidad de que los ISPbloqueen sus correos electrónicos, debido a picos inesperados en su tasa o volumen de envío de correoelectrónico.

Los límites de envío de Amazon SES son los siguientes:

• Cuota de envío: el número máximo de correos electrónicos que puede enviar en un período de 24 horas.La cuota de envío refleja un período de tiempo acumulativo. Cada vez que intenta enviar un correoelectrónico, Amazon SES comprueba la cantidad de correos electrónicos que ha enviado en las 24horas anteriores. Siempre que el número total de mensajes de correo electrónico que haya enviado seainferior a su cuota, se aceptará su solicitud de envío y se enviará su correo electrónico. Si ya ha enviadosu cuota completa, su solicitud de envío se rechazará con una excepción de limitación controlada. Porejemplo, si su cuota de envío es 50 000 y ha enviado 15 000 mensajes de correo electrónico en las24 horas anteriores, todavía puede enviar otros 35 000 correos electrónicos. Si ya ha enviado 50 000mensajes de correo electrónico en las últimas 24 horas, no podrá enviar más correos electrónicos hastaque algunos de los envíos anteriores salgan de su ventana de 24 horas.

• Ratio máximo de envío: el número máximo de mensajes de correo electrónico procedentes de su cuentaque Amazon SES puede aceptar por segundo. Puede superar este límite durante ráfagas breves, perono durante un periodo de tiempo prolongado.

Note

La tasa de aceptación de mensajes en Amazon SES podría ser inferior a la tasa máxima deenvío.

Sus límites de envío de Amazon SES para cada región de AWS son independientes. Para obtener másinformación sobre el uso de Amazon SES en varias regiones de AWS, consulte Regiones y AmazonSES (p. 439).

Cuando está en el entorno de pruebas de Amazon SES, su cuota de envío es de 200 mensajes cadaperíodo de 24 horas y la ratio máximo de envío es de un mensaje por segundo. Para aumentar sus límitesde envío, tiene que enviar un caso de SES Sending Limits Increase. Para obtener más información,consulte Salir del entorno de pruebas de Amazon SES (p. 72). Una vez que haya salido del entornode pruebas y empezado a enviar correos electrónicos, puede aumentar sus límites de envío aún másenviando otro caso de SES Sending Limits Increase, como se ha tratado Aumento de los límites de envíode Amazon SES (p. 139).

Note

Los límites de envío se basan en los destinatarios en lugar de en los mensajes. Por ejemplo, uncorreo electrónico que tenga 10 destinatarios se contabiliza como 10 en su cuota. Sin embargo,no le recomendamos que envíe un correo electrónico a varios destinatarios en una llamada aSendEmail porque si la llamada a Amazon SES falla (por ejemplo, la solicitud tiene un formatoincorrecto), se rechazará todo el correo electrónico y ninguno de los destinatarios lo recibirá. Lerecomendamos que llame a SendEmail una vez por cada destinatario.

• Para aumentar sus límites de envío, consulte Aumento de los límites de envío de AmazonSES (p. 139).

• Para obtener información sobre los errores que recibe su aplicación al alcanzar los límites de envío,consulte Qué ocurre si alcanza sus límites de envío de Amazon SES (p. 140).

• Para monitorear sus límites de envío utilizando la consola de Amazon SES o el API de Amazon SES,consulte Monitoreo de sus límites de envío de Amazon SES (p. 137).

Monitoreo de sus límites de envío de Amazon SESPuede monitorear sus límites de envío utilizando la consola de Amazon SES o a través del API de AmazonSES, ya sea directamente mediante una llamada a la interfaz de consulta (HTTPS) o indirectamente a

137

Amazon Simple Email Service Developer GuideMonitoreo de sus límites de envío

través de un SDK de AWS, el AWS Command Line Interfaceo el Herramientas de AWS para WindowsPowerShell.

Important

Le recomendamos que consulte con frecuencia sus estadísticas de envío, a fin de asegurarsede que no está cerca de sus límites de envío. Si está cerca de sus límites de envío, consulteAumento de los límites de envío de Amazon SES (p. 139) para obtener información acerca decómo aumentarlos. No espere a alcanzar a los límites de envío para plantearse aumentarlos.

Monitoreo de sus límites de envío utilizando la consola deAmazon SESEl siguiente procedimiento muestra cómo ver sus límites de envío utilizando la consola de Amazon SES.


2. En el panel de navegación, elija Sending Statistics. Sus límites de envío se muestran en Your AmazonSES Sending Limits.

3. Para actualizar la pantalla, elija Refresh.

Monitoreo de sus límites de envío utilizando el API de AmazonSESEl API de Amazon SES ofrece la acción GetSendQuota, que devuelve sus límites de envío. Cuando llamea la acción GetSendQuota, recibe la información siguiente:

• Número de mensajes de correo electrónico que ha enviado durante las últimas 24 horas• Cuota de envío para el periodo de 24 horas actual• Tasa máxima de envío

Note

Para una descripción de GetSendQuota, consulte Amazon Simple Email Service API Reference.

138








Amazon Simple Email Service Developer GuideAumento de sus límites de envío

Aumento de los límites de envío de Amazon SESCuando su cuenta está fuera del entorno de pruebas, sus límites de envío aumentarán si envía contenidode alta calidad y detectamos que su utilización se aproxima a sus límites actuales. A menudo, el sistemaaumenta automáticamente la cuota antes de que la necesite realmente y no se precisan medidasadicionales.

Si su cuota existente no es suficiente para sus necesidades y el sistema no ha aumentadoautomáticamente su cuota, puede abrir un SES Sending Limits Increase case en el servicio de atención alcliente.

Para obtener una lista de la información que necesita al abrir el caso, consulte Apertura de un caso de SESSending Limits Increase (p. 139).

Important

Planificar. Tenga en cuenta sus límites de envío y procure mantenerse dentro de ellos. Si creeque necesitará una cuota superior a la que el sistema le ha asignado automáticamente, abra uncaso SES Sending Limits Increase con antelación a la fecha en que necesita una cuota mayor.Important

Si prevé que va a tener que enviar más de un millón de correos electrónicos al día, debe abrir uncaso SES Sending Limits Increase.

Para que Amazon SES incremente su cuota, utilice las siguientes directrices:

• Enviar contenido de alta calidad: envíe contenido que los destinatarios desean y esperan.• Enviar contenido de producción real: envíe su correo electrónico de producción real. Esto permite a

Amazon SES evaluar con precisión sus patrones de envío y verificar que está enviando contenido dealta calidad.

• Enviar cerca de su cuota actual: si su volumen se mantiene cerca de su cuota sin excederla, AmazonSES puede detectar este patrón de uso y aumentar automáticamente su cuota.

• Tener tasas bajas de rebotes y reclamaciones: intente minimizar las cifras de rebotes y reclamaciones.Tener un gran número de rebotes y reclamaciones puede afectar negativamente a sus límites de envío.

Important

Los correos electrónicos de prueba que envía a sus propias direcciones de correo electrónicopodrían afectar negativamente a sus métricas de rebotes y reclamaciones o aparecer comocontenido de baja calidad en nuestros filtros. Siempre que sea posible, utilice el simulador debandeja de correo de Amazon SES para probar el sistema. Los correos electrónicos que seenvían al simulador de bandeja de correo no se contabilizan en la métrica de envío o sus tasasde rebotes y reclamaciones. Para obtener más información, consulte Probar el envío de correoelectrónico en Amazon SES (p. 173).

Para obtener información sobre cómo abrir un caso de SES Sending Limits Increase, consulte Apertura deun caso de SES Sending Limits Increase (p. 139).

Apertura de un caso de SES Sending Limits IncreasePara solicitar límites de envío mayores para Amazon SES, abra un caso en el servicio de atención alcliente utilizando las siguientes instrucciones.

Para solicitar límites de envío mayores


139




Amazon Simple Email Service Developer GuideQué ocurre si alcanza sus límites de envío

2. Abra un SES Sending Limits Increase case en el servicio de atención al cliente. También puedeacceder a este enlace utilizando la página Dedicated IPs en la consola de Amazon SES.

3. En el formulario, proporcione la siguiente información:

• Region: elija la región de AWS para la que solicita un aumento del límite de envío. Su estado deentorno de pruebas y límites de envío de Amazon SES son independientes para cada región deAWS. Para obtener más información, consulte Regiones y Amazon SES (p. 439).

• Limit: elija Desired Daily Sending Quota o Desired Maximum Send Rate. Los límites de envío sedescriben en Administrar sus límites de envío de Amazon SES (p. 136).

Note

La tasa de aceptación de mensajes en Amazon SES podría ser inferior a la tasa máxima deenvío.

• New limit value: introduzca la cantidad que solicita. Solicite solo la cantidad que crea que va anecesitar. Recuerde que no se garantiza que reciba la cantidad que solicite y que mientras mayorsea el límite que solicite, mayor justificación necesita para que sea tenido en cuenta para dichacantidad.

• Mail Type: elija el tipo de correo electrónico que prevé enviar utilizando su dirección IP dedicada. Sise aplican varios valores, elija el tipo que supondrá la mayor parte de su envío de correo electrónico.

• Website URL: escriba la dirección URL de su sitio web. Esta información nos ayudará a entendermejor el tipo de contenido que desea enviar.

• My email sending complies with the AWS Service Terms and AUP: elija la opción que se aplica a sucaso de uso.

• I only send to recipients who have specifically requested my mail: elija la opción que se aplica a sucaso de uso.

• I have a process to handle bounces and complaints: elija la opción que se aplica a su caso de uso.• Use Case Description: describa las formas en las que utilizará Amazon SES para enviar correo

electrónico. Para ayudarnos a procesar su solicitud más rápidamente, responda a las siguientespreguntas:• ¿Cómo va a crear o adquirir su lista de correo?• ¿Cómo gestionará los rebotes y las reclamaciones?• ¿Cómo pueden los destinatarios cancelar la suscripción a su lista de correo y cómo va a

responder a estas solicitudes?• ¿Cómo eligió aumentar la cantidad que especificó en esta solicitud?

Cuando haya terminado, elija Submit. Responderemos al caso después de revisar su solicitud. Deberáesperar un día laborable para el procesamiento.

Qué ocurre si alcanza sus límites de envío de AmazonSESSi intenta enviar un correo electrónico después de alcanzar su cuota de envío diaria (la cantidad máximade correo electrónico que puede enviar en un periodo de 24 horas) o su ratio máximo de envío (el númeromáximo de mensajes que puede enviar por segundo), Amazon SES elimina el mensaje y no intentaenviarlo de nuevo. Amazon SES también proporciona un mensaje de error que explica el problema. Laforma en que Amazon SES produce este mensaje de error depende de cómo intentó enviar el correoelectrónico. En este tema se incluye información acerca de los mensajes que recibe a través de la API deAmazon SES y a través de la interfaz de SMTP.

140


Amazon Simple Email Service Developer GuideUso de autorización de envío

Para conocer la técnica que puede utilizar cuando alcanza su ratio máximo de envío, consulte How tohandle a "Throttling – Maximum sending rate exceeded" error en el Blog de AWS sobre mensajería yselección de destinatarios.

Alcanzar límites de envío con el API de Amazon SESSi intenta enviar un correo electrónico a través de la API de Amazon SES (o un SDK de AWS), pero ya hasuperado los límites de envío de su cuenta, la API produce un error ThrottlingException. El mensajede error incluye uno de los siguientes mensajes:

• Daily message quota exceeded

• Maximum sending rate exceeded

Si encuentra un error de limitación controlada, debe programar su aplicación para que espere un intervalode hasta 10 minutos y, a continuación, vuelva a intentar la solicitud de envío.

Alcanzar límites de envío con SMTPSi intenta enviar un correo electrónico utilizando la interfaz SMTP de Amazon SES, pero ya ha superadolos límites de envío de su cuenta, es posible que su cliente SMTP muestre uno de los siguientes errores:

• 454 Throttling failure: Maximum sending rate exceeded

• 454 Throttling failure: Daily message quota exceeded

Los diferentes clientes de SMTP controlan estos errores de distintas formas. Por ejemplo, MicrosoftOutlook proporciona un mensaje error de envío/recepción en el panel de estado en la parte inferior de laventana. El mensaje se parece al siguiente ejemplo:

Task '[email protected] - Sending' reported error (0x800CCC7F):'Establishing an encrypted connection to your outgoing (SMTP) server failed. Ifthis problem continues, contact your server administrator or Internet serviceprovider (ISP). The server responded: 454 Throttling failure: Daily messagequota exceeded.'

Uso de autorización de envío con Amazon SESPuede configurar Amazon SES para permitir que otros usuarios envíen correo electrónico desdedirecciones o dominios de su propiedad (sus identidades) mediante sus propias cuentas de AmazonSES. Esta característica, denominada autorización de envío, le permite mantener el control sobre susidentidades de modo que pueda cambiar o revocar los permisos en cualquier momento. Por ejemplo, si esel propietario de una compañía, puede usar la autorización de envío para permitir a un tercero (como unaempresa de marketing por correo electrónico) enviar correo electrónico desde un dominio de su propiedad.

Si desea autorizar a alguien para enviar mensajes de correo electrónico en su nombre, entonces esun propietario de identidad. Si es un propietario de identidad, le recomendamos que lea las siguientessecciones:

• Descripción general de autorización de envío (p. 142)• Políticas de autorización de envío (p. 144)• Ejemplos de políticas de autorización de envío (p. 149)• Tareas de propietario de identidad (p. 154)

141

https://aws.amazon.com//blogs/messaging-and-targeting/how-to-handle-a-throttling-maximum-sending-rate-exceeded-error/


Amazon Simple Email Service Developer GuideDescripción general de autorización de envío

Si se le ha autorizado enviar correos electrónicos en nombre de otra persona, usted es un remitentedelegado. Si es un remitente delegado, le recomendamos que lea las siguientes secciones:

• Descripción general de autorización de envío (p. 142)• Tareas de remitente delegado (p. 160)

Note

También puede controlar el acceso a Amazon SES utilizando políticas de IAM. Las políticas deIAM restringen lo que pueden hacer los usuarios de IAM individuales, mientras que el envío depolíticas de autorización restringe cómo se pueden utilizar las identidades verificadas. Además,solo las políticas de autorización de envío pueden otorgar acceso entre cuentas. Para obtenermás información sobre el uso de políticas de IAM con Amazon SES, consulte Control del acceso aAmazon SES (p. 377).

Descripción general de autorización de envío deAmazon SESEste tema proporciona información general sobre el proceso de autorización de envío y, a continuación,explica cómo las características de envío de correo electrónico de Amazon SES, tales como los límites deenvío y las notificaciones, trabajan con la autorización de envío.

En esta sección se usan los siguientes términos:

• Identidad: una dirección de correo electrónico o dominio que los usuarios de Amazon SES utilizan paraenviar correo electrónico.

• Propietario de identidad: un usuario de Amazon SES que tiene una propiedad verificada de unadirección de correo electrónico o dominio utilizando el procedimiento descrito en Verificación deidentidades (p. 47).

• Remitente delegado: una entidad que recibe autorización para enviar correo electrónico desde unaidentidad de la que no es propietario. Una cuenta de AWS, un usuario de AWS Identity and AccessManagement (IAM) o un servicio de AWS pueden tener esta autoridad entre cuentas.

• Política de autorización de envío: un documento que adjunta a una identidad para especificar quiénpuede realizar envíos para esa identidad y en qué condiciones.

• Nombre de recurso de Amazon (ARN): una forma estandarizada de identificar de manera inequívocaun recurso de AWS en todos los servicios de AWS. En el caso de una autorización de envío, el recursoes la identidad que el propietario de la identidad desea que utilice el remitente delegado. Un ejemplo deARN es arn:aws:ses:us-west-2:123456789012:identity/example.com.

Proceso de autorización de envíoLa autorización de envío se basa en políticas de autorización de envío. Si desea habilitar un remitentedelegado para que realice envíos en su nombre, debe crear una política de autorización de envío yasociar la política a su identidad a través de la consola de Amazon SES o el API de Amazon SES. Cuandoel remitente delegado intenta enviar un correo electrónico a través de Amazon SES en su nombre,el remitente delegado transfiere el ARN de su identidad en la solicitud o en el encabezado del correoelectrónico.

Cuando Amazon SES recibe la solicitud para enviar el correo electrónico, comprueba la política de suidentidad (si la hay) para determinar si ha autorizado al remitente delegado para enviar en nombre de laidentidad. Si el remitente delegado está autorizado, Amazon SES acepta el correo electrónico; en casocontrario, Amazon SES devuelve un mensaje de error.

En el siguiente diagrama se muestra la relación de alto nivel entre los conceptos de autorización de envío:

142

Amazon Simple Email Service Developer GuideDescripción general de autorización de envío

El proceso de autorización de envío consta de los siguientes pasos:

1. El propietario de identidad verifica una identidad con Amazon SES a través de la consola de AmazonSES o el API de Amazon SES. Para obtener más información acerca del procedimiento de verificación,consulte Verificación de identidades (p. 47).

2. El remitente delegado ofrece al propietario de identidad el ID de cuenta de AWS, el ARN de usuario deIAM o el nombre de servicio de AWS de la entidad que realizará el envío.

3. El propietario de identidad crea una política de autorización de envío y adjunta la política a la identidadmediante la consola de Amazon SES o el API de Amazon SES.

4. El propietario de la identidad ofrece el remitente delegado el ARN de la identidad, de modo que elremitente delegado puede proporcionar el ARN a Amazon SES en el momento en que se envía elcorreo electrónico.

5. El remitente delegado configura las notificaciones de rebotes y reclamaciones. El propietario deidentidad también puede configurar notificaciones de retroalimentación de correo electrónico para loseventos de rebotes y reclamaciones. El propietario de identidad y el remitente delegado también puedenconfigurar la publicación de eventos (p. 259) para capturar datos de eventos de envío.

Note

Si el propietario de identidad deshabilita las notificaciones de eventos de envío, el remitentedelegado debe configurar la publicación de eventos para publicar los eventos de rebotes yreclamaciones en un tema de Amazon SNS o un flujo de Kinesis Data Firehose. El remitentedebe aplicar también el conjunto de configuración que contiene la regla de publicación deeventos a cada mensaje de correo electrónico que envíe. Si ni el propietario de identidad ni elremitente delegado configuran un método de envío de notificaciones para eventos de rebotesy reclamaciones, Amazon SES envía automáticamente notificaciones de eventos por correoelectrónico a la dirección que figura en el campo Return-Path del mensaje (o a la dirección delcampo Source, si no se ha especificado una dirección Return-Path), aunque el propietario deidentidad haya deshabilitado el reenvío de retroalimentación de correo electrónico.

6. El remitente delegado intenta enviar un correo electrónico a través de Amazon SES en nombre delpropietario de identidad transfiriendo el ARN de la identidad del propietario de identidad en la solicitudo en el encabezado del correo electrónico. El remitente delegado puede enviar el correo electrónicoutilizando la interfaz SMTP de Amazon SES o el API de Amazon SES. Tras recibir la solicitud, AmazonSES examina las políticas que se han adjuntado a la identidad y acepta el correo electrónico si elremitente delegado está autorizado para utilizar la dirección de remitente "From" especificada y ladirección de ruta de retorno "Return Path"; de lo contrario, Amazon SES devuelve un error y no aceptael mensaje.

143

Amazon Simple Email Service Developer GuidePolíticas de autorización de envío

7. Si el propietario de identidad necesita anular la autorización del remitente delegado, deberá editar lapolítica de autorización de envío o eliminar la política en su totalidad. El propietario de identidad puederealizar ambas acciones a través de la consola de Amazon SES o la API de Amazon SES.

Para obtener más información acerca de cómo el propietario de la identidad o el remitente delegadorealizan estas tareas, consulte Tareas de propietario de identidad (p. 154) o Tareas de remitentedelegado (p. 160), respectivamente.

Atribución de características de envío de correo electrónicoEs importante entender la función del remitente delegado y del propietario de la identidad con respecto alas características de envío de correo electrónico de Amazon SES, tales como la cuota de envío diaria,los rebotes y las reclamaciones, la firma de DKIM, el reenvío de retroalimentación, etc. La atribución es lasiguiente:

• Límites de envío: el correo electrónico enviado desde las identidades del propietario de identidad secontabiliza en la cuota de envío diario del remitente.

• Rebotes y reclamaciones: los eventos de rebotes y las reclamaciones se contabilizan en la cuenta deAmazon SES del remitente y, por tanto, afectan a la reputación del remitente delegado.

• Firma de DKIM: si el propietario de identidad ha habilitado la firma de Easy DKIM para una identidad,todo el correo electrónico enviado desde dicha identidad estará firmado por DKIM, incluido el correoelectrónico enviado por el remitente delegado. Solo el propietario de identidad puede controlar si loscorreos electrónicos están firmados con DKIM.

• Notificaciones: el propietario de identidad y el remitente delegado pueden configurar notificaciones pararebotes y reclamaciones. El propietario de la identidad de correo electrónico también puede habilitar elreenvío de retroalimentación de correo electrónico. Para obtener información sobre la configuración denotificaciones, consulte Monitoreo de la actividad de envío de Amazon SES (p. 230).

• Verificación: los propietarios de identidad son responsables de realizar el procedimiento que se describeen Verificación de identidades (p. 47) para verificar que son los propietarios de las direcciones decorreo electrónico y de los dominios cuyo uso autorizan a los remitentes delegados. Los remitentesdelegados no tienen que comprobar ninguna dirección de correo electrónico o dominios específicamentepara autorización de envío.

• Regiones de AWS: el remitente delegado debe enviar los mensajes de correo electrónico desde laregión de AWS en la que se verifica la identidad del propietario de identidad. La política de autorizaciónde envío que otorga permiso al remitente delegado debe estar adjunta a la identidad en dicha región.

• Facturación: todos los mensajes que se envían desde la cuenta del remitente delegado, incluidos loscorreos electrónicos que este envía utilizando las direcciones del propietario de la identidad, se facturanal remitente delegado.

Políticas de autorización de envío de Amazon SESPara permitir que otra cuenta de AWS usuario de Identity and Access Management (IAM) o serviciode AWS envíe correo electrónico a través de Amazon SES en su nombre, debe crear una política deautorización de envío, que es un documento JSON que se adjunta a una identidad de su propiedad. Lapolítica enumera de forma explícita a quién permite enviar para dicha identidad y en qué condiciones. Sedeniegan todos los remitentes excepto usted y las entidades a las que conceda permiso explícitamenteen las políticas. Una identidad puede no tener ninguna política, una política o varias políticas adjuntas.También puede tener una política con varias instrucciones para conseguir el efecto de varias políticas.

Las políticas pueden ser sencillas o se pueden configurar para ofrecer un control minucioso. Porejemplo, si es propietario de example.com, puede escribir una política sencilla para conceder al IDde AWS 123456789012 permiso para enviar correo desde dicho dominio. Una política más detalladapodría especificar que el ID de AWS 123456789012 puede enviar correo electrónico solo [email protected] y solo dentro de un intervalo de fechas especificado.

144


Las políticas de autorización de envío de Amazon SES solo se aplican a las API de envío de correoelectrónico (SendEmail y SendRawEmail). No permiten a un usuario tener acceso a su cuenta de AWSde ninguna otra forma.

Note

No puede crear políticas de identidad que permitan a los remitentes delegados usar lasoperaciones SendTemplatedEmail o SendBulkTemplatedEmail.

Estructura de la políticaCada política de autorización de envío es un documento JSON que está adjunto a una identidad. Cadapolítica incluye las siguientes secciones.

• Información aplicable a toda la política en la parte superior del documento.• Una o varias instrucciones individuales, cada una de las cuales describe un conjunto de permisos.

Cada instrucción incluye la información básica sobre un único permiso. Si una política incluye variasinstrucciones, Amazon SES aplica un operador lógico O en todas las instrucciones durante la evaluación.Del mismo modo, si una identidad tiene varias políticas adjuntas, Amazon SES aplica un operador lógico Oen las políticas durante la evaluación.

La siguiente política de ejemplo otorga al ID de cuenta de AWS 123456789012 permiso para enviar correodesde el dominio verificado example.com.

{ "Id":"ExampleAuthorizationPolicy", "Version":"2012-10-17", "Statement":[ { "Sid":"AuthorizeAccount", "Effect":"Allow", "Resource":"arn:aws:ses:us-east-1:888888888888:identity/example.com", "Principal":{ "AWS":[ "123456789012" ] }, "Action":[ "SES:SendEmail", "SES:SendRawEmail" ] } ]}

Puede encontrar más ejemplos de política de autorización de envío en Ejemplos de políticas deautorización de envío (p. 149).

Elementos de políticaEsta sección describe los elementos que contienen las políticas de autorización de envío. En primer lugar,describimos elementos aplicables a toda la política y, a continuación, describimos los elementos que seaplican únicamente a la instrucción en la que están incluidos. Se sigue con una exposición sobre cómoañadir condiciones a sus instrucciones.

Para obtener información específica acerca de la sintaxis de los elementos, consulte Grammar of the IAMPolicy Language en la Guía del usuario de IAM.

145

https://docs.aws.amazon.com/IAM/latest/UserGuide/policies-grammar.html

https://docs.aws.amazon.com/IAM/latest/UserGuide/policies-grammar.html


Información aplicable a toda la política

Existen dos elementos a escala de política: Id y Version. La tabla siguiente proporciona informaciónacerca de estos elementos.

Nombre Descripción Obligatorio Valores válidos

Id Identifica de forma exclusiva lapolítica.

No. Cualquier cadena

Version Especifica la versión de idiomade acceso de la política.

No, perocomo prácticarecomendada,le aconsejamosque incluyaeste campocon un valor de"2012-10-17".

Cualquier cadena

Instrucciones específicas de la política

Las políticas de autorización de envío requieren al menos una instrucción. Cada instrucción puede incluirlos elementos que se describen en la siguiente tabla.

Nombre Descripción Obligatorio Valores válidos

Sid Identifica de formaexclusiva la instrucción.

No. Cualquier cadena.

Effect Especifica el resultadoque desea que devuelvala instrucción depolítica en tiempo deevaluación.

No, aunque unainstrucción sin efecto esinútil.

"Allow" o "Deny".

Resource Especifica la identidada la que se aplica lapolítica. Esta es ladirección de correoelectrónico o dominioque el propietario deidentidad autorizautilizar al remitentedelegado.

Sí. Un ARN de identidad,tal y como se especificaen la consola deAmazon SES.

Principal Especifica la cuenta deAWS, usuario de IAMo servicio de AWS querecibe el permiso en lainstrucción.

Sí. Un ID de cuenta deAWS válido, ARNde usuario de IAM oservicio de AWS. LosID de cuenta de AWSy ARN de usuario deIAM se especificanutilizando "AWS" (porejemplo, "AWS":["123456789012"]

146


Nombre Descripción Obligatorio Valores válidoso "AWS":["arn:aws:iam::123456789012:root"]).Los nombres deservicios de AWS seespecifican utilizando"Service" (porejemplo, "Service":["cognito-idp.amazonaws.com"]).

Para ver ejemplosdel formato de ARNde usuario de IAM,consulte la AWSGeneral Reference.

Action Especifica la acciónde envío de correoelectrónico a la que serefiere la instrucción.

Sí. "ses:SendEmail","ses:SendRawEmail" (unoo ambos).

Si utiliza el editor depolíticas personalizadas,también puedeconfigurar la acción a"ses:*" para abarcarambos API. Si elremitente va a teneracceso a AmazonSES a través de lainterfaz SMTP, debeespecificar al menos"ses:SendRawEmail" ousar "ses:*".

Condition Especifica algunalimitación o informaciónsobre el permiso.

No. Consulte la informaciónacerca de lascondiciones siguiendoesta tabla.

Condiciones

Una condición es cualquier restricción sobre el permiso en la instrucción. La parte de la instrucción queespecifica las condiciones puede ser la más detallada de todas las partes. Una clave es la característicaespecífica que es la base para la restricción de acceso, como la fecha y hora de la solicitud.

Usted utiliza ambas condiciones y claves conjuntamente para expresar la restricción. Por ejemplo, si desearestringir al remitente delegado a la hora de realizar solicitudes a Amazon SES en su nombre después del30 de octubre de 2015, utilice la condición denominada DateLessThan. Usted utiliza la clave denominadaaws:CurrentTime y la define con el valor 2015-07-30T00:00:00Z.

Puede utilizar cualquiera de las claves aplicables a todo AWS que se indican en Claves disponibles en laGuía del usuario de IAM o puede utilizar una de las siguientes claves específicas de Amazon SES:

147

https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html#arn-syntax-iam.html

https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html#arn-syntax-iam.html

https://docs.aws.amazon.com/IAM/latest/UserGuide/AccessPolicyLanguage_ElementDescriptions.html#AvailableKeys


Clave de condición Descripción

ses:Recipients Restringe las direcciones del destinatario, que incluyen lasdirecciones To:, "CC" y "BCC".

ses:FromAddress Restringe la dirección de remitente ("From").

ses:FromDisplayName Restringe el contenido de la cadena que se utiliza comoel nombre de visualización "From" (a veces denominado"remitente descriptivo"). Por ejemplo, el nombre devisualización de "John Doe <[email protected]>" esJohn Doe.

ses:FeedbackAddress Restringe la dirección de "ruta de retorno", que esla dirección donde se pueden enviar los rebotes yreclamaciones mediante reenvío de retroalimentaciónde correo electrónico. Para obtener información acercadel reenvío de retroalimentación de correo electrónico,consulte Notificaciones de Amazon SES a través de correoelectrónico (p. 237).

Es frecuente utilizar las condiciones StringEquals y StringLike con las claves de Amazon SES.Las condiciones son para coincidencia de cadenas con distinción entre mayúsculas y minúsculas. ParaStringLike, los valores pueden incluir un comodín de coincidencias de varios caracteres (*) o uncomodín de coincidencia de un único carácter (?) en cualquier lugar de la cadena. Por ejemplo, la siguientecondición especifica que el remitente delegado solo puede enviar desde una dirección de remitente("From") que empieza por invoicing y termina por example.com:

"Condition": { "StringLike": { "ses:FromAddress": "invoicing+.*@example.com" }}

Note

Cuando desee desactivar el acceso a una dirección de correo electrónico, utilice comodines paraasegurarse de que está evitando el acceso por completo a todas las formas de esa dirección. Porejemplo, para anular el permiso de envío desde [email protected], puede evitar el accesoa alternativas tales como "admin"@example.com y [email protected] especificando lasiguiente condición:

"Condition": { "StringNotLike": { "ses:FromAddress": "*admin*.example.com" } }

Para obtener más información sobre cómo especificar condiciones, consulte Condition en la Guía delusuario de IAM.

Requisitos de políticaCada política debe cumplir los siguientes requisitos:

• Cada política debe incluir al menos una instrucción.

148

https://docs.aws.amazon.com/IAM/latest/UserGuide/AccessPolicyLanguage_ElementDescriptions.html#Condition

Amazon Simple Email Service Developer GuideEjemplos de políticas de autorización de envío

• Cada política debe incluir al menos una entidad principal válida.• Cada política debe especificar un recurso y dicho recurso debe ser el ARN de la identidad al que se

adjunta dicha política.• Los propietarios de identidad pueden asociar hasta 20 políticas con cada identidad única.• Las políticas no deben exceder los 4 kilobytes (KB).• Los nombres de política no pueden superar los 64 caracteres y solo pueden incluir caracteres

alfanuméricos, guiones y guiones bajos.

Ejemplos de políticas de autorización de envío deAmazon SESLa autorización de envío le permite especificar las condiciones detalladas según las cuales permite a losremitentes delegados enviar en su nombre.

Los siguientes ejemplos muestran cómo escribir políticas para controlar distintos aspectos de envío:• Especificar el remitente delegado (p. 149)• Restricción de la dirección de remitente ("From") (p. 150)• Restringir el periodo de tiempo en el que el delegado puede enviar correo electrónico (p. 151)• Restricción de la acción de envío de correo electrónico (p. 152)• Restricción del nombre de visualización del remitente de correo electrónico (p. 152)• Uso de varias instrucciones (p. 153)

Especificar el remitente delegadoLa entidad principal, que es la entidad a la que se conceden los permisos, puede ser una cuenta de AWS,un usuario de AWS Identity and Access Management (IAM) o un servicio de AWS.

El siguiente ejemplo muestra una política sencilla que permite al ID de AWS 123456789012 enviarcorreo electrónico desde la identidad verificada example.com (que es propiedad de la cuenta de AWS888888888888). La instrucción Condition de esta política solo permite al delegado (es decir, el ID deAWS 123456789012) enviar correo electrónico desde la dirección marketing+.*@example.com, donde .* escualquier cadena que el remitente quiera añadir después de marketing+.

{ "Id":"SampleAuthorizationPolicy", "Version":"2012-10-17", "Statement":[ { "Sid":"AuthorizeMarketer", "Effect":"Allow", "Resource":"arn:aws:ses:us-east-1:888888888888:identity/example.com", "Principal":{ "AWS":[ "123456789012" ] }, "Action":[ "SES:SendEmail", "SES:SendRawEmail" ], "Condition":{ "StringLike":{

149


"ses:FromAddress":"marketing+.*@example.com" } } } ]}

La siguiente política de ejemplo otorga a dos usuarios de IAM permiso para enviar desde la identidadexample.com. Los usuarios de IAM se especifican por su nombre de recurso de Amazon (ARN).

{ "Id":"ExampleAuthorizationPolicy", "Version":"2012-10-17", "Statement":[ { "Sid":"AuthorizeIAMUser", "Effect":"Allow", "Resource":"arn:aws:ses:us-east-1:888888888888:identity/example.com", "Principal":{ "AWS":[ "arn:aws:iam::111122223333:user/John", "arn:aws:iam::444455556666:user/Jane" ] }, "Action":[ "SES:SendEmail", "SES:SendRawEmail" ] } ]}

La siguiente política de ejemplo otorga a Amazon Cognito permiso para enviar desde la identidadexample.com.

{ "Id":"ExampleAuthorizationPolicy", "Version":"2012-10-17", "Statement":[ { "Sid":"AuthorizeService", "Effect":"Allow", "Resource":"arn:aws:ses:us-east-1:888888888888:identity/example.com", "Principal":{ "Service":[ "cognito-idp.amazonaws.com" ] }, "Action":[ "SES:SendEmail", "SES:SendRawEmail" ] } ]}

Restricción de la dirección de remitente ("From")Si utiliza un dominio verificado, puede crear una política que permita únicamente a un remitente delegadoenviar correo electrónico desde una dirección de correo electrónico especificada. Para restringir ladirección de remitente ("From"), se establece una condición en la clave denominada ses:FromAddress.

150


La siguiente política permite al ID de cuenta de AWS 123456789012 enviar correo electrónico desde laidentidad example.com, pero solo desde la dirección de correo electrónico [email protected].

{ "Id":"ExamplePolicy", "Version":"2012-10-17", "Statement":[ { "Sid":"AuthorizeFromAddress", "Effect":"Allow", "Resource":"arn:aws:ses:us-east-1:888888888888:identity/example.com", "Principal":{ "AWS":[ "123456789012" ] }, "Action":[ "SES:SendEmail", "SES:SendRawEmail" ], "Condition":{ "StringEquals":{ "ses:FromAddress":"[email protected]" } } } ]}

Restringir el periodo de tiempo en el que el delegado puedeenviar correo electrónicoTambién puede configurar la política de autorización del remitente de forma que un remitente delegadosolo pueda enviar correo electrónico a una hora determinada del día o en un determinado intervalode fechas. Por ejemplo, si tiene previsto enviar su campaña de correo electrónico durante el mes deseptiembre de 2018, puede usar la siguiente política para limitar la capacidad del delegado de enviarcorreo electrónico solo durante ese mes.

{ "Id":"ExamplePolicy", "Version":"2012-10-17", "Statement":[ { "Sid":"ControlTimePeriod", "Effect":"Allow", "Resource":"arn:aws:ses:us-east-1:888888888888:identity/example.com", "Principal":{ "AWS":[ "123456789012" ] }, "Action":[ "SES:SendEmail", "SES:SendRawEmail" ], "Condition":{ "DateGreaterThan":{ "aws:CurrentTime":"2018-08-31T12:00Z" }, "DateLessThan":{ "aws:CurrentTime":"2018-10-01T12:00Z" }

151


} } ]}

Restricción de la acción de envío de correo electrónicoHay dos acciones que los remitentes pueden utilizar para enviar un correo electrónico con Amazon SES:SendEmail y SendRawEmail, en función del control que el remitente desee sobre el formato del correoelectrónico. Las políticas de autorización de envío le permiten limitar al remitente delegado a una de lasdos acciones. Sin embargo, muchos propietarios de identidad habilitan ambas acciones en sus políticas,lo que permite que sea el remitente delegado quien decida los detalles de las llamadas de envío de correoelectrónico.

Note

Si desea habilitar al remitente delegado para acceder a Amazon SES a través de la interfaz deSMTP, debe elegir SendRawEmail como mínimo.

Si su caso de uso es tal que desea restringir la acción, puede hacerlo incluyendo solo una de lasacciones en su política de autorización de envío. El siguiente ejemplo muestra cómo restringir la acción aSendRawEmail.

{ "Id":"ExamplePolicy", "Version":"2012-10-17", "Statement":[ { "Sid":"ControlAction", "Effect":"Allow", "Resource":"arn:aws:ses:us-east-1:888888888888:identity/example.com", "Principal":{ "AWS":[ "123456789012" ] }, "Action":[ "SES:SendRawEmail" ] } ]}

Restricción del nombre de visualización del remitente de correoelectrónicoAlgunos clientes de correo electrónico muestran el nombre "descriptivo" del remitente de correo electrónico(si el encabezado de correo electrónico lo proporciona), en lugar de la dirección de remitente ("From")real. Por ejemplo, el nombre de visualización de "John Doe <[email protected]>" es John Doe.Por ejemplo, podría enviar correos electrónicos desde [email protected], pero prefiere que dichosdestinatarios vean que el correo electrónico procede de marketing en lugar de [email protected]. Lasiguiente política permite al ID de cuenta de AWS 123456789012 enviar correo electrónico desde laidentidad example.com, pero solo si el nombre de visualización de la dirección de remitente ("From")incluye Marketing.

{ "Id":"ExamplePolicy",

152


"Version":"2012-10-17", "Statement":[ { "Sid":"AuthorizeFromAddress", "Effect":"Allow", "Resource":"arn:aws:ses:us-east-1:888888888888:identity/example.com", "Principal":{ "AWS":[ "123456789012" ] }, "Action":[ "SES:SendEmail", "SES:SendRawEmail" ], "Condition":{ "StringLike":{ "ses:FromDisplayName":"Marketing" } } } ]}

Uso de varias instruccionesLa política de autorización de envío puede incluir varias instrucciones. La siguiente política de ejemplocontiene dos instrucciones. La primera instrucción permite que dos cuentas de AWS distintas envíencorreo electrónico desde [email protected], siempre y cuando la dirección de remitente ("From")y la dirección de retroalimentación usen el dominio example.com. La segunda instrucción autoriza a unusuario de IAM a enviar correo electrónico desde [email protected] siempre que la dirección decorreo electrónico del destinatario esté en el dominio example.com.

{ "Version":"2012-10-17", "Statement":[ { "Sid":"AuthorizeAWS", "Effect":"Allow", "Resource":"arn:aws:ses:us-east-1:999999999999:identity/[email protected]", "Principal":{ "AWS":[ "111111111111", "222222222222" ] }, "Action":[ "SES:SendEmail", "SES:SendRawEmail" ], "Condition":{ "StringLike":{ "ses:FromAddress":"*@example.com", "ses:FeedbackAddress":"*@example.com" } } }, { "Sid":"AuthorizeInternal", "Effect":"Allow", "Resource":"arn:aws:ses:us-east-1:999999999999:identity/[email protected]", "Principal":{ "AWS":"arn:aws:iam::333333333333:user/Jane"

153

Amazon Simple Email Service Developer GuideTareas de propietario de identidad

}, "Action":[ "SES:SendEmail", "SES:SendRawEmail" ], "Condition":{ "ForAllValues:StringLike":{ "ses:Recipients":"*@example.com" } } } ]}

Tareas de propietario de identidad para autorizaciónde envío de Amazon SESEn esta sección se describen los pasos que los propietarios de identidad deben realizar al configurar laautorización de envío.

Temas• Verificación de una identidad para autorización de envío de Amazon SES (p. 154)• Configuración de notificaciones de propietario de identidad para autorización de envío de Amazon

SES (p. 154)• Obtener información del remitente delegado para autorización de envío de Amazon SES (p. 155)• Creación de una política para autorización de envío de Amazon SES (p. 155)• Proporcionar al remitente delegado la información de identidad para autorización de envío de Amazon

SES (p. 158)• Administración de sus políticas para autorización de envío de Amazon SES (p. 158)

Verificación de una identidad para autorización de envío deAmazon SESEl primer paso para configurar la autorización de envío es demostrar que usted es el propietario de ladirección de correo electrónico o el dominio desde el que el remitente delegado enviará correo electrónico.El procedimiento de verificación se describe en Verificación de identidades (p. 47).

Puede confirmar que una dirección de correo electrónico o un dominio está verificado comprobado suestado en la sección Identity Management de la consola de Amazon SES o mediante la operación de APIGetIdentityVerificationAttributes.

Configuración de notificaciones de propietario de identidad paraautorización de envío de Amazon SESSi autoriza a un remitente delegado a enviar correos electrónicos en su nombre, Amazon SES contabilizatodos los rebotes o reclamaciones que generan dichos correos electrónicos en los límites de rebotesy reclamaciones del remitente delegado en lugar de en los de usted. Sin embargo, si las identidadesde envío acaban en listas negras antispam de terceros como resultado de los mensajes enviados porun remitente delegado, la reputación de esas identidades puede deteriorarse. Por este motivo, si es unpropietario de identidades, debería configurar el reenvío de retroalimentación de correo electrónico parasus identidades. Para obtener más información, consulte Notificaciones de Amazon SES a través de correoelectrónico (p. 237).

154



Los remitentes delegados pueden configurar sus propias notificaciones de rebotes y reclamacionespara las identidades cuyo uso se les ha autorizado. También pueden configurar la publicación deeventos (p. 259) para enviar notificaciones cuando se produzcan eventos de rebotes o reclamaciones.Si el propietario de identidad deshabilita el reenvío de retroalimentación, el remitente delegado debeconfigurar la publicación de eventos para publicar los eventos de rebotes y reclamaciones en un temade Amazon SNS o un flujo de Kinesis Data Firehose. Si ni el propietario de identidad ni el remitentedelegado configuran un método de envío de notificaciones para eventos de rebotes y reclamaciones, o siel remitente no aplica el conjunto de configuración que utiliza la regla de publicación de eventos, AmazonSES envía automáticamente notificaciones de eventos por correo electrónico a la dirección que figura en elcampo Return-Path del mensaje (o a la dirección del campo Source, si no se ha especificado una direcciónReturn-Path), aunque se haya deshabilitado el reenvío de retroalimentación de correo electrónico. Esteproceso se ilustra en la imagen siguiente.

Obtener información del remitente delegado para autorización deenvío de Amazon SESSu política de autorización de envío debe especificar al menos una entidad principal, que es la entidad a laque se concede acceso. Para las políticas de autorización de envío de Amazon SES, la entidad principalpuede ser una cuenta de AWS, un usuario de AWS Identity and Access Management (IAM) o un serviciode AWS.

El tipo de entidad principal que elija depende de sus preferencias, pero si desea el control más detallado,solicite al remitente delegado que configure un usuario de IAM de modo que solo un remitente delegadopueda enviarle correo electrónico a usted en lugar de cualquier usuario de la cuenta de AWS del remitentedelegado. El remitente delegado puede encontrar información acerca de cómo configurar un usuario deIAM en Creación de un usuario de IAM en su cuenta de AWS en la Guía del usuario de IAM.

Después de haber decidido si desea conceder acceso a una cuenta de AWS, un usuario de IAM o unservicio de AWS, solicite al remitente delegado el ID de cuenta de AWS o el nombre de recurso deAmazon (ARN) del usuario de IAM para que pueda incluirlo en su política de autorización de envío.Puede remitir a su remitente delegado a las instrucciones para buscar esta información en Proporcionarinformación al propietario de identidad (p. 160). Si el remitente delegado es un servicio de AWS, consultela documentación correspondiente a dicho servicio para determinar el nombre del servicio.

Creación de una política para autorización de envío de AmazonSESPara autorizar a un remitente delegado a enviar correo electrónico para una de sus identidades, debecrear una política de autorización de envío y asociarla a la identidad. Las identidades pueden tener ceropolíticas, una política o varias políticas. Sin embargo, cada política solo puede estar asociada a unaidentidad.

Important

Las políticas adjuntas a identidades de dirección de correo electrónico anulan las políticasadjuntas a las identidades de dominio correspondientes. Por ejemplo, digamos que ha verificadoexample.com y [email protected]. Si crea una política para example.com que no permite a unremitente delegado y crea una política para [email protected] que permite a dicho remitentedelegado, el remitente delegado podrá enviar desde [email protected] si especifica el ARN [email protected] en la solicitud para enviar el correo electrónico.

Puede crear una política de autorización de envío de las siguientes formas:

• Mediante el generador de políticas: puede crear una política sencilla utilizando el generador de políticasde la consola de Amazon SES. Además de especificar quién puede enviar los correos electrónicos,

155

https://docs.aws.amazon.com/IAM/latest/UserGuide/Using_SettingUpUser.html


puede restringir el envío de correos electrónicos con condiciones basadas en el intervalo de fecha yhora en el que se pueden enviar los correos electrónicos, la dirección de remitente ("From"), el nombrede visualización del remitente ("From"), la dirección a la que se envían los rebotes y reclamaciones,las direcciones de destinatario y la IP de origen. Es posible que también desee usar el generador depolíticas para crear la estructura de una política sencilla y, a continuación, personalizarla más adelanteeditando la política.

• Mediante la creación de una política personalizada: si desea incluir condiciones más avanzadas o utilizarun servicio de AWS como entidad principal, puede crear una política personalizada y asociarla a laidentidad a través de la consola de Amazon SES o la API de Amazon SES.

En este tema se describen ambos métodos.

Usando el generador de políticas

Puede usar el generador de políticas para crear una política de autorización sencilla usando el siguienteprocedimiento.

Para crear una política utilizando el generador de políticas


2. En el panel de navegación izquierdo, en Identity Management, elija Domains o bien Email Addresses.3. En la lista de identidades, elija la identidad para la que desea crear una política.4. En el panel de detalles, expanda Identity Policies, elija Create Policy y, a continuación, Policy

Generator.5. En el asistente, cree una instrucción de política eligiendo valores para los siguientes campos. Puede

encontrar información acerca de estas opciones en Políticas de autorización de envío (p. 144).

• Effect: si desea conceder acceso, elija Allow; de lo contrario, seleccione Deny.• Principals: introduzca el ID de cuenta de AWS de 12 dígitos o bien el ARN de un usuario de IAM

al que permita o deniegue el acceso y, a continuación, elija Add. Puede añadir más entidadesprincipales repitiendo este paso. Un ejemplo de un ID de cuenta de AWS es 123456789012 y unejemplo de un ARN de usuario de IAM es arn:aws:iam::123456789012:user/John.

Note

El asistente de generador de políticas no admite actualmente las entidades principales deservicio de AWS. Para añadir una entidad principal de servicio de AWS, debe crear unapolítica personalizada (p. 157) o utilizar el generador de políticas para añadir una cuentade AWS o entidad principal de usuario de IAM y, a continuación, editar (p. 158) la política.

• Actions: elija el acceso de envío de correo electrónico al que se aplica esta política. Normalmente,los propietarios de identidad eligen ambas opciones para dar al remitente delegado libertad paraelegir cómo implementar el envío de correos electrónicos. Para obtener más información, consulteInstrucciones específicas de la política (p. 146).

6. (Opcional) Si desea añadir restricciones a la política, elija Add Conditions y, a continuación, elija lasiguiente información:

• Key: es la característica específica que define la restricción del acceso. El generador de políticasle permite elegir una clave específica de Amazon SES o una de las claves aplicables a todoAWS de uso menos común (hora actual e IP de origen). Para obtener más información, consulteCondiciones (p. 147). Si desea especificar las claves aplicables a todo AWS más avanzadas quese incluyen en Claves disponibles, puede editar la política después de crearla.

• Condition: es el tipo de condición que desea especificar. Por ejemplo, existen condiciones decadena, condiciones numéricas, condiciones de fecha y hora, etc. Para ver una lista de condiciones,consulte Condition Types en la Guía del usuario de IAM.

156



https://docs.aws.amazon.com/IAM/latest/UserGuide/AccessPolicyLanguage_ElementDescriptions.html#AvailableKeys

https://docs.aws.amazon.com/IAM/latest/UserGuide/AccessPolicyLanguage_ElementDescriptions.html#AccessPolicyLanguage_ConditionType


• Value: se trata del valor que se probará con la condición. Para ver algunos ejemplos, consulte laspolíticas de Ejemplos de políticas de autorización de envío (p. 149).

Después de elegir la clave, la condición y el valor, seleccione Add Condition. La condición aparece enla lista Conditions. Puede eliminar las condiciones eligiendo Remove junto a una condición en la lista.Puede añadir otra condición eligiendo Add Conditions de nuevo.

7. Cuando haya terminado de añadir condiciones, elija Add Statement. La instrucción aparecerá en lalista Statements, donde puede elegir editarla o eliminarla. Puede añadir instrucciones adicionalesrepitiendo los pasos 5-7.

8. Cuando haya terminado de añadir instrucciones, elija Next.9. En el cuadro de diálogo Edit Policy, revise su política, edítela si es necesario y, a continuación, elija

Apply Policy.

Creando una política personalizadaSi desea crear una política personalizada y adjuntarla a una identidad, dispone de las siguientes opciones:

• Mediante la API de Amazon SES: cree una política en un editor de texto y, a continuación, asocie lapolítica a la identidad utilizando la API PutIdentityPolicy que se describe en la Amazon SimpleEmail Service API Reference.

157




• Mediante la consola de Amazon SES: cree una política en un editor de texto y asóciela a una identidadpegándola en el editor de políticas personalizadas en la consola de Amazon SES. El siguienteprocedimiento describe este método.

Para crear una política personalizada utilizando el editor de políticas personalizadas


2. En el panel de navegación izquierdo, en Identity Management, elija Domains o bien Email Addresses.3. En la lista de identidades, elija la identidad para la que desea crear una política.4. En el panel de detalles, expanda Identity Policies, elija Create Policy y, a continuación, Custom Policy.5. En el panel Edit Policy, pegue el texto de su política.6. Seleccione Apply Policy.

Proporcionar al remitente delegado la información de identidadpara autorización de envío de Amazon SESDespués de crear su política de autorización de envío y asociarla a su identidad, puede proporcionaral remitente delegado el nombre de recurso de Amazon (ARN) de la identidad. El remitente delegadotransferirá dicho ARN a Amazon SES en la operación de envío de correo electrónico o en el encabezadodel correo electrónico. Use el siguiente procedimiento para buscar el ARN de su identidad.

Para buscar el ARN de una identidad


2. En el panel de navegación izquierdo, en Identity Management, elija Domains o bien Email Addresses.3. En la lista de identidades, elija la identidad a la que asoció la política de autorización de envío.4. En la parte superior del panel de detalles, después de Identity ARN, verá el ARN de la identidad.

Tendrá un aspecto similar a arn:aws:ses:us-east-1:123456789012:identity/[email protected]. Copietodo el ARN y proporciónelo a su remitente delegado.

Administración de sus políticas para autorización de envío deAmazon SESAdemás de crear y adjuntar políticas a identidades tal como se explica en Creación de unapolítica (p. 155), puede editar, quitar, enumerar y recuperar las políticas de una identidad, tal y como sedescribe en las secciones siguientes.

Note

Para revocar los permisos, puede editar una política o eliminarla.

Edición de una política

La forma más sencilla de editar una política consiste en utilizar la consola de Amazon SES. Si deseautilizar la API de Amazon SES en su lugar, puede utilizar la operación GetIdentityPolicies para recuperar lapolítica, editarla mediante un editor de texto y, a continuación, utilizar la operación PutIdentityPolicy parasobrescribir la política antigua.

En el siguiente procedimiento se muestra cómo editar una política utilizando la consola de Amazon SES.

158





https://docs.aws.amazon.com/ses/latest/APIReference/API_GetIdentityPolicies.html

https://docs.aws.amazon.com/ses/latest/APIReference/API_PutIdentityPolicy.html


Para editar una política utilizando la consola de Amazon SES


2. En el panel de navegación izquierdo, en Identity Management, elija Domains o bien Email Addresses.3. En la lista de identidades, elija la identidad que está asociada con la política que desea editar.4. En el panel de detalles, expanda Identity Policies.5. Junto a la política que desea editar, elija Edit Policy.6. En el panel Edit Policy, edite la política y, a continuación, elija Apply Policy.7. En el cuadro de diálogo Overwrite Existing Policy, elija Overwrite.

Eliminación de una política

Para revocar los permisos en cualquier momento, puede simplemente eliminar la política. Puede eliminaruna política mediante la operación de API DeleteIdentityPolicy o bien puede usar la consola de AmazonSES, tal y como se describe en el siguiente procedimiento.

Important

Después de eliminar una política, no se puede recuperar de nuevo. Le recomendamos que hagauna copia de la política copiándola y pegándola en un archivo de texto antes de eliminarla.

Para eliminar una política utilizando la consola de Amazon SES


2. En el panel de navegación izquierdo, en Identity Management, elija Domains o bien Email Addresses.3. En la lista de identidades, elija la identidad que está asociada con la política que desea eliminar.4. En el panel de detalles, expanda Identity Policies. Junto a la política que desea eliminar, elija Remove

Policy.5. En el cuadro de diálogo Remove Policy, elija Yes, Remove Policy.

Enumerar y recuperar políticas

Puede mostrar las políticas que se han asociado a una identidad mediante la operación de APIListIdentityPolicies. También puede recuperar las propias políticas mediante la operación de APIGetIdentityPolicies.

También puede realizar estas tareas en la consola de Amazon SES tal y como se describe en el siguienteprocedimiento.

Para enumerar y mostrar las políticas adjuntas a una identidad mediante la consola de AmazonSES


2. En el panel de navegación izquierdo, en Identity Management, elija Domains o bien Email Addresses.3. En la lista de identidades, elija la identidad para la que desea ver las políticas.4. En el panel de detalles, expanda Identity Policies.5. Junto a la política que desea ver, elija Show Policy.

159



https://docs.aws.amazon.com/ses/latest/APIReference/API_DeleteIdentityPolicy.html



https://docs.aws.amazon.com/ses/latest/APIReference/API_ListIdentityPolicies.html




Amazon Simple Email Service Developer GuideTareas de remitente delegado

Tareas de remitente delegado para autorización deenvío de Amazon SESComo remitente delegado, está enviando correos electrónicos entre cuentas. Esto significa que estáenviando correos electrónicos en nombre de una identidad que no le pertenece, pero que está autorizado autilizar. Aunque realice el envío en nombre del propietario de identidad, los rebotes y las reclamaciones secontabilizan en sus métricas de rebotes y reclamaciones de su cuenta de AWS y el número de mensajesenviados se contabiliza en su cuota de envío. Usted también tiene la responsabilidad de solicitar losaumentos de límite de envío que pueda necesitar para enviar correo electrónico del propietario deidentidad.

Como remitente delegado, debe realizar las siguientes tareas:

• Proporcionar información al propietario de identidad (p. 160)• Uso de notificaciones de remitente delegado (p. 160)• Envío de correos electrónicos para el propietario de identidad (p. 163)

Proporcionar información al propietario de identidad paraautorización de envío de Amazon SESComo remitente delegado, debe proporcionar al propietario de identidad su ID de cuenta de AWS o elnombre de recurso de Amazon (ARN) del usuario de AWS Identity and Access Management (IAM) queenviará correo electrónico en nombre del propietario de identidad. Puede encontrar esta información através de los siguientes procedimientos.

Para encontrar el ID de su cuenta de AWS

1. Inicie sesión en la Consola de administración de AWS en https://console.aws.amazon.com.2. En el menú de navegación, elija el nombre de la cuenta y, a continuación, elija My Account.3. Expanda Account Settings. En esta sección, se muestra su ID de cuenta de AWS.

Para buscar el ARN de un usuario de IAM

1. Inicie sesión en la Consola de administración de AWS y abra la consola de IAM en https://console.aws.amazon.com/iam/.

2. En el panel de navegación, seleccione Users.3. En la lista de usuarios, elija el nombre de usuario. La sección Summary muestra el ARN. El ARN es

similar al siguiente ejemplo: arn:aws:iam::123456789012:user/John.

Uso de notificaciones de remitente delegado para autorización deenvío de Amazon SESComo remitente delegado, los rebotes y las reclamaciones contabilizan en sus métricas de rebotes yreclamaciones, no en las del propietario de identidad. Unas tasas elevadas de rebotes y reclamacionessuponen un riesgo de que la cuenta se cierre, por lo que es importante configurar las notificacionesy disponer de un proceso para monitorearlas y eliminar de las listas de correo las direcciones dedestinatarios con rebotes o reclamaciones.

Los remitentes delegados pueden configurar Amazon SES para que envíe notificaciones cuando seproduzcan eventos de rebotes y reclamaciones. Los remitentes delegados también puede configurar la

160

https://console.aws.amazon.com




publicación de eventos (p. 259) para publicar notificaciones de rebotes y reclamaciones en Amazon SNSo Kinesis Data Firehose.

Note

Si configura Amazon SES para enviar notificaciones mediante Amazon SNS, se le cobraránlas tarifas estándar de Amazon SNS para las notificaciones que reciba. Para obtener másinformación, consulte la Página de precios de Amazon SNS.

Temas• Configuración de notificación de identidad entre cuentas de Amazon SES (p. 161)• Edición de una configuración de notificación entre cuentas de Amazon SES (p. 162)• Ver las notificaciones de identidad entre cuentas de Amazon SES (p. 162)• Eliminar una configuración de notificación de identidad entre cuentas de Amazon SES (p. 162)

Configuración de notificación de identidad entre cuentas de Amazon SESAntes de configurar las notificaciones, tiene que conocer el nombre de recurso de Amazon (ARN)de la identidad que el propietario de identidad ha autorizado a utilizar y para la que desea configurarnotificaciones. Por ejemplo, el ARN para la identidad [email protected] tendría un aspecto similara arn:aws:ses:us-east-1:123456789012:identity/[email protected]. Si el propietario de identidad noha dado el ARN de la identidad, remítalos al procedimiento en Proporcionar al remitente delegado lainformación de identidad (p. 158).

La forma más sencilla de configurar notificaciones consiste en utilizar la consola de Amazon SES. Tambiénpuede usar la operación de API SetIdentityNotificationTopic, pasando el ARN de la identidad como elparámetro Identity.

En el siguiente procedimiento se muestra cómo configurar notificaciones utilizando la consola de AmazonSES.

Para configurar las notificaciones de rebote, reclamación o entrega de Amazon SNS utilizando laconsola de Amazon SES


2. En el panel de navegación, elija Cross-Account Notifications (Notificaciones entre cuentas).3. Elija Add Notification Config.4. En el cuadro de diálogo Add Notification Configuration (Añadir configuración de notificación), en

Identity ARN (ARN de identidad), escriba el ARN de la identidad para la que desea configurar lasnotificaciones. La identidad no puede pertenecer a la cuenta en la que ha iniciado sesión actualmente.

5. Seleccione los temas de Amazon SNS que desea utilizar para rebotes, reclamaciones o entregas.También puede crear nuevos temas de Amazon SNS para estas notificaciones.

Important

Los temas de Amazon SNS que utilice para las notificaciones de Amazon SES deben estaren la misma región de AWS que usa para enviar correo electrónico mediante Amazon SES.

Puede elegir publicar notificaciones de rebotes, reclamaciones y entregas al mismo tema de AmazonSNS o en temas de Amazon SNS distintos. Si desea utilizar un tema de Amazon SNS que no sea desu propiedad, el propietario de dicho tema debe configurar una política de acceso de Amazon SNSque permita a su cuenta llamar a la acción SNS:Publish en su tema. Para obtener información sobrecómo controlar el acceso a su tema de Amazon SNS a través del uso de políticas de IAM, consulteManaging Access to Your Amazon SNS Topics.

6. Elija Save Config para guardar su configuración de notificación. Estos cambios pueden tardar un ratoen aplicarse.

161

https://aws.amazon.com/sns/pricing

https://docs.aws.amazon.com/ses/latest/APIReference/API_SetIdentityNotificationTopic.html



https://docs.aws.amazon.com/sns/latest/dg/AccessPolicyLanguage.html


Edición de una configuración de notificación entre cuentas de Amazon SESLa forma más sencilla de editar configuraciones de notificación consiste en utilizar la consola deAmazon SES. Si desea utilizar la API de Amazon SES en su lugar, puede utilizar la operación de APISetIdentityNotificationTopic y pasar el ARN de la identidad como el parámetro Identity.

En el siguiente procedimiento se muestra cómo editar una configuración de notificación entre cuentasutilizando la consola de Amazon SES.

Para editar una configuración de notificación entre cuentas mediante la consola de Amazon SES


2. En el panel de navegación izquierdo, elija Cross-Account Notifications.

Las identidades entre cuentas para las que ha configurado notificaciones se muestran en el panel dedetalles Cross-Account Notifications.

3. Elija el ARN de la identidad para la que desea ver la configuración de notificaciones.4. Edite la configuración de notificaciones y, a continuación, elija Save Config.

Ver las notificaciones de identidad entre cuentas de Amazon SESLa forma más sencilla de ver sus configuraciones de notificación consiste en utilizar la consola de AmazonSES. También puede usar la operación de API GetIdentityNotificationAttributes, pasando el ARN de laidentidad como el parámetro Identity.

Note

Las únicas identidades entre cuentas que se muestran en la lista de identidades entre cuentasson aquellas para las que ha configurado notificaciones utilizando el procedimiento descrito enConfiguración de notificación (p. 161).

Para ver sus configuraciones de notificación entre cuentas mediante la consola de Amazon SES




3. Elija el ARN de una identidad.

El cuadro de diálogo Edit Configuration Notification muestra la configuración de la identidad.

Eliminar una configuración de notificación de identidad entre cuentas de AmazonSESLa forma más sencilla de eliminar una configuración de notificación consiste en utilizar la consola deAmazon SES. También puede usar la operación de API SetIdentityNotificationTopic, pasando el ARN dela identidad como el parámetro Identity y pasando null para el parámetro SnsTopic. Para eliminarcompletamente la configuración de notificación, debe realizar esta operación para cada tipo de notificación(rebote, reclamación o entrega) definida.

Note

Al eliminar una configuración de notificación, el ARN de la identidad entre cuentas se elimina dela lista de ARN de identidad entre cuentas en la consola de Amazon SES. Esto no significa que

162




https://docs.aws.amazon.com/ses/latest/APIReference/API_GetIdentityNotificationAttributes.html





no pueda seguir enviando correo para dicha identidad; solo significa que su cuenta ya no estáconfigurada para recibir las notificaciones de rebotes, reclamaciones o entregas. Si desea volvera habilitar las notificaciones, tiene que repetir el procedimiento de configuración de notificacionesque se describe en Configuración de notificación (p. 161).

En el siguiente procedimiento se muestra cómo eliminar una configuración de notificación entre cuentasutilizando la consola de Amazon SES.

Para eliminar una configuración de notificación entre cuentas mediante la consola de AmazonSES




3. Seleccione la casilla situada a la izquierda de la identidad cruzada que desee eliminar y, acontinuación, seleccione Remove.

4. En el cuadro de diálogo Remove Cross-Account Notification Config, elija Delete Notification config.

El ARN de la identidad entre cuentas ya no aparece en la lista de ARN de identidad entre cuentas.Esto no significa que no pueda enviar para la identidad, solo que ya no tiene configuradas lasnotificaciones para ella.

Envío de correos electrónicos para el propietario de identidadpara autorización de envío de Amazon SESComo remitente delegado, envía correos electrónicos de la misma forma que lo hacen otros remitentesde Amazon SES, salvo que proporciona el ARN de la identidad que el propietario de identidad le haautorizado a utilizar. Cuando llama a Amazon SES para enviar el correo electrónico, Amazon SEScomprueba si la identidad que ha especificado tiene una política que le autoriza a enviarlo.

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

Important

Para poder enviar un correo electrónico desde una identidad de propietario de identidad, debeconectarse al punto de enlace de Amazon SES de la región de AWS en la que se verifica laidentidad. La política autorización de envío que le concede permiso debe estar adjunta a laidentidad en dicha región.

Con la API de Amazon SES

Al igual que con cualquier remitente de correo electrónico de Amazon SES, si tiene acceso a Amazon SESa través de la API de Amazon SES (ya sea directamente a través de HTTPS o indirectamente a travésde un SDK de AWS), puede elegir una de las dos acciones de envío de correo electrónico: SendEmail ySendRawEmail. El Amazon Simple Email Service API Reference describe los detalles de estos API, peroaquí ofrecemos una descripció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 entre cuentas de alguna de las dos formas siguientes:

163





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

Parámetro Descripción

SourceArn El ARN de la identidad que está asociada a la políticade autorización de envío que le permite enviar parala dirección de correo electrónico especificada en elparámetro Source de SendRawEmail.

Note

Para la mayoría de los casos de uso, lerecomendamos que especifique el SourceArn yno especifique el FromArn o ReturnPathArn.Si solo especifica el SourceArn, Amazon SESestablece la dirección de remitente ("From") y ladirección de ruta de retorno ("Return Path") en laidentidad especificada en SourceArn.

FromArn El ARN de la identidad que está asociada a la políticade autorización de envío que le permite especificaruna dirección de remitente ("From") particular en elencabezado del correo electrónico sin procesar.

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

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

Important

No incluya estos encabezados X en la firma DKIM, ya que Amazon SES los elimina antes deenviar 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 incluyenvarias 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-west-2:123456789012:identity/example.comX-SES-FROM-ARN: arn:aws:ses:us-west-2:123456789012:identity/example.comX-SES-RETURN-PATH-ARN: arn:aws:ses:us-west-2:123456789012:identity/example.com

From: [email protected]

164


To: [email protected]: [email protected]: subjectContent-Type: multipart/alternative; boundary="----=_boundary"

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

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

body------=_boundary--

SendEmail

Si utiliza la operación SendEmail, puede especificar la identidad entre cuentas pasando los parámetrosopcionales que se indican a continuación. No puede utilizar el método de encabezado X cuando utiliza laoperación SendEmail.

Parámetro Descripción

SourceArn El ARN de la identidad que está asociada a la políticade autorización de envío que le permite enviar parala dirección de correo electrónico especificada en elparámetro Source de SendRawEmail.

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

El siguiente ejemplo muestra cómo enviar un correo electrónico que incluye los atributos SourceArn yReturnPathArn mediante la operación SendEmail y el SDK for Python.


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

# Try to send the email.try: #Provide the contents of the email. response = client.send_email( Destination={ 'ToAddresses': [ '[email protected]', ], }, Message={ 'Body': { 'Html': { 'Charset': 'UTF-8', 'Data': 'This email was sent with Amazon SES.',

165


Amazon Simple Email Service Developer GuideUso de direcciones IP dedicadas

}, }, 'Subject': { 'Charset': 'UTF-8', 'Data': 'Amazon SES Test', }, }, SourceArn='arn:aws:ses:us-west-2:123456789012:identity/example.com', ReturnPathArn='arn:aws:ses:us-west-2:123456789012:identity/example.com', Source='[email protected]', ReturnPath='[email protected]' )# 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 SMTP de Amazon SES para el envío entre cuentas, deberá incluir losencabezados X-SES-SOURCE-ARN, X-SES-FROM-ARN y X-SES-RETURN-PATH-ARN en su mensaje.Pase estos encabezados después enviar el comando DATA en la conversación SMTP.

Uso de direcciones IP dedicadas con Amazon SESAl crear una nueva cuenta de Amazon SES, sus correos electrónicos se envían desde direcciones IPque se comparten con otros usuarios de Amazon SES. Por un cargo mensual adicional, puede alquilardirecciones IP dedicadas que están reservadas para su uso exclusivo. Ambas opciones ofrecen beneficiose inconvenientes específicos, que se resumen en la tabla siguiente; haga clic en un elemento en lacolumna Beneficio para obtener información adicional acerca de dicho beneficio.

Beneficio Direcciones IP compartidas Direcciones IP dedicadas

Lista para utilizar sinconfiguración adicional (p. 167)

Sí No

Reputación administrada porAWS (p. 167)

Sí No

Bueno para clientes conpatrones de envío continuos ypredecibles (p. 167)

Sí Sí

Bueno para clientes conpatrones de envío menospredecibles (p. 167)

Sí No

Bueno para remitentes de granvolumen (p. 168)

Sí Sí

Bueno para remitentes de bajovolumen (p. 168)

Sí No

Costos mensualesadicionales (p. 168)

No Sí

166


Amazon Simple Email Service Developer GuideFacilidad de configuración

Beneficio Direcciones IP compartidas Direcciones IP dedicadas

Control completosobre la reputación delremitente (p. 168)

No Sí

Aislar reputación por correoelectrónico tipo, destinatario uotros factores (p. 168)

No Sí

Ofrece direcciones IP conocidasque no cambian nunca (p. 168)

No Sí

Important

Si no prevé enviar grandes volúmenes de correo electrónico de forma regular y predecible, lerecomendamos que utilice direcciones IP compartidas. Si utiliza direcciones IP dedicadas ensituaciones en las que desea enviar bajos volúmenes de correo electrónico o si los patrones deenvío son muy irregulares, experimentará problemas de capacidad de entrega.

Facilidad de configuraciónSi decide utilizar direcciones IP compartidas, entonces no es necesario realizar ninguna configuraciónadicional; su cuenta de Amazon SES está lista para enviar correo electrónico en cuanto verifique unadirección de correo electrónico y salga del entorno de pruebas.

Si decide alquilar direcciones IP dedicadas, debe determinar la cantidad de direcciones IP dedicadas quenecesita, enviar una solicitud y, opcionalmente, configurar grupos de IP dedicadas.

Reputación administrada por AWSLa reputación de las direcciones IP se basa en gran medida en los patrones de envío históricos y en elvolumen. Una dirección IP que envía volúmenes de correo electrónico uniformes durante un periodo detiempo largo, normalmente tiene una buena reputación.

Las direcciones IP compartidas las utilizan varios clientes de Amazon SES. En conjunto, estos clientesenvían un gran volumen de correo electrónico. AWS administra cuidadosamente este tráfico saliente con elfin de maximizar las reputaciones de las direcciones IP compartidas.

Si utiliza direcciones IP dedicadas, es responsabilidad suya mantener su reputación de remitente enviandovolúmenes coherentes y predecibles de correo electrónico.

Capacidad de predicción de los patrones de envíoUna dirección IP con un historial de envío de correo electrónico coherente tiene una mejor reputación queotra que de repente comienza a enviar grandes volúmenes de correo electrónico sin un historial previo deenvíos.

Si sus patrones de envío de correo electrónico son irregulares; es decir, no siguen un patrón predecible,las direcciones IP compartidas probablemente se adecuan mejor a sus necesidades. Al utilizar direccionesIP compartidas, puede aumentar o reducir sus patrones de envío de correo electrónico en función de lasdemandas de la situación.

Si utiliza direcciones IP dedicadas, debe preparar estas direcciones enviando una cantidad de correoelectrónico que aumente progresivamente cada día. El proceso de preparación de nuevas direcciones

167

Amazon Simple Email Service Developer GuideVolumen de correo electrónico saliente

IP se describe en Preparación de direcciones IP dedicadas (p. 171). Una vez que las direcciones IPdedicadas estén preparadas, debe mantener un patrón de envío coherente.

Volumen de correo electrónico salienteLas direcciones IP dedicadas son más adecuadas para los clientes que envían grandes volúmenesde correo electrónico. La mayoría de los proveedores de servicios de Internet (ISP) solo realizan unseguimiento de la reputación de una determinada dirección IP si reciben un importante volumen de correoelectrónico de esa dirección. Para cada ISP con el que desee cultivar una reputación, debe enviar varioscientos de mensajes de correo electrónico en un periodo de 24 horas, al menos una vez al mes.

En algunos casos, es posible que pueda utilizar direcciones IP dedicadas si no envía grandes volúmenesde correo electrónico. Por ejemplo, es posible que las direcciones IP dedicadas funcionen bien si envíaa un pequeño grupo de destinatarios bien definido cuyos servidores de correo electrónico aceptan orechazan correo electrónico a través de una lista de direcciones IP específicas, en lugar de la reputaciónde la dirección IP.

Costos adicionalesEl uso de direcciones IP compartidas está incluido en el precio de Amazon SES estándar. Las direccionesIP dedicadas alquiladas incurren en un costo mensual adicional más allá de los costos estándar asociadoscon el envío de correo electrónico con Amazon SES. Cada dirección IP dedicada incurre en un cargomensual independiente. Para obtener información acerca de los precios, consulte la página de precios deAmazon SES.

Control sobre la reputación del remitenteAl utilizar direcciones IP dedicadas, su cuenta de Amazon SES es la única que puede enviar correoelectrónico desde dichas direcciones. Por este motivo, la reputación del remitente de las direcciones IPdedicadas que alquila se determina en función de sus prácticas de envío de correos electrónicos.

Capacidad de aislar la reputación del remitenteMediante el uso de direcciones IP dedicadas, puede aislar su reputación de remitente para distintoscomponentes de su programa de correo electrónico. Si alquila más de una dirección IP dedicada parasu uso con Amazon SES, puede crear grupos de IP dedicadas: grupos de direcciones IP dedicadas quese pueden utilizar para enviar determinados tipos de correo electrónico. Por ejemplo, puede crear unconjunto de direcciones IP dedicadas para el envío de correo electrónico de marketing y otro para el envíode correos electrónicos de transacciones. Para obtener más información, consulte Creación de grupos deIP dedicadas (p. 172).

Direcciones IP conocidas y sin cambiosAl utilizar direcciones IP dedicadas, puede encontrar los valores de las direcciones que envían su correoelectrónico en la página Dedicated IPs de la consola de Amazon SES. Las direcciones IP dedicadas nocambian.

Con las direcciones IP compartidas, no conoce las direcciones IP que utiliza Amazon SES para enviar sucorreo electrónico y pueden cambiar en cualquier momento.

Solicitar y dejar de utilizar direcciones IP dedicadasEn esta sección se describe cómo solicitar direcciones IP dedicadas y renunciar a ellas enviando unasolicitud al AWS Support Center. Tenga en cuenta que se le cobra una cuota mensual adicional por cada

168



https://console.aws.amazon.com/support/home#/

Amazon Simple Email Service Developer GuideSolicitar y dejar de utilizar direcciones IP dedicadas

dirección IP dedicada que alquile para su uso con Amazon SES. Para obtener más información sobre loscostos asociados con direcciones IP dedicadas, consulte Precios de Amazon SES.

Prácticas recomendadas para trabajar con direcciones IPdedicadasAunque no hay compromiso mínimo, le recomendamos que alquile tres o más direcciones IP dedicadas afin de maximizar la entrega de correo electrónico.

Cada región de AWS en la que está disponible Amazon SES, contiene al menos tres zonas dedisponibilidad (zonas). Cuando se alquila más de una dirección IP dedicada, las distribuimosuniformemente entre las zonas de disponibilidad de la región.

Si crea un grupo de IP dedicadas (p. 172) que contiene solamente una dirección, y la zona en la que sebasa esa dirección no está disponible temporalmente, es posible que no se envíen los correos electrónicosque intente enviar utilizando dicho grupo. Sin embargo, si crea un grupo que contiene tres direcciones,puede estar seguro de que cada dirección está en una zona distinta. En este supuesto, incluso en el casopoco probable de que dos de las tres zonas no estén disponibles, podrá seguir enviando correo electrónicodesde la dirección restante.

Las interrupciones de servicio son poco frecuentes, pero es buena idea utilizar sistemas redundantes,especialmente si envía correo electrónico urgente o de gran importancia. Para obtener más informaciónsobre zonas de disponibilidad y las regiones de AWS, consulte Infraestructura global de AWS.

Solicitud de direcciones IP dedicadasA continuación, se describe cómo solicitar direcciones IP dedicadas enviando una SES Sending LimitsIncrease case. Puede usar este proceso para solicitar tantas direcciones IP dedicadas como necesite.

Para solicitar direcciones IP dedicadas


2. Abra un SES Sending Limits Increase case en el servicio de atención al cliente.3. En el caso de formulario de envío, realice las siguientes selecciones:

• En Regarding, elija Service Limit Increase.• En Limit Type, elija SES Sending Limits.• En Region, elija la región de AWS en la que utiliza Amazon SES.

Note

Las direcciones IP dedicadas son únicas para cada región de AWS, por lo que esimportante que seleccione la región en la que utiliza Amazon SES.Por ejemplo, si tiene una dirección IP dedicada para su uso en la región EE.UU. Oeste(Oregón), no podrá utilizar esa dirección para enviar correo electrónico desde la región USEast (N. Virginia).Si necesita solicitar direcciones IP dedicadas para su uso en más de una región, envíe unformulario de solicitud distinto para cada región.

• En Limit, elija Desired Daily Sending Quota.• En New limit value, especifique el número aproximado de mensajes de correo electrónico que desea

enviar al día desde las direcciones IP dedicadas que está solicitando.• En Mail Type, elija el tipo de correo electrónico que prevé enviar utilizando su dirección IP dedicada.

Si se aplican varios valores, elija el tipo que supondrá la mayor parte de su envío de correoelectrónico.

169

https://aws.amazon.com/ses/pricing/#Optional_Services

https://aws.amazon.com/about-aws/global-infrastructure/






Amazon Simple Email Service Developer GuideSolicitar y dejar de utilizar direcciones IP dedicadas

• En Website URL, escriba la dirección URL de su sitio web. Esta información nos ayudará a entendermejor el tipo de contenido que desea enviar.

• En My email sending complies with the AWS Service Terms and AUP, elija la opción que se aplica asu caso de uso.

• En I only send to recipients who have specifically requested my mail, elija la opción que se aplica asu caso de uso.

• En I have a process to handle bounces and complaints, elija la opción que se aplica a su caso deuso.

• En Use Case Description, indique que desea solicitar direcciones IP dedicadas y el número dedirecciones IP dedicadas que desea solicitar. A continuación, describa las formas en que utilizarálas direcciones IP dedicadas para enviar correo electrónico utilizando Amazon SES. Incluyainformación acerca de por qué desea utilizar direcciones IP dedicadas en lugar de direcciones IPcompartidas; esta información nos ayudará a entender mejor su caso de uso.

• En Support Language, elija el idioma que prefiera.• En Contact method, elija Web.

Cuando haya terminado, elija Submit.

Una vez que envíe el formulario, evaluaremos su solicitud. Responderemos a su solicitud en el servicio deatención al cliente. Si se concede la solicitud, la respuesta confirmará que sus direcciones IP dedicadasestán ahora asociadas a su cuenta.

Dejar de utilizar direcciones IP dedicadasSi ya no necesita las direcciones IP dedicadas asignadas a su cuenta, puede renunciar a ellas realizandolos pasos siguientes.

Para dejar de utilizar direcciones IP dedicadas


2. Abra un SES Sending Limits Increase case en el servicio de atención al cliente.3. En el caso de formulario de envío, realice las siguientes selecciones:

• En Regarding, elija Service Limit Increase.• En Limit Type, elija SES Sending Limits.• En Region, elija la región de AWS en la que utiliza Amazon SES.

Note

Las direcciones IP dedicadas son únicas para cada región de AWS, por lo que esimportante que seleccione la región en la que utiliza Amazon SES.Si necesita renunciar a direcciones IP dedicadas en más de una región, envíe un formulariode solicitud distinto para cada región.

• En Limit, elija Desired Daily Sending Quota.• En New limit value, escriba cualquier valor. El número que introduzca aquí no es importante, ya que

especificará el número de direcciones IP dedicadas a las que desea renunciar en el campo UseCase Description.

• En Use Case Description, indique que desea renunciar a direcciones IP dedicadas y despuésindique el número de direcciones IP dedicadas a las que desea renunciar.

• En Support Language, elija el idioma que prefiera.• En Contact method, elija Web.

170




Amazon Simple Email Service Developer GuidePreparación de direcciones IP dedicadas

Cuando haya terminado, elija Submit.

Después de evaluar su solicitud, recibirá una respuesta sobre el caso en el que se le pedirá queconfirme que desea liberar el número de direcciones IP que haya especificado. Recibirá una respuestaal caso confirmando que sus direcciones IP dedicadas se han liberado.

Preparación de direcciones IP dedicadasA la hora de determinar si desea aceptar o rechazar un mensaje, los proveedores de servicios de correoelectrónico tienen en cuenta la dirección IP que lo envía. Uno de los factores que contribuye a la reputaciónde una dirección IP es si esta tiene un historial de envío de correo electrónico de alta calidad. Es menosprobable que los proveedores de correo electrónico acepten correo de nuevas direcciones IP que tenganpoco o ningún historial. El correo electrónico enviado desde direcciones IP con poco o ningún historialpodría acabar en las carpetas de correo no deseado de los destinatarios o bloquearse.

Cuando empiece a enviar correo electrónico desde una nueva dirección IP, debe aumentar gradualmentela cantidad de correo electrónico que envía desde esa dirección antes de utilizarla a plena capacidad. Esteproceso se denomina preparación de la dirección IP.

La cantidad de tiempo necesario para preparar una dirección IP varía en función del proveedor de correoelectrónico. Para algunos proveedores de correo electrónico, puede establecer una reputación positiva enaproximadamente dos semanas, mientras que para otros puede tardar hasta seis semanas. Al prepararuna nueva dirección IP, debe enviar correo electrónico a los usuarios más activos para garantizar que latasa de reclamaciones permanezca baja. También debe examinar atentamente los mensajes de rebotes yenviar menos correo electrónico si recibe un gran número de notificaciones de bloqueo o limitación. Paraobtener información sobre cómo monitorizar los rebotes, consulte Monitoreo de la actividad de envío deAmazon SES (p. 230).

Preparar direcciones IP dedicadas automáticamenteCuando solicita direcciones IP dedicadas, Amazon SES las prepara automáticamente para mejorar laentrega del correo electrónico que envía. La característica de preparación automática de direcciones IPestá activada de forma predeterminada.

Los pasos que tienen lugar durante el proceso automático de preparación dependen de si dispone o no dedirecciones IP dedicadas:

• Cuando solicita direcciones IP dedicadas por primera vez, Amazon SES distribuye el envío de correoelectrónico entre sus direcciones IP dedicadas y un conjunto de direcciones que se comparten con otrosclientes de Amazon SES. Amazon SES aumenta progresivamente el número de mensajes enviadosdesde las direcciones IP dedicadas con el paso del tiempo.

• Si ya tiene direcciones IP dedicadas, Amazon SES distribuye el envío de correo electrónico entre susdirecciones IP dedicadas (si ya están preparadas) y las nuevas direcciones IP dedicadas (que no estánpreparadas). Amazon SES aumenta progresivamente el número de mensajes enviados desde lasnuevas direcciones IP dedicadas con el paso del tiempo.

Después de preparar una dirección IP dedicada, debe enviar aproximadamente 1 000 mensajes de correoelectrónico cada día a cada proveedor de correo electrónico con el que desee mantener una reputaciónpositiva. Debe realizar esta tarea en cada dirección IP dedicada que utilice con Amazon SES.

Debe evitar enviar grandes volúmenes de correo electrónico inmediatamente después de que se completeel proceso de preparación. En lugar de ello, aumente lentamente el número de mensajes que envíahasta alcanzar el volumen deseado. Si un proveedor de correo electrónico detecta un gran aumentorepentino del número de mensajes enviados desde una dirección IP, podría bloquear o limitar la entrega demensajes desde esa dirección.

171

Amazon Simple Email Service Developer GuideCreación de grupos de IP dedicadas

Deshabilitar el proceso de preparación automáticaCuando adquiere nuevas direcciones IP dedicadas, Amazon SES se encarga de prepararlas. Si prefierepreparar usted mismo las direcciones IP dedicadas, puede deshabilitar la característica de preparaciónautomática.

Important

Si deshabilita la característica de preparación automática, usted es responsable de preparar lasdirecciones IP dedicadas. Si envía correo electrónico desde direcciones que no se han preparado,puede experimentar tasas de envío reducidas.

Para deshabilitar la característica de preparación automática


2. En la barra de navegación a la izquierda, elija Dedicated IPs.3. Borre la casilla junto a Automatic IP warm-up.

Reiniciar el proceso de preparación automáticaPuede reiniciar el proceso de preparación de IP automático para un conjunto de direcciones IP quepertenezca a un grupo de IP dedicadas.

Para reiniciar el proceso de preparación automática


2. En la barra de navegación a la izquierda, elija Dedicated IPs.3. En el grupo de IP dedicadas para el que desea reiniciar el proceso de preparación, elija Actions, a

continuación, elija Restart IP warm up.

El estado del proceso de preparación automática se encuentra en la columna Warm Up Status;cuando el proceso de calentamiento haya finalizado, esta columna indicará Complete.

Creación de grupos de IP dedicadasSi ha comprado varias direcciones IP dedicadas para su uso con Amazon SES, puede crear grupos dedichas direcciones. Estos grupos se denominan grupos de IP dedicadas. Un escenario común consiste encrear un conjunto de direcciones IP dedicadas para el envío de comunicaciones de marketing y otro parael envío de correos electrónicos de transacciones. Su reputación de remitente para correos electrónicosde transacciones queda aislada de la de sus correos electrónicos de marketing. En este caso, si unacampaña de marketing genera un gran número de reclamaciones, la entrega de sus correos electrónicosde transacción no se verá afectada.

Esta sección contiene procedimientos para crear grupos de IP dedicadas.

Note

También puede crear conjuntos de configuración que utilicen un grupo de direcciones IPque compartan todos los clientes de Amazon SES. El grupo de IP compartidas resulta útil ensituaciones en las que necesita enviar correo electrónico que no se ajusta a sus comportamientosde envío habituales. Para obtener información acerca de cómo utilizar el grupo de IP compartidascon un conjunto de configuración, consulte Administración de grupos de IP (p. 227).

172





Amazon Simple Email Service Developer GuideProbar el envío de correo electrónico

Para crear un grupo de IP dedicadas utilizando la consola de Amazon SES


2. En el panel de navegación del lado izquierdo de la pantalla, en Email Sending, elija Dedicated IPs.3. Elija Create a New IP Pool.4. En la página IP Pool Name, para Pool name, escriba un nombre descriptivo para el grupo de IP

dedicadas y, a continuación, elija Next.5. En la página Add Dedicated IPs, marque el recuadro junto a cada dirección IP que desee añadir al

grupo y, a continuación, elija Next.

Note

Las direcciones IP dedicadas que aún no se han asignado a un grupo se enumeran en ses-default-dedicated-pool.Una dirección IP dedicada solo puede pertenecer a un grupo único. Si selecciona unadirección IP dedicada que esté asociada a un grupo distinto, dicha configuración sesobrescribe y la dirección está asociada en su lugar al grupo que está creando.

6. En la página Assign to a configuration set, lleve a cabo una de las siguientes operaciones:

• Seleccione Add this pool to an existing configuration set para asociar el grupo de IP dedicadas a unconjunto de configuración existente. A continuación, en Existing configuration sets, elija el conjuntode configuración con el que desea asociar el grupo de IP.

• Seleccione Create a new configuration set para crear un conjunto de configuración y asociar elgrupo de IP dedicadas al mismo. Para Configuration set name, escriba un nombre descriptivo parael conjunto de configuración.

Cuando haya terminado, elija Next.7. En la página Review, verifique la configuración del grupo de IP dedicadas. Cuando esté listo para

crear el grupo de IP, elija Create.

Probar el envío de correo electrónico en AmazonSES

Amazon SES incluye un simulador de bandeja de correo que puede utilizar para probar cómo su aplicacióncontrola diferentes escenarios de envío de correo electrónico. El simulador de bandeja de correo es útilcuando, por ejemplo, necesita probar una aplicación de envío de correo electrónico sin crear direccionesde correo electrónico ficticias, o cuando necesita encontrar el rendimiento máximo de su sistema sin quese vea afectada su cuota de envío diaria.

Consideraciones importantesTenga en cuenta las siguientes características y limitaciones cuando utilice el simulador de bandeja decorreo de Amazon SES:

• Puede usar el simulador de bandeja de correo aunque la cuenta esté en el entorno de pruebas deAmazon SES.

• Los correos electrónicos que envíe al simulador de bandeja de correo están limitados por la tasade envío máxima de su cuenta, pero no afectan a sus límites de envío diarios. Por ejemplo, si sucuenta está autorizada para enviar 10 000 mensajes por período de 24 horas y envía 100 mensajes al

173



Amazon Simple Email Service Developer GuideUso del simulador de bandeja de correo

simulador de bandeja de correo, todavía puede enviar hasta 10 000 mensajes a destinatarios habitualessin alcanzar su límite de envío.

• Los correos electrónicos que envíe al simulador de bandeja de correo no afectan a las métricas decapacidad de entrega o de reputación de correo electrónico. Por ejemplo, si envía un gran número demensajes a la dirección de rebote del simulador de correo electrónico, no provocará que el panel dereputación (p. 350) muestre un mensaje advirtiéndole de que su tasa de rebote es demasiado alta.

• A efectos de facturación, los mensajes de correo electrónico que envíe al simulador de bandeja decorreo de Amazon SES son los mismos que cualquier otro correo electrónico que envíe a través deAmazon SES. Es decir, le facturamos el mismo importe por los mensajes que envía al simulador debuzón de correo que por los que envía a destinatarios habituales.

• El simulador de bandeja de correo es compatible con el etiquetado, lo que le permite enviar correoselectrónicos a la misma dirección del simulador de bandeja de correo de diversas maneras opara ver cómo la aplicación controla la ruta variable de retorno de sobres (VERP). Por ejemplo,puede enviar un correo electrónico a [email protected] y [email protected] para ver si su aplicación puede relacionar un mensaje rebotado conla dirección de correo electrónico que provocó el rebote.

• Si utiliza el simulador de bandeja de correo para simular varios rebotes desde la misma solicitud deenvío, Amazon SES combina las respuestas de rebote en una sola.

Uso del simulador de bandeja de correoPara utilizar el simulador de correo electrónico, busque el escenario que desea simular en la siguientetabla y, a continuación, envíe un correo electrónico a la dirección de correo electrónico correspondiente.

Note

Cuando envíe un correo electrónico a una dirección del simulador de bandeja de correo, debehacerlo a través de Amazon SES, utilizando la AWS CLI, un SDK de AWS, la consola de AmazonSES, la interfaz SMTP de Amazon SES o la API de Amazon SES. El simulador de bandeja decorreo no responde a los correos electrónicos que recibe de fuentes externas.

Escenario simulado Email address

Entrega correcta: el proveedor de correoelectrónico del destinatario acepta su correoelectrónico. Si configuró las notificaciones deentrega como se describe en Monitoreo utilizandonotificaciones de Amazon SES (p. 236), AmazonSES le envía una notificación de entrega a travésde Amazon Simple Notification Service (AmazonSNS).

[email protected]

Rebote: el proveedor de correo electrónicodel destinatario rechaza su correo electrónicocon un código de respuesta SMTP 550 5.1.1("usuario desconocido"). Amazon SES generauna notificación de rebote y, en función de cómohaya configurado la cuenta, se la envía enun correo electrónico o envía una notificacióna un tema de Amazon SNS. La dirección decorreo electrónico del simulador de bandeja decorreo no se coloca en la lista de supresión deAmazon SES, lo que sucedería normalmentecuando se produce un rebote permanente. Larespuesta de rebote que reciba desde el simulador

[email protected]

174

Amazon Simple Email Service Developer GuidePrueba de eventos de rechazo

Escenario simulado Email addressde bandeja de correo cumple con RFC 3464.Para obtener más información acerca de cómorecibir retroalimentación de rebotes, consulteMonitoreo utilizando notificaciones de AmazonSES (p. 236).

Respuestas automáticas: el proveedor de correoelectrónico del destinatario acepta su correoelectrónico y lo envía a la bandeja de entrada deldestinatario. El proveedor de correo electrónicoenvía una respuesta automática, como un mensajede "fuera de la oficina" (OOTO), a la dirección queaparece en el encabezado Return-Path del correoelectrónico, o a la dirección del remitente del sobre("MAIL FROM") si no está presente el encabezadoReturn-Path. La respuesta automática que recibadesde el simulador de bandeja de correo cumplecon RFC 3834.

[email protected]

Reclamación: el proveedor de correo electrónicodel destinatario acepta su correo electrónico y loenvía a la bandeja de entrada del destinatario.El destinatario decide que su mensaje no essolicitado y hace clic en "Marcar como spam"en su cliente de correo electrónico. AmazonSES, a continuación, le reenvía la notificación dereclamación por correo electrónico o medianteuna notificación de un tema de Amazon SNS, enfunción de cómo haya configurado la cuenta. Larespuesta de reclamación que reciba desde elsimulador de bandeja de correo cumple con RFC5965. Para obtener más información acerca decómo recibir retroalimentación de reclamaciones,consulte Monitoreo utilizando notificaciones deAmazon SES (p. 236).

[email protected]

Dirección del destinatario en la lista de supresión:Amazon SES genera un rebote permanente comosi la dirección del destinatario estuviera en la listade supresión de Amazon SES.

[email protected]

Prueba de eventos de rechazoCada mensaje que envía a través de Amazon SES se analiza para detectar la presencia de virus. Si envíaun mensaje que contenga un virus, Amazon SES acepta el mensaje, detecta el virus y rechaza el mensajecompleto. Cuando Amazon SES rechaza un mensaje, deja de procesarlo y no intenta entregarlo al servidorde correo del destinatario. A continuación, genera un evento de rechazo.

El simulador de bandeja de correo de Amazon SES no incluye una dirección para las pruebas de eventosde rechazo. Sin embargo, puede probar eventos de rechazo utilizando un archivo de prueba EICAR. Estearchivo es un método estándar del sector para probar el software antivirus de una forma segura. Para crearun archivo de prueba EICAR, pegue el texto siguiente en un archivo:

X5O!P%@AP[4\PZX54(P^)7CC)7}$EICAR-STANDARD-ANTIVIRUS-TEST-FILE!$H+H*

175





Amazon Simple Email Service Developer GuideAmazon SES y los protocolos de seguridad

Guarde el archivo como sample.txt, adjúntelo a un correo electrónico y, a continuación, envíe el correoelectrónico a una dirección verificada. Si no hay ningún otro problema con el correo electrónico, AmazonSES acepta el mensaje, pero lo rechaza tal y como lo haría si tuviera un virus real.

Note

Correos electrónicos rechazados: incluidos los que envía mediante el procedimiento anterior, secontabilizan para calcular su cuota de envío diaria. Le facturaremos cada mensaje que envíe,incluidos los rechazados.

Para obtener más información acerca de los archivos de prueba EICAR, consulte la página de archivo deprueba EICAR en Wikipedia. Para ver ejemplos de código que puede utilizar para enviar mensajes conarchivos adjuntos, consulte Envío de correo electrónico sin procesar mediante los SDK de AWS (p. 427).

Amazon SES y los protocolos de seguridadEn este tema, se describen los protocolos de seguridad que puede utilizar al conectarse a Amazon SES,así como cuando Amazon SES entrega un correo electrónico a un receptor.

Del remitente de correo electrónico a Amazon SESEl protocolo de seguridad que se utiliza para conectarse a Amazon SES depende de si se utiliza la API deAmazon SES o la interfaz de SMTP de Amazon SES, tal y como se describe a continuación.

HTTPSSi se utiliza la API de Amazon SES (ya sea directamente o a través de un SDK de AWS), todas lascomunicaciones se cifran mediante TLS a través del punto de enlace HTTPS de Amazon SES. El punto deenlace HTTPS de Amazon SES admite TLS 1.2, TLS 1.1 y TLS 1.0.

Interfaz de SMTPSi obtiene acceso a Amazon SES a través de la interfaz de SMTP, deberá cifrar la conexión medianteTransport Layer Security (TLS). Tenga en cuenta que TLS se denomina en ocasiones con el nombre de suprotocolo predecesor, capa de conexión segura (SSL).

Amazon SES admite dos mecanismos para establecer la conexión cifrada por TLS: STARTTLS y TLSWrapper.

• STARTTLS: STARTTLS es un medio de actualizar una conexión sin cifrar a una conexión cifrada.Existen versiones de STARTTLS para diversos protocolos; la versión de SMTP se define en RFC 3207.Para las conexiones STARTTLS, Amazon SES admite TLS 1.2, TLS 1.1, TLS 1.0 y SSLv2Hello.

• TLS Wrapper: TLS Wrapper (también conocido como SMTPS o protocolo Handshake) es un mediode iniciar una conexión cifrada sin establecer primero una conexión sin cifrar. Con TLS Wrapper, elpunto de enlace de SMTP de Amazon SES no realiza la negociación de TLS: es responsabilidad delcliente conectarse al punto de enlace mediante TLS y seguir utilizando TLS para toda la conversación.TLS Wrapper es un protocolo más antiguo, pero muchos clientes siguen siendo compatibles. Para lasconexiones TLS Wrapper, Amazon SES admite TLS 1.2, TLS 1.1 y TLS 1.0.

Para obtener información sobre cómo conectarse a la interfaz de SMTP de Amazon SES utilizando estosmétodos, consulte Conexión al punto de enlace de SMTP de Amazon SES (p. 80).

De Amazon SES al receptorDe forma predeterminada, Amazon SES envía mensajes a través de una conexión protegida con TLS. Estemétodo, denominado TLS oportunista, significa que cuando Amazon SES establece una conexión SMTP

176

https://en.wikipedia.org/wiki/EICAR_test_file

https://en.wikipedia.org/wiki/EICAR_test_file


Amazon Simple Email Service Developer GuideDe Amazon SES al receptor

con un servidor de correo electrónico receptor, Amazon SES actualiza la conexión mediante el protocoloSTARTTLS si el servidor de correo electrónico receptor admite TLS. Si el servidor receptor no anunciaSTARTTLS o si la negociación de TLS produce un error, la conexión continúa en texto sin formato. Paralas conexiones TLS oportunista, Amazon SES admite TLS 1.2, TLS 1.1 y TLS 1.0.

Amazon SES admite TLS oportunista en todas las regiones de AWS. No es necesario realizar ningunaacción para habilitarlo.

177

Amazon Simple Email Service Developer GuideConceptos de recepción de correo electrónico

Recepción de correo electrónico conAmazon SES

Amazon Simple Email Service (Amazon SES) es un servidor de correo electrónico que puede enviar yrecibir correo electrónico en su nombre. Cuando se utiliza Amazon SES para recibir su correo electrónicoAmazon SES gestiona las operaciones subyacentes de recepción de correo, tales como:

• comunicarse con otros servidores de correo electrónico• escanear en busca de spam y virus• rechazar correo electrónico de fuentes que no sean de confianza• aceptar correo de destinatarios en su dominio

Cuando recibe correo electrónico, Amazon SES lo procesa según las instrucciones que proporcione. Porejemplo, Amazon SES puede entregar correo entrante a un bucket de Amazon S3, publicarlo en un temade Amazon SNS o enviarlo a Amazon WorkMail. También puede crear reglas que bloquean o permiten deforma explícita todos los mensajes de intervalos específicos de direcciones IP o que envíe mensajes derebotes automáticamente cuando los mensajes se envían a direcciones de correo electrónico específicas.

Las siguientes secciones contienen la información que tiene que entender, configurar y utilizar AmazonSES para recibir su correo.

• Conceptos de recepción de correo electrónico (p. 178)• Introducción a la recepción de correo electrónico (p. 180)• Configuración de la recepción de correo electrónico (p. 186)• Administración de recepción de correo electrónico (p. 206)

Conceptos de recepción de correo electrónico deAmazon SES

Al utilizar Amazon SES como receptor de correo electrónico, debe comunicar al servicio qué es lo quedebe hacer con su correo electrónico. El método principal, que ofrece un control detallado sobre el correoelectrónico, consiste en especificar las medidas que se tomarán en función del destinatario. El otro métodoconsiste en bloquear o permitir el correo electrónico en función de la dirección IP de origen. En este temase describen ambos métodos.

Control basado en destinatariosLa forma principal de controlar su correo entrante consiste en especificar cómo se gestiona el correoen función de su destinatario. Por ejemplo, si es propietario de example.com, puede especificar que elcorreo para [email protected] debe presentar rebotes y todo el resto de correo para example.com y sussubdominios deben entregarse. La lista de destinatarios que proporcione se denomina la condición.

Puede configurar reglas de recepción para especificar cómo gestionar el correo cuando se satisfaceuna condición. Una regla de recepción consiste en una condición y una lista ordenada de acciones. Siun destinatario del correo electrónico entrante coincide con el destinatario especificado en la condición,Amazon SES ejecuta las acciones especificadas en la regla. Están disponibles las siguientes acciones:

• Acción de S3: entrega el correo a un bucket de Amazon S3 y, opcionalmente, se lo notifica a través deAmazon SNS.

178

Amazon Simple Email Service Developer GuideControl basado en dirección IP

• Acción de SNS: publica el correo en un tema de Amazon SNS.

Note

La acción de SNS incluye una copia completa del contenido de correo electrónico en lasnotificaciones de Amazon SNS. Las demás notificaciones de Amazon SNS mencionadas aquísimplemente le notifican la entrega de correo electrónico; contienen información sobre el correoelectrónico, no el propio contenido del correo electrónico.

• Acción lambda: llama al código a través de una función de Lambda y, opcionalmente, se lo notifica através de Amazon SNS.

• Acción de rebote: rechaza el correo electrónico devolviendo una respuesta de rebote al remitente y,opcionalmente, se lo notifica a través de Amazon SNS.

• Acción Stop: termina la evaluación del conjunto de reglas de recepción y, opcionalmente, se lo notifica através de Amazon SNS.

• Acción Añadir encabezado: añade un encabezado al correo electrónico recibido. Normalmente, utiliceesta acción solo en combinación con otras acciones.

• Acción WorkMail: gestiona el correo con Amazon WorkMail. Normalmente no utilizará esta accióndirectamente porque Amazon WorkMail se encarga de la configuración.

Las reglas de recepción se agrupan conjuntamente en conjuntos de reglas de recepción. Puede definirvarios conjuntos de reglas de recepción en su cuenta de AWS, pero solo se activa uno de ellos a la vez.La figura siguiente muestra cómo las reglas de recepción, conjuntos de reglas de recepción y acciones eserelacionan entre sí.

Control basado en dirección IPPuede controlar su flujo de correo en un nivel más amplio mediante la configuración de filtros dedirecciones IP. Los filtros de direcciones IP son opcionales y le permiten especificar si desea aceptaro rechazar correo procedente de una dirección IP o de un intervalo de direcciones IP. Sus filtros dedirección IP pueden incluir listas de bloqueo (direcciones IP desde las que desea bloquear correo entrante)y listas permitidas (direcciones IP desde la que desea aceptar correo electrónico siempre). Los filtrosde direcciones IP son útiles para bloquear spam. Amazon SES mantiene su propia lista de bloqueo dedirecciones IP conocidas por enviar spam, pero puede optar por recibir correo de dichas direcciones IPañadiéndolas a su lista de direcciones permitidas.

Note

Si desea permitir correo procedente de una dirección IP de Amazon EC2, debe añadirla a su listade direcciones permitidas. Todos el correo electrónico procedente de Amazon EC2 se bloquea deforma predeterminada.

179

Amazon Simple Email Service Developer GuideProceso de recepción de correos electrónicos

Proceso de recepción de correos electrónicosCuando Amazon SES recibe un correo electrónico para su dominio, se producen los eventos siguientes:

1. Amazon SES primero examina la dirección IP del remitente. Amazon SES permite que el correoelectrónico supere esta fase a menos que:• La dirección IP se encuentre en la lista de bloqueo.• La dirección IP se encuentra en la lista de bloqueo de Amazon SES y no está en su lista de

direcciones permitidas.2. Amazon SES examina su conjunto de sus reglas de recepción activas para determinar si alguna de

sus reglas de recepción contiene una condición que coincida con alguno de los destinatarios del correoelectrónico entrante.

3. Si no se detectan coincidencias Amazon SES rechaza el correo. De lo contrario, Amazon SES lo acepta.4. Si Amazon SES acepta el correo, evalúa su conjunto de reglas de recepción activas. Todas las reglas

de recepción que coincidan con al menos una de las condiciones del destinatario se aplican en el ordenen el que están definidas, a menos que una acción o una regla de recepción termine explícitamente laevaluación del conjunto de reglas de destinatario.

Ahora que ya dispone de información general del proceso, puede empezar accediendo a Configuración dela recepción de correo electrónico (p. 186).

Introducción a la recepción de correo electrónicocon Amazon SES

En este tutorial, creará una cuenta de AWS, registrará un dominio utilizando Amazon Route 53 yconfigurará Amazon Simple Email Service para enviar todo el correo electrónico enviado a su dominio a unbucket de Amazon Simple Storage Service.

Temas• Paso 1: Antes de comenzar (p. 180)• Paso 2: comprobación de su dominio (p. 181)• Paso 3: configurar una regla de recepción (p. 182)• Paso 4: enviar un correo electrónico de prueba (p. 184)• Paso 5: ver el correo electrónico recibido (p. 185)• Paso 6: Eliminación (p. 185)

Paso 1: Antes de comenzarAntes de empezar este tutorial, inscríbase para obtener una cuenta de AWS (si no dispone de ella aún) yutilice Amazon Route 53 para registrar el dominio en el que desea recibir correo electrónico.

InscripciónSi ya tiene una cuenta de AWS, puede omitir esta sección.

Para crear una cuenta de AWS

1. Vaya a https://console.aws.amazon.com/ses/ y, a continuación, elija Get Started with Amazon SES(Introducción a Amazon SES).

180

https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/Welcome.html


Amazon Simple Email Service Developer GuidePaso 2: comprobación de su dominio

2. En la página Create an AWS Account (Crear una cuenta de AWS), rellene los campos obligatorios ysiga las instrucciones en pantalla para crear una cuenta nueva.

Registrar un dominio utilizando Route 53En este tutorial se supone que está utilizando un dominio que ha registrado utilizando Route 53. Tambiénpuede utilizar un dominio que ha registrado utilizando otro servicio, pero los procedimientos paracomprobar su dominio diferirán de los que se muestran en este tutorial. Para obtener más informaciónacerca de cómo utilizar Route 53 para registrar un dominio, consulte Register a New Domain en la Guíapara desarrolladores de Amazon Route 53.

También puede transferir un dominio existente a Route 53. Para obtener más información acerca de latransferencia de dominios a Route 53, consulte Transferencia del registro de un dominio a Route 53 en laGuía para desarrolladores de Amazon Route 53.

Paso siguiente: Paso 2: comprobación de su dominio (p. 181)

Paso 2: comprobación de su dominioAntes de poder configurar Amazon SES para recibir correo electrónico para su dominio, debe demostrarque el dominio le pertenece. Puede verificar cualquier dominio de su propiedad, pero es más sencilloverificar dominios que haya registrado mediante Route 53.

Para verificar un dominio con Amazon SES

1. Abra la consola de Amazon SES en https://console.aws.amazon.com/ses/.Note

Para completar el procedimiento de esta sección, inicie sesión en la consola deadministración de AWS con la misma cuenta de AWS que utilizó al registrar el dominio conRoute 53.

2. En el panel de navegación, en Identity Management, elija Domains.3. Elija Verify a New Domain.4. En el cuadro de diálogo Verify a New Domain (Verificar un nuevo dominio), para Domain (Dominio),

escriba el nombre del dominio que registró utilizando Route 53 y, a continuación, elija Verify ThisDomain (Verificar este dominio).

5. En el cuadro de diálogo Verify a New Domain (Verificar un nuevo dominio), elija Use Route 53 (UtilizarRoute 53).

Note

Si no ve el botón Use Route 53 (Utilizar Route 53), es posible que su dominio no se hayaregistrado con Route 53. Si utilizó otro servicio para registrar su dominio, puede verificar eldominio completando los procedimientos que se describen en Verificación de un dominio conAmazon SES (p. 60).

6. En el cuadro de diálogo Use Route 53 (Utilizar Route 53), seleccione Domain Verification Record(Registro de verificación de dominio) y Email Receiving Record (Registro de recepción de correoelectrónico). A continuación, en Hosted Zones (Zonas hospedadas), seleccione el nombre de lazona hospedada que desea utilizar. Si no ha efectuado cambios en los dominios que ha registradoutilizando Route 53, sólo debe haber una opción disponible en la sección Hosted Zones (Zonashospedadas).

Important

Si ya ha configurado registros de intercambio de correo (MX) para su dominio, el siguienteplazo reemplazará dichos registros por los nuevos.

181

https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-register.html

https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-transfer-to-route-53.html


Amazon Simple Email Service Developer GuidePaso 3: configurar una regla de recepción

7. Elija Create Record Sets. Volverá a la lista de dominios.8. Espere cinco minutos y, a continuación, elija el botón refresh (actualizar) ( ). Confirme que el valor

de la columna Status (Estado) sea verified (verificado). Si el estado es pending verification (verificaciónpendiente), espere unos minutos más y, a continuación, vuelva a actualizar la lista. Repita esteproceso hasta que el estado del dominio sea verified (verificado).

Paso siguiente: Paso 3: configurar una regla de recepción (p. 182)

Paso 3: configurar una regla de recepciónPara utilizar Amazon SES como receptor de correo electrónico, debe tener un conjunto de reglas derecepción activo. Un conjunto de reglas de recepción es una colección de reglas de recepción queespecifican cómo debe proceder Amazon SES en relación con un correo electrónico que recibe para susdominios verificados. Dado que está configurando la recepción de correo electrónico con Amazon SES porprimera vez, Amazon SES crea automáticamente un conjunto de reglas de recepción predeterminado. Laregla de recepción que cree en esta sección pertenece al conjunto de reglas de recepción predeterminado.

Note

Los procedimientos de esta sección suponen que nunca ha creado un conjunto de reglas derecepción. Si su cuenta ya contiene un conjunto de reglas de recepción, tendrá que activar laregla de recepción que cree en esta sección antes de que Amazon SES la aplique al correoelectrónico entrante para su dominio. Para obtener más información acerca de cómo habilitar ydeshabilitar conjuntos de reglas de recepción, consulte Activar y deshabilitar un conjunto de reglasde recepción (p. 207).

Para crear una regla de recepción

1. En el panel de navegación, en Email Receiving (Recepción de correo electrónico), elija Rule Sets(Conjuntos de reglas).

2. Elija Create a Receipt Rule.3. En la página Recipients, elija Next Step.

Note

Habida cuenta de que no está añadiendo destinatarios, Amazon SES aplica esta regla atodos los destinatarios en todos los dominios verificados.

4. Para Add action (Añadir acción), elija S3 (S3).

182

Amazon Simple Email Service Developer GuidePaso 3: configurar una regla de recepción

5. Para S3 bucket, elija Create S3 bucket.

6. En Bucket Name, escriba un nombre para el bucket de Amazon S3. El nombre del bucket queintroduzca debe cumplir los siguientes requisitos:

• Puede contener solo letras en minúsculas, números, puntos (.) y guiones (-).• Debe ser único en todo AWS.• Debe comenzar y terminar con una letra minúscula o un número.• Debe contener un mínimo de 3 y un máximo de 63 caracteres.• No puede tener el formato de una dirección IP (por ejemplo, 192.168.5.4).• No puede contener dos puntos consecutivos (..) o un guion junto a un punto (-. o bien .-).

Cuando haya terminado, elija Create Bucket (Crear bucket).

183

Amazon Simple Email Service Developer GuidePaso 4: enviar un correo electrónico

Note

Dado que está utilizando la consola de Amazon SES para crear un bucket de Amazon S3,Amazon SES crea y aplica automáticamente una política que le da permiso para escribir enel bucket. Sin embargo, si elige un bucket de Amazon S3 existente, debe conceder permiso aAmazon SES para escribir en el bucket adjuntando una política al bucket (p. 189) mediantela consola de Amazon S3 o el API.

7. Seleccione Next Step.8. En la página Rule Details (Detalles de regla), para Rule name (Nombre de regla), escriba my-rule.

Seleccione la casilla de verificación junto a Enabled (Habilitado) y, a continuación, elija Next Step(Paso siguiente).

9. En la página Review, elija Create Rule.

Paso siguiente: Paso 4: enviar un correo electrónico de prueba (p. 184)

Paso 4: enviar un correo electrónico de pruebaAhora que ha verificado y configurado su dominio, puede enviar un correo electrónico para probar lacapacidad de su dominio para recibir correo electrónico.

Para enviar un correo electrónico de prueba, utilice una cuenta de correo electrónico que sabe que escapaz de enviar correo electrónico, como, por ejemplo, su dirección de correo electrónico personal.Envíe un mensaje de prueba a cualquier dirección de correo electrónico en su dominio verificado. Porejemplo, si su dominio es example.com, puede enviar un correo electrónico a [email protected] [email protected] (o a cualquier otra dirección del dominio example.com).

Note

No es necesario completar ningún paso adicional para crear direcciones de correo electrónicoindividuales en su dominio, Amazon SES recibe cada correo electrónico que se envía a cualquierdirección en el dominio verificado y aplica la regla de recepción que creó en Paso 3: configuraruna regla de recepción (p. 182).

Paso siguiente: Paso 5: ver el correo electrónico recibido (p. 185)

184

Amazon Simple Email Service Developer GuidePaso 5: ver el correo electrónico

Paso 5: ver el correo electrónico recibidoDespués de enviar un mensaje de prueba a una dirección en su dominio, puede recuperarla desde subucket de Amazon S3 y ver su contenido.

Para ver un mensaje que recibió a través de Amazon SES

1. Abra la consola de Amazon S3 en https://console.aws.amazon.com/s3/.2. En la consola de Amazon S3, elija el bucket que ha creado en el Paso 3: configurar una regla de

recepción (p. 182).3. En el bucket de Amazon S3, busque el correo electrónico que ha recibido. El nombre del correo

electrónico es una cadena única de letras y números.

Note

El bucket también podría contener un archivo denominadoAMAZON_SES_SETUP_NOTIFICATION. Puede omitir o eliminar este archivo.

4. Seleccione la casilla de verificación que hay junto al nombre del archivo. En el menú Actions, elijaDownload.

5. Abra en su equipo la carpeta que contiene el archivo que ha descargado en el paso anterior. Hayvarias formas de ver el mensaje descargado, entre las que se incluyen las siguientes:

• Abra el archivo en un editor de texto y lea su contenido directamente. En función del métodoutilizado para enviar el correo electrónico, es posible que parte del mensaje esté codificado. Si partedel mensaje está codificado, tendrá que descodificarlos manualmente (por ejemplo, mediante lautilización de un descodificador base64).

• Añada la extensión .eml al final del nombre del archivo y, a continuación, abra el archivo con uncliente de correo electrónico como Microsoft Outlook o Mozilla Thunderbird. La mayoría de losclientes de correo electrónico descodificarán automáticamente las partes codificadas de un mensajey mostrarán elementos como el formato HTML y los archivos adjuntos.

Paso siguiente: Paso 6: Eliminación (p. 185)

Paso 6: EliminaciónUna vez completado este tutorial, puede limpiar los recursos que ha creado para evitar incurrir en cargosadicionales.

Conjunto de reglas de recepción de Amazon SESSi ya no desea que Amazon SES reciba correo para su dominio, puede deshabilitar el conjunto de reglasde recepción activas (p. 207).

Bucket de Amazon S3Si ya no desea el bucket de Amazon S3 que ha creado, puede eliminarlo. Para eliminar un bucket, primerodebe eliminar su contenido. Para obtener más información acerca de la eliminación de carpetas y buckets,consulte Eliminación de un objeto y un bucket en la Guía de introducción a Amazon Simple StorageService.

Dominio de Route 53Si ya no desea utilizar Route 53 para registrar su dominio, puede eliminar el registro o transferir el dominioa otro registrador.

185

https://console.aws.amazon.com/s3/

https://docs.aws.amazon.com/AmazonS3/latest/gsg/DeletingAnObjectandBucket.html

https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-delete.html

https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-transfer-from-route-53.html

https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-transfer-from-route-53.html

Amazon Simple Email Service Developer GuideConfiguración de la recepción de correo electrónico

Configuración de la recepción de correo electrónicode Amazon SES

Esta sección describe lo que tiene que hacer para configurar Amazon SES para recibir correo electrónico.Por ejemplo, en primer lugar debe plantearse la forma en que desea recibir, filtrar y procesar su correo,ya que estas decisiones afectarán al modo de configurar Amazon SES. También tendrá que verificar sudominio con Amazon SES para demostrar que es de su propiedad y apuntar su dominio a Amazon SESpara correo entrante. Otro paso consiste en ofrecer a Amazon SES permiso para acceder a los recursos deAWS requeridos. A continuación, configure la recepción de correo electrónico mediante la creación de unconjunto de reglas de destinatario, reglas de recepción y, de forma opcional, filtros de direcciones IP.

Estos pasos se explican en los temas siguientes:• Consideración de su caso de uso para recepción de correo electrónico de Amazon SES (p. 186)• Verificación de su dominio para recepción de correo electrónico de Amazon SES (p. 188)• Publicación de un registro MX para recepción de correo electrónico de Amazon SES (p. 188)• Otorgar permisos a Amazon SES para recepción de correo electrónico (p. 189)• Creación de filtros de dirección IP para recepción de correo electrónico de Amazon SES (p. 191)• Creación de un conjunto de reglas de recepción para recepción de correo electrónico de Amazon

SES (p. 192)• Creación de reglas de recepción para recepción de correo electrónico de Amazon SES (p. 192)

Para ver dónde encajan estas tareas en el proceso global de recepción de correo electrónico, consulteConceptos de recepción de correo electrónico (p. 178).

Consideración de su caso de uso para recepción decorreo electrónico de Amazon SESAntes de configurar Amazon SES para recibir su correo electrónico, podría resultarle útil plantearse lassiguientes preguntas.

Contenido de correo electrónico• ¿Cómo desea que Amazon SES le transfiera el contenido de correo electrónico?

Amazon SES puede proporcionarle el contenido del correo electrónico de dos formas: puede almacenarlos correos electrónicos en un bucket de Amazon S3 que especifique o puede enviarle una notificaciónde Amazon SNS que contiene una copia del correo electrónico. Amazon SES le entrega el correoelectrónico sin procesar y sin modificar que normalmente está en formato Multipurpose Internet MailExtensions (MIME). Para obtener más información acerca del formato MIME, consulte RFC 2045.

• ¿De qué tamaño es el límite de tamaño de correo electrónico que necesita?

Si elige almacenar correos electrónicos en un bucket de Amazon S3, el tamaño de correo electrónicomáximo (incluidos los encabezados) es de 30 MB. Si decide recibir los correos electrónicos mediantenotificaciones de Amazon SNS, el tamaño máximo de correo electrónico (incluidos los encabezados) es150 KB.

• ¿Cómo desea activar el procesamiento de su correo electrónico?

Una vez que se entregue su correo electrónico, podrá desear procesarlo con su propio código. Porejemplo, su aplicación puede convertir el correo electrónico cifrado en base 64 en un formato que se

186


Amazon Simple Email Service Developer GuideConsideración de su caso de uso

pueda mostrar y, a continuación, hacer que esté disponible para un usuario final a través de un clientede correo electrónico. Hay una serie de formas en las que puede empezar el proceso:• Si sus correos electrónicos se entregan a Amazon S3, su aplicación puede escuchar las notificaciones

de Amazon SNS generadas por las acciones de S3, extraer el ID de mensaje del correo electrónicodesde las notificaciones y, a continuación, utilizar el ID de mensaje para recuperar el correoelectrónico desde Amazon S3.

De forma alternativa, puede incorporar procesamiento de correo electrónico en sus reglas derecepción escribiendo una función de Lambda. En este caso, la regla de recepción debe escribirprimero el correo electrónico en Amazon S3 y, a continuación, activar la función de Lambda. Lasacciones de Lambda se pueden ejecutar de forma sincrónica o asincrónica desde dentro de sus reglasde recepción, en función de si la función de Lambda necesita devolver un resultado que influya encómo se ejecutan otras acciones. Le recomendamos que use la ejecución asincrónica, a menos que lasincrónica sea absolutamente necesaria en su caso de uso. Para obtener más información sobre AWSLambda, consulte la AWS Lambda Developer Guide.

• Si los correos electrónicos se entregan a través de una notificación de Amazon SNS utilizando laacción de SNS, la aplicación puede escuchar las notificaciones de Amazon SNS y, a continuación,extraer los mensajes de correo electrónico de las notificaciones.

• ¿Desea que se cifren los correos electrónicos?

Amazon SES se integra con AWS Key Management Service (AWS KMS) para cifrar opcionalmente elcorreo que escribe en su bucket de Amazon S3. Amazon SES utiliza el cifrado del lado del cliente paracifrar su correo antes de escribirlo a Amazon S3. Esto significa que deberá descifrar el contenido en sulado después de recuperar el correo desde Amazon S3. El AWS SDK for Java y AWS SDK parar Rubyproporcionan un cliente que puede encargarse de gestionar el descifrado. Amazon SES puede cifrar loscorreos electrónicos solo si elige que sus correos electrónicos se entreguen en un bucket de AmazonS3.

Correo no deseado• ¿En qué punto del proceso de recepción de correo electrónico desea rechazar el correo no deseado?

Puede rechazar correos electrónicos en dos puntos del proceso de recepción de correo electrónico:durante la conversación de SMTP con el servidor de correo del remitente y después de la entregacuando pueda examinar las propiedades del correo electrónico. No se le cobra por ningún correoelectrónico rechazado durante la conversación SMTP, con lo cual, le conviene rechazar todo correoelectrónico no deseado que le sea posible en esta fase. Puede rechazar correos electrónicos durante laconversación de SMTP con los filtros de direcciones IP y las reglas de recepción, que se describen enConceptos de recepción de correo electrónico (p. 178).

Después de la conversación de SMTP, Amazon SES realiza una exploración de virus, exploración despam, así como las comprobaciones de autenticación para correo identificado con claves de dominio(DKIM), marco de directivas de remitente (SPF) y Domain-based Message Authentication, Reportingand Conformance (DMARC). Amazon SES pone a su disposición los veredictos de todas estas pruebaspara que pueda decidir si confía en el correo electrónico. Si no confía en el correo electrónico, puedeeliminarlo o enviar una respuesta de rebote al remitente. Se le facturará el correo electrónico, ya queesta decisión se produce después de que Amazon SES le envíe el correo electrónico. Si utiliza Lambdapara enviar una respuesta de rebote, es posible que también se facture su uso de Lambda.

• ¿Desea filtrar sus mensajes de correo electrónico en función de laguna propiedad que no sea eldestinatario o la dirección IP?

Puede escribir condiciones de coincidencia de mensajes complejas utilizando funciones de Lambda(invocadas como "RequestResponse") y, a continuación, incorporar dichas funciones en sus reglasde recepción. El valor de retorno de la función de Lambda determina si la evaluación de la regla derecepción y el conjunto de reglas de recepción debería continuar o detenerse. Por ejemplo, puede teneruna regla de recepción que elimine el correo que Amazon SES marca como spam. También puede

187

https://docs.aws.amazon.com/lambda/latest/dg/welcome.html

https://aws.amazon.com/sdk-for-java/


Amazon Simple Email Service Developer GuideVerificación de su dominio

rebotar mensajes que no superen determinadas pruebas de autenticación, como DKIM o DMARC. Losejemplos de código de estas situaciones están disponibles en Ejemplos de funciones Lambda (p. 200).

Uso de otros servicios de AWS• ¿Ha configurado los permisos adecuados?

Si desea que sus correo se entreguen en un bucket de Amazon S3, se publique en un tema de AmazonSNS que no sea de su propiedad, active una función de Lambda o utilice una clave de AWS KMSmaestra personalizada, tiene que darle permiso a Amazon SES para acceder a dichos recursos. Paradar acceso a Amazon SES, debe crear políticas de recursos desde las consolas o API para dichosservicios de AWS. Para obtener más información, consulte Otorgar permisos (p. 189).

Flujos de correo• ¿Cómo desea separar su flujo de correo electrónico?

Su dominio es probable que reciba distintas clases de correo electrónico. Por ejemplo, parte delcorreo de su dominio como, por ejemplo, un correo electrónico a [email protected], podríaestar destinado a una bandeja de correo personal. Otros mensajes, como un correo electrónico [email protected], podrían ir dirigidos a sistemas automáticos. Puede utilizar reglas derecepción para separar el correo entrante a fin de que se pueda procesar de forma distinta. Paraobtener información acerca de cómo configurar las reglas de recepción, consulte Creación de reglas derecepción (p. 192).

Verificación de su dominio para recepción de correoelectrónico de Amazon SESAl igual que con cualquier dominio que desee utilizar para enviar o recibir correo electrónico con AmazonSES, primero debe demostrar que es de su propiedad. El procedimiento de verificación, que incluye llevara cabo una verificación de dominio con Amazon SES y, a continuación, publicar un registro TXT en suservidor de DNS, se describe en Verificación de dominios en Amazon SES (p. 59).

Note

Aunque Amazon SES le permite verificar direcciones de correo electrónico individuales, debeverificar un dominio si desea utilizar Amazon SES para recepción de correo electrónico.

También puede iniciar el proceso de verificación de dominio al configurar las reglas de recepción enCreación de reglas de recepción (p. 192). La lista de destinatarios indicará qué destinatarios no estánverificados y le permite iniciar la verificación. En cualquier caso, debe completar la verificación del dominiomediante la publicación de un registro TXT para su servidor de DNS, tal y como se describe en RegistrosTXT de verificación de dominio de Amazon SES (p. 62).

Puede confirmar que su dirección de correo electrónico o dominio se verifique comprobando su estadoen la lista Email Address Identities o Domain Identities en la consola de Amazon SES o usando el APIGetIdentityVerificationAttributes de Amazon SES.

Publicación de un registro MX para recepción decorreo electrónico de Amazon SESUn registro de intercambio de correo (registro MX#) es una configuración que especifica los servidores decorreo que pueden aceptar correo electrónico enviado a su dominio.

188

Amazon Simple Email Service Developer GuideOtorgar permisos

Para que Amazon SES administre su correo electrónico entrante, añada un registro MX a la configuraciónDNS de su dominio. El registro MX hace referencia al punto de enlace de recepción del correo electrónicocorrespondiente a la región de AWS en la que usa Amazon SES. Por ejemplo, el punto de enlace de laregión EE.UU. Oeste (Oregón) es inbound-smtp.us-west-2.amazonaws.com. Consulte Puntos de enlace derecepción de correo electrónico (p. 440) para obtener una lista completa de puntos de enlace.

Los procedimientos para publicar un registro MX dependen del proveedor de DNS o de alojamiento.Consulte la documentación del proveedor para obtener más información sobre cómo añadir un registro MXa la configuración DNS de su dominio.

Otorgar permisos a Amazon SES para recepción decorreo electrónicoPara habilitar Amazon SES a fin de escribir correos electrónicos en su bucket de Amazon S3, utilice unaclave de AWS KMS para cifrar sus correos electrónicos, llame a su función de Lambda o publique en untema de Amazon SNS de otra cuenta, Amazon SES debe tener permiso para acceder a esos recursos. Elpermiso se concede adjuntando una política al recurso. Este tema ofrece ejemplos de políticas.

Otorgue permiso a Amazon SES para escribir en su bucket deAmazon S3Cuando se aplica a un bucket de Amazon S3, la siguiente política otorga a Amazon SES permisos paraescribir en dicho bucket. Para obtener más información sobre la creación de reglas de recepción quetransfieren el correo electrónico entrante a Amazon S3, consulte Acción S3 (p. 203). Para obtener másinformación sobre cómo adjuntar políticas a buckets de Amazon S3, consulte la Guía para desarrolladoresde Amazon Simple Storage Service.

{ "Version": "2012-10-17", "Statement": [ { "Sid": "AllowSESPuts", "Effect": "Allow", "Principal": { "Service": "ses.amazonaws.com" }, "Action": "s3:PutObject", "Resource": "arn:aws:s3:::BUCKET-NAME/*", "Condition": { "StringEquals": { "aws:Referer": "AWSACCOUNTID" } } } ]}

Conceder permisos a Amazon SES para utilizar su clave maestrade AWS KMSPara que Amazon SES cifre sus correos electrónicos, debe tener permiso para utilizar la clave de AWSKMS especificada al configurar la regla de recepción. Puede utilizar la clave maestra predeterminada(aws/ses) de su cuenta o bien una clave maestra personalizada que cree. Si usa la clave maestrapredeterminada, no tiene que realizar ningún paso para conceder permiso a Amazon SES para que la use.Si utiliza una clave maestra personalizada, debe dar permiso a Amazon SES para utilizarla añadiendouna instrucción a la política de la clave. La instrucción de la política incluye las condiciones que se han

189

https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html.html

https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html.html

Amazon Simple Email Service Developer GuideOtorgar permisos

diseñado para garantizar que Amazon SES solo pueda utilizar su clave maestra personalizada cuando haydeterminados valores en la solicitud para AWS KMS; específicamente:

• aws:ses:source-account—El ID de cuenta de AWS en nombre del cual Amazon SES recibió elcorreo electrónico.

• aws:ses:message-id—El ID de mensaje de Amazon SES del correo electrónico recibido.• aws:ses:rule-name—El nombre de la regla de recepción que se utilizó para cifrar el correo

electrónico.

Pegue la siguiente instrucción de política en la política clave para permitir que Amazon SES utilice su claveprincipal personalizada cuando Amazon SES recibe correo electrónico en nombre de su cuenta de AWS.Reemplace AWSACCOUNTID por su ID de cuenta de AWS de 12 dígitos.

{ "Sid": "AllowSESToEncryptMessagesBelongingToThisAccount", "Effect": "Allow", "Principal": {"Service":"ses.amazonaws.com"}, "Action": ["kms:Encrypt", "kms:GenerateDataKey*"], "Resource": "*", "Condition": { "Null": { "kms:EncryptionContext:aws:ses:rule-name": "false", "kms:EncryptionContext:aws:ses:message-id": "false" }, "StringEquals": { "kms:EncryptionContext:aws:ses:source-account": "AWSACCOUNTID" } }}

Para obtener más información sobre cómo adjuntar políticas a claves de AWS KMS, consulte la AWS KeyManagement Service Developer Guide.

Dar permiso a Amazon SES para invocar su función de LambdaPara habilitar Amazon SES para llamar a su función de Lambda, configure la función de Lambda utilizandola consola de Amazon SES durante la configuración de regla de recepción (en cuyo caso Amazon SESañade automáticamente los permisos necesarios a la función) o puede utilizar el API AddPermissionde AWS Lambda para adjuntar una política a la función. El siguiente API AddPermission da permiso aAmazon SES para invocar a su función de Lambda. Reemplace AWSACCOUNTID por su ID de cuenta deAWS de 12 dígitos. Para obtener más información sobre cómo adjuntar políticas a funciones de Lambda,consulte la AWS Lambda Developer Guide.

{ "Action": "lambda:InvokeFunction", "Principal": "ses.amazonaws.com", "SourceAccount": "AWSACCOUNTID", "StatementId": "GiveSESPermissionToInvokeFunction"}

Otorgar permiso a Amazon SES para publicar un tema deAmazon SNS de otra cuentaSi el tema de Amazon SNS que desea utilizar es propiedad de la misma cuenta de AWS que utiliza paraAmazon SES, no es necesaria ninguna configuración para permitir a Amazon SES para publicar en eltema. Sin embargo, si desea publicar notificaciones en un tema que no sea de su propiedad, utilice la

190

https://docs.aws.amazon.com/kms/latest/developerguide/key-policies.html

https://docs.aws.amazon.com/kms/latest/developerguide/key-policies.html

https://docs.aws.amazon.com/lambda/latest/dg/intro-permission-model.html

Amazon Simple Email Service Developer GuideCreación de filtros de dirección IP

consola o el API de Amazon SNS para adjuntar una política al tema de Amazon SNS. La siguiente políticaconcede permiso a Amazon SES para publicar en un tema de Amazon SNS. Reemplace AWSACCOUNTIDpor su ID de cuenta de AWS de 12 dígitos y TOPIC-NAME por el nombre del tema de Amazon SNS. Paraobtener más información sobre escribir políticas para temas de Amazon SNS, consulte la Guía paradesarrolladores de Amazon Simple Notification Service.

{ "Version": "2008-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "ses.amazonaws.com" }, "Action": "SNS:Publish", "Resource": "arn:aws:sns:us-east-1:AWSACCOUNTID:TOPIC-NAME" } ]}

Creación de filtros de dirección IP para recepción decorreo electrónico de Amazon SESUn filtro de dirección IP le permite especificar opcionalmente si desea aceptar o rechazar correoprocedente de una dirección IP o de un intervalo de direcciones IP.

Puede utilizar la consola de Amazon SES o el API CreateReceiptFilter para crear un filtro dedirección IP.

Note

Si solo desea recibir correo electrónico de una lista finita de direcciones IP conocidas, entoncesconfigure una lista de bloques que contenga 0.0.0.0/0 y configure una lista permitida quecontiene las direcciones IP de confianza. Esta configuración bloquea todas las direcciones IPde forma predeterminada y solo permite correo de las direcciones IP que especifique de formaexplícita.

Para crear un filtro de dirección IP (consola)


2. En el panel de navegación izquierdo, en Email Receiving, elija IP Address Filters.3. En el panel de contenido, elija Create Filter.4. Para Filter Name, escriba un nombre para el filtro de dirección IP. El nombre debe contener menos de

64 caracteres alfanuméricos, guion (-), guion bajo (_) y punto (.) caracteres. El nombre debe comenzary terminar por una letra o un número.

5. Para IP Address Range, introduzca una única dirección IP o un intervalo de direcciones IP que deseebloquear o permitir, especificado en notación de enrutamiento entre dominios sin clases (CIDR).Un ejemplo de una única dirección IP es 10.0.0.1. Un ejemplo de un intervalo de direcciones IP es10.0.0.1/24. Para obtener más información acerca de la notación CIDR, consulte RFC 2317.

6. Para Policy Type, elija Allow o Block.7. Elija Create Filter.

Para obtener información sobre cómo utilizar el CreateReceiptFilter API para crear un filtro dedirección IP, consulte la Amazon Simple Email Service API Reference.

191






https://docs.aws.amazon.com/ses/latest/APIReference/API_CreateReceiptFilter.html

Amazon Simple Email Service Developer GuideCreación de un conjunto de reglas de recepción

Creación de un conjunto de reglas de recepción pararecepción de correo electrónico de Amazon SESUn conjunto de reglas de recepción es una colección de reglas de recepción que especifican cómodebe proceder Amazon SES en relación con un correo electrónico que recibe para un dominio suyo.Para utilizar Amazon SES como receptor de correo electrónico, debe crear un conjunto de reglas derecepción para su cuenta. Para obtener más información sobre la función de los conjuntos de reglas derecepción en el proceso de recepción de correo electrónico, consulte Conceptos de recepción de correoelectrónico (p. 178).

Solo puede haber activo un conjunto de reglas de recepción a la vez. Sin embargo, puede crear variosconjuntos de reglas de recepción. Por ejemplo, podría resultar útil tener varios conjuntos de reglas derecepción si desea mantener un registro de las reglas de recepción que utilizó en el pasado, o si necesitacambiar las reglas de recepción rápidamente con fines de prueba.

Note

Si no desea utilizar Amazon SES como receptor de correo electrónico, solo tiene que deshabilitartodos sus conjuntos de reglas de recepción. Para obtener información acerca de cómodeshabilitar los conjuntos de reglas de recepción, consulte Administración de conjuntos de reglasde recepción (p. 206).

Puede utilizar la consola de Amazon SES o el API para crear un conjunto de reglas de recepción.

• Mediante la consola de Amazon SES• Las reglas de recepción existen en conjuntos de reglas de recepción solo, por tanto para crear un

conjunto de reglas de recepción, puede empezar por crear una regla de recepción. Para obtenermás información, consulte Creación de reglas de recepción (p. 192). Cuando llegue al final de esteprocedimiento, puede crear un nuevo conjunto de reglas de recepción.

• Copie un conjunto de reglas de recepción tal como se explica en Administración de conjuntos dereglas de recepción (p. 206).

• En el panel de navegación izquierdo, en Email Receiving, elija Rule Sets y, a continuación, elija Createa New Rule Set.

• Uso del API de Amazon SES: utilice el API CreateReceiptRuleSet para crear un conjunto dereglas de recepción vacío, tal como se describe en Amazon Simple Email Service API Reference. Acontinuación, puede utilizar la consola de Amazon SES o el API CreateReceiptRule para añadirreglas de recepción al mismo.

Creación de reglas de recepción para recepción decorreo electrónico de Amazon SESLas reglas de recepción le permiten especificar qué hace Amazon SES con correo electrónico que recibapara las direcciones de correo electrónico o dominios de su propiedad. Una regla de recepción contieneuna condición y una lista ordenada de acciones. Si el destinatario de un correo electrónico entrantecoincide con un destinatario especificado en las condiciones de la regla de recepción, entonces AmazonSES lleva a cabo las acciones especificadas en dicha regla de recepción. Para obtener más informaciónsobre la función de las reglas de recepción en el proceso de recepción de correo electrónico, consulteConceptos de recepción de correo electrónico (p. 178).

Important

Para configurar las reglas de recepción, en primer lugar verifique un dominio y publique unregistro MX en dicho dominio. Para obtener más información sobre la verificación de dominios,consulte Verificación de dominios en Amazon SES (p. 59). Para obtener más información acerca

192

https://docs.aws.amazon.com/ses/latest/APIReference/API_CreateReceiptRuleSet.html

Amazon Simple Email Service Developer GuideCreación de reglas de recepción

de la publicación de registros MX, consulte the section called “Publicación de un registro deMX” (p. 188).

Puede utilizar la consola de Amazon SES o la operación del API CreateReceiptRule para crearreglas de recepción. Esta sección proporciona los procedimientos para la creación de una nueva regla derecepción mediante la consola. Estos procedimientos suponen que su cuenta de Amazon SES no contieneninguna regla de recepción existente.

Configuración de una regla de recepciónPuede utilizar la consola de Amazon SES o el API CreateReceiptRule para crear reglas.

Para crear una regla de recepción con la consola


2. En el panel de navegación izquierdo, en Email Receiving, elija Rule Sets.3. Elija Create a Receipt Rule.4. Utilice el procedimiento siguiente para agregar uno o varios destinatarios. En conjunto, estos

destinatarios son la condición. Puede tener un máximo de 100 destinatarios por regla de recepción.

a. En Recipients, especifique la dirección de correo electrónico o dominio entrante para el que deseaconfigurar una regla de recepción. En la siguiente tabla se utiliza la dirección [email protected] mostrar cómo especificar los destinatarios.

Si desea… Especifique los siguientesdestinatarios...

Notas

Haga coincidir una direcciónde correo electrónicoespecífica.

[email protected] Haga coincidir tambiénvariaciones de ladirección que contenganetiquetas (como [email protected] y [email protected]). Noobstante, si especifica unadirección que contengauna etiqueta, solo se hacecoincidir dicha direcciónespecífica.

Haga coincidir todas lasdirecciones dentro de undominio, pero no aquellasdentro de sus subdominios.

example.com

Haga coincidir todas lasdirecciones dentro de unsubdominio específico, perono aquellas dentro del dominioprincipal.

subdomain.example.com

Haga coincidir todas lasdirecciones dentro de todoslos subdominios, pero noaquellas dentro del dominioprincipal.

.example.com Tenga en cuenta el punto (.)antes del nombre de dominio.

193




Si desea… Especifique los siguientesdestinatarios...

Notas

Haga coincidir todas lasdirecciones dentro deun dominio y todas lasdirecciones dentro de todossus subdominios.

example.com

.example.com

Crear dos destinatariosindependientes: uno con elnombre de dominio y otro conun punto seguido del nombrede dominio.

Haga coincidir todos losdestinatarios en todos losdominios verificados

[Ninguno] Deje en blanco el campo dedestinatario.

Important

Si varias cuentas de Amazon SES reciben correo electrónico en un dominio común (porejemplo, si varios equipos de la misma empresa tienen cada uno cuentas de AmazonSES independientes), Amazon SES procesa todas las reglas de recepción coincidentesde forma simultánea para cada una de las cuentas. Este comportamiento puede darlugar a una situación en la que una cuenta genera un rebote, mientras que otra cuentaacepta el correo electrónico.Le recomendamos que se coordine con otros equipos de la organización que utilicenAmazon SES para garantizar que cada cuenta utilice reglas de recepción únicas y queestas reglas no se solapen. En estas situaciones, es mejor configurar sus reglas derecepción para utilizar solo direcciones de correo electrónico o subdominios que seanúnicos de su grupo o equipo.

b. Elija Add Recipient.c. Repita los pasos a y b para cada destinatario que desee añadir. Cuando haya terminado de

añadir destinatarios, elija Next Step.5. Utilice el siguiente procedimiento para añadir una o más acciones a la regla de recepción.

a. Elija una acción del menú.b. Elija la configuración de la acción. Para obtener información sobre las opciones de cada acción,

consulte Opciones de acción (p. 195).c. Añada acciones adicionales según sea necesario y, a continuación, elija Next Step.

6. Para Rule Details, utilice el procedimiento siguiente para elegir la configuración.

a. Para Rule Name, escriba un nombre para la regla de recepción. El nombre debe contener menosde 64 caracteres alfanuméricos, guion (-), guion bajo (_) y punto (.) caracteres. El nombre debecomenzar y terminar por una letra o un número.

b. Si desea habilitar la regla de recepción, deje la opción Enabled seleccionada.c. Si desea que Amazon SES rechace los correos electrónicos entrantes que no se envíen a través

de una conexión cifrada con Transport Layer Security (TLS), seleccione TLS.d. Si desea que Amazon SES analice los mensajes de correo electrónico entrantes en busca de

spam y virus, seleccione Enable Spam and Virus Scanning.7. Para Rule Set, elija un conjunto de reglas de recepción existente o haga clic en Create New Rule Set.8. Para Rule Position, elija dónde desea colocar la regla de recepción en la lista ordenada de reglas de

recepción. Las reglas de recepción se evalúan de forma secuencial.9. Elija Next Step y, a continuación, seleccione Create Rule.

194


Para obtener información sobre cómo utilizar el API CreateReceiptRule para crear reglas, consulte laAmazon Simple Email Service API Reference.

Opciones de acciónCada regla de recepción para recibir correo electrónico Amazon SES contiene una lista ordenada deacciones. El procedimiento de configuración global para reglas de recepción se describe en Creación dereglas de recepción para recepción de correo electrónico de Amazon SES (p. 192). En esta sección sedescriben las opciones específicas para cada tipo de acción.

Los tipos de acción son los siguientes:

• Acción Add Header (p. 195)• Acción Bounce (p. 195)• Acción Lambda (p. 196)• Acción S3 (p. 203)• Acción SNS (p. 204)• Acción Stop (p. 205)• Acción WorkMail (p. 205)

Acción Add HeaderLa acción Add Header añade un encabezado personalizado al correo electrónico recibido. Normalmente,utilice esta acción solo en combinación con otra acción. Esta acción tiene las siguientes opciones.

• Header name: el nombre del encabezado que añadir. Debe tener entre 1 y 50 caracteres, incluidos yconsta únicamente de caracteres alfanuméricos (a-z, A-Z, 0-9) y guiones.

• Header value: el valor del encabezado que añadir. Debe tener menos de 2 048 caracteres y no debecontener caracteres de línea nueva ("\r" o "\n").

Acción BounceLa acción Bounce rechaza el correo electrónico devolviendo una respuesta de rebote al remitente y,opcionalmente, se lo notifica a través de Amazon SNS. Esta acción tiene las siguientes opciones.

• SMTP Reply Code: el código de respuesta SMTP, tal como define RFC 5321.• SMTP Status Code: el código de estado mejorado SMTP, tal como define RFC 3463.• Message: texto en lenguaje natural para incluir en el correo electrónico de rebote.• Reply Sender: la dirección de correo electrónico del remitente del correo electrónico rebotado. Esta es la

dirección desde la que se enviará el correo electrónico de rebote. Se debe verificar con Amazon SES.• SNS Topic: el nombre o ARN del tema de Amazon SNS para notificar opcionalmente cuando se envía

un correo electrónico de rebote. Un ejemplo de un ARN de tema de Amazon SNS es arn:aws:sns:us-west-2:123456789012:MyTopic. También puede crear un tema de Amazon SNS cuando configure suacción eligiendo Create SNS Topic. Para obtener más información sobre los temas de Amazon SNS,consulte la Guía para desarrolladores de Amazon Simple Notification Service.

Note

El tema de Amazon SNS que elija deberá estar en la misma región de AWS que el punto deenlace de Amazon SES que utilice para recibir correo electrónico.

Puede introducir sus propios valores para estos campos o bien puede elegir una plantilla que rellene loscampos SMTP Reply Code, SMTP Status Code y Message con valores en función del motivo del rebote.Están disponibles las siguientes plantillas:

195

https://docs.aws.amazon.com/ses/latest/APIReference/API_CreateReceiptRule.html





• Mailbox Does Not Exist: código de respuesta de SMTP = 550, código de estado SMTP = 5.1.1• Message Too Large: código de respuesta de SMTP = 552, código de estado SMTP = 5.3.4• Message Full: código de respuesta de SMTP = 552, código de estado SMTP = 5.2.2• Message Content Rejected: código de respuesta de SMTP = 500, código de estado SMTP = 5.6.1• Unknown Failure: código de respuesta de SMTP = 554, código de estado SMTP = 5.0.0• Temporary Failure: código de respuesta de SMTP = 450, código de estado SMTP = 4.0.0

Para obtener códigos de rebote adicionales que podría utilizar introduciendo valores personalizados en loscampos, consulte RFC 3463.

Acción LambdaLa acción Lambda llama al código a través de una función de Lambda y, opcionalmente, se lo notifica através de Amazon SNS. Esta acción tiene las siguientes opciones.

• Lambda function: el ARN de la función de Lambda. Un ejemplo de un ARN de función de Lambdaes arn:aws:lambda:us-west-2:account-id:function:MyFunction. Para obtener información sobre AWSLambda, consulte la AWS Lambda Developer Guide.

• Invocation type: el tipo de invocación de la función de Lambda. Un tipo de invocación deRequestResponse significa que la ejecución de la función dará lugar de inmediato a una respuesta y unvalor de Event significa que la función se invocará de manera asíncrona. Le recomendamos que utilice eltipo de invocación Event a menos que la ejecución sincrónica sea absolutamente necesaria en su casode uso.

Note

Se produce un desfase de 30 segundos en las invocaciones RequestResponse.

Para obtener más información sobre los tipos de invocación de AWS Lambda, consulte la AWS LambdaDeveloper Guide.

• SNS Topic: el nombre o ARN del tema de Amazon SNS para notificar cuando se activa la funciónde Lambda especificada. Un ejemplo de un ARN de tema de Amazon SNS es arn:aws:sns:us-west-2:123456789012:MyTopic. También puede crear un tema de Amazon SNS cuando configure suacción eligiendo Create SNS Topic. Para obtener más información sobre los temas de Amazon SNS,consulte la Guía para desarrolladores de Amazon Simple Notification Service.

Note


Escritura de la función de Lambda

Para procesar su correo electrónico, su función de Lambda se puede invocar de manera asíncrona (esdecir, utilizando el tipo de invocación Event). El objeto de evento transferido a su función de Lambdacontendrá metadatos pertenecientes al evento de correo electrónico de entrada. También puede utilizar losmetadatos para acceder al contenido del mensaje desde su bucket de Amazon S3.

Si desea realmente controlar el flujo de correo electrónico, se debe invocar su función de Lambdasincrónicamente (es decir, utilizando el tipo de invocación RequestResponse) y su función de Lambdadebe llamar al método callback con dos argumentos: el primer argumento es null y el segundoargumento es una propiedad disposition que se establece en STOP_RULE, STOP_RULE_SET oCONTINUE. Si el segundo argumento es null o no tiene una propiedad disposition válida, el flujo decorreo continúa y se procesan acciones y reglas adicionales, que es lo mismo que con CONTINUE.

Por ejemplo, puede detener el conjunto de reglas de recepción escribiendo la siguiente línea al final delcódigo de la función de Lambda:

196


https://docs.aws.amazon.com/lambda/latest/dg/welcome.html

https://docs.aws.amazon.com/lambda/latest/dg/API_Invoke.html

https://docs.aws.amazon.com/lambda/latest/dg/API_Invoke.html



callback( null, { "disposition" : "STOP_RULE_SET" });

Para obtener ejemplos de código de AWS Lambda, consulte Ejemplos de funciones Lambda (p. 200).Para ver ejemplos de casos de uso de alto nivel, consulte Ejemplos de casos de uso (p. 197).

Formato de entrada

Amazon SES transfiere información a la función de Lambda en formato JSON. El objeto de nivel superiorcontiene una matriz Records, que se rellena con las propiedades eventSource, eventVersion y ses.El objeto ses contiene objetos receipt y mail, que tienen exactamente el mismo formato que en lasnotificaciones de Amazon SNS descritas en Contenido de notificación (p. 213).

A continuación se ofrece una vista de alto nivel de la estructura de la entrada que Amazon SESproporciona a la función de Lambda.

{ "Records": [ { "eventSource": "aws:ses", "eventVersion": "1.0", "ses": { "receipt": { <same contents as SNS notification> }, "mail": { <same contents as SNS notification> } } } ]}

Valores devueltos

Su función de Lambda pueden controlar el flujo de correo electrónico devolviendo uno de los siguientesvalores:

• STOP_RULE: no se procesarán acciones adicionales en la regla de recepción actual, pero se puedenprocesar reglas de recepción adicionales.

• STOP_RULE_SET: no se procesarán acciones o reglas de recepción adicionales.• CONTINUE o cualquier otro valor no válido: esto significa que se pueden procesar acciones y reglas de

recepción adicionales.

Ejemplos de casos de uso

Los siguientes ejemplos describen algunas reglas que podría configurar para utilizar los resultados de lafunción de Lambda para controlar el flujo de correo electrónico. Para fines de demostración, muchos deestos ejemplos utilizan la acción de S3 como resultado.

Caso de uso 1: rechazar spam en todos los dominios

Este ejemplo muestra una regla global que rechaza spam en todos sus dominios. Las reglas 2 y 3 seincluyen para mostrar que puede aplicar reglas específicas de dominio después de rechazar el spam entodos los dominios.

Regla 1

Lista de destinatarios: vacía. Esta regla, por tanto, se aplicará a todos los destinatarios en todos losdominios verificados.

197


Actions

1. Acción Lambda (síncrona) que devuelve STOP_RULE_SET si el correo electrónico es spam. De locontrario, devuelve CONTINUE. Consulte el ejemplo de la función de Lambda para rechazar spam enEjemplos de funciones Lambda (p. 200).

Regla 2

Lista de destinatarios: example1.com

Actions

1. Cualquier acción.

Regla 3


Actions


Caso de uso 2: rebotar spam en todos los dominios

Este ejemplo muestra una regla global que rebota spam en todos sus dominios. Las reglas 2 y 3 seincluyen para mostrar que puede aplicar reglas específicas de dominio después de rebotar el spam entodos los dominios.

Regla 1

Lista de destinatarios: vacía. Esta regla, por tanto, se aplicará a todos los destinatarios en todos losdominios verificados.

Actions

1. Acción Lambda (síncrona) que devuelve CONTINUE si el correo electrónico es spam. De lo contrario,devuelve STOP_RULE.

2. Acción de rebote ("500 5.6.1. Message content rejected").3. Acción Stop.

Regla 2


Actions

1. Cualquier acción

Regla 3


Actions

1. Cualquier acción

198


Caso de uso 3: aplica la regla más específica

Este ejemplo ilustra cómo puede utilizar la acción Stop para impedir que varias reglas procesen los correoselectrónicos. En este ejemplo, dispone de una regla para una dirección específica y de otra para todas lasdirecciones de correo electrónico del dominio. Al utilizar la acción Stop, los mensajes que coinciden conla regla de la dirección de correo electrónico específica no se procesan con la regla más genérica que seaplica al dominio.

Regla 1

Lista de destinatarios: [email protected]

Actions

1. Acción Lambda (asíncrona)2. Acción Stop.

Regla 2

Lista de destinatarios: example.com

Actions


Caso de uso 4: registrar eventos de correo para CloudWatch

Este ejemplo muestra cómo mantener un registro de auditoría de todo el correo del sistema antes deguardar el correo en Amazon SES.

Regla 1


Actions

1. Acción Lambda (asíncrona) que escribe el objeto de evento en un registro de CloudWatch. Lasfunciones Lambda de ejemplo en Ejemplos de funciones Lambda (p. 200) registran en CloudWatch.

2. Acción S3.

Caso de uso 5: rechazar correo que no supera DKIM

Este ejemplo muestra cómo puede guardar todo el correo electrónico entrante en un bucket de AmazonS3, pero solo enviar correo electrónico que vaya a una dirección de correo electrónico específica y supereDKIM, a su aplicación de correo electrónico automatizada.

Regla 1


Actions

1. Acción S3.2. Acción Lambda (síncrona) que devuelve STOP_RULE_SET si el mensaje no supera DKIM. De lo

contrario, devuelve CONTINUE.

199


Regla 2


Actions

1. Acción Lambda (asíncrona) que activa la aplicación automatizada.

Caso de uso 6: filtra correo en función de la línea de asunto

Este ejemplo ilustra cómo puede rechazar todo el correo electrónico entrante de un dominio quecontenga la palabra "descuento" en la línea de asunto y, a continuación, procesar los correos electrónicosdestinados a un sistema automatizado de forma unidireccional y procesar todo el correo electrónico dirigidoa todos los demás destinatarios del dominio de una forma diferente.

Regla 1


Actions

1. Acción Lambda (síncrona) que devuelve STOP_RULE_SET si la línea de asunto contiene la palabra"descuento". De lo contrario, devuelve CONTINUE.

Regla 2


Actions

1. Acción S3 con bucket 1.2. Acción Lambda (asíncrona) que activa la aplicación automatizada.3. Acción Stop.

Regla 3


Actions

1. Acción S3 con bucket 2.2. Acción Lambda (asíncrona) que procesa el correo electrónico para el resto del dominio.

Ejemplos de funciones Lambda

Este tema contiene ejemplos de funciones Lambda que controlan el flujo de correo electrónico.

Ejemplo 1: rechazar spam

Este ejemplo detiene el procesamiento de mensajes que tienen al menos un indicador de spam.

exports.handler = function(event, context, callback) { console.log('Spam filter'); var sesNotification = event.Records[0].ses; console.log("SES Notification:\n", JSON.stringify(sesNotification, null, 2)); // Check if any spam check failed

200


if (sesNotification.receipt.spfVerdict.status === 'FAIL' || sesNotification.receipt.dkimVerdict.status === 'FAIL' || sesNotification.receipt.spamVerdict.status === 'FAIL' || sesNotification.receipt.virusVerdict.status === 'FAIL') { console.log('Dropping spam'); // Stop processing rule set, dropping message callback(null, {'disposition':'STOP_RULE_SET'}); } else { callback(null, null); }};

Ejemplo 2: continúa en caso de encabezado particular

Este ejemplo continúa el procesamiento de la regla actual únicamente si el correo electrónico contiene unvalor de encabezado específico.

exports.handler = function(event, context, callback) { console.log('Header matcher'); var sesNotification = event.Records[0].ses; console.log("SES Notification:\n", JSON.stringify(sesNotification, null, 2)); // Iterate over the headers for (var index in sesNotification.mail.headers) { var header = sesNotification.mail.headers[index]; // Examine the header values if (header.name === 'X-Header' && header.value === 'X-Value') { console.log('Found header with value.'); callback(null, null); return; } } // Stop processing the rule if the header value wasn't found callback(null, {'disposition':'STOP_RULE'}); };

Ejemplo 3: recupera correo electrónico de Amazon S3

Este ejemplo obtiene el correo electrónico sin procesar de Amazon S3 y lo procesa.Note

En primer lugar, debe escribir el correo electrónico en Amazon S3 utilizando una acción de S3.

var AWS = require('aws-sdk');var s3 = new AWS.S3(); var bucketName = '<YOUR BUCKET GOES HERE>'; exports.handler = function(event, context, callback) { console.log('Process email'); var sesNotification = event.Records[0].ses; console.log("SES Notification:\n", JSON.stringify(sesNotification, null, 2)); // Retrieve the email from your bucket s3.getObject({ Bucket: bucketName, Key: sesNotification.mail.messageId }, function(err, data) { if (err) {

201


console.log(err, err.stack); callback(err); } else { console.log("Raw email:\n" + data.Body); // Custom email processing goes here callback(null, null); } });};

Ejemplo 4: rebota los mensajes que no superan la autenticación DMARC

Este ejemplo envía un mensaje de rebote si un correo electrónico entrante no supera la autenticaciónDMARC.

Note

Cuando utilice este ejemplo, defina el valor de la variable de entorno emailDomain en su dominiode recepción de correo electrónico.

'use strict';

const AWS = require('aws-sdk');

// Assign the emailDomain environment variable to a constant.const emailDomain = process.env.emailDomain;

exports.handler = (event, context, callback) => { console.log('Spam filter starting');

const sesNotification = event.Records[0].ses; const messageId = sesNotification.mail.messageId; const receipt = sesNotification.receipt;

console.log('Processing message:', messageId);

// If DMARC verdict is FAIL and the sending domain's policy is REJECT // (p=reject), bounce the email. if (receipt.dmarcVerdict.status === 'FAIL' && receipt.dmarcPolicy.status === 'REJECT') { // The values that make up the body of the bounce message. const sendBounceParams = { BounceSender: `mailer-daemon@${emailDomain}`, OriginalMessageId: messageId, MessageDsn: { ReportingMta: `dns; ${emailDomain}`, ArrivalDate: new Date(), ExtensionFields: [], }, // Include custom text explaining why the email was bounced. Explanation: "Unauthenticated email is not accepted due to the sending domain's DMARC policy.", BouncedRecipientInfoList: receipt.recipients.map((recipient) => ({ Recipient: recipient, // Bounce with 550 5.6.1 Message content rejected BounceType: 'ContentRejected', })), };

console.log('Bouncing message with parameters:'); console.log(JSON.stringify(sendBounceParams, null, 2)); // Try to send the bounce.

202


new AWS.SES().sendBounce(sendBounceParams, (err, data) => { // If something goes wrong, log the issue. if (err) { console.log(Àn error occurred while sending bounce for message: ${messageId}`, err); callback(err); // Otherwise, log the message ID for the bounce email. } else { console.log(`Bounce for message ${messageId} sent, bounce message ID: ${data.MessageId}`); // Stop processing additional receipt rules in the rule set. callback(null, { disposition: 'stop_rule_set', }); } }); // If the DMARC verdict is anything else (PASS, QUARANTINE or GRAY), accept // the message and process remaining receipt rules in the rule set. } else { console.log('Accepting message:', messageId); callback(); }};

Acción S3

La acción S3 envía el correo a un bucket de Amazon S3 y, opcionalmente, se lo notifica a través deAmazon SNS. Esta acción tiene las siguientes opciones.

• S3 Bucket: el nombre del bucket de Amazon S3 donde guardar los correos electrónicos recibidos.También puede crear un nuevo bucket de Amazon S3 cuando configure su acción eligiendo Create S3Bucket. Amazon SES le proporciona el correo electrónico sin procesar y sin modificar que normalmenteestá en formato Multipurpose Internet Mail Extensions (MIME). Para obtener más información acerca delformato MIME, consulte RFC 2045.

Important

Cuando guarde sus correos electrónicos en un bucket de Amazon S3, el tamaño máximo decorreo electrónico (incluidos los encabezados) es de 30 MB.

• Object Key Prefix: un prefijo de nombre de clave que utilizar dentro del bucket de Amazon S3. Losprefijos de nombre de clave le permiten organizar su bucket de Amazon S3 en una estructura decarpetas. Por ejemplo, si utiliza Email como Object Key Prefix, sus correos electrónicos aparecerán ensu bucket de Amazon S3 en una carpeta denominada Email.

• KMS Key (si se selecciona "Encrypt Message" en la consola de Amazon SES): la clave principal delcliente que Amazon SES debería utilizar para cifrar sus correos electrónicos antes de guardarlosen el bucket de Amazon S3. Puede utilizar la clave maestra predeterminada o una clave maestrapersonalizada que usted mismo cree en AWS KMS.

Note

La clave maestra que elija deberá estar en la misma región de AWS que el punto de enlace deAmazon SES que utilice para recibir correo electrónico.

• Para utilizar la clave maestra predeterminada, elija aws/ses al configurar la regla derecepción en la consola de Amazon SES. Si utiliza el API de Amazon SES, puedeespecificar la clave maestra predeterminada proporcionando un ARN en forma dearn:aws:kms:REGION:AWSACCOUNTID:alias/aws/ses. Por ejemplo, si su ID de cuentade AWS es 123456789012 y desea utilizar la clave principal predeterminada en la regiónEE.UU. Oeste (Oregón), el ARN de la clave maestra predeterminada sería arn:aws:kms:us-west-2:123456789012:alias/aws/ses. Si usa la clave maestra predeterminada, no tiene querealizar ningún paso adicional para conceder permiso a Amazon SES para que utilice la clave.

203



• Para utilizar una clave maestra personalizada que haya creado en AWS KMS, proporcione el ARN dela clave maestra y asegúrese de añadir una instrucción a su política de clave para otorgar permisoa Amazon SES para utilizarla. Para obtener más información acerca de otorgar permisos, consulteOtorgar permisos a Amazon SES para recepción de correo electrónico (p. 189).

Para obtener más información acerca del uso de AWS KMS con Amazon SES, consulte la AWS KeyManagement Service Developer Guide. Si no especifica una clave maestra en la consola o el API,Amazon SES no cifrará sus correos electrónicos.

Important

Amazon SES cifra su correo electrónico utilizando el cliente de cifrado de Amazon S3 antes deque el correo electrónico se envíe a Amazon S3 para su almacenamiento. No se cifra utilizandoel cifrado del servidor de Amazon S3. Esto significa que debe utilizar el cliente de cifrado deAmazon S3 para descifrar el correo electrónico después de recuperarlo desde Amazon S3, yaque el servicio no tiene acceso para utilizar sus claves de AWS KMS para el descifrado. Estecliente está disponible en el AWS SDK for Java y en el AWS SDK parar Ruby. Para obtenerinformación adicional sobre el cifrado del cliente utilizando las claves maestras de AWS KMS,consulte la Guía para desarrolladores de Amazon Simple Storage Service.

• SNS Topic: el nombre o ARN del tema de Amazon SNS para notificar cuando se guarda un correoelectrónico en el bucket de Amazon S3. Un ejemplo de un ARN de tema de Amazon SNS esarn:aws:sns:us-west-2:123456789012:MyTopic. También puede crear un tema de Amazon SNS cuandoconfigure su acción eligiendo Create SNS Topic. Para obtener más información sobre los temas deAmazon SNS, consulte la Guía para desarrolladores de Amazon Simple Notification Service.

Note


Acción SNS

La acción SNS publica el correo con una notificación de Amazon SNS. La notificación incluye todo elcontenido del correo electrónico. Esta acción tiene las siguientes opciones.

• SNS Topic: el nombre o ARN del tema de Amazon SNS en el que publicar los correos electrónicos. Lasnotificaciones de Amazon SNS contendrán una copia del correo electrónico sin modificar y sin procesar,que normalmente está en formato Multipurpose Internet Mail Extensions (MIME). Para obtener másinformación acerca del formato MIME, consulte RFC 2045.

Important

Si decide recibir los correos electrónicos mediante notificaciones de Amazon SNS, el tamañomáximo de correo electrónico (incluidos los encabezados) es 150 KB. Los correos electrónicosde mayor tamaño rebotarán. Si prevé utilizar correos electrónicos de un tamaño mayor, guardelos correos electrónicos en un bucket de Amazon S3 en su lugar.

Un ejemplo de un ARN de tema de Amazon SNS es arn:aws:sns:us-west-2:123456789012:MyTopic.También puede crear un tema de Amazon SNS cuando configure su acción eligiendo Create SNS Topic.Para obtener más información sobre los temas de Amazon SNS, consulte la Guía para desarrolladoresde Amazon Simple Notification Service.

Note


• Encoding: el cifrado que utilizar para el correo electrónico dentro de la notificación de Amazon SNS.UTF-8 es más fácil de utilizar, pero no conservará todos los caracteres especiales si un mensaje se

204

https://docs.aws.amazon.com/kms/latest/developerguide/services-ses.html

https://docs.aws.amazon.com/kms/latest/developerguide/services-ses.html



https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingClientSideEncryption.html






ha cifrado con un formato de cifrado diferente. Base64 conserva todos los caracteres especiales. Paraobtener información sobre UTF-8 y Base64, consulte RFC 3629 y RFC 4648, respectivamente.

Acción Stop

La acción Stop termina la evaluación del conjunto de regla de recepción y, opcionalmente, se lo notifica através de Amazon SNS. Esta acción tiene las siguientes opciones.

• SNS Topic: el nombre o ARN del tema de Amazon SNS para notificar cuando se realiza la acción Stop.Un ejemplo de un ARN de tema de Amazon SNS es arn:aws:sns:us-west-2:123456789012:MyTopic.También puede crear un tema de Amazon SNS cuando configure su acción eligiendo Create SNS Topic.Para obtener más información sobre los temas de Amazon SNS, consulte la Guía para desarrolladoresde Amazon Simple Notification Service.

Note


Acción WorkMail

La acción WorkMail se integra con Amazon WorkMail. Si Amazon WorkMail realiza todo el procesamientode su correo electrónico, normalmente, no utilizará esta acción directamente ya que Amazon WorkMail seencarga de la configuración. Esta acción tiene las siguientes opciones.

• Organization ARN: el ARN de la organización de Amazon WorkMail.los ARN de la organización de Amazon WorkMail tienen la formaarn:aws:workmail:region:account_ID:organization/organization_ID, donde:• region es la región en la que está utilizando Amazon SES y Amazon WorkMail. (Debe utilizarlas a

partir de la misma región). Un ejemplo es us-west-2.• account_ID es el ID de cuenta de AWS. Puede encontrar su ID de cuenta de AWS en la página

Account de la consola de administración de AWS.• organization_ID es un identificador exclusivo que genera Amazon WorkMail cuando crea una

organización. Puede encontrar el ID de organización en la consola de Amazon WorkMail en la páginaOrganization Settings de su organización.

Un ejemplo de ARN de organización de Amazon WorkMail completo es arn:aws:workmail:us-west-2:123456789012:organization/m-68755160c4cb4e29a2b2f8fb58f359d7. Para obtener informaciónsobre las organizaciones de Amazon WorkMail, consulte la Amazon WorkMail Administrator Guide.

• SNS Topic: el nombre o ARN del tema de Amazon SNS para notificar cuando se realiza la acciónde Amazon WorkMail. Un ejemplo de un ARN de tema de Amazon SNS es arn:aws:sns:us-west-2:123456789012:MyTopic. También puede crear un tema de Amazon SNS cuando configure suacción eligiendo Create SNS Topic. Para obtener más información sobre los temas de Amazon SNS,consulte la Guía para desarrolladores de Amazon Simple Notification Service.

Note


205





https://console.aws.amazon.com/billing/home?#/account

https://docs.aws.amazon.com/workmail/latest/adminguide/organizations_overview.html


Amazon Simple Email Service Developer GuideAdministración de recepción de correo electrónico

Administración de recepción de correo electrónicode Amazon SES

Después de crear sus conjuntos de reglas de recepción, reglas de recepción y filtros de direccionesIP, puede utilizar la consola o el API de Amazon SES para editar, eliminar y realizar otras operaciones.También puede examinar las notificaciones de Amazon SNS que recibe y utilizar Amazon CloudWatchpara consultar las métricas de errores.

Temas de esta sección:• Administración de conjuntos de reglas de recepción para recepción de correo electrónico de Amazon

SES (p. 206)• Administración de reglas de recepción para recepción de correo electrónico de Amazon SES (p. 209)• Administración de filtros de dirección IP para recepción de correo electrónico de Amazon

SES (p. 211)• Visualización de métricas para recepción de correo electrónico de Amazon SES (p. 212)• Uso de notificaciones para recepción de correo electrónico de Amazon SES (p. 213)

Administración de conjuntos de reglas de recepciónpara recepción de correo electrónico de Amazon SESDespués de crear un conjunto de reglas de recepción tal y como se describe en Creación de un conjuntode reglas de recepción (p. 192), puede actualizarlo según sea necesario. Aunque la edición de unconjunto de reglas de recepción normalmente supone editar reglas de recepción individuales, tal como sedescribe en Administración de reglas de recepción (p. 209), también puede eliminar, activar, deshabilitary copiar conjuntos de reglas de recepción. Además, puede reordenar las reglas de recepción en unconjunto de reglas de recepción. Estas operaciones se describen en las siguientes secciones.

Temas de esta sección:• Eliminación de un conjunto de reglas de recepción (p. 206)• Activar y deshabilitar un conjunto de reglas de recepción (p. 207)• Copia de un conjunto de reglas de recepción (p. 207)• Reordenación de reglas de recepción (p. 208)

Eliminación de un conjunto de reglas de recepciónPuede utilizar la consola de Amazon SES o el API DeleteReceiptRuleSet para eliminar un conjunto dereglas de recepción.

Note

No puede eliminar el conjunto de reglas de recepción que está activo actualmente.

Para eliminar un conjunto de reglas de recepción (consola)


2. En el panel de navegación izquierdo, en Email Receiving, elija Rule Sets.3. En la lista Inactive Rule Sets, seleccione el conjunto de reglas de recepción que desea eliminar.

206



Amazon Simple Email Service Developer GuideAdministración de conjuntos de reglas de recepción

4. En el menú Actions, elija Delete y, a continuación, confirme que desea eliminar el conjunto de reglasde recepción.

Para obtener información sobre cómo utilizar el API DeleteReceiptRuleSet para eliminar un conjuntode reglas de recepción, consulte la Amazon Simple Email Service API Reference.

Activar y deshabilitar un conjunto de reglas de recepciónCada conjunto de reglas de recepción tiene uno de estos dos estados: activo o deshabilitado. Solo uno desus conjuntos de reglas de recepción puede estar activo en un momento dado. Los conjuntos de reglas derecepción deshabilitados puede resultar útiles en casos en los que desee realizar cambios en su conjuntode reglas de recepción activo, pero no desea que dichos cambios estén activos hasta que esté seguro deque las actualizaciones son correctas. En ese caso, puede copiar el conjunto de reglas de recepción activoy realizar cambios en conjunto de reglas de recepción copiado deshabilitado. Cuando esté conforme conlos cambios, puede activar el conjunto de reglas de recepción copiado. Al activar un conjunto de reglas derecepción, todos los demás conjuntos de reglas de recepción están deshabilitados automáticamente.

Note

Para deshabilitar la recepción de correo electrónico a través de Amazon SES por completo,deshabilite todos los conjuntos de reglas de recepción.

Puede utilizar la consola de Amazon SES o el API SetActiveReceiptRuleSet para controlar queconjunto de reglas está activo.

Para activar un conjunto de reglas de recepción deshabilitado (consola)


2. En el panel de navegación izquierdo, en Email Receiving, elija Rule Sets.3. En la lista Inactive Rule Sets, seleccione el conjunto de reglas de recepción que desea activar.4. Elija Set as Active Rule Set.

Para deshabilitar el conjunto de reglas de recepción activo (consola)


2. En el panel de navegación izquierdo, en Email Receiving, elija Rule Sets.3. En Active Rule Set, elija Disable Active Rule Set y, a continuación, confirme que desea deshabilitar el

conjunto de reglas de recepción.

Para obtener información sobre cómo utilizar el API SetActiveReceiptRuleSet para activar odeshabilitar un conjunto de reglas, consulte la Amazon Simple Email Service API Reference.

Copia de un conjunto de reglas de recepciónPuede utilizar la consola de Amazon SES o el API CloneReceiptRuleSet para copiar un conjunto dereglas de recepción. Si utiliza la consola de Amazon SES el procedimiento es ligeramente distinto, enfunción de si el conjunto de reglas de recepción que desea copiar está activo o deshabilitado.

Para copiar el conjunto de reglas de recepción activo (consola)


2. En el panel de navegación izquierdo, en Email Receiving, elija Rule Sets.

207

https://docs.aws.amazon.com/ses/latest/APIReference/API_DeleteReceiptRuleSet.html





https://docs.aws.amazon.com/ses/latest/APIReference/API_SetActiveReceiptRuleSet.html



Amazon Simple Email Service Developer GuideAdministración de conjuntos de reglas de recepción

3. En el panel de contenido, elija Copy Active Rule Set.4. En el cuadro de diálogo Copy Rule Set, escriba el nombre que desea asignar al conjunto de reglas de

recepción copiado.5. Elija Copy Rule Set. El conjunto de reglas de recepción copiado aparecerá en la lista Inactive Rule

Sets.

Para copiar un conjunto de reglas de recepción deshabilitado (consola)


2. En el panel de navegación izquierdo, en Email Receiving, elija Rule Sets.3. En la lista Inactive Rule Sets, seleccione el conjunto de reglas de recepción que desea copiar.4. En el menú Actions, elija Copy.5. En el cuadro de diálogo Copy Rule Set, escriba el nombre que desea asignar al conjunto de reglas de

recepción copiado.6. Elija Copy Rule Set. El conjunto de reglas de recepción copiado aparecerá en la lista Inactive Rule

Sets.

Para obtener información sobre cómo utilizar el API CloneReceiptRuleSet para copiar un conjunto dereglas de recepción, consulte la Amazon Simple Email Service API Reference.

Reordenación de reglas de recepciónPuede utilizar la consola de Amazon SES o el API ReorderReceiptRuleSet para reordenar las reglasde recepción en un conjunto de reglas de recepción. Si utiliza la consola de Amazon SES el procedimientoes ligeramente distinto, en función de si el conjunto de reglas de recepción está activo o deshabilitado.

Para reordenar las reglas de recepción en el conjunto de reglas de recepción activo (consola)


2. En el panel de navegación izquierdo, en Email Receiving, elija Rule Sets.3. En el panel de contenido, elija View Active Rule Set.4. Elija Reorder Rules.5. Utilice las flechas arriba y abajo junto a los nombres de reglas de recepción para reordenar las reglas

de recepción y, a continuación, elija Save Order.

Para reordenar las reglas de recepción en un conjunto de reglas de recepción deshabilitado(consola)


2. En el panel de navegación izquierdo, en Email Receiving, elija Rule Sets.3. En la lista Inactive Rule Sets, seleccione el conjunto de reglas de recepción.4. Elija Reorder Rules.5. Utilice las flechas arriba y abajo junto a los nombres de reglas de recepción para reordenar las reglas


Para obtener información sobre cómo utilizar el API ReorderReceiptRuleSet para reordenar las reglasde recepción un conjunto de reglas de recepción, consulte la Amazon Simple Email Service API Reference.

208



https://docs.aws.amazon.com/ses/latest/APIReference/API_CloneReceiptRuleSet.html





https://docs.aws.amazon.com/ses/latest/APIReference/API_ReorderReceiptRuleSet.html

Amazon Simple Email Service Developer GuideAdministración de reglas de recepción

Administración de reglas de recepción para recepciónde correo electrónico de Amazon SESAdemás de crear reglas de recepción tal como se describe en Creación de reglas de recepción (p. 192),puede editar, eliminar, habilitar, deshabilitar, copiar y definir la posición de una regla de recepción en suconjunto de reglas de recepción, tal y como se describe en las secciones siguientes.

Note

Las instrucciones de esta sección suponen que la regla de recepción se encuentra en el conjuntode reglas de recepción activo. Para editar las reglas de recepción de un conjunto de reglas derecepción deshabilitado, elija un conjunto de reglas de recepción de la lista Inactive Rule Sets.A partir de ahí, las instrucciones para editar reglas de recepción son las mismas que para elconjunto de reglas de recepción activo.

Temas de esta sección:• Edición de una regla de recepción (p. 209)• Eliminación de una regla de recepción (p. 209)• Habilitar y deshabilitar una regla de recepción (p. 210)• Copia de una regla de recepción (p. 210)• Establecimiento de la posición de una regla de recepción (p. 211)

Edición de una regla de recepciónPuede utilizar la consola de Amazon SES o el API de Amazon SES para editar una regla de recepción. Esmás fácil utilizar la consola de Amazon SES.

Para editar una regla de recepción (consola)


2. En el panel de navegación izquierdo, en Email Receiving, elija Rule Sets.3. En el panel de contenido, elija View Active Rule Set o elija un conjunto de reglas de recepción de la

lista Inactive Rule Sets.4. En el panel de detalles, elija la regla de recepción que desea editar.5. En el panel Edit Rule, edite la política y, a continuación, elija Save Rule.

Si desea utilizar el API de Amazon SES en su lugar, utilice el API DescribeReceiptRule para recuperarla regla, utilice un editor de texto para editar la regla y, a continuación, utilice el API UpdateReceiptRulepara sobrescribir la versión anterior de la regla. Para obtener más información, consulte la Amazon SimpleEmail Service API Reference.

Eliminación de una regla de recepciónPuede utilizar la consola de Amazon SES o el API DeleteReceiptRule para eliminar una regla derecepción.

Para eliminar una regla de recepción (consola)


2. En el panel de navegación izquierdo, en Email Receiving, elija Rule Sets.

209



https://docs.aws.amazon.com/ses/latest/APIReference/API_UpdateReceiptRule.html




Amazon Simple Email Service Developer GuideAdministración de reglas de recepción

3. En el panel de contenido, elija View Active Rule Set o elija un conjunto de reglas de recepción de lalista Inactive Rule Sets.

4. En el panel de detalles, seleccione la regla de recepción.5. En el menú Actions, elija Delete y, a continuación, confirme que desea eliminar la regla de recepción.

Para obtener información sobre cómo utilizar el API DeleteReceiptRule para eliminar una regla,consulte la Amazon Simple Email Service API Reference.

Habilitar y deshabilitar una regla de recepciónPuede utilizar la consola de Amazon SES o el API de Amazon SES para habilitar o deshabilitar una reglade recepción. Es más fácil utilizar la consola de Amazon SES.

Para habilitar o deshabilitar una regla de recepción (consola)



lista Inactive Rule Sets.4. En el panel de detalles, elija la regla de recepción que desea editar.5. En el panel Edit Rule, seleccione o borre Enabled y, a continuación, elija Save Rule.

Si desea utilizar el API de Amazon SES en su lugar, puede utilizar el API DescribeReceiptRule pararecuperar la regla de recepción, utilice un editor de texto para editar el campo Enabled de la regla derecepción y, a continuación, utilice el API UpdateReceiptRule para sobrescribir la versión anteriorde la regla de recepción. Para obtener más información, consulte la Amazon Simple Email Service APIReference.

Copia de una regla de recepciónPuede utilizar la consola de Amazon SES o el API de Amazon SES para copiar una regla de recepción. Esmás fácil utilizar la consola de Amazon SES.

Para copiar una regla de recepción (consola)



lista Inactive Rule Sets.4. En el panel de detalles, seleccione la regla de recepción.5. En el menú Actions, elija Copy Rule.6. En el cuadro de diálogo Copy Rule, escriba un nuevo nombre de regla de recepción y seleccione el

conjunto de regla de recepción de destino. La nueva regla de recepción se insertará al principio delconjunto de reglas de recepción y aparecerá desactivado inicialmente.

Si desea utilizar el API de Amazon SES en su lugar, puede utilizar el API DescribeReceiptRule pararecuperar la regla de recepción, utilice un editor de texto para editar el nombre de la regla de recepción yel conjunto de la regla de recepción (si lo desea) y, a continuación, transfiera dicha regla de recepción alAPI CreateReceiptRule. Para obtener más información, consulte la Amazon Simple Email Service APIReference.

210

https://docs.aws.amazon.com/ses/latest/APIReference/API_DeleteReceiptRule.html









Amazon Simple Email Service Developer GuideAdministración de filtros de dirección IP

Establecimiento de la posición de una regla de recepciónPuede utilizar la consola de Amazon SES o el API SetReceiptRulePosition para cambiar la posiciónde una regla de recepción en el conjunto de reglas de recepción.

Para definir la posición de una regla de recepción (consola)



lista Inactive Rule Sets.4. En el panel de contenido, elija Reorder Rules.5. Utilice las flechas arriba y abajo junto a los nombres de reglas de recepción para reordenar las reglas


Para obtener información sobre cómo utilizar el API SetReceiptRulePosition para cambiar la posiciónde una regla de recepción en el conjunto de reglas de recepción, consulte la Amazon Simple Email ServiceAPI Reference.

Administración de filtros de dirección IP pararecepción de correo electrónico de Amazon SESAdemás de la creación de filtros de dirección IP tal como se explica en Creación de filtros de direcciónIP (p. 191), puede verlos y eliminarlos, tal y como se describe en las secciones siguientes.

Ver filtros de dirección IPPuede utilizar la consola de Amazon SES o el API ListReceiptFilters para obtener una lista de susfiltros de direcciones IP.

Para ver sus filtros de dirección IP (consola)


2. En el panel de navegación izquierdo, en Email Receiving, elija IP Address Filters. Verá una lista de susfiltros de dirección IP.

Para obtener información sobre cómo utilizar el API ListReceiptFilters para obtener una lista de susfiltros de dirección IP, consulte la Amazon Simple Email Service API Reference.

Eliminación de un filtro de dirección IPPuede utilizar la consola de Amazon SES o el API DeleteReceiptFilter para eliminar un filtro dedirección IP.

Para eliminar un filtro de dirección IP (consola)


2. En el panel de navegación izquierdo, en Email Receiving, elija IP Address Filters.3. En el panel de detalles, seleccione el filtro de dirección IP.

211



https://docs.aws.amazon.com/ses/latest/APIReference/API_SetReceiptRulePosition.html




https://docs.aws.amazon.com/ses/latest/APIReference/API_ListReceiptFilters.html



Amazon Simple Email Service Developer GuideVisualización de métricas de error

4. Seleccione Delete y, a continuación, confirme que desea eliminar el filtro de dirección IP.

Para obtener información sobre cómo utilizar el API DeleteReceiptFilter para eliminar un filtro dedirección IP, consulte la Amazon Simple Email Service API Reference.

Visualización de métricas para recepción de correoelectrónico de Amazon SESPuede utilizar Amazon CloudWatch (CloudWatch) para ver métricas de error para sus reglas de recepción.Encontrará las métricas en SES/Rule Metrics.

Existen dos métricas de error:

• PublishFailure: Amazon SES ha encontrado un error cuando intentaba ejecutar las acciones que haconfigurado.

• PublishExpired: Amazon SES encontró un error cuando intentaba ejecutar las acciones que configuró yAmazon SES ya no volverá a intentar entregar el correo electrónico. Este error puede ser permanente otransitorio. Amazon SES ya no lo volverá a intentar porque la acción no ha tenido éxito en un plazo decuatro horas.

Estos errores pueden ocurrir, por ejemplo, si ha eliminado o revocado permisos para un bucket de AmazonS3, tema de Amazon SNS o función de Lambda que una acción de una de las reglas de recepción tenía ensu configuración.

Important

Los cambios que realice para corregir su conjunto de reglas de recepción se aplicarán soloa los correos electrónicos que Amazon SES recibe después de la actualización. Los correoselectrónicos siempre se evalúan respecto al conjunto de reglas de recepción en vigor en elmomento en que se recibió el correo electrónico.

La figura siguiente muestra las métricas en la consola de CloudWatch.

212

https://docs.aws.amazon.com/ses/latest/APIReference/API_DeleteReceiptFilter.html

Amazon Simple Email Service Developer GuideUso de notificaciones

Uso de notificaciones para recepción de correoelectrónico de Amazon SESCuando se recibe un correo electrónico, Amazon SES ejecuta las reglas del conjunto de reglas derecepción activo. Puede configurar reglas de recepción para que se le envíen notificaciones medianteAmazon SNS. Las reglas de recepción pueden enviar dos tipos distintos de notificaciones:

• Notificaciones enviadas desde acciones de SNS: cuando se añade una acción de SNS (p. 204) a unaregla de recepción, envía información sobre el correo electrónico. Si el mensaje tiene 150 KB o menos,este tipo de notificación también incluye el cuerpo MIME completo del correo electrónico.

• Notificaciones enviadas desde otros tipos de acciones: cuando se añade cualquier otro tipo deacción (incluidas las acciones Bounce (p. 195), Lambda (p. 196), Stop Rule Set (p. 205) oWorkMail (p. 205)) a una regla de recepción, es posible de especificar un tema de Amazon SNS.Si lo hace, recibirá notificaciones cuando se realicen estas acciones. Estas notificaciones contieneninformación sobre el correo electrónico, pero no incluyen el contenido del correo electrónico.

En esta sección se describe el contenido de estas notificaciones y se ofrece un ejemplo de cada tipo denotificación.

Temas de esta sección:• Contenido de notificaciones para recepción de correo electrónico de Amazon SES (p. 213)• Ejemplos de notificaciones para recepción de correo electrónico de Amazon SES (p. 219)

Contenido de notificaciones para recepción de correo electrónicode Amazon SESTodas las notificaciones de recepción de correo electrónico se publican en temas de Amazon SimpleNotification Service (Amazon SNS) en formato JavaScript Object Notation (JSON).

Objeto JSON de nivel superiorLos objetos JSON de nivel superior contienen los siguientes campos.

Nombre del campo Descripción

notificationType Cadena que especifica el tipo de notificación. Estevalor será siempre Received.

receipt Objeto que contiene información sobre la entregade correo electrónico.

mail Objeto que contiene información sobre el correoelectrónico al que pertenece la notificación.

content Cadena que contiene el correo electrónico sinprocesar y sin modificar que normalmente estáen formato Multipurpose Internet Mail Extensions(MIME). Para obtener más información acerca delformato MIME, consulte RFC 2045.

Note

Este campo está presente solo si lanotificación la activó una acción SNS. Las

213



Nombre del campo Descripciónnotificaciones activadas por las demásacciones no contienen este campo.

Objeto receiptEl objeto receipt tiene los siguientes campos.


action Objeto que encapsula información sobre la acciónque se ha ejecutado. Para obtener una lista de losposibles valores, consulte Objeto action (p. 215).

dkimVerdict Objeto que indica si se ha superado lacomprobación de Correo identificado conclaves de dominio (DKIM). Para obtener unalista de los posibles valores, consulte ObjetodkimVerdict (p. 216).

dmarcPolicy Indica la configuración Domain-based MessageAuthentication, Reporting & Conformance(DMARC) para el dominio de envío. Estecampo solo aparece si el mensaje no supera laautenticación DMARC.

Los valores posibles para este campo son:

• none: el propietario del dominio de envío solicitaque no se tome ninguna medida específica paralos mensajes que no superen la autenticaciónDMARC.

• quarantine: el propietario del dominio deenvío solicita que los receptores traten comosospechosos los mensajes que no superen laautenticación DMARC.

• reject: el propietario del dominio de envíosolicita que se rechacen los mensajes que nosuperen la autenticación DMARC.

dmarcVerdict Objeto que indica si se ha superado lacomprobación Domain-based MessageAuthentication, Reporting & Conformance(DMARC). Para obtener una lista de los posiblesvalores, consulte Objeto dmarcVerdict (p. 216).

processingTimeMillis Cadena que especifica el periodo, enmilisegundos, a partir del momento en que AmazonSES recibió el mensaje hasta el momento en quese activó la acción.

recipients Lista de destinatarios (específicamente, lasdirecciones RCPT TO del sobre) que secorresponde con la regla de recepción (p. 192)activa. Las direcciones indicadas aquí puedenser distintas de las que figuran en el campo

214


Nombre del campo Descripcióndestination del the section called “Objetomail” (p. 218).

spamVerdict Objeto que indica si el mensaje es spam. Paraobtener una lista de los posibles valores, consulteObjeto spamVerdict (p. 217).

spfVerdict Objeto que indica si se ha superado lacomprobación de Sender Policy Framework (SPF).Para obtener una lista de los posibles valores,consulte Objeto spfVerdict (p. 217).

timestamp Cadena que especifica la fecha y la hora a la quese activó la acción, en formato ISO 8601.

virusVerdict Objeto que indica si el mensaje contiene un virus.Para obtener una lista de los posibles valores,consulte Objeto virusVerdict (p. 218).

Objeto action

El objeto action tiene los siguientes campos.


type Cadena que indica el tipo de acción que se haejecutado. Los valores posibles son S3, SNS,Bounce, Lambda, Stop y WorkMail.

topicArn Cadena que contiene el Nombre de recurso deAmazon (ARN) del tema de Amazon SNS en elque se publicó la notificación.

bucketName Cadena que contiene el nombre del bucket deAmazon S3 en el que se publicó el mensaje.Presente solo para el tipo de acción de S3.

objectKey Cadena que contiene un nombre que identifica deforma única el correo electrónico en el bucket deAmazon S3. Coincide con el messageId del thesection called “Objeto mail” (p. 218). Presentesolo para el tipo de acción de S3.

smtpReplyCode Cadena que contiene el código de respuestade SMTP, tal y como se define en RFC 5321.Presente solo para el tipo de acción de rebote.

statusCode Cadena que contiene el código de estadomejorado de SMTP, tal y como se define en RFC3463. Presente solo para el tipo de acción derebote.

message Cadena que contiene texto en lenguaje naturalpara incluir en el mensaje de rebote. Presente solopara el tipo de acción de rebote.

215

https://en.wikipedia.org/wiki/ISO_8601






sender Cadena que contiene la dirección de correoelectrónico del remitente del correo electrónicorebotado. Esta es la dirección desde la que seenvió el mensaje de rebote. Presente solo para eltipo de acción de rebote.

functionArn Cadena que contiene el ARN de la función deLambda que se activó. Presente solo para el tipode acción Lambda.

invocationType Cadena que contiene el tipo de invocación dela función de Lambda. Los posibles valores sonRequestResponse y Event. Presente solo parael tipo de acción Lambda.

organizationArn Cadena que contiene el ARN de la organización deAmazon WorkMail. Presente solo para el tipo deacción WorkMail.

Objeto dkimVerdict

El objeto dkimVerdict tiene los siguientes campos.


status Cadena que contiene el veredicto de DKIM. Losvalores posibles son:

• PASS: el mensaje ha superado la autenticaciónDKIM.

• FAIL: el mensaje no ha superado laautenticación DKIM.

• GRAY: el mensaje no está firmado con DKIM.• PROCESSING_FAILED: hay un problema que

impide que Amazon SES compruebe la firmaDKIM. Por ejemplo, las consultas de DNSdevuelven un error o el encabezado de la firmaDKIM no tiene el formato correcto.

Objeto dmarcVerdict

El objeto dmarcVerdict tiene los siguientes campos.


status Cadena que contiene el veredicto de DMARC. Losvalores posibles son:

• PASS: el mensaje ha superado la autenticaciónDMARC.

• FAIL: el mensaje no ha superado laautenticación DMARC.

216


Nombre del campo Descripción• GRAY: el mensaje no ha superado la

autenticación DMARC y el dominio de envío notiene una política de DMARC o utiliza la políticap=none.

• PROCESSING_FAILED: existe un problemaque impide que Amazon SES proporcione unveredicto de DMARC.

Objeto spamVerdict

El objeto spamVerdict tiene los siguientes campos.


status Cadena que contiene el resultado del análisis despam. Los valores posibles son:

• PASS: el análisis de spam ha determinado quees improbable que el mensaje contenga spam.

• FAIL: el análisis de spam ha determinado quees probable que el mensaje contenga spam.

• GRAY: Amazon SES ha analizado el correoelectrónico, pero no ha podido determinar conconfianza si se trata de spam.

• PROCESSING_FAILED: Amazon SES no hapodido analizar el correo electrónico. Porejemplo, el correo electrónico no es un mensajeMIME válido.

Objeto spfVerdict

El objeto spfVerdict tiene los siguientes campos.


status Cadena que contiene el veredicto de SPF. Losvalores posibles son:

• PASS: el mensaje ha superado la autenticaciónSPF.

• FAIL: el mensaje no ha superado laautenticación SPF.

• GRAY: no existe ninguna política de SPF bajo eldominio utilizado en el comando MAIL FROM.

• PROCESSING_FAILED: hay un problema queimpide que Amazon SES compruebe el registroSPF. Por ejemplo, las consultas DNS estánfallando.

217


Objeto virusVerdict

El objeto virusVerdict tiene los siguientes campos.


status Cadena que contiene el resultado del análisis devirus. Los valores posibles son:

• PASS: el mensaje no contiene un virus.• FAIL: el mensaje contiene un virus.• GRAY: Amazon SES ha analizado el correo

electrónico, pero no ha podido determinar conconfianza si contiene un virus.

• PROCESSING_FAILED: Amazon SES no puedeanalizar el contenido del correo electrónico. Porejemplo, el correo electrónico no es un mensajeMIME válido.

Objeto mailEl objeto mail tiene los siguientes campos.


destination

Lista completa de todas las direcciones de losdestinatarios (incluidos en los campos To: y CC:)de los encabezados MIME de los mensajes decorreo electrónico entrantes.

messageId Cadena que contiene un ID único que asignaal correo electrónico Amazon SES. Si el correoelectrónico se ha entregado a Amazon S3, el ID delmensaje es también la clave de objeto de AmazonS3 que se utilizó para escribir el mensaje a subucket de Amazon S3.

source Cadena que contiene la dirección de correoelectrónico (específicamente, la dirección MAILFROM del sobre) desde la que se envió el correoelectrónico.

timestamp Cadena que contiene la hora en la que se recibió elcorreo electrónico, en formato ISO8601.

headers Una lista de encabezados de Amazon SES y susencabezados personalizados. Cada encabezadode la lista tiene un campo name y un campovalue.

commonHeaders Una lista de encabezados comunes a todos loscorreos electrónicos. Todos los encabezados de lalista se componen de un nombre y un valor.

headersTruncated Cadena que especifica si los encabezados setruncaron en la notificación, lo que ocurrirá si los

218


Nombre del campo Descripciónencabezados tienen un tamaño superior a 10 KB.Los posibles valores son true y false.

Ejemplos de notificaciones para recepción de correo electrónicode Amazon SESEn esta sección se ofrecen ejemplos de los siguientes tipos de notificaciones:

• Una notificación enviada como resultado de una acción de SNS. (p. 219)• Una notificación enviada como resultado de otro tipo de acción (p. 221) (una notificación de alerta).

Notificación de una acción de SNS

Esta sección contiene un ejemplo de una notificación de acción de SNS. A diferencia de la notificación dealerta mostrada anteriormente, incluye una sección content que contiene el correo electrónico, que sueleestar en formato Multipurpose Internet Mail Extensions (MIME).

{"notificationType": "Received","receipt": {"timestamp": "2015-09-11T20:32:33.936Z","processingTimeMillis": 222,"recipients": [ "[email protected]"],"spamVerdict": { "status": "PASS"},"virusVerdict": { "status": "PASS"},"spfVerdict": { "status": "PASS"},"dkimVerdict": { "status": "PASS"},"action": { "type": "SNS", "topicArn": "arn:aws:sns:us-east-1:012345678912:example-topic"}},"mail": {"timestamp": "2015-09-11T20:32:33.936Z","source": "[email protected]","messageId": "d6iitobk75ur44p8kdnnp7g2n800","destination": [ "[email protected]"],"headersTruncated": false,"headers": [ { "name": "Return-Path", "value": "<0000014fbe1c09cf-7cb9f704-7531-4e53-89a1-5fa9744f5eb6-000000@amazonses.com>" }, { "name": "Received",

219


"value": "from a9-183.smtp-out.amazonses.com (a9-183.smtp-out.amazonses.com [54.240.9.183]) by inbound-smtp.us-east-1.amazonaws.com with SMTP id d6iitobk75ur44p8kdnnp7g2n800 for [email protected]; Fri, 11 Sep 2015 20:32:33 +0000 (UTC)" }, { "name": "DKIM-Signature", "value": "v=1; a=rsa-sha256; q=dns/txt; c=relaxed/simple; s=ug7nbtf4gccmlpwj322ax3p6ow6yfsug; d=amazonses.com; t=1442003552; h=From:To:Subject:MIME-Version:Content-Type:Content-Transfer-Encoding:Date:Message-ID:Feedback-ID; bh=DWr3IOmYWoXCA9ARqGC/UaODfghffiwFNRIb2Mckyt4=; b=p4ukUDSFqhqiub+zPR0DW1kp7oJZakrzupr6LBe6sUuvqpBkig56UzUwc29rFbJF hlX3Ov7DeYVNoN38stqwsF8ivcajXpQsXRC1cW9z8x875J041rClAjV7EGbLmudVpPX 4hHst1XPyX5wmgdHIhmUuh8oZKpVqGi6bHGzzf7g=" }, { "name": "From", "value": "[email protected]" }, { "name": "To", "value": "[email protected]" }, { "name": "Subject", "value": "Example subject" }, { "name": "MIME-Version", "value": "1.0" }, { "name": "Content-Type", "value": "text/plain; charset=UTF-8" }, { "name": "Content-Transfer-Encoding", "value": "7bit" }, { "name": "Date", "value": "Fri, 11 Sep 2015 20:32:32 +0000" }, { "name": "Message-ID", "value": "<[email protected]>" }, { "name": "X-SES-Outgoing", "value": "2015.09.11-54.240.9.183" }, { "name": "Feedback-ID", "value": "1.us-east-1.Krv2FKpFdWV+KUYw3Qd6wcpPJ4Sv/pOPpEPSHn2u2o4=:AmazonSES" }],"commonHeaders": { "returnPath": "0000014fbe1c09cf-7cb9f704-7531-4e53-89a1-5fa9744f5eb6-000000@amazonses.com", "from": [ "[email protected]" ], "date": "Fri, 11 Sep 2015 20:32:32 +0000", "to": [ "[email protected]" ],

220


"messageId": "<[email protected]>", "subject": "Example subject"}},"content": "Return-Path: <[email protected]>\r\nReceived: from a9-183.smtp-out.amazonses.com (a9-183.smtp-out.amazonses.com [54.240.9.183])\r\n by inbound-smtp.us-east-1.amazonaws.com with SMTP id d6iitobk75ur44p8kdnnp7g2n800\r\n for [email protected];\r\n Fri, 11 Sep 2015 20:32:33 +0000 (UTC)\r\nDKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/simple;\r\n\ts=ug7nbtf4gccmlpwj322ax3p6ow6yfsug; d=amazonses.com; t=1442003552;\r\n\th=From:To:Subject:MIME-Version:Content-Type:Content-Transfer-Encoding:Date:Message-ID:Feedback-ID;\r\n\tbh=DWr3IOmYWoXCA9ARqGC/UaODfghffiwFNRIb2Mckyt4=;\r\n\tb=p4ukUDSFqhqiub+zPR0DW1kp7oJZakrzupr6LBe6sUuvqpBkig56UzUwc29rFbJF\r\n\thlX3Ov7DeYVNoN38stqwsF8ivcajXpQsXRC1cW9z8x875J041rClAjV7EGbLmudVpPX\r\n\t4hHst1XPyX5wmgdHIhmUuh8oZKpVqGi6bHGzzf7g=\r\nFrom: [email protected]\r\nTo: [email protected]\r\nSubject: Example subject\r\nMIME-Version: 1.0\r\nContent-Type: text/plain; charset=UTF-8\r\nContent-Transfer-Encoding: 7bit\r\nDate: Fri, 11 Sep 2015 20:32:32 +0000\r\nMessage-ID: <[email protected]>\r\nX-SES-Outgoing: 2015.09.11-54.240.9.183\r\nFeedback-ID: 1.us-east-1.Krv2FKpFdWV+KUYw3Qd6wcpPJ4Sv/pOPpEPSHn2u2o4=:AmazonSES\r\n\r\nExample content\r\n"}

Notificación de alertaEsta sección contiene un ejemplo de notificación de Amazon SNS que se puede activar mediante unaacción de S3. Las notificaciones activadas por acciones de Lambda, acciones de rebote, acciones dedetención y acciones de WorkMail son similares. Aunque la notificación contiene información sobre elcorreo electrónico, no incluye el contenido del propio correo electrónico.

{"notificationType": "Received","receipt": {"timestamp": "2015-09-11T20:32:33.936Z","processingTimeMillis": 406,"recipients": [ "[email protected]"],"spamVerdict": { "status": "PASS"},"virusVerdict": { "status": "PASS"},"spfVerdict": { "status": "PASS"},"dkimVerdict": { "status": "PASS"},"action": { "type": "S3", "topicArn": "arn:aws:sns:us-east-1:012345678912:example-topic", "bucketName": "my-S3-bucket", "objectKey": "\email"}},"mail": {"timestamp": "2015-09-11T20:32:33.936Z","source": "0000014fbe1c09cf-7cb9f704-7531-4e53-89a1-5fa9744f5eb6-000000@amazonses.com","messageId": "d6iitobk75ur44p8kdnnp7g2n800","destination": [ "[email protected]"],"headersTruncated": false,

221


"headers": [ { "name": "Return-Path", "value": "<0000014fbe1c09cf-7cb9f704-7531-4e53-89a1-5fa9744f5eb6-000000@amazonses.com>" }, { "name": "Received", "value": "from a9-183.smtp-out.amazonses.com (a9-183.smtp-out.amazonses.com [54.240.9.183]) by inbound-smtp.us-east-1.amazonaws.com with SMTP id d6iitobk75ur44p8kdnnp7g2n800 for [email protected]; Fri, 11 Sep 2015 20:32:33 +0000 (UTC)" }, { "name": "DKIM-Signature", "value": "v=1; a=rsa-sha256; q=dns/txt; c=relaxed/simple; s=ug7nbtf4gccmlpwj322ax3p6ow6yfsug; d=amazonses.com; t=1442003552; h=From:To:Subject:MIME-Version:Content-Type:Content-Transfer-Encoding:Date:Message-ID:Feedback-ID; bh=DWr3IOmYWoXCA9ARqGC/UaODfghffiwFNRIb2Mckyt4=; b=p4ukUDSFqhqiub+zPR0DW1kp7oJZakrzupr6LBe6sUuvqpBkig56UzUwc29rFbJF hlX3Ov7DeYVNoN38stqwsF8ivcajXpQsXRC1cW9z8x875J041rClAjV7EGbLmudVpPX 4hHst1XPyX5wmgdHIhmUuh8oZKpVqGi6bHGzzf7g=" }, { "name": "From", "value": "[email protected]" }, { "name": "To", "value": "[email protected]" }, { "name": "Subject", "value": "Example subject" }, { "name": "MIME-Version", "value": "1.0" }, { "name": "Content-Type", "value": "text/plain; charset=UTF-8" }, { "name": "Content-Transfer-Encoding", "value": "7bit" }, { "name": "Date", "value": "Fri, 11 Sep 2015 20:32:32 +0000" }, { "name": "Message-ID", "value": "<[email protected]>" }, { "name": "X-SES-Outgoing", "value": "2015.09.11-54.240.9.183" }, { "name": "Feedback-ID", "value": "1.us-east-1.Krv2FKpFdWV+KUYw3Qd6wcpPJ4Sv/pOPpEPSHn2u2o4=:AmazonSES" }],"commonHeaders": { "returnPath": "0000014fbe1c09cf-7cb9f704-7531-4e53-89a1-5fa9744f5eb6-000000@amazonses.com",

222


"from": [ "[email protected]" ], "date": "Fri, 11 Sep 2015 20:32:32 +0000", "to": [ "[email protected]" ], "messageId": "<[email protected]>", "subject": "Example subject"}}}

223

Amazon Simple Email Service Developer GuideAdministración de conjuntos de configuración

Uso de conjuntos de configuración deAmazon SES

Los conjuntos de configuración son grupos de reglas que puede aplicar a los mensajes que envíe através de Amazon SES. Un conjunto de configuración se aplica a un correo electrónico incluyendo unareferencia al conjunto de configuración en los encabezados del correo electrónico. Cuando aplica unconjunto de configuración a un correo electrónico, todas las reglas de dicho conjunto de configuración seaplican al correo electrónico. Para obtener más información acerca de la especificación de conjuntos deconfiguración en los mensajes de correo electrónico, consulte Especificar un conjunto de configuración alenviar correo electrónico (p. 228).

Puede utilizar conjuntos de configuración para aplicar los siguientes tipos de reglas a sus mensajes decorreo electrónico:

• Publicación de eventos: Amazon SES puede realizar un seguimiento del número de eventos de envío,entrega, apertura, clic, rebote y reclamación por cada mensaje de correo electrónico que envíe. Puedeutilizar la publicación de eventos para enviar información sobre estos eventos a otros servicios de AWS.Por ejemplo, puede enviar sus métricas de correo electrónico a un destino de Amazon Kinesis DataFirehose y, a continuación, analizarlo mediante Amazon Kinesis Data Analytics. Como alternativa, puedeenviar información de rebotes y reclamaciones a Amazon SNS y recibir notificaciones de inmediatocuando se producen dichos eventos.

• Administración de grupos de IP: si alquila direcciones IP dedicadas para utilizarlas con Amazon SES,puede crear grupos de estas direcciones denominados grupos de IP dedicadas. A continuación, puedeasociar estos grupos de IP dedicadas con conjuntos de configuración. Un caso de uso común consisteen crear un conjunto de direcciones IP dedicadas para el envío de comunicaciones de marketing yotro para el envío de correos electrónicos de transacciones. Su reputación de remitente para correoselectrónicos de transacciones queda aislada de la de sus correos electrónicos de marketing.

Los conjuntos de configuración pueden contener uno, ambos o ninguno de estos tipos de reglas.

Para obtener más información sobre la gestión de conjuntos de configuración y sus componentesrelacionados, consulte los siguientes temas:

• Administración de conjuntos de configuración de Amazon SES (p. 224)• Administración de destinos de eventos de Amazon SES (p. 226)• Administración de grupos de IP (p. 227)

Administración de conjuntos de configuración deAmazon SES

Esta sección contiene procedimientos para ver una lista de sus conjuntos de configuración existentes, versus detalles y eliminar los conjuntos de configuración.

Visualizar una lista de conjuntos de configuraciónPuede utilizar la consola de Amazon SES o puede utilizar el API ListConfigurationSets para ver unalista de sus conjuntos de configuración.

224

Amazon Simple Email Service Developer GuideVisualización de los detalles de un conjunto de configuración

Para ver sus conjuntos de configuración utilizando la consola de Amazon SES


2. En el panel de navegación izquierdo, elija Configuration Sets.

En el panel de detalles, verá una lista de sus conjuntos de configuración.

Para obtener información sobre cómo utilizar el API ListConfigurationSets para enumerar susconjuntos de configuración, consulte el Amazon Simple Email Service API Reference.

Visualización de los detalles de un conjunto deconfiguraciónPuede utilizar la consola de Amazon SES para ver los detalles de un conjunto de configuración, o bien sepuede usar el API DescribeConfigurationSet para describir un conjunto de configuración.

Visualización de los detalles de un conjunto de configuración utilizando la consola de AmazonSES


2. En el panel de navegación izquierdo, elija Configuration Sets.3. En el panel de detalles, seleccione el icono de ampliación situado junto al conjunto de configuración.

Verá los detalles del conjunto de configuración.

Para obtener información sobre cómo utilizar el API DescribeConfigurationSet para describir unconjunto de configuración, consulte el Amazon Simple Email Service API Reference.

Eliminación de un conjunto de configuraciónPuede utilizar la consola de Amazon SES o el API DeleteConfigurationSet para eliminar un conjuntode configuración.

Para eliminar un conjunto de configuración utilizando la consola de Amazon SES


2. En el panel de navegación izquierdo, elija Configuration Sets.3. En el panel de detalles, elija el conjunto de configuración.4. En el menú Actions, elija Delete y, a continuación, confirme que desea eliminar el conjunto de

configuración.

Para obtener información sobre cómo utilizar el API DeleteConfigurationSet para eliminar unconjunto de configuración, consulte el Amazon Simple Email Service API Reference.

225



https://docs.aws.amazon.com/ses/latest/APIReference/API_ListConfigurationSets.html



https://docs.aws.amazon.com/ses/latest/APIReference/API_DescribeConfigurationSet.html



https://docs.aws.amazon.com/ses/latest/APIReference/API_DeleteConfigurationSet.html

Amazon Simple Email Service Developer GuideAdministración de destinos de eventos

Administración de destinos de eventos de AmazonSES

Los destinos de eventos le permiten publicar métricas de envío de correo electrónico, incluidos losnúmeros de envíos, entregas, aperturas, clic, rebotes y reclamaciones, a otros productos de AWS. Paraobtener más información sobre la publicación de eventos, consulte the section called “Uso del monitoreoutilizando la publicación de eventos” (p. 259).

Actualización de un destino de eventoPuede utilizar la consola de Amazon SES o el API UpdateConfigurationSetEventDestination paraactualizar un destino de evento.

Para actualizar un destino de evento (consola).


2. En el panel de navegación izquierdo, elija Configuration Sets.3. En la lista de conjuntos de configuración, elija el conjunto de configuración que contenga el destino de

evento que desee actualizar.4. En la lista Destination, a la derecha del destino que desea editar, elija el icono edit ( ).5. Edite los detalles del destino de evento y, a continuación, elija Save.6. Para salir de la página Edit Configuration Set, utilice el botón Atrás de su navegador.

Para obtener información sobre cómo utilizar el API UpdateConfigurationSetEventDestinationpara actualizar un destino de evento, consulte el Amazon Simple Email Service API Reference.

Eliminación de un destino de eventoPuede utilizar la consola de Amazon SES o el API DeleteConfigurationSetEventDestination paraeliminar un destino de evento.

Para eliminar un destino de evento (consola)



evento que desee eliminar.4. En la lista Destination, elija el icono delete ( ).5. Confirme que desea eliminar el conjunto de configuración.6. Para salir de la página Edit Configuration Set, utilice el botón Atrás de su navegador.

Para obtener información sobre cómo utilizar el API DeleteConfigurationSetEventDestinationpara eliminar un destino de evento, consulte el Amazon Simple Email Service API Reference.

Habilitar o deshabilitar un destino de eventosPuede utilizar la consola de Amazon SES o el API UpdateConfigurationSetEventDestination parahabilitar o deshabilitar un destino de evento.

226



https://docs.aws.amazon.com/ses/latest/APIReference/API_UpdateConfigurationSetEventDestination.html



https://docs.aws.amazon.com/ses/latest/APIReference/API_DeleteConfigurationSetEventDestination.html

Amazon Simple Email Service Developer GuideAdministración de grupos de IP

Para habilitar o deshabilitar un destino de evento (consola)



evento que desee habilitar o deshabilitar.4. En la lista Destination, a la derecha del destino que desea editar, elija el icono edit (el lápiz).5. Seleccione o cancele la selección de Enabled y, a continuación, elija Save.6. Para salir de la página Edit Configuration Set, utilice el botón Atrás de su navegador.

Para obtener información sobre cómo utilizar el API UpdateConfigurationSetEventDestinationpara habilitar o deshabilitar un destino de evento, consulte el Amazon Simple Email Service API Reference.

Administración de grupos de IPPuede utilizar grupos de IP para crear grupos de direcciones IP dedicadas para enviar determinados tiposde correo electrónico. También puede utilizar un grupo de direcciones IP que compartan todos los clientesde Amazon SES.

Asignación de un grupo de IP a un conjunto deconfiguración existentePuede utilizar la consola de Amazon SES para asociar un grupo de IP con un conjunto de configuraciónexistente.

Para asignar un grupo de IP a un conjunto de configuración


2. En el panel de navegación izquierdo, elija Configuration Sets.3. En la lista de conjuntos de configuración, elija el conjunto de configuración que desee asociar a un

grupo de IP.4. En la pestaña Sending IP pool, para Pool name, elija una de las siguientes opciones:

• Un grupo de IP dedicado específico: al seleccionar un conjunto de IP dedicado existente, loscorreos electrónicos que utilizan el conjunto de configuración se utilizan solo las direcciones IPdedicadas que perteneces a dicho grupo. Para ver los procedimientos para crear nuevos grupos deIP, consulte Creación de grupos de IP dedicadas (p. 172).

• ses-default-dedicated-pool: este grupo contiene todas las direcciones IP dedicadas para su cuentaque no pertenecen ya a un grupo de IP. Si envía un mensaje de correo electrónico utilizando unconjunto de configuración que no esté asociado a un grupo, el correo electrónico se envía desdeuna de las direcciones del grupo predeterminado.

• ses-shared-pool: este grupo contiene un conjunto grande de direcciones IP compartidas entretodos los clientes de Amazon SES. Esta opción puede resultar útil cuando necesita enviar correoelectrónico que no se ajusta a sus comportamientos de envío habituales.

Cuando haya terminado, elija Assign.

227






Amazon Simple Email Service Developer GuideModificación de asignaciones de grupo de IP

Modificación de asignaciones de grupo de IPTambién puede utilizar la consola de Amazon SES para asignar un grupo diferente a un conjunto deconfiguración que ya está asociado a un grupo. La asignación de un conjunto distinto de un conjunto deconfiguración sobrescribe la asociación anterior.

Para editar una asignación de grupo de IP


2. En el panel de navegación izquierdo, elija Configuration Sets.3. En la lista de conjuntos de configuración, elija el conjunto de configuración que desee modificar.4. En la pestaña Sending IP pool, en Assign an IP pool, elija el icono edit ( ).5. En Pool name, seleccione el conjunto que desea utilizar y, a continuación, elija Assign.

Especificar un conjunto de configuración al enviarcorreo electrónico

Para utilizar un conjunto de configuración al enviar un correo electrónico, debe transferir el nombre delmismo de los encabezados del correo electrónico. Todos los métodos de envío de correo electrónico deAmazon SES, incluidos la AWS CLI, los SDK de AWS y la interfaz de SMTP de Amazon SES (p. 74), lepermiten transferir un conjunto de configuración en los encabezados del correo electrónico que envíe.

Si utiliza la interfaz de SMTP (p. 74) o la operación de la API SendRawEmail, puede especificar unconjunto de configuración incluyendo el siguiente encabezado en su correo electrónico (sustituyendoConfigSet por el nombre del conjunto de configuración que desee utilizar):

X-SES-CONFIGURATION-SET: ConfigSet

Esta guía incluye ejemplos de código para enviar correo electrónico a través de Postfix, los SDK de AWS yla interfaz de SMTP de Amazon SES. Cada uno de estos ejemplos incluye un método para especificar unconjunto de configuración. Para ver los procedimientos paso a paso para enviar correos electrónicos queincluyen referencias a conjuntos de configuración, consulte lo siguiente:

• Integración de Amazon SES con Postfix (p. 88)• Enviar un correo electrónico a través de Amazon SES mediante un SDK de AWS (p. 30)• Enviar un correo electrónico a través de Amazon SES mediante SMTP (p. 20)

Puede encontrar más ejemplos de código en la sección Ejemplos de código de Amazon SES (p. 405).

Exportación de métricas de reputación de unconjunto de configuración a CloudWatch

Amazon SES exporta automáticamente la información sobre los porcentajes de rebotes y reclamacionesde toda su cuenta a Amazon CloudWatch. Puede utilizar estas métricas para crear alarmas en CloudWatcho para poner en pausa automáticamente el envío de correo electrónico mediante una función de Lambda.

228





/ses/latest/APIReference/API_SendRawEmail.html

Amazon Simple Email Service Developer GuideHabilitar la exportación de métricas de

reputación de un conjunto de configuración

También puede exportar las métricas de reputación de conjuntos de configuración individuales aCloudWatch. La exportación de los datos de reputación en el nivel de conjunto de configuración le ofrecemayor control sobre su reputación como remitente.

Esta sección incluye procedimientos para exportar los datos de reputación de conjuntos de configuraciónindividuales a CloudWatch mediante la API de Amazon SES.

Habilitar la exportación de métricas de reputación deun conjunto de configuraciónPara comenzar a exportar las métricas de reputación de un conjunto de configuración, use la operación deAPI UpdateConfigurationSetReputationMetricsEnabled. Para tener acceso a la API de AmazonSES, le recomendamos que use la AWS CLI o uno de los SDK de AWS.

En este procedimiento se presupone que la AWS CLI está instalada en su equipo y configuradacorrectamente. Para obtener más información acerca de cómo instalar y configurar el AWS CLI, consulte laGuía del usuario de AWS Command Line Interface.

Para habilitar la exportación de métricas de reputación de un conjunto de configuración

• En la línea de comandos, escriba el siguiente comando: aws ses update-configuration-set-reputation-metrics-enabled --configuration-set-name ConfigSet --enabled

Sustituya ConfigSet en el comando anterior por el nombre del conjunto de configuración para el quedesea empezar a exportar las métricas de reputación.

Deshabilitar la exportación de métricas de reputaciónde un conjunto de configuraciónTambién puede usar la operación de API UpdateConfigurationSetReputationMetricsEnabledpara deshabilitar la exportación de métricas de reputación de un conjunto de configuración.

Para deshabilitar la exportación de métricas de reputación de un conjunto de configuración

• En la línea de comandos, escriba el siguiente comando: aws ses update-configuration-set-reputation-metrics-enabled --configuration-set-name ConfigSet --no-enabled

Sustituya ConfigSet en el comando anterior por el nombre del conjunto de configuración para el quedesea deshabilitar la exportación de métricas de reputación.

229

https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html


Monitoreo de la actividad de envío deAmazon SES

Amazon SES ofrece métodos para monitorear la actividad de envío. Le recomendamos que implementeestos métodos para que pueda realizar un seguimiento de medidas importantes, como, por ejemplo, lastasas de rebotes, reclamaciones y rechazos de su cuenta. Unas tasas de rebotes y rechazos demasiadoaltas podrían comprometer su capacidad de enviar correos electrónicos utilizando Amazon SES.

También puede utilizar estos métodos para medir las tasas a la que los clientes se involucran conlos mensajes que envía. Por ejemplo, estas métricas de envío pueden ayudarle a identificar las tasasgenerales de mensajes abiertos y clickthrough.

Las métricas que puede medir utilizando Amazon SES se denominan eventos de envío de correoelectrónico. Los eventos de envío de correo electrónico que puede monitorear son:

• Sends (Envíos): la llamada a Amazon SES se realizó correctamente y Amazon SES intentará entregar elcorreo electrónico.

• Rejects (Rechazos): Amazon SES aceptó el correo electrónico, determinó que contenía un virus y lorechazó. Amazon SES no intentará entregar el correo electrónico al servidor de correo del destinatario.

• Rebotes: el servidor de correo del destinatario ha rechazado permanentemente el correo electrónico.Este evento se corresponde con rebotes permanentes. Los rebotes provisionales solo se incluyencuando Amazon SES no puede entregar el correo electrónico tras intentarlo durante un periodo detiempo.

• Complaints (Reclamaciones): el correo electrónico se ha entregado correctamente al destinatario. Eldestinatario marcó el correo electrónico como spam.

• Entregas: Amazon SES entregó correctamente el correo electrónico al servidor de correo deldestinatario.

• Abiertos: el destinatario recibió el mensaje y lo abrió en su cliente de correo electrónico.• Clics: el destinatario hizo clic en uno o varios enlaces incluidos en el correo electrónico.• Rendering Failures (Errores de representación): el correo electrónico no se ha enviado por un problema

de representación de la plantilla. Este tipo de evento solo se produce cuando se envía correo electrónicomediante las operaciones SendTemplatedEmail o SendBulkTemplatedEmail de la API. Este tipo deevento se puede producir cuando faltan datos en la plantilla o cuando los parámetros y los datos de laplantilla no coinciden.

Puede monitorear los eventos de envío de correo electrónico de varias maneras. El método que elijadependerá del tipo de evento que desee monitorear, la granularidad y el nivel de detalle con los quequiera monitorearlos y la ubicación en la que desea que Amazon SES publique los datos. Debe utilizarlas notificaciones de retroalimentación o la publicación de eventos para realizar un seguimiento de loseventos de rebotes y reclamaciones. También puede optar por utilizar varios métodos de monitoreo. Lascaracterísticas de cada método se indican en la siguiente tabla.

Método demonitoreo

Eventos quepuede monitorear

Cómo acceder alos datos

Nivel de detalle Grado de detalle

Consola deAmazon SES

Entregas yrechazos

Página SendingStatistics (p. 232)en la consola deAmazon SES

Recuento solo En toda la cuentade AWS

230

https://docs.aws.amazon.com/ses/latest/APIReference/API_SendTemplatedEmail.html

https://docs.aws.amazon.com/ses/latest/APIReference/API_SendBulkTemplatedEmail.html


Método demonitoreo




Consola deAmazon SES

Tasas de rebote yreclamaciones

Página ReputationDashboard (p. 350)en la consola deAmazon SES

Solo tarifascalculadas

En toda la cuentade AWS

API de AmazonSES

Entregas, rebotes,reclamaciones yrechazos

GetSendStatisticsOperación de laAPI


Consolade AmazonCloudWatch

Envíos, entregas,abiertos,clics, rebotes,reclamaciones yrechazos

CloudWatchconsole

Note

AlgunasmétricasnoaparecenenCloudWatchhastaque seproduceel eventoasociado.Porejemplo,lasmétricasderebotesnoaparecenenCloudWatchhasta querebote almenos unmensajede correoelectrónicoque hayaenviado.


Notificaciones deretroalimentación

Entregas, rebotesy reclamaciones

Notificación deAmazon SNS(entregas, rebotesy reclamaciones) ocorreo electrónico(solo rebotes yreclamaciones)

Detalles de cadaevento

En toda la cuentade AWS

231

Amazon Simple Email Service Developer GuideMonitoreo utilizando la consola

Método demonitoreo




Publicación deeventos

Envíos, entregas,abiertos,clics, rebotes,reclamaciones,rechazos y erroresde representación.

AmazonCloudWatch oAmazon KinesisData Firehose, opor notificación deAmazon SNS

Detalles de cadaevento

Detallado(basado encaracterísticas decorreo electrónicodefinibles por elusuario)

Note

Las métricas medidas por eventos de envío de correo electrónico pueden no alinearseperfectamente con sus límites de envío. Esta discrepancia puede ser causada por rebotes yrechazos de correo electrónico o utilizando simulador de bandeja de correo de Amazon SES.Para saber lo cerca que está de sus límites de envío, consulte Monitoreo de sus límites deenvío (p. 137).

Para obtener información acerca de cómo utilizar cada método de monitoreo, consulte los siguientestemas:

• Monitoreo de sus estadísticas de envío utilizando la consola de Amazon SES (p. 232)• Monitorear su reputación de remitente de Amazon SES (p. 350)• Monitoreo de sus estadísticas de uso utilizando el API de Amazon SES (p. 233)• Monitoreo utilizando notificaciones (p. 236)• Uso del monitoreo utilizando la publicación de eventos (p. 259)

Monitoreo de sus estadísticas de envío utilizando laconsola de Amazon SES

Puede monitorear el número de correos electrónicos enviados desde su cuenta, así como el número demensajes que se han rechazado, directamente desde la consola de Amazon SES. Las tasas de entrega yde rechazo para su cuenta se muestran en la página Sending Statistics.

Puede encontrar información sobre rebotes y reclamaciones en el panel de reputación. Para obtener másinformación, consulte Monitorear su reputación de remitente de Amazon SES (p. 350).

Para ver las métricas de entrega y rechazo


2. En el panel de navegación, elija Sending Statistics. Las estadísticas de uso se muestran en YourAmazon SES Metrics.

3. Para ver los datos de tendencias de cualquier métrica, haga doble clic en el gráfico correspondiente.Cuando hace doble clic en un gráfico, también puede cambiar el período de análisis.

232



Amazon Simple Email Service Developer GuideMonitorear utilizando el API

Monitoreo de sus estadísticas de uso utilizando elAPI de Amazon SES

El API de Amazon SES proporciona la operación GetSendStatistics, que devuelve información acercade su uso del servicio. Le recomendamos que compruebe las estadísticas de envío con regularidad, a finde que pueda realizar ajustes si es necesario.

Si llama a la operación GetSendStatistics, recibe una lista de puntos de datos que representan lasdos últimas semanas de su actividad de envío. Cada punto de datos de esta lista representa 15 minutos deactividad y contiene la siguiente información para ese periodo:

• El número de rebotes permanentes• El número de reclamaciones• El número de intentos de entrega (corresponde al número de correos electrónicos que haya enviado)• El número de intentos de envío rechazados• Una marca de tiempo para el período de análisis

Para obtener una descripción completa de la operación GetSendStatistics, consulte la Amazon SimpleEmail Service API Reference.

En esta sección encontrará los temas siguientes:

• the section called “Llamada a la operación del API GetSendStatistics utilizando la AWSCLI” (p. 233)

• the section called “Llamada a la operación GetSendStatistics mediante programación” (p. 233)

Llamada a la operación del APIGetSendStatistics utilizando la AWS CLILa forma más sencilla de llamar a la operación del API GetSendStatistics consiste en utilizar la AWSCommand Line Interface (AWS CLI).

Para llamar a la operación del API GetSendStatistics utilizando la AWS CLI

1. Si aún no lo ha hecho, descargue e instale la AWS CLI. Para obtener más información, consulte"Installing the AWS Command Line Interface" en la AWS Command Line Interface User Guide.

2. Si aún no lo ha hecho, configure la AWS CLI para utilizar sus credenciales de AWS. Para obtener másinformación, consulte "Configuring the AWS CLI" en la AWS Command Line Interface User Guide.

3. En la línea de comando, escriba aws ses get-send-statistics

Si la AWS CLI está configurada correctamente, verá una lista de estadísticas de envío en formatoJSON. Cada objeto JSON incluye estadísticas de envío agregadas para un período de 15 minutos.

Llamada a la operación GetSendStatisticsmediante programaciónTambién puede llamar a la operación GetSendStatistics utilizando los SDK de AWS. Esta secciónincluye ejemplos de código para los SDK de AWS para Go, PHP, Python y Ruby. Elija uno de lossiguientes enlaces para ver ejemplos de código para dicho lenguaje:

233

https://docs.aws.amazon.com/ses/latest/APIReference/GetSendStatistics.html

https://docs.aws.amazon.com/ses/latest/APIReference/GetSendStatistics.html



https://docs.aws.amazon.com/cli/latest/userguide/installing.html

https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html

Amazon Simple Email Service Developer GuideLlamada a la operación GetSendStatistics

mediante programación

• Ejemplo de código para el AWS SDK for Go (p. 234)• Ejemplo de código para el AWS SDK para PHP (p. 235)• Ejemplo de código para el AWS SDK for Python (Boto) (p. 235)• Ejemplo de código para el AWS SDK parar Ruby (p. 235)

Note

Estos ejemplos de código suponen que ha creado un archivo de credenciales compartidas deAWS que contiene su ID de clave de acceso de AWS y su clave de acceso secreta de AWSy su región de AWS preferida. Para obtener más información, consulte Crear un archivo decredenciales compartidas (p. 31).

Llamar a GetSendStatistics utilizando el AWS SDK for Gopackage main import ( "fmt" //go get github.com/aws/aws-sdk-go/... "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/ses" "github.com/aws/aws-sdk-go/aws/awserr") const ( // Replace us-west-2 with the AWS Region you're using for Amazon SES. AwsRegion = "us-west-2") func main() { // Create a new session and specify an AWS Region. sess, err := session.NewSession(&aws.Config{ Region:aws.String(AwsRegion)}, ) // Create an SES client in the session. svc := ses.New(sess) input := &ses.GetSendStatisticsInput{} result, err := svc.GetSendStatistics(input) // Display error messages if they occur. if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { default: fmt.Println(aerr.Error()) } } else { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) } return } fmt.Println(result)}

234

Amazon Simple Email Service Developer GuideLlamada a la operación GetSendStatistics

mediante programación

Llamar a GetSendStatistics utilizando el AWS SDK paraPHP<?php

// Replace path_to_sdk_inclusion with the path to the SDK as described in // http://docs.aws.amazon.com/aws-sdk-php/v3/guide/getting-started/basic-usage.htmldefine('REQUIRED_FILE','path_to_sdk_inclusion'); // Replace us-west-2 with the AWS Region you're using for Amazon SES.define('REGION','us-west-2');


use Aws\Ses\SesClient;


try { $result = $client->getSendStatistics([]); echo($result);} catch (Exception $e) { echo($e->getMessage()."\n");}

?>

Llamar a GetSendStatistics utilizando el AWS SDK forPython (Boto)import boto3 #pip install boto3import jsonfrom botocore.exceptions import ClientError

client = boto3.client('ses')

try: response = client.get_send_statistics()except ClientError as e: print(e.response['Error']['Message'])else: print(json.dumps(response, indent=4, sort_keys=True, default=str))

Llamar a GetSendStatistics utilizando el AWS SDK pararRubyrequire 'aws-sdk' # gem install aws-sdkrequire 'json'

# Replace us-west-2 with the AWS Region you're using for Amazon SES.awsregion = "us-west-2"


235

Amazon Simple Email Service Developer GuideMonitoreo utilizando notificaciones

begin

resp = ses.get_send_statistics({ }) puts JSON.pretty_generate(resp.to_h)

# If something goes wrong, display an error message.rescue Aws::SES::Errors::ServiceError => error puts error

end

Monitoreo utilizando notificaciones de Amazon SESPara poder enviar correo electrónico con Amazon SES, es necesario disponer de un sistema paraadministrar los rebotes y las reclamaciones. Amazon SES puede informarle de eventos de rebotes oreclamaciones de tres maneras: enviando un correo electrónico de notificación, notificando a un tema deAmazon SNS o publicando eventos de envío. Esta sección contiene información sobre cómo configurarAmazon SES para enviar determinados tipos de notificaciones, bien por correo electrónico o bien mediantela notificación a un tema de Amazon SNS. Para obtener más información sobre cómo publicar eventos deenvío, consulte Uso del monitoreo utilizando la publicación de eventos de Amazon SES (p. 259).

Puede configurar notificaciones utilizando la consola de Amazon SES o la API de Amazon SES.

Temas• Consideraciones importantes (p. 236)• Notificaciones de Amazon SES a través de correo electrónico (p. 237)• Notificaciones de Amazon SES a través de Amazon SNS (p. 239)

Consideraciones importantesHay que tener en cuenta varios puntos importantes al configurar Amazon SES para enviar notificaciones:

• Las notificaciones de correo electrónico y de Amazon SNS se aplican a identidades individuales(las direcciones de correo electrónico o los dominios verificados que se utilizan para enviar correoelectrónico). Cuando se habilitan las notificaciones para una identidad, Amazon SES solo envíanotificaciones para los mensajes de correo electrónico enviados desde dicha identidad, y únicamente enla región de AWS en la que se hayan configurado las notificaciones.

• Es necesario habilitar un método de recepción de notificaciones de rebotes o reclamaciones. Puedeenviar notificaciones al dominio o a la dirección de correo electrónico que generó el rebote o lareclamación, o a un tema de Amazon SNS. También puede utilizar la publicación de eventos (p. 259)para enviar notificaciones sobre distintos tipos de eventos (incluidos rebotes, reclamaciones, entregas,etc.) a un tema de Amazon SNS o un flujo de Kinesis Data Firehose.

Si no se configura uno de estos métodos de recepción de notificaciones de rebotes y reclamaciones,Amazon SES reenvía automáticamente las notificaciones de rebotes y reclamaciones a la direcciónReturn-Path (o la dirección Source, si no se ha especificado una dirección Return-Path) del mensajeque generó el evento de rebote o de reclamación, aunque se haya deshabilitado el reenvío deretroalimentación de correo electrónico.

Si deshabilita el reenvío de retroalimentación de correo electrónico y habilita la publicación de eventos,debe aplicar el conjunto de configuración que contiene la regla de publicación de eventos a todos losmensajes de correo electrónico que envíe. En esta situación, si no se utiliza el conjunto de configuración,

236

Amazon Simple Email Service Developer GuideNotificaciones a través de correo electrónico

Amazon SES reenvía automáticamente las notificaciones de rebotes y reclamaciones a la direcciónReturn-Path o Source del correo electrónico que generó el evento de rebote o reclamación.

• Si configura Amazon SES para enviar eventos de rebotes y reclamaciones utilizando varios métodos(como, por ejemplo, mediante el envío de notificaciones de correo electrónico o el uso de eventos deenvío), es posible que reciba más de una notificación para el mismo evento.

Notificaciones de Amazon SES a través de correoelectrónicoAmazon SES puede enviarle correo electrónico cuando reciba rebotes y reclamaciones mediante unproceso denominado reenvío de retroalimentación de correo electrónico.

Para poder enviar correo electrónico con Amazon SES, debe configurarlo para enviar las notificaciones derebotes y reclamaciones mediante uno de los siguientes métodos:

• Habilitando el reenvío de retroalimentación de correo electrónico. El procedimiento para configurar estetipo de notificación se incluye en esta sección.

• Enviando notificaciones a un tema de Amazon SNS. Para obtener más información, consulteNotificaciones de Amazon SES a través de Amazon SNS (p. 239).

• Publicando notificaciones de eventos. Para obtener más información, consulte Uso del monitoreoutilizando la publicación de eventos de Amazon SES (p. 259).

Important

Para conocer varios puntos importantes acerca de las notificaciones, consulte Monitoreoutilizando notificaciones de Amazon SES (p. 236).

Temas• Habilitar el reenvío de retroalimentación de correo electrónico (p. 237)• Deshabilitar el reenvío de retroalimentación de correo electrónico (p. 238)• Destino de reenvío de retroalimentación de correo electrónico (p. 239)

Habilitar el reenvío de retroalimentación de correo electrónicoEl reenvío de retroalimentación de correo electrónico está habilitado de forma predeterminada. Sianteriormente lo deshabilitó, puede habilitarlo siguiendo los procedimientos de esta sección.

Para habilitar el reenvío de rebotes y reclamaciones a través de correo electrónico utilizando laconsola de Amazon SES


2. En el panel de navegación, en Identity Management, elija Email Addresses si desea configurarnotificaciones de rebotes y reclamaciones para una dirección de correo electrónico o elija Domains sidesea configurar notificaciones de rebotes y reclamaciones para un dominio.

3. En la lista de direcciones de correo electrónico o dominios verificados, elija la dirección de correoelectrónico o el dominio en los que desea configurar las notificaciones de rebotes y reclamaciones.

4. En el panel de detalles de la derecha, expanda la sección Notifications.5. Elija Edit Configuration.6. En Email Feedback Forwarding, elija Enabled.

237



Amazon Simple Email Service Developer GuideNotificaciones a través de correo electrónico

Note

Los cambios que realice en esta página pueden tardar varios minutos en surtir efecto.

También puede habilitar las notificaciones de rebotes y reclamaciones a través de correo electrónicoutilizando la operación de API SetIdentityFeedbackForwardingEnabled.

Deshabilitar el reenvío de retroalimentación de correo electrónicoSi configura un método diferente para proporcionar notificaciones de rebotes y reclamaciones, puededeshabilitar el reenvío de retroalimentación de correo electrónico para no recibir varias notificacionescuando se produzca un evento de rebote o reclamación.

Para deshabilitar el reenvío de rebotes y reclamaciones a través de correo electrónico utilizando laconsola de Amazon SES


2. En el panel de navegación, en Identity Management, elija Email Addresses si desea configurarnotificaciones de rebotes y reclamaciones para una dirección de correo electrónico o elija Domains sidesea configurar notificaciones de rebotes y reclamaciones para un dominio.

3. En la lista de direcciones de correo electrónico o dominios verificados, elija la dirección de correoelectrónico o el dominio en los que desea configurar las notificaciones de rebotes y reclamaciones.

4. En el panel de detalles de la derecha, expanda la sección Notifications.5. Elija Edit Configuration.6. En Email Feedback Forwarding, elija Disabled.

Note

Debe configurar un método de recepción de notificaciones de rebotes y reclamacionespara poder enviar correo electrónico a través de Amazon SES. Si deshabilita el reenvíode retroalimentación de correo electrónico, debe habilitar las notificaciones enviadas porAmazon SNS o publicar eventos de rebotes y reclamaciones en un tema de Amazon SNSo un flujo de Kinesis Data Firehose mediante la publicación de eventos (p. 259). Si utilizala publicación de eventos, debe aplicar también el conjunto de configuración que contiene laregla de publicación de eventos a cada mensaje de correo electrónico que envíe. Si no seconfigura un método de recepción de notificaciones de rebotes y reclamaciones, AmazonSES reenvía automáticamente las notificaciones de retroalimentación por correo electrónicoa las direcciones que figuran en el campo Return-Path (o en el campo Source, si no seha especificado una dirección Return-Path) del mensaje que generó el evento de reboteo de reclamación. En esta situación, Amazon SES reenvía las notificaciones de rebotes yreclamaciones incluso si se han deshabilitado las notificaciones de retroalimentación decorreo electrónico.

7. Elija Save Config para guardar su configuración de notificación.

Note

Los cambios que realice en esta página podrían tardar varios minutos en surtir efecto.

También puede deshabilitar las notificaciones de rebotes y reclamaciones a través de correo electrónicoutilizando la operación de API SetIdentityFeedbackForwardingEnabled.

238

https://docs.aws.amazon.com/ses/latest/APIReference/API_SetIdentityFeedbackForwardingEnabled.html




Amazon Simple Email Service Developer GuideNotificaciones a través de Amazon SNS

Destino de reenvío de retroalimentación de correo electrónicoAl recibir notificaciones por correo electrónico, Amazon SES vuelve a escribir el encabezado From y leenvía la notificación. La dirección a la que Amazon SES reenvía la notificación depende de cómo hayaenviado el mensaje original.

Si ha utilizado la interfaz SMTP para enviar el mensaje, las notificaciones se remiten a la direcciónespecificada en el comando MAIL FROM, lo que invalida cualquier encabezado Return-Path: que hayaespecificado en SMTP DATA.

Si utilizó la operación de API SendEmail para enviar el mensaje, las notificaciones se entregan delsiguiente modo:

• Si especificó el parámetro ReturnPath opcional de SendEmail, entonces las notificaciones van a esadirección.

• De lo contrario, las notificaciones se envían a las direcciones especificadas en el parámetro Sourceobligatorio de SendEmail, que rellena el encabezado From del mensaje.

Si utilizó la operación de API SendRawEmail para enviar el mensaje, las notificaciones se entregan delsiguiente modo:

• Si ha especificado el parámetro Source opcional de SendRawEmail, entonces las notificaciones sedirigirán a esa dirección, invalidando cualquier encabezado Return-Path que se haya especificado en elmensaje sin procesar.

• De lo contrario, si se especificó el encabezado Return-Path en el mensaje sin procesar, lasnotificaciones se dirigirán a esa dirección.

• De lo contrario, las notificaciones se dirigirán a la dirección del encabezado From del mensaje sinprocesar.

Important

Independientemente de si se utiliza la interfaz SMTP, la API SendEmail o la APISendRawEmail, Amazon SES sobrescribe cualquier encabezado Return-Path que proporcione.

Notificaciones de Amazon SES a través de AmazonSNSPuede configurar Amazon SES para notificar a un tema de Amazon SNS cuando se reciban rebotes oreclamaciones, o cuando se entreguen mensajes de correo electrónico. Las notificaciones de AmazonSNS están en formato JavaScript Object Notation (JSON), lo que le permite procesarlas medianteprogramación.

Para poder enviar correo electrónico con Amazon SES, debe configurarlo para enviar las notificaciones derebotes y reclamaciones mediante uno de los siguientes métodos:

• Enviando notificaciones a un tema de Amazon SNS. El procedimiento para configurar este tipo denotificación se incluye en esta sección.

• Habilitando el reenvío de retroalimentación de correo electrónico. Para obtener más información,consulte Notificaciones de Amazon SES a través de correo electrónico (p. 237).

• Publicando notificaciones de eventos. Para obtener más información, consulte Uso del monitoreoutilizando la publicación de eventos de Amazon SES (p. 259).

239

http://www.json.org


Important

Consulte Monitoreo utilizando notificaciones de Amazon SES (p. 236) para obtener informaciónimportante sobre las notificaciones.

Temas• Configuración de notificaciones de Amazon SNS para Amazon SES (p. 240)• Contenido de notificación de Amazon SNS para Amazon SES (p. 242)• Ejemplos de notificación de Amazon SNS para Amazon SES (p. 252)

Configuración de notificaciones de Amazon SNS para AmazonSESAmazon SES puede informarle de sus rebotes, reclamaciones y entregas a través de Amazon SimpleNotification Service (Amazon SNS).

Puede configurar las notificaciones en la consola de Amazon SES o mediante la API de Amazon SES.

Temas de esta sección:• Requisitos previos (p. 240)• Configuración de notificaciones mediante la consola de Amazon SES (p. 240)• Configuración de notificaciones con la API de Amazon SES (p. 241)

Requisitos previos

Realice los pasos siguientes antes de configurar notificaciones de Amazon SNS en Amazon SES:

1. Cree un tema en Amazon SNS. Para obtener más información, consulte Create a Topic en la Guíapara desarrolladores de Amazon Simple Notification Service.

2. Suscriba al menos un punto de enlace al tema. Por ejemplo, si desea recibir notificaciones pormensaje de texto, suscriba un punto de enlace de SMS (es decir, un número de teléfono móvil)al tema. Para recibir notificaciones por correo electrónico, suscriba un punto de enlace de correoelectrónico (una dirección de correo electrónico) al tema.

Para obtener más información, consulte la sección que explica cómo suscribirse a un tema en la Guíapara desarrolladores de Amazon Simple Notification Service.

Configuración de notificaciones mediante la consola de Amazon SES

Para configurar notificaciones mediante la consola de Amazon SES

1. Abra la consola de Amazon SES en https://console.aws.amazon.com/ses/.2. En el panel de navegación izquierdo, en Identity Management, elija Domains o Email Addresses.3. En la lista de remitentes verificados, elija la dirección de correo electrónico o dominio para los que

desea configurar notificaciones.

Important

La configuración de notificaciones de dominio verificada se aplican a todos los correoselectrónicos enviados desde las direcciones de correo electrónico en dicho dominio exceptopara las direcciones de correo electrónico que también se han verificado.

4. En Notifications, elija Edit Configuration.

240

https://aws.amazon.com/sns






5. En SNS Topic Configuration, realice los siguientes cambios en la configuración del tema de AmazonSNS:

a. Elija los temas de Amazon SNS que desea utilizar para recibir notificaciones. Puede publicarvarias notificaciones de tipos de eventos en el mismo tema de Amazon SNS o en temas deAmazon SNS distintos.

Important

Los temas de Amazon SNS que utiliza para las notificaciones de rebotes, reclamacionesy entregas deben estar en la misma región de AWS en la que utiliza Amazon SES.Además, los temas que seleccione deben tener uno o varios puntos de enlace suscritos.Por ejemplo, si desea que las notificaciones se envíen a una dirección de correoelectrónico, debe suscribir un punto de enlace de correo electrónico al tema. Paraobtener más información, consulte la sección que explica cómo suscribirse a un tema enla Guía para desarrolladores de Amazon Simple Notification Service.

Si desea utilizar un tema de Amazon SNS que no sea de su propiedad, debe configurar su políticade AWS Identity and Access Management (IAM) para permitir la publicación desde el nombre derecurso de Amazon (ARN) del tema de Amazon SNS.

b. Si desea que las notificaciones de Amazon SNS contengan los encabezados originales de loscorreos electrónicos que transfiere a Amazon SES, elija Include original headers. Esta opciónsolo está disponible si ha asignado un tema de Amazon SNS al tipo de notificación asociado.Para obtener información sobre el contenido de los encabezados de correo electrónico originales,consulte el objeto mail en Contenido de notificación de Amazon SNS (p. 242).

6. Si elige temas de Amazon SNS tanto para rebotes como para reclamaciones, puede deshabilitarlas notificaciones por correo electrónico en su totalidad. Para deshabilitar las notificaciones porcorreo electrónico de rebotes y reclamaciones, en Email Feedback Forwarding, elija Disable. Lasnotificaciones de entregas solo están disponibles a través de Amazon SNS.

7. Elija Save Config. Los cambios que haya realizado en su configuración de notificaciones podríantardar varios minutos en surtir efecto.

Después de configurar sus ajustes, empezará a recibir notificaciones de rebotes, reclamaciones o entregaen sus temas de Amazon SNS. Estas notificaciones estarán en formato JavaScript Object Notation (JSON)y seguirán la estructura que se describe en Contenido de notificación de Amazon SNS (p. 242).

Se le cobrarán las tarifas estándar de Amazon SNS para notificaciones de rebotes, reclamaciones yentregas. Para obtener más información, consulte la Página de precios de Amazon SNS.

Note

Si un intento de publicar en su tema Amazon SNS devuelve un error porque el tema se haeliminado o su cuenta de AWS ya no tiene permisos para publicar, se eliminará la configuraciónde Amazon SES; para ese tema para la identidad de envío, las notificaciones de rebote y dereclamaciones a través de correo electrónico se volverán a habilitar para dicha identidad y sele notificará el cambio a través de correo electrónico. Si tiene varias identidades configuradaspara utilizar dicho tema, se cambiará la configuración de tema de cada identidad cuando cadaidentidad experimenta un error a la hora de publicar en dicho tema.

Configuración de notificaciones con la API de Amazon SES

También puede configurar notificaciones de rebotes, reclamaciones y entregas con la API de AmazonSES. Utilice las siguientes operaciones para configurar las notificaciones:

• SetIdentityNotificationTopic• SetIdentityFeedbackForwardingEnabled• GetIdentityNotificationAttributes

241


https://docs.aws.amazon.com/IAM/latest/UserGuide/AccessPolicyLanguage.html

https://docs.aws.amazon.com/IAM/latest/UserGuide/AccessPolicyLanguage.html

http://www.json.org

https://aws.amazon.com/sns/pricing





• SetIdentityHeadersInNotificationsEnabled

Puede utilizar estas acciones del API para escribir una aplicación front-end personalizada paranotificaciones. Para obtener una descripción completa de las acciones del API relacionadas connotificaciones, consulte la Amazon Simple Email Service API Reference.

Contenido de notificación de Amazon SNS para Amazon SESLas notificaciones de rebotes, reclamaciones y entregas se publican en temas de Amazon SimpleNotification Service (Amazon SNS) en formato JavaScript Object Notation (JSON). El objeto JSON denivel superior contiene una cadena notificationType, un objeto mail y un objeto bounce, un objetocomplaint o un objeto delivery.

Consulte las secciones siguientes para las descripciones de los diferentes tipos de objetos:

• Objeto JSON de nivel superior (p. 242)• mail objeto (p. 243)• bounce objeto (p. 245)• complaint objeto (p. 250)• Objeto delivery (p. 252)

A continuación se muestran algunas notas importantes sobre el contenido de las notificaciones de AmazonSNS para Amazon SES:

• Para un tipo de notificación determinado, es posible que reciba una notificación de Amazon SNS paravarios destinatarios o puede recibir una sola notificación de Amazon SNS por destinatario. El códigodebe ser capaz de analizar la notificación de Amazon SNS y gestionar ambos casos; Amazon SES norealizar pedidos o garantías de lotes para las notificaciones enviadas a través de Amazon SNS. Sinembargo, distintos tipos de notificación de Amazon SNS (por ejemplo, rebotes y reclamaciones) nuncase combinan en una sola notificación.

• Podría recibir varios tipos de notificaciones de Amazon SNS para un destinatario. Por ejemplo, elservidor de correo electrónico receptor podría aceptar el correo electrónico (activando una notificaciónde entrega), pero después de procesar el correo electrónico, el servidor de correo electrónico receptorpodría determinar que el correo electrónico da lugar en realidad a un rebote (desencadenando unanotificación de rebote). Sin embargo, estas notificaciones siempre son independientes, ya que son tiposde notificación distintos.

• Amazon SES se reserva el derecho de añadir campos adicionales a las notificaciones. Por tanto,las aplicaciones que analizan estas notificaciones deben ser lo suficientemente flexibles como paragestionar campos desconocidos.

• Amazon SES sobrescribe los encabezados del mensaje cuando envía el correo electrónico. Puederecuperar los encabezados del mensaje original desde los campos headers y commonHeaders delobjeto mail.

Objeto JSON de nivel superior

El objeto JSON de nivel superior en una notificación Amazon SES contiene los siguientes campos.


notificationType Una cadena que contiene el tipo de notificaciónrepresentado por el objeto JSON. Los valoresposibles son Bounce, Complaint o Delivery.

242

https://docs.aws.amazon.com/ses/latest/APIReference/API_SetIdentityHeadersInNotificationsEnabled.html






mail Un objeto JSON que contiene información sobreel correo original al que pertenece la notificación.Para obtener más información, consulte ObjetoMail (p. 243).

bounce Este campo está presente solo sinotificationType es Bounce y contiene unobjeto JSON que mantiene información sobre elrebote. Para obtener más información, consulteObjeto Bounce (p. 245).

complaint Este campo está presente solo sinotificationType es Complaint y contieneun objeto JSON que mantiene información sobrela reclamación. Para obtener más información,consulte Objeto Complaint (p. 250).

delivery Este campo está presente solo sinotificationType es Delivery y contiene unobjeto JSON que mantiene información sobre laentrega. Para obtener más información, consulteObjeto Delivery (p. 252).

Objeto Mail

Cada notificación de rebote, reclamación o entrega contiene información sobre el correo electrónicooriginal en el objeto mail. El objeto JSON que contiene información acerca de un objeto mail tiene loscampos siguientes.


timestamp La hora a la que se ha enviado el mensaje original(en formato ISO8601).

messageId Un identificador exclusivo que Amazon SES asignóal mensaje. Amazon SES le devolvió este valorcuando usted envió el mensaje.

Note

Este ID de mensaje lo asignó AmazonSES. Puede encontrar el ID de mensajedel correo electrónico original en loscampos headers y commonHeaders delobjeto mail.

source La dirección de correo electrónico desde la que seenvió el mensaje original (la dirección MAIL FROMdel sobre).

sourceArn El nombre de recurso de Amazon (ARN) de laidentidad que se utilizó para enviar el correoelectrónico. En el caso de una autorización deenvío, el sourceArn es el ARN de la identidadde que el propietario de la identidad autorizó

243


Nombre del campo Descripciónutilizar al remitente delegado para enviar el correoelectrónico. Para obtener más información acercade la autorización de envío, consulte Uso deautorización de envío (p. 141).

sourceIp La dirección IP pública de origen del cliente querealizó la solicitud de envío de correo electrónico aAmazon SES.

sendingAccountId El ID de cuenta de AWS de la cuenta que se utilizópara enviar el correo electrónico. En el caso de laautorización de envío, el sendingAccountId esel ID de cuenta del remitente delegado.

destination Una lista de direcciones de correo electrónicoque han sido destinatarios del correo electrónicooriginal.

headersTruncated (Solo presente en caso de que la configuración denotificaciones (p. 240) incluya los encabezadosde correo electrónico originales). Una cadena queespecifica si los encabezados están truncados enla notificación, que se produce si los encabezadostienen un tamaño superior a 10 KB. Los posiblesvalores son true y false.

headers (Solo presente en caso de que la configuraciónde notificaciones incluya los encabezados decorreo electrónico originales). Una lista de losencabezados originales del correo electrónico.Cada encabezado de la lista tiene un campo namey un campo value.

Note

Cualquier ID de mensaje dentro delcampo headers procede del mensajeoriginal que transfirió a Amazon SES. ElID de mensaje que Amazon SES asignóseguidamente al mensaje está en elcampo messageId del objeto mail.

commonHeaders (Solo presente en caso de que la configuraciónde notificaciones incluya los encabezados decorreo electrónico originales). Una lista de losencabezados originales del correo electrónicoutilizados habitualmente. Cada encabezado de lalista tiene un campo name y un campo value.

Note

Cualquier ID de mensaje dentro delcampo commonHeaders procede delmensaje original que transfirió a AmazonSES. El ID de mensaje que Amazon SESasignó seguidamente al mensaje está enel campo messageId del objeto mail.

244


A continuación, se muestra un ejemplo de un objeto mail que incluye los encabezados de correoelectrónico originales. Cuando este tipo de notificación no está configurado para incluir los encabezadosde correo electrónico originales, el objeto mail no incluye los campos headersTruncated, headers ycommonHeaders.

{ "timestamp":"2016-01-27T14:05:45 +0000", "messageId":"000001378603177f-7a5433e7-8edb-42ae-af10-f0181f34d6ee-000000", "source":"[email protected]", "sourceArn": "arn:aws:ses:us-west-2:888888888888:identity/example.com", "sourceIp": "127.0.3.0", "sendingAccountId":"123456789012", "destination":[ "[email protected]" ], "headersTruncated":false, "headers":[ { "name":"From", "value":"\"John Doe\" <[email protected]>" }, { "name":"To", "value":"\"Jane Doe\" <[email protected]>" }, { "name":"Message-ID", "value":"custom-message-ID" }, { "name":"Subject", "value":"Hello" }, { "name":"Content-Type", "value":"text/plain; charset=\"UTF-8\"" }, { "name":"Content-Transfer-Encoding", "value":"base64" }, { "name":"Date", "value":"Wed, 27 Jan 2016 14:05:45 +0000" } ], "commonHeaders":{ "from":[ "John Doe <[email protected]>" ], "date":"Wed, 27 Jan 2016 14:05:45 +0000", "to":[ "Jane Doe <[email protected]>" ], "messageId":" custom-message-ID", "subject":"Hello" }}

Objeto Bounce

El objeto JSON que contiene información acerca de rebotes contiene los campos siguientes.

245



bounceType El tipo de rebote, tal como determina Amazon SES.Para obtener más información, consulte Tipos derebote (p. 247).

bounceSubType El subtipo de rebote, tal como determina AmazonSES. Para obtener más información, consulteTipos de rebote (p. 247).

bouncedRecipients Una lista que contiene información acerca de losdestinatarios del mensaje de correo electrónicooriginal que dio lugar a un rebote. Para obtenermás información, consulte Destinatarios conrebote (p. 247).

timestamp La fecha y la hora a la que se ha enviado el rebote(en formato ISO8601). Tenga en cuenta que setrata de la hora a la que el ISP envió la notificacióny no la hora a la que la recibió Amazon SES.

feedbackId Un identificador único para el rebote.

Si Amazon SES pudo ponerse en contacto con la autoridad de transferencia de mensajes (MTA) remota,también está presente el siguiente campo.


remoteMtaIp La dirección IP de la MTA al que Amazon SESintentó entregar el correo electrónico.

Si se adjunta una notificación de estado de entrega (DSN) al rebote, también está presente el siguientecampo.


reportingMTA El valor del campo Reporting-MTA del DSN. Setrata del valor de la autoridad de transferencia demensajes (MTA) que intentó realizar la operaciónde entrega, retransmisión o gateway descrita en elDSN.

A continuación se muestra un ejemplo de un objeto bounce.

{ "bounceType":"Permanent", "bounceSubType": "General", "bouncedRecipients":[ { "status":"5.0.0", "action":"failed", "diagnosticCode":"smtp; 550 user unknown", "emailAddress":"[email protected]" }, {

246


"status":"4.0.0", "action":"delayed", "emailAddress":"[email protected]" } ], "reportingMTA": "example.com", "timestamp":"2012-05-25T14:59:38.605Z", "feedbackId":"000001378603176d-5a4b5ad9-6f30-4198-a8c3-b1eb0c270a1d-000000", "remoteMtaIp":"127.0.2.0"}

Destinatarios con rebote

Una notificación de rebote podría pertenecer a un único destinatario o a varios destinatarios. El campobouncedRecipients aloja una lista de objetos (un objeto por destinatario a quien pertenece lanotificación de rebote) y siempre contiene el campo siguiente.


emailAddress La dirección de correo electrónico del destinatario.Si hay un DSN disponible, se trata del valor delcampo Final-Recipient del DSN.

Opcionalmente, si hay un DSN adjunto al rebote, los siguientes campos también podrían estar presentes.


action El valor del campo Action del DSN. Esto indicala acción que realiza el Reporting-MTA comoresultado de su intento de entregar el mensaje aeste destinatario.

status El valor del campo Status del DSN. Se trata delcódigo de estado independiente del transporte pordestinatario que indica el estado de entrega delmensaje.

diagnosticCode El código de estado emitido por la MTAde notificación. Este es el valor del campoDiagnostic-Code del DSN. Este campo puedeestar ausente en el DSN (y, por lo tanto, tambiénausente en el JSON).

A continuación se muestra un ejemplo de objeto que podría estar en la lista bouncedRecipients.

{ "emailAddress": "[email protected]", "action": "failed", "status": "5.0.0", "diagnosticCode": "X-Postfix; unknown user"}

Tipos de rebote

El objeto de rebote contiene un tipo de rebote Undetermined, Permanent o Transient. Los tipos derebote Permanent y Transient también pueden contener uno de varios subtipos de rebote.

247


Cuando reciba una notificación de rebote con un tipo Transient, es posible que pueda enviar correoelectrónico a ese destinatario en el futuro si se resuelve el problema que provocó el rebote del mensaje.

Cuando recibes una notificación de rebote con un tipo Permanent, es poco probable que pueda enviarcorreo electrónico a ese destinatario en el futuro. Por este motivo, debe quitar inmediatamente eldestinatario cuya dirección produjo el rebote de las listas de correo.

Note

Cuando se produce un rebote temporal (un rebote relacionado con un problema temporal, porejemplo, que se llene la bandeja de entrada del destinatario), Amazon SES intenta entregar denuevo el correo electrónico durante un determinado periodo de tiempo. Al final de ese periodo detiempo, si Amazon SES sigue sin poder entregar el correo electrónico, deja de intentarlo.Amazon SES ofrece notificaciones de los rebotes permanentes, así como de los rebotestemporales cuya entrega ha dejado de intentar.

bounceType bounceSubType Descripción

Undetermined Undetermined El proveedor de correo electrónico del destinatarioenvió un mensaje de rebote. El mensaje de reboteno contenía información suficiente para queAmazon SES determinara el motivo del rebote.El correo electrónico de rebote, que se envióa la dirección del encabezado Return-Path delcorreo electrónico que generó el rebote, podríacontener información adicional sobre el problemaque provocó que rebotara el correo electrónico.

Permanent General El proveedor de correo electrónico del destinatarioenvió un mensaje de rebote permanente, pero noespecificó el motivo de dicho rebote.

Important

Cuando reciba este tipo de notificaciónde rebote, debe quitar inmediatamentela dirección de correo electrónico deldestinatario de su lista de correo. El envíode mensajes a direcciones que producenrebotes permanentes puede tener unimpacto negativo en su reputación comoremitente. Si sigue enviando correoselectrónicos a direcciones que producenrebotes permanentes, podríamosdetener su capacidad para enviar correoelectrónico adicional.

Permanent NoEmail El proveedor de correo electrónico del destinatarioenvió un mensaje de rebote indicando que noexiste la dirección de correo electrónico.

Important

Cuando reciba este tipo de notificaciónde rebote, debe quitar inmediatamentela dirección de correo electrónico deldestinatario de su lista de correo. Elenvío de mensajes a direcciones que noexisten puede tener un impacto negativo

248


bounceType bounceSubType Descripciónen su reputación como remitente. Sisigue enviando correos electrónicos adirecciones que no existen, podríamosdetener su capacidad para enviar correoelectrónico adicional.

Permanent Suppressed La dirección de correo electrónico del destinatarioestá en la lista de supresión de Amazon SESporque tiene un historial reciente de generarrebotes permanentes. Para obtener informaciónacerca de cómo quitar una dirección de la lista desupresión de Amazon SES, consulte Eliminaciónde una dirección de correo electrónico de la lista desupresión de Amazon SES (p. 462).

Transient General El proveedor de correo electrónico del destinatarioenvió un mensaje de rebote general. Puede enviarun mensaje al mismo destinatario en el futuro si seresolviera el problema que provocó el rebote delmensaje.

Note

Si envía un correo electrónico a undestinatario que tiene una regla derespuesta automática activa (como, porejemplo, un mensaje de "fuera de laoficina"), es posible que reciba este tipode notificación. Aunque la respuestatiene un tipo de notificación de Bounce,Amazon SES no cuenta las respuestasautomáticas cuando calcula la tasa derebotes de su cuenta.

Transient MailboxFull El proveedor de correo electrónico del destinatarioenvió un mensaje de rebote porque la bandejade entrada del destinatario estaba llena. Podríarealizar el envío al mismo destinatario en el futurocuando la bandeja de entrada deje de estar llena.

Transient MessageTooLarge El proveedor de correo electrónico del destinatarioenvió un mensaje de rebote porque el mensajeenviado era demasiado grande. Podría enviar unmensaje al mismo destinatario si reduce el tamañodel mensaje.

Transient ContentRejected El proveedor de correo electrónico del destinatarioenvió un mensaje de rebote porque el mensajeenviado incluye contenido que el proveedor nopermite. Podría enviar un mensaje al mismodestinatario si cambia el contenido del mensaje.

249



Transient AttachmentRejected El proveedor de correo electrónico del destinatarioenvió un mensaje de rebote porque el mensajecontenía un archivo adjunto inaceptable.Por ejemplo, algunos proveedores de correoelectrónico pueden rechazar mensajes conarchivos adjuntos de un determinado tipo dearchivo o mensajes con archivos adjuntos muygrandes. Podría enviar un mensaje al mismodestinatario si quita o cambia el contenido delarchivo adjunto.

Objeto Complaint

El objeto JSON que contiene información acerca de reclamaciones tiene los campos siguientes.


complainedRecipients Una lista que contiene información sobredestinatarios que podrían haber sidoresponsables de la reclamación. Para obtenermás información, consulte Destinatarios conreclamaciones (p. 251).

timestamp La fecha y la hora a la que el ISP envió lanotificación de reclamación, en formato ISO 8601.La fecha y la hora de este campo podrían noser las mismas en que Amazon SES recibió lanotificación.

feedbackId Un ID único asociado con la reclamación.

Además, si se adjunta un informe de retroalimentación a la reclamación, podrían estar presentes lossiguientes campos.


userAgent El valor del campo User-Agent del informede retroalimentación. Esto indica el nombre y laversión del sistema que generó el informe.

complaintFeedbackType El valor del campo Feedback-Type del informede retroalimentación recibido desde el ISP.Contiene el tipo de retroalimentación.

arrivalDate El valor del campo Arrival-Date o Received-Date del informe de retroalimentación (en formatoISO8601). Este campo puede estar ausente enel informe (y, por lo tanto, también ausente en elJSON).

A continuación se muestra un ejemplo de un objeto complaint.

250


{ "userAgent":"AnyCompany Feedback Loop (V0.01)", "complainedRecipients":[ { "emailAddress":"[email protected]" } ], "complaintFeedbackType":"abuse", "arrivalDate":"2009-12-03T04:24:21.000-05:00", "timestamp":"2012-05-25T14:59:38.623Z", "feedbackId":"000001378603177f-18c07c78-fa81-4a58-9dd1-fedc3cb8f49a-000000"}

Destinatarios con reclamaciones

El campo complainedRecipients contiene una lista de destinatarios que podrían haber enviado lareclamación. Debe utilizar esta información para determinar qué destinatario envió la reclamación y, acontinuación, quitar inmediatamente a ese destinatario de sus listas de correo.

Important

La mayoría de los ISP eliminan la dirección de correo electrónico del destinatario que envió lareclamación de su notificación de reclamación. Por este motivo, esta lista contiene informaciónacerca de los destinatarios que podrían haber enviado la reclamación, en función de losdestinatarios del mensaje original y el ISP del que hemos recibido la reclamación. Amazon SESrealiza una búsqueda en el mensaje original para determinar esta lista de destinatarios.

Los objetos JSON de esta lista contienen el siguiente campo.


emailAddress La dirección de correo electrónico del destinatario.

A continuación se muestra un ejemplo de un objeto de destinatario con reclamación.

{ "emailAddress": "[email protected]" }

Note

Debido a este comportamiento, puede estar más seguro de que sabe qué dirección de correoelectrónico ha presentado una reclamación por su mensaje si limita el envío a un mensaje pordestinatario (en lugar de enviar un mensaje con 30 direcciones de correo electrónico distintas enla línea CCO).

Tipos de reclamación

Es posible que vea los siguientes tipos de reclamación en el campo complaintFeedbackType talcomo los ha asignado el ISP que realiza la notificación, de acuerdo con el sitio web de Internet AssignedNumbers Authority:

• abuse: indica correo electrónico no solicitado o algún otro tipo de abuso de correo electrónico.• auth-failure: informe de error de autenticación de correo electrónico.• fraud: indica algún tipo de fraude o actividad de phishing.

251

http://www.iana.org/assignments/marf-parameters/marf-parameters.xml#marf-parameters-2

http://www.iana.org/assignments/marf-parameters/marf-parameters.xml#marf-parameters-2


• not-spam: indica que la entidad que proporciona el informe no considera el mensaje como spam. Estose puede utilizar para corregir un mensaje que estaba mal etiquetado o clasificado como spam.

• other: indica cualquier otra retroalimentación que no encaje en otros tipos registrados.• virus: notifica que se ha encontrado un virus en el mensaje de origen.

Objeto DeliveryEl objeto JSON que contiene información sobre entregas tiene siempre los campos siguientes.


timestamp La hora a la que Amazon SES entregó el correoelectrónico al servidor de correo del destinatario(en formato ISO8601).

processingTimeMillis El tiempo en milisegundos desde el momento enque Amazon SES acepta la solicitud del remitentepara transferir el mensaje al servidor de correo deldestinatario.

recipients Una lista de sus destinatarios de los correoselectrónicos a los que corresponde la notificaciónde entrega.

smtpResponse El mensaje de respuesta SMTP del ISP remotoque ha aceptado el correo electrónico desdeAmazon SES. Este mensaje varía por correoelectrónico, por servidor de correo electrónico derecepción y por ISP de recepción.

reportingMTA El nombre de host del servidor de correo deAmazon SES que envió el mensaje de correoelectrónico.

remoteMtaIp La dirección IP de la MTA al que Amazon SESentregó el correo electrónico.

A continuación se muestra un ejemplo de un objeto delivery.

{ "timestamp":"2014-05-28T22:41:01.184Z", "processingTimeMillis":546, "recipients":["[email protected]"], "smtpResponse":"250 ok: Message 64111812 accepted", "reportingMTA":"a8-70.smtp-out.amazonses.com", "remoteMtaIp":"127.0.2.0"}

Ejemplos de notificación de Amazon SNS para Amazon SESEn las secciones siguientes se ofrecen ejemplos de los tres tipos de notificaciones:

• Para obtener ejemplos de notificaciones de rebote, consulte Ejemplos de notificación de rebote deAmazon SNS (p. 253).

• Para obtener ejemplos de notificaciones de reclamaciones, consulte Ejemplos de notificaciones dereclamaciones de Amazon SNS (p. 255).

252


• Para obtener ejemplos de notificaciones de entrega, consulte Ejemplo de notificación de entrega deAmazon SNS (p. 258).

Ejemplos de notificación de rebote de Amazon SNSEsta sección contiene ejemplos de notificaciones de rebote con y sin una notificación de estado de entrega(DSN) proporcionada por el receptor de correo electrónico que envió la retroalimentación.

Notificación de rebote con una DSN

A continuación, se muestra un ejemplo de una notificación de rebote que contiene una DSN y losencabezados de correo electrónico originales. Cuando las notificaciones de rebote no se configuran paraincluir los encabezados de correo electrónico originales, el objeto mail con las notificaciones no incluyelos campos headersTruncated, headers y commonHeaders.

{ "notificationType":"Bounce", "bounce":{ "bounceType":"Permanent", "reportingMTA":"dns; email.example.com", "bouncedRecipients":[ { "emailAddress":"[email protected]", "status":"5.1.1", "action":"failed", "diagnosticCode":"smtp; 550 5.1.1 <[email protected]>... User" } ], "bounceSubType":"General", "timestamp":"2016-01-27T14:59:38.237Z", "feedbackId":"00000138111222aa-33322211-cccc-cccc-cccc-ddddaaaa068a-000000", "remoteMtaIp":"127.0.2.0" }, "mail":{ "timestamp":"2016-01-27T14:59:38.237Z", "source":"[email protected]", "sourceArn": "arn:aws:ses:us-west-2:888888888888:identity/example.com", "sourceIp": "127.0.3.0", "sendingAccountId":"123456789012", "messageId":"00000138111222aa-33322211-cccc-cccc-cccc-ddddaaaa0680-000000", "destination":[ "[email protected]", "[email protected]", "[email protected]"], "headersTruncated":false, "headers":[ { "name":"From", "value":"\"John Doe\" <[email protected]>" }, { "name":"To", "value":"\"Jane Doe\" <[email protected]>, \"Mary Doe\" <[email protected]>, \"Richard Doe\" <[email protected]>" }, { "name":"Message-ID", "value":"custom-message-ID" }, { "name":"Subject", "value":"Hello" },

253


{ "name":"Content-Type", "value":"text/plain; charset=\"UTF-8\"" }, { "name":"Content-Transfer-Encoding", "value":"base64" }, { "name":"Date", "value":"Wed, 27 Jan 2016 14:05:45 +0000" } ], "commonHeaders":{ "from":[ "John Doe <[email protected]>" ], "date":"Wed, 27 Jan 2016 14:05:45 +0000", "to":[ "Jane Doe <[email protected]>, Mary Doe <[email protected]>, Richard Doe <[email protected]>" ], "messageId":"custom-message-ID", "subject":"Hello" } } }

Notificación de rebote sin una DSN

A continuación, se muestra un ejemplo de una notificación de rebote que incluye los encabezadosde correo electrónico originales pero no incluye una DSN. Cuando las notificaciones de rebote nose configuran para incluir los encabezados de correo electrónico originales, el objeto mail con lasnotificaciones no incluye los campos headersTruncated, headers y commonHeaders.

{ "notificationType":"Bounce", "bounce":{ "bounceType":"Permanent", "bounceSubType": "General", "bouncedRecipients":[ { "emailAddress":"[email protected]" }, { "emailAddress":"[email protected]" } ], "timestamp":"2016-01-27T14:59:38.237Z", "feedbackId":"00000137860315fd-869464a4-8680-4114-98d3-716fe35851f9-000000", "remoteMtaIp":"127.0.2.0" }, "mail":{ "timestamp":"2016-01-27T14:59:38.237Z", "messageId":"00000137860315fd-34208509-5b74-41f3-95c5-22c1edc3c924-000000", "source":"[email protected]", "sourceArn": "arn:aws:ses:us-west-2:888888888888:identity/example.com", "sourceIp": "127.0.3.0", "sendingAccountId":"123456789012", "destination":[ "[email protected]", "[email protected]", "[email protected]" ],

254


"headersTruncated":false, "headers":[ { "name":"From", "value":"\"John Doe\" <[email protected]>" }, { "name":"To", "value":"\"Jane Doe\" <[email protected]>, \"Mary Doe\" <[email protected]>, \"Richard Doe\" <[email protected]>" }, { "name":"Message-ID", "value":"custom-message-ID" }, { "name":"Subject", "value":"Hello" }, { "name":"Content-Type", "value":"text/plain; charset=\"UTF-8\"" }, { "name":"Content-Transfer-Encoding", "value":"base64" }, { "name":"Date", "value":"Wed, 27 Jan 2016 14:05:45 +0000" } ], "commonHeaders":{ "from":[ "John Doe <[email protected]>" ], "date":"Wed, 27 Jan 2016 14:05:45 +0000", "to":[ "Jane Doe <[email protected]>, Mary Doe <[email protected]>, Richard Doe <[email protected]>" ], "messageId":"custom-message-ID", "subject":"Hello" } } }

Ejemplos de notificaciones de reclamaciones de Amazon SNS

Esta sección contiene ejemplos de notificaciones de reclamaciones con y sin un informe deretroalimentación proporcionado por el receptor de correo electrónico que envió el comentario.

Notificación de reclamación con un informe de retroalimentación

A continuación, se muestra un ejemplo de una notificación de reclamación que contiene un informede retroalimentación y los encabezados de correo electrónico originales. Cuando las notificaciones dereclamación no se configuran para incluir los encabezados de correo electrónico originales, el objeto mailcon las notificaciones no incluye los campos headersTruncated, headers y commonHeaders.

{ "notificationType":"Complaint", "complaint":{ "userAgent":"AnyCompany Feedback Loop (V0.01)",

255


"complainedRecipients":[ { "emailAddress":"[email protected]" } ], "complaintFeedbackType":"abuse", "arrivalDate":"2016-01-27T14:59:38.237Z", "timestamp":"2016-01-27T14:59:38.237Z", "feedbackId":"000001378603177f-18c07c78-fa81-4a58-9dd1-fedc3cb8f49a-000000" }, "mail":{ "timestamp":"2016-01-27T14:59:38.237Z", "messageId":"000001378603177f-7a5433e7-8edb-42ae-af10-f0181f34d6ee-000000", "source":"[email protected]", "sourceArn": "arn:aws:ses:us-west-2:888888888888:identity/example.com", "sourceIp": "127.0.3.0", "sendingAccountId":"123456789012", "destination":[ "[email protected]", "[email protected]", "[email protected]" ], "headersTruncated":false, "headers":[ { "name":"From", "value":"\"John Doe\" <[email protected]>" }, { "name":"To", "value":"\"Jane Doe\" <[email protected]>, \"Mary Doe\" <[email protected]>, \"Richard Doe\" <[email protected]>" }, { "name":"Message-ID", "value":"custom-message-ID" }, { "name":"Subject", "value":"Hello" }, { "name":"Content-Type", "value":"text/plain; charset=\"UTF-8\"" }, { "name":"Content-Transfer-Encoding", "value":"base64" }, { "name":"Date", "value":"Wed, 27 Jan 2016 14:05:45 +0000" } ], "commonHeaders":{ "from":[ "John Doe <[email protected]>" ], "date":"Wed, 27 Jan 2016 14:05:45 +0000", "to":[ "Jane Doe <[email protected]>, Mary Doe <[email protected]>, Richard Doe <[email protected]>" ], "messageId":"custom-message-ID", "subject":"Hello" }

256


} }

Notificación de reclamación sin un informe de retroalimentación

A continuación, se muestra un ejemplo de una notificación de reclamación que incluye los encabezados decorreo electrónico originales, pero no incluye un informe de retroalimentación. Cuando las notificaciones dereclamación no se configuran para incluir los encabezados de correo electrónico originales, el objeto mailcon las notificaciones no incluye los campos headersTruncated, headers y commonHeaders.

{ "notificationType":"Complaint", "complaint":{ "complainedRecipients":[ { "emailAddress":"[email protected]" } ], "timestamp":"2016-01-27T14:59:38.237Z", "feedbackId":"0000013786031775-fea503bc-7497-49e1-881b-a0379bb037d3-000000" }, "mail":{ "timestamp":"2016-01-27T14:59:38.237Z", "messageId":"0000013786031775-163e3910-53eb-4c8e-a04a-f29debf88a84-000000", "source":"[email protected]", "sourceArn": "arn:aws:ses:us-west-2:888888888888:identity/example.com", "sourceIp": "127.0.3.0", "sendingAccountId":"123456789012", "destination":[ "[email protected]", "[email protected]", "[email protected]" ], "headersTruncated":false, "headers":[ { "name":"From", "value":"\"John Doe\" <[email protected]>" }, { "name":"To", "value":"\"Jane Doe\" <[email protected]>, \"Mary Doe\" <[email protected]>, \"Richard Doe\" <[email protected]>" }, { "name":"Message-ID", "value":"custom-message-ID" }, { "name":"Subject", "value":"Hello" }, { "name":"Content-Type", "value":"text/plain; charset=\"UTF-8\"" }, { "name":"Content-Transfer-Encoding", "value":"base64" }, { "name":"Date", "value":"Wed, 27 Jan 2016 14:05:45 +0000" }

257


], "commonHeaders":{ "from":[ "John Doe <[email protected]>" ], "date":"Wed, 27 Jan 2016 14:05:45 +0000", "to":[ "Jane Doe <[email protected]>, Mary Doe <[email protected]>, Richard Doe <[email protected]>" ], "messageId":"custom-message-ID", "subject":"Hello" } } }

Ejemplo de notificación de entrega de Amazon SNSA continuación, se muestra un ejemplo de una notificación de entrega que incluye los encabezadosde correo electrónico originales. Cuando las notificaciones de entrega no se configuran para incluir losencabezados de correo electrónico originales, el objeto mail con las notificaciones no incluye los camposheadersTruncated, headers y commonHeaders.

{ "notificationType":"Delivery", "mail":{ "timestamp":"2016-01-27T14:59:38.237Z", "messageId":"0000014644fe5ef6-9a483358-9170-4cb4-a269-f5dcdf415321-000000", "source":"[email protected]", "sourceArn": "arn:aws:ses:us-west-2:888888888888:identity/example.com", "sourceIp": "127.0.3.0", "sendingAccountId":"123456789012", "destination":[ "[email protected]" ], "headersTruncated":false, "headers":[ { "name":"From", "value":"\"John Doe\" <[email protected]>" }, { "name":"To", "value":"\"Jane Doe\" <[email protected]>" }, { "name":"Message-ID", "value":"custom-message-ID" }, { "name":"Subject", "value":"Hello" }, { "name":"Content-Type", "value":"text/plain; charset=\"UTF-8\"" }, { "name":"Content-Transfer-Encoding", "value":"base64" }, { "name":"Date", "value":"Wed, 27 Jan 2016 14:58:45 +0000"

258

Amazon Simple Email Service Developer GuideUso del monitoreo utilizando la publicación de eventos

} ], "commonHeaders":{ "from":[ "John Doe <[email protected]>" ], "date":"Wed, 27 Jan 2016 14:58:45 +0000", "to":[ "Jane Doe <[email protected]>" ], "messageId":"custom-message-ID", "subject":"Hello" } }, "delivery":{ "timestamp":"2016-01-27T14:59:38.237Z", "recipients":["[email protected]"], "processingTimeMillis":546, "reportingMTA":"a8-70.smtp-out.amazonses.com", "smtpResponse":"250 ok: Message 64111812 accepted", "remoteMtaIp":"127.0.2.0" } }

Uso del monitoreo utilizando la publicación deeventos de Amazon SES

Para habilitar el seguimiento del envío de correo electrónico a nivel granular, puede configurar AmazonSES para publicar eventos de envío de correo electrónico en Amazon CloudWatch o Amazon Kinesis DataFirehose en función de las características de correo electrónico detallado que defina. Por ejemplo, puedeclasificar los correos electrónicos por finalidad (transacciones frente a marketing), detalles del producto, eldominio ("From") del destinatario, etc.

Puede realizar un seguimiento de varios tipos de eventos de envío de correo electrónico, incluidos envíos,entregas, mensajes abiertos, clics, rebotes, reclamaciones y rechazos. Esta información puede resultar útilpara fines operativos y de análisis. Por ejemplo, puede publicar sus datos de envío de correo electrónicoa CloudWatch y crear paneles que realizan un seguimiento del rendimiento de sus campañas de correoelectrónico.

Cómo funciona la publicación de eventosPara utilizar la publicación de eventos, primero debe configurar uno o varios conjuntos de configuración.Un conjunto de configuración especifica dónde publicar los eventos y qué eventos publicar. A continuación,cada vez que envíe un correo electrónico, proporcione el nombre del conjunto de configuración y una ovarias etiquetas de mensajes, en forma de pares nombre/valor, para clasificar el correo electrónico. Porejemplo, si promociona libros, puede denominar una etiqueta del mensaje como género y asignarle unvalor de ciencia ficción o western, cuando envíe un correo electrónico para la campaña asociada. Enfunción de la interfaz de envío de correo electrónico que utilice, tendrá que proporcionar la etiqueta delmensaje como parámetro a la llamada al API o como encabezado de correo electrónico específico deAmazon SES. Para obtener más información acerca de los conjuntos de configuración, consulte Uso deconjuntos de configuración de Amazon SES (p. 224).

Además de las etiquetas de mensajes que especifique, Amazon SES también añade etiquetas automáticasa los mensajes que envía. No necesita realizar ningún paso adicional para utilizar etiquetas automáticas.

En la siguiente tabla se muestran las etiquetas automáticas que se aplican automáticamente a losmensajes que envía con Amazon SES.

259

Amazon Simple Email Service Developer GuideCómo utilizar la publicación de eventos

Etiquetas automáticas de Amazon SES

Nombre de etiqueta automática Descripción

ses:configuration-set El nombre del conjunto de configuración asociadoal correo electrónico.

ses:caller-identity La identidad de IAM del usuario de Amazon SESque ha enviado el correo electrónico.

ses:from-domain El dominio de la dirección del remitente ("From").

ses:source-ip La dirección IP que el intermediario utilizó paraenviar el correo electrónico.

ses:outgoing-ip La dirección IP que Amazon SES utilizó paraenviar el correo electrónico.

Cómo utilizar la publicación de eventosLas siguientes secciones contienen la información que tiene que configurar y utilizar la publicación deeventos de Amazon SES.

• Configuración de publicación de eventos (p. 261)• Trabajo con datos de eventos (p. 270)• Tutoriales (p. 308)

Terminología de publicación de eventosLa siguiente lista define términos relacionados con la publicación de eventos de Amazon SES.

Evento de envío de correo electrónico

La información asociada con el resultado de un correo electrónico que envía a Amazon SES. Loseventos de envío incluyen lo siguiente:• Sends (Envíos): la llamada a Amazon SES se realizó correctamente y Amazon SES intentará

entregar el correo electrónico.• Rejects (Rechazos): Amazon SES aceptó el correo electrónico, determinó que contenía un virus

y lo rechazó. Amazon SES no intentará entregar el correo electrónico al servidor de correo deldestinatario.

• Rebotes: el servidor de correo del destinatario ha rechazado permanentemente el correoelectrónico. Este evento se corresponde con rebotes permanentes. Los rebotes provisionales solose incluyen cuando Amazon SES no puede entregar el correo electrónico tras intentarlo durante unperiodo de tiempo.



• Abiertos: el destinatario recibió el mensaje y lo abrió en su cliente de correo electrónico.• Clics: el destinatario hizo clic en uno o varios enlaces incluidos en el correo electrónico.• Rendering Failures (Errores de representación): el correo electrónico no se ha enviado por un

problema de representación de la plantilla. Este tipo de evento solo se produce cuando se envíacorreo electrónico mediante las operaciones SendTemplatedEmail o SendBulkTemplatedEmail

260



Amazon Simple Email Service Developer GuideConfiguración de publicación de eventos

de la API. Este tipo de evento se puede producir cuando faltan datos en la plantilla o cuando losparámetros y los datos de la plantilla no coinciden.

Conjunto de configuración

Un constructo de Amazon SES que encapsula dónde desea publicar los eventos de envío de correoelectrónico y qué eventos de envío de correo electrónico desea publicar. Cuando envíe un correoelectrónico que desea utilizar con la publicación de eventos, especifique el conjunto de configuraciónque asociar con el correo electrónico.

Destino de eventos

Un constructo de Amazon SES que representa un servicio de AWS en el que publicar los eventos deenvío de correo electrónico de Amazon SES. Cada destino de evento que configure pertenece a uno ysolo a un conjunto de configuración.

Etiqueta de mensajes

Un par nombre/valor que utiliza para clasificar un correo electrónico para fines de publicación deeventos. Los ejemplos son campaña/libro y campaña/ropa. Cuando envíe un correo electrónico,especifica la etiqueta del mensaje como parámetro a la llamada al API o como encabezado de correoelectrónico específico de Amazon SES.

Etiqueta automática

Las etiquetas de mensajes que se incluyen automáticamente en informes de publicación de eventos.Hay una etiqueta automática para el nombre del conjunto de configuración, el dominio de la dirección"From", la dirección IP de salida del intermediario, la dirección IP saliente de Amazon SES y laidentidad de IAM del intermediario.

Configuración de publicación de eventos de AmazonSESEsta sección describe lo que debe hacer para configurar Amazon SES para publicar sus eventos de envíode correo electrónico en Amazon CloudWatch o Amazon Kinesis Data Firehose.

En primer lugar, cree un conjunto de configuración a través del API o de la consola de Amazon SES.Después de crear un conjunto de configuración, añada uno o varios destinos de eventos (CloudWatcho Kinesis Data Firehose) al conjunto de configuración y configure parámetros específicos del destinode evento. A continuación, cada vez que se envíe un correo electrónico, incluya el nombre del conjuntode configuración y las características de correo electrónico, denominadas etiquetas de mensajes, comoparámetros del API o encabezados específicos de Amazon SES en el correo electrónico.

Estos pasos se explican en los temas siguientes.

1. Paso 1: crear un conjunto de configuración (p. 261)2. Paso 2: Añadir un destino de evento (p. 262)3. Paso 3: enviar correo electrónico (p. 268)

Paso 1: crear un conjunto de configuración utilizando AmazonSESLos conjuntos de configuración le permiten publicar eventos de envío de correo electrónico (rebotes,reclamaciones, entregas, correos electrónicos enviados y correos electrónicos rechazados) para AmazonCloudWatch o Amazon Kinesis Data Firehose.

Puede utilizar la consola de Amazon SES o el API CreateConfigurationSet para crear un conjunto deconfiguración.

261


Para crear un conjunto de configuración (consola)


2. En el panel de navegación izquierdo, elija Configuration Sets.3. En el panel de contenido, elija Create Configuration Set.4. Escriba un nombre para el conjunto de configuración y, a continuación, elija Create Configuration Set.5. Seleccione la opción Close.

Para obtener información sobre cómo utilizar el API CreateConfigurationSet para crear un conjuntode configuración, consulte el Amazon Simple Email Service API Reference.

Paso 2: añadir un destino de evento utilizando Amazon SESLos destinos de evento representan servicios de AWS en los que publicar eventos de envío de correoelectrónico tales como rebotes, reclamaciones, entregas, correos electrónicos enviados y correoselectrónicos rechazados. Cada destino de evento que configure pertenece a uno y solo a un conjunto deconfiguración. Al configurar un destino de evento con Amazon SES, puede elegir el destino de servicio deAWS y especificar parámetros asociados a dicho destino.

Existen tres destinos de eventos: Amazon CloudWatch, Amazon Kinesis Data Firehose y Amazon SimpleNotification Service (Amazon SNS). El destino de evento que elija depende del nivel de detalle que deseasobre los eventos y la forma en la que desea recibir la información del evento. Si simplemente desea untotal acumulado de cada tipo de evento (por ejemplo, para poder configurar una alarma cuando el totalsea demasiado alto), utilice CloudWatch. Si desea registros de evento detallados que pueda enviar aotro servicio como Amazon Elasticsearch Service o Amazon Redshift para su análisis, elija Kinesis DataFirehose. Si desea recibir notificaciones cuando se producen determinados eventos, elija Amazon SNS.

Esta sección contiene los siguientes temas• Configuración de un destino de evento de CloudWatch para publicación de eventos de Amazon

SES (p. 262)• Configuración de un destino de evento de Kinesis Data Firehose para publicación de eventos de

Amazon SES (p. 265)• Configuración de un destino de evento de Amazon SNS para publicación de eventos de Amazon

SES (p. 267)

Configuración de un destino de evento de CloudWatch para publicación deeventos de Amazon SES

Puede utilizar destinos de eventos de Amazon CloudWatch para publicar eventos de envío de correoelectrónico de Amazon SES en CloudWatch. Dado que un destino de evento de CloudWatch existe dentrode un único conjunto de configuración, primero debe crear un conjunto de configuración (p. 261) y, acontinuación, añadir el destino de evento al conjunto de configuración.

Al añadir un destino de evento de CloudWatch a un conjunto de configuración, debe elegir una o variasdimensiones de CloudWatch que se correspondan con las etiquetas de mensaje que utiliza al enviar losmensajes de correo electrónico. Al igual que las etiquetas de mensajes, una dimensión de CloudWatch esun par de nombre-valor que le ayuda a identificar una métrica de forma inequívoca.

Por ejemplo, podría tener una etiqueta de mensajes y una dimensión denominada campaign que usapara identificar su campaña de correo electrónico. Cuando publique sus eventos de envío de correoelectrónico en CloudWatch, es importante elegir las etiquetas de mensajes y las dimensiones, ya que estasselecciones afectan a su facturación de CloudWatch y determinan cómo puede filtrar sus datos de eventode envío de correo electrónico en CloudWatch.

262



https://docs.aws.amazon.com/ses/latest/APIReference/API_CreateConfigurationSet.html


Esta sección proporciona información para ayudarle a elegir sus dimensiones y, a continuación, muestracómo añadir un destino de evento de CloudWatch a un conjunto de configuración.

Temas de esta sección• Añadir un destino de evento de CloudWatch (p. 263)• Selección de dimensiones de CloudWatch (p. 264)

Añadir un destino de evento de CloudWatch

El procedimiento de esta sección muestra cómo añadir un destino de evento de CloudWatch a un conjuntode configuración.

Puede utilizar la operación UpdateConfigurationSetEventDestination de la API para creardestinos de eventos. Para obtener más información sobre el uso de la API, consulte Amazon Simple EmailService API Reference.

Para añadir un destino de evento de CloudWatch a un conjunto de configuración (consola)


2. En el panel de navegación, elija Configuration Sets.3. En la lista de conjuntos de configuración, elija el conjunto de configuración para el que desea crear un

destino de eventos de CloudWatch. En primer lugar, cree un conjunto de configuración (p. 261).4. En la pestaña Event Destinations, para Add Destination, elija Select a destination type, seguido de

CloudWatch.5. En el cuadro de diálogo CloudWatch Destination, seleccione Enabled.6. En Name, escriba un nombre para el destino de evento.7. En Event types, seleccione los tipos de eventos que desea publicar en el destino de eventos. Están

disponibles los siguientes tipos de eventos:

• Sends (Envíos): la llamada a Amazon SES se realizó correctamente y Amazon SES intentaráentregar el correo electrónico.

• Rejects (Rechazos): Amazon SES aceptó el correo electrónico, determinó que contenía un virusy lo rechazó. Amazon SES no intentará entregar el correo electrónico al servidor de correo deldestinatario.





problema de representación de la plantilla. Este tipo de evento solo se produce cuando se envíacorreo electrónico mediante las operaciones SendTemplatedEmail o SendBulkTemplatedEmailde la API. Este tipo de evento se puede producir cuando faltan datos en la plantilla o cuando losparámetros y los datos de la plantilla no coinciden.

8. En Value Source (Origen de valor), especifique cómo obtendrá Amazon SES los datos que pasa aCloudWatch. Están disponibles los siguientes orígenes de valores:

263








• Message Tag (Etiqueta de mensaje): Amazon SES recupera el nombre de dimensión y el valor deuna etiqueta que especifica utilizando el encabezado X-SES-MESSAGE-TAGS o el parámetro dela API Tags. Para obtener más información acerca del uso de etiquetas de mensaje, consulte thesection called “Paso 3: enviar correo electrónico” (p. 268).

Note

Las etiquetas de mensaje pueden incluir los números del 0 al 9, las letras de la A a la Z(mayúsculas y minúsculas), guiones (-) y guiones bajos (_).

También puede utilizar el origen de valor Message Tag (Etiqueta de mensaje) para creardimensiones en función de etiquetas automáticas de Amazon SES. Para utilizar una etiquetaautomática, escriba el nombre completo de la etiqueta automática como Dimension Name (Nombrede dimensión). Por ejemplo, para crear una dimensión en función de la etiqueta automática delconjunto de configuración, utilice ses:configuration-set para el Dimension Name (Nombre dedimensión) y el nombre del conjunto de configuración para el Default Value (Valor predeterminado).Para obtener una lista completa de etiquetas automáticas, consulte Cómo funciona la publicación deeventos (p. 259).

• Email Header: Amazon SES recupera el nombre y el valor de la dimensión a partir de unencabezado del correo electrónico.

Note

No puede usar ninguno de los siguientes encabezados de correo electrónico comoDimension Name: Received, To, From, DKIM-Signature, CC, message-id o Return-Path.

• Link Tag: Amazon SES recupera el nombre y el valor de la dimensión a partir de una etiquetaespecificada en un enlace. Para obtener más información sobre cómo añadir etiquetas a losenlaces, consulte ¿Puedo etiquetar enlaces con identificadores únicos? (p. 499).

9. Para Dimension Name (Nombre de dimensión), escriba el nombre de la dimensión que deseatransferir a CloudWatch. Para Default Value (Valor predeterminado), escriba el valor de la dimensión.

Note

Los nombres y los valores de las dimensiones solo pueden contener las letras de la A a la Z,los números del 0 al 9, guiones bajos (_), signos de arroba (@), guiones (-) y puntos (.). Losespacios, los caracteres acentuados, los caracteres no latinos y otros caracteres especialesno están permitidos.

10. Si desea añadir más dimensiones, elija Add Dimension (Añadir dimensión). De lo contrario, seleccioneGuardar.

Selección de dimensiones de CloudWatch

Al elegir los nombres y los valores que va a utilizar como dimensiones de CloudWatch, tenga en cuenta losfactores siguientes:

• Precio por métrica: Puede ver métricas básicas de Amazon SES en CloudWatch de forma gratuita. Sinembargo, si recopila métricas a través de la publicación de eventos, debe crear métricas personalizadasen CloudWatch. Cada combinación exclusiva de tipo de evento, nombre de dimensión y valor dedimensión crea una métrica personalizada distinta en CloudWatch. Si utiliza CloudWatch, se lecobrará por cada métrica personalizada que cree. Por este motivo, es posible que desee evitar elegirdimensiones que puedan tener muchos valores diferentes. Por ejemplo, a menos que esté muyinteresado en el seguimiento de sus eventos de envío de correo electrónico desde el dominio deremitente ("From"), es posible que no desee definir una dimensión para la etiqueta automática AmazonSES ses:from-domain ya que puede tener muchos valores distintos. Para obtener más información,consulte Precios de CloudWatch.

264

https://aws.amazon.com/cloudwatch/pricing


• Filtrado de métricas: si una métrica tiene varias dimensiones, no se puede tener acceso a la métrica enCloudWatch en función de cada dimensión por separado. Por este motivo, piense detenidamente antesde añadir más de una dimensión a un único destino de evento de CloudWatch. Por ejemplo, si deseamétricas por campaign y por una combinación de campaign y genre, tiene que añadir dos destinos deevento: uno solo con campaign como dimensión y otro con campaign y genre como dimensiones.

• Origen de los valores de las dimensiones: como alternativa a especificar los valores de las dimensionesutilizando encabezados específicos de Amazon SES o un parámetro para la API, también puedeespecificar que Amazon SES tome los valores de las dimensiones de sus propios encabezadosde mensaje MIME. Podría utilizar esta opción si ya está utilizando encabezados personalizados yno desea cambiar sus mensajes de correo electrónico o sus llamadas al API de envío de correoelectrónico para recopilar métricas en función de los valores de encabezado. Si utiliza sus propiosencabezados de mensaje MIME para la publicación de eventos de Amazon SES, los nombres y losvalores de los encabezados con esta finalidad solo pueden incluir las letras de la A a la Z, los númerosdel 0 al 9, guiones bajos (_), signos arroba (@), guiones (-) y puntos (.). Si especifica un valor o unnombre que contenga otros caracteres, la llamada de envío de correo electrónico seguirá realizándosecorrectamente, pero las métricas de eventos no se enviarán a Amazon CloudWatch.

Para obtener más información sobre los conceptos de CloudWatch, consulte Amazon CloudWatchConcepts en la Guía del usuario de Amazon CloudWatch.

Configuración de un destino de evento de Kinesis Data Firehose para publicaciónde eventos de Amazon SESUn destino de evento de Amazon Kinesis Data Firehose representa una entidad que publica eventos deenvío de correo electrónico de Amazon SES específicos a Kinesis Data Firehose. Dado que un destinode evento de Kinesis Data Firehose existe dentro de un único conjunto de configuración, primero debecrear un conjunto de configuración (p. 261) y, a continuación, añadir el destino de evento al conjunto deconfiguración.

Puede utilizar la consola de Amazon SES o el API UpdateConfigurationSetEventDestination paraañadir un destino de evento de Kinesis Data Firehose.

Para añadir un destino de evento de Kinesis Data Firehose a un conjunto de configuración(consola)


2. En el panel de navegación izquierdo, elija Configuration Sets.3. Elija un conjunto de configuración de la lista de conjuntos de configuración. En primer lugar, cree un

conjunto de configuración (p. 261).4. Para Add Destination, elija Select a destination type y, a continuación, elija Kinesis Data Firehose.5. En Name, escriba un nombre para el destino de evento.6. Para Event types, seleccione al menos un tipo de evento que publicar en el destino de evento:





265

https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html

https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html







7. Seleccione Enabled.8. Para Stream, elija un flujo de entrega de Kinesis Data Firehose existente o elija Create new stream

para crear uno nuevo utilizando la consola de Kinesis Data Firehose.

Para obtener información acerca de la creación de un flujo utilizando la consola de KinesisData Firehose, consulte Creating an Amazon Kinesis Firehose Delivery Stream en la Guía paradesarrolladores de Amazon Kinesis Data Firehose.

9. Para IAM role, seleccione una función de IAM para la que Amazon SES tenga permiso para publicaren Kinesis Data Firehose en su nombre. Puede elegir una función existente, hacer que Amazon SEScree una función por usted o crear su propia función.

Si elige una función existente o crea su propia función, debe modificar manualmente las políticasde la función para concederle permiso para acceder al flujo de entrega de Kinesis Data Firehose ydar permiso a Amazon SES para asumir la función. Para ver ejemplos de políticas de , consulte Darpermiso a Amazon SES para publicar en su flujo de entrega de Kinesis Data Firehose (p. 266).

10. Seleccione Save.

Para obtener información sobre cómo utilizar el API UpdateConfigurationSetEventDestinationpara añadir un destino de evento de Kinesis Data Firehose, consulte el Amazon Simple Email Service APIReference.

Dar permiso a Amazon SES para publicar en su flujo de entrega de Kinesis Data Firehose

Para habilitar Amazon SES para publicar registros en su flujo de entrega de Kinesis Data Firehose, debeutilizar una función de AWS Identity and Access Management (IAM) y adjuntar o modificar la política depermisos y la política de confianza de la función. La política de permisos permite a la función publicarregistros en su flujo de entrega de Kinesis Data Firehose y la política de confianza permite a Amazon SESasumir la función.

En esta sección se proporcionan ejemplos de ambas políticas. Para obtener más información sobre cómoadjuntar políticas a funciones de IAM, consulte Modifying a Role en la Guía del usuario de IAM.

Política de permisos

La siguiente política de permisos habilita a la función para publicar registros de datos en su flujo de entregade Kinesis Data Firehose.

{ "Version": "2012-10-17", "Statement": [ { "Sid": "", "Effect": "Allow", "Action": [ "firehose:PutRecordBatch" ], "Resource": [ "arn:aws:firehose:region:ACCOUNT-ID:deliverystream/DELIVERY-STREAM-NAME "

266



https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html



https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html

https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_manage_modify.html


] }, ]}

Política de confianza

La siguiente política de confianza permite a Amazon SES asumir la función.

{ "Version": "2012-10-17", "Statement": [ { "Sid": "", "Effect": "Allow", "Principal": { "Service": "ses.amazonaws.com" }, "Action": "sts:AssumeRole", "Condition": { "StringEquals": { "sts:ExternalId": "ACCOUNT-ID" } } } ]}

Configuración de un destino de evento de Amazon SNS para publicación deeventos de Amazon SESUn destino de evento de Amazon Simple Notification Service le notifica acerca de eventos deenvío de correo electrónico específicos mediante Amazon SNS. Dado que un destino de evento deAmazon SNS existe dentro de un único conjunto de configuración, primero debe crear un conjunto deconfiguración (p. 261) y, a continuación, añadir el destino de evento al conjunto de configuración.

Puede utilizar la consola de Amazon SES o la operación del APIUpdateConfigurationSetEventDestination para añadir un destino de evento de Amazon SNS.

Note

También es posible recibir notificaciones a través de Amazon SNS en el nivel de cuenta. Estosignifica que puede recibir notificaciones de Amazon SNS cada vez que se produce un eventode envío en toda su cuenta de Amazon SES. Al utilizar la publicación de eventos en lugar de lasnotificaciones en el nivel de cuenta, puede configurar Amazon SES solo para enviar notificacionesacerca de tipos de eventos específicos o únicamente para correos electrónicos enviados através de un determinado conjunto de configuración. Para obtener más información acerca dela configuración de notificaciones de Amazon SNS en el nivel de cuenta, consulte Monitoreoutilizando notificaciones de Amazon SES (p. 236).

Para añadir un destino de evento de Amazon SNS a un conjunto de configuración

1. Si aún no lo ha hecho, cree un tema de Amazon SNS y suscríbase a él. Para obtener másinformación, consulte Introducción en la Guía para desarrolladores de Amazon Simple NotificationService.

2. Abra la consola de Amazon SES en https://console.aws.amazon.com/ses/.3. En el panel de navegación, elija Configuration Sets.4. Elija un conjunto de configuración de la lista de conjuntos de configuración. En primer lugar, cree un

conjunto de configuración (p. 261).

267

https://docs.aws.amazon.com/sns/latest/dg/GettingStarted.html



5. Para Add Destination, elija Select a destination type y, a continuación, elija SNS.6. En Name, escriba un nombre para el destino de evento.7. Para Event types, seleccione al menos un tipo de evento que publicar en el destino de evento:








8. Seleccione Enabled.9. Para Topic, elija un tema de Amazon SNS existente o elija Create new topic para crear uno nuevo.

Para obtener información acerca de la creación de un tema, consulte Creación de un tema en la Guíapara desarrolladores de Amazon Simple Notification Service.


Paso 3: enviar correo electrónico utilizando la publicación deeventos de Amazon SESDespués de crear un conjunto de configuración (p. 261) y añadir un evento de destino (p. 262), elúltimo paso para la publicación de eventos consiste en enviar sus mensajes de correo electrónico.

Para publicar eventos asociados con un correo electrónico, debe proporcionar el nombre del conjunto deconfiguración para asociar con el correo electrónico. Opcionalmente, puede proporcionar etiquetas demensaje para categorizar el correo electrónico.

Debería proporcionar esta información a Amazon SES como parámetros para el API de envío decorreo electrónico, encabezados de correo electrónico específicos de Amazon SES o encabezadospersonalizados en su mensaje de MIME. El método que elija depende de la interfaz de envío de correoelectrónico que utilice, tal y como se muestra en la siguiente tabla.

Interfaz de envío de correo electrónico Formas de publicar eventos

SendEmail Parámetros del API

SendRawEmail Parámetros del API, encabezados de correoelectrónico específicos de Amazon SES oencabezados MIME personalizados

268





Interfaz de envío de correo electrónico Formas de publicar eventos

Important

Si especifica etiquetas de mensajesutilizando ambos encabezados yparámetros del API, Amazon SESutiliza solo las etiquetas de mensajeproporcionadas por los parámetros delAPI. Amazon SES no une etiquetas demensajes especificadas por encabezadosy parámetros del API.

Interfaz de SMTP Encabezados de correo electrónico específicos deAmazon SES

En las secciones siguientes se describe cómo especificar el conjunto de configuración y las etiquetas demensajes utilizando encabezados y utilizando parámetros del API.

• Uso de parámetros del API de Amazon SES (p. 269)• Uso de encabezados de correo electrónico específicos de Amazon SES (p. 269)• Uso de encabezados de correo electrónico personalizados (p. 270)

Además, esta guía contiene varios ejemplos de código que demuestran cómo enviar correos electrónicosmediante programación utilizando Amazon SES. Cada uno de estos ejemplos de código incluye un métodode transferir un conjunto de configuración al enviar un correo electrónico. Para obtener más información,consulte Ejemplos de código de Amazon SES (p. 405).

Note

También puede incluir etiquetas de mensaje en los encabezados de los correos electrónicos. Lasetiquetas de mensaje pueden incluir los números del 0 al 9, las letras de la A a la Z (mayúsculas yminúsculas), guiones (-) y guiones bajos (_).

Uso de parámetros del API de Amazon SES

Para utilizar SendEmail o SendRawEmail con la publicación de eventos, se especifica el conjunto deconfiguración y las etiquetas de mensaje transfiriendo estructuras de datos denominadas ConfigurationSety MessageTag a la llamada a la API.

Para obtener más información sobre el uso del API de Amazon SES, consulte Amazon Simple EmailService API Reference.

Uso de encabezados de correo electrónico específicos de Amazon SES

Cuando utilice SendRawEmail o la interfaz de SMTP, puede especificar el conjunto de configuración y lasetiquetas de mensaje añadiendo encabezados específicos de Amazon SES al correo electrónico. AmazonSES elimina los encabezados antes de enviar el correo electrónico. En la siguiente tabla se muestran losnombres de los encabezados que utilizar.

Información de publicación de eventos Encabezado

Conjunto de configuración X-SES-CONFIGURATION-SET

Etiquetas de mensajes X-SES-MESSAGE-TAGS

269

https://docs.aws.amazon.com/ses/latest/APIReference/API_SendEmail.html

https://docs.aws.amazon.com/ses/latest/APIReference/API_SendRawEmail.html

https://docs.aws.amazon.com/ses/latest/APIReference/API_ConfigurationSet.html

https://docs.aws.amazon.com/ses/latest/APIReference/API_MessageTag.html



Amazon Simple Email Service Developer GuideTrabajo con datos de eventos

El siguiente ejemplo muestra el aspecto que podrían tener los encabezados en un correo electrónico sinprocesar que envíe a Amazon SES.

X-SES-MESSAGE-TAGS: tagName1=tagValue1, tagName2=tagValue2X-SES-CONFIGURATION-SET: myConfigurationSetFrom: [email protected]: [email protected]: SubjectContent-Type: multipart/alternative; boundary="----=_boundary"

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

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

body------=_boundary--

Uso de encabezados de correo electrónico personalizados

Aunque debe especificar el nombre del conjunto de configuración utilizando el encabezado específico deAmazon SES X-SES-CONFIGURATION-SET, puede especificar las etiquetas del mensaje utilizando suspropios encabezados MIME.

Note

Los nombres y valores de encabezado que utilice para la publicación de eventos de AmazonSES deben estar en ASCII. Si especifica un valor o nombre de encabezado no ASCII para lapublicación de eventos de Amazon SES, la llamada de envío de correo electrónico seguirárealizándose correctamente, pero las métricas del evento no se emitirán a Amazon CloudWatch.

Trabajo con datos de eventos de Amazon SESDespués de configurar la publicación de eventos (p. 261) y especificar un conjunto de configuraciónpara el envío de correos electrónicos, puede recuperar los eventos de envío de correo electrónico desdeel destino de eventos especificado al configurar el conjunto de configuración asociado con el correoelectrónico.

Esta sección describe cómo recuperar los eventos de envío de correo electrónico desde AmazonCloudWatch y Amazon Kinesis Data Firehose y cómo interpretar los datos de eventos proporcionados porAmazon SNS.

• Recuperación de datos de eventos de Amazon SES desde CloudWatch (p. 270)• Recuperación de datos de eventos de Amazon SES desde Kinesis Data Firehose (p. 272)• Interpretación de datos de eventos de Amazon SES desde Amazon SNS (p. 290)

Recuperación de datos de eventos de Amazon SES desdeCloudWatchAmazon SES puede publicar métricas para sus eventos de envío de correo electrónico a AmazonCloudWatch. Al publicar datos de eventos para CloudWatch, proporciona estas métricas como un conjuntoordenado de datos de series temporales. Puede utilizar estas métricas para monitorear el desempeño de

270


su envío de correo electrónico. Por ejemplo, puede monitorear la métrica de reclamaciones y estableceruna alarma de CloudWatch que se active cuando la métrica supere un determinado valor.

Hay dos niveles de granularidad a los que Amazon SES puede publicar estos eventos en CloudWatch:

• En su cuenta de AWS: estas métricas amplias, que corresponden a las métricas que monitorea conla consola de Amazon SES y el API GetSendStatistics son totales en toda su cuenta de AWS.Amazon SES publica estas métricas en CloudWatch automáticamente.

• Detalladas: estas métricas se clasifican por características de correo electrónico que define utilizandoetiquetas de mensajes. Para publicar estas métricas en CloudWatch, debe configurar la publicaciónde eventos (p. 261) con un destino de evento de CloudWatch y especificar un conjunto deconfiguración (p. 268) al enviar un correo electrónico. También puede especificar etiquetas demensajes o utilizar etiquetas automáticas (p. 259) que ofrece Amazon SES de forma automática.

En esta sección se describen las métricas disponibles y cómo ver las métricas en CloudWatch.

Métricas disponibles

Puede publicar las siguientes métricas de envío de correo electrónico de Amazon SES en CloudWatch:

• Sends (Envíos): la llamada a Amazon SES se realizó correctamente y Amazon SES intentará entregar elcorreo electrónico.

• Rejects (Rechazos): Amazon SES aceptó el correo electrónico, determinó que contenía un virus y lorechazó. Amazon SES no intentará entregar el correo electrónico al servidor de correo del destinatario.

• Rebotes: el servidor de correo del destinatario ha rechazado permanentemente el correo electrónico.Este evento se corresponde con rebotes permanentes. Los rebotes provisionales solo se incluyencuando Amazon SES no puede entregar el correo electrónico tras intentarlo durante un periodo detiempo.



• Abiertos: el destinatario recibió el mensaje y lo abrió en su cliente de correo electrónico.• Clics: el destinatario hizo clic en uno o varios enlaces incluidos en el correo electrónico.• Rendering Failures (Errores de representación): el correo electrónico no se ha enviado por un problema

de representación de la plantilla. Este tipo de evento solo se produce cuando se envía correo electrónicomediante las operaciones SendTemplatedEmail o SendBulkTemplatedEmail de la API. Este tipo deevento se puede producir cuando faltan datos en la plantilla o cuando los parámetros y los datos de laplantilla no coinciden.

Dimensiones disponibles

CloudWatch usa los nombres de dimensión que especifica cuando añade un evento de destino deCloudWatch a una configuración definida en Amazon SES. Para obtener más información, consulteConfiguración de un destino de evento de CloudWatch para publicación de eventos de AmazonSES (p. 262).

Visualización de métricas de Amazon SES en la consola de CloudWatch

El siguiente procedimiento describe cómo ver sus métricas de publicación de eventos de Amazon SESutilizando la consola de CloudWatch.

271




Para consultar las métricas mediante la consola de CloudWatch

1. Inicie sesión en la Consola de administración de AWS y abra la consola de CloudWatch en https://console.aws.amazon.com/cloudwatch/.

2. Si es necesario, cambie la región. En la barra de navegación, seleccione la región donde residen susrecursos de AWS. Para obtener más información, consulte Regiones y puntos de enlace.

3. En el panel de navegación, seleccione Metrics.4. En el panel All metrics, expanda AWS Namespaces y, a continuación, elija SES.5. Para ver las métricas en toda su cuenta de AWS, que Amazon SES publica automáticamente,

elija Account Sending Metrics. Para ver métricas de publicación de eventos (p. 259) detalladas,elija la combinación de dimensiones que ha especificado al configurar su destino de eventos deCloudWatch (p. 262).

6. Elija la métrica que desea ver.

El gráfico mostrará la métrica a lo largo del tiempo.

Para ver métricas mediante la CLI de AWS

• En el símbolo del sistema, ejecute el siguiente comando:

aws cloudwatch list-metrics --namespace "AWS/SES"

Recuperación de datos de eventos de Amazon SES desdeKinesis Data FirehoseAmazon SES publica los eventos de envío de correo electrónico a Kinesis Data Firehose como registrosJSON. Kinesis Data Firehose publica a continuación los registros en el destino en el servicio de AWS queeligió al configurar la transmisión de entrega en Kinesis Data Firehose. Para obtener información acercade cómo configurar las transmisiones de entrega de Kinesis Data Firehose, consulte Creating an AmazonKinesis Firehose Delivery Stream en la Guía para desarrolladores de Amazon Kinesis Data Firehose.

Para obtener ejemplos de cómo puede utilizar Kinesis Data Firehose para publicar sus eventos de envío decorreo electrónico en Amazon Redshift y Amazon Elasticsearch Service, consulte Tutoriales (p. 308).

Para obtener una descripción del contenido de registros y registros de ejemplo, consulte las seccionessiguientes.

• Contenido de registros de eventos (p. 272)• Ejemplos de registros de evento (p. 280)

Contenido de datos de eventos de Amazon SES publicados en Kinesis DataFirehose

Amazon SES publica los registros de eventos de envío de correo electrónico en Amazon Kinesis DataFirehose en formato JSON. Al publicar eventos en Kinesis Data Firehose Amazon SES sigue cada registroJSON con un carácter de nueva línea.

El objeto JSON de nivel superior contiene una cadena eventType, un objeto mail y un objeto bounce,complaint, delivery, send, reject, open o click, en función del tipo de evento.

Consulte las secciones siguientes para las descripciones de los diferentes tipos de objetos:

272

https://console.aws.amazon.com/cloudwatch/


https://docs.aws.amazon.com/general/latest/gr/rande.html




• Objeto JSON de nivel superior (p. 273)• mail objeto (p. 274)• bounce objeto (p. 275)• complaint objeto (p. 277)• delivery objeto (p. 279)• send objeto (p. 279)• reject objeto (p. 279)• open objeto (p. 280)• click objeto (p. 280)


El objeto JSON de nivel superior en un registro de eventos de envío de correo electrónico contiene lossiguientes campos.


eventType Una cadena que describe el tipo de evento.Valores posibles: Delivery, Send, Reject,Open, Click, Bounce, Complaint o RenderingFailure.

mail Un objeto JSON que contiene información acercadel mensaje de correo electrónico que produjo elevento.

bounce Este campo solo está presente si eventType esBounce. Contiene información sobre el rebote.

complaint Este campo solo está presente si eventTypees Complaint. Contiene información sobre lareclamación.

delivery Este campo solo está presente si eventType esDelivery. Contiene información sobre la entrega.

send Este campo solo está presente si eventType esSend.

reject Este campo solo está presente si eventType esReject. Contiene información sobre el rechazo.

open Este campo solo está presente si eventType esOpen. Contiene información sobre el evento deapertura.

click Este campo solo está presente si eventType esClick. Contiene información sobre el evento declic.

failure Este campo solo está presente si eventTypees Rendering Failure. Contiene informaciónsobre el evento de error de presentación.

273


Objeto Mail

Cada registro de evento de envío de correo electrónico contiene información acerca del correo electrónicooriginal en el objeto mail. El objeto JSON que contiene información acerca de un objeto mail tiene loscampos siguientes.


timestamp La fecha y la hora, en formato ISO8601 (AAAA-MM-DDThh:mm:ss.sZ), en la que se envió elmensaje.


Note


source La dirección de correo electrónico desde la quese envió el mensaje (la dirección MAIL FROM delsobre).

sourceArn El nombre de recurso de Amazon (ARN) de laidentidad que se utilizó para enviar el correoelectrónico. En el caso de una autorización deenvío, el sourceArn es el ARN de la identidadde que el propietario de la identidad autorizóutilizar al remitente delegado para enviar el correoelectrónico. Para obtener más información acercade la autorización de envío, consulte Uso deautorización de envío (p. 141).



headersTruncated Una cadena que especifica si los encabezadosestán truncados en la notificación, que se producesi los encabezados tienen un tamaño superior a 10KB. Los posibles valores son true y false.

headers Una lista de los encabezados originales del correoelectrónico. Cada encabezado de la lista tiene uncampo name y un campo value.

Note

Cualquier ID de mensaje dentro delcampo headers procede del mensaje

274


Nombre del campo Descripciónoriginal que transfirió a Amazon SES. ElID de mensaje que Amazon SES asignóseguidamente al mensaje está en elcampo messageId del objeto mail.

commonHeaders Una lista de los encabezados originales delcorreo electrónico utilizados habitualmente. Cadaencabezado de la lista tiene un campo name y uncampo value.

Note


Objeto Bounce

El objeto JSON que contiene información acerca de un evento Bounce tendrá siempre los campossiguientes.


bounceType El tipo de rebote, tal como determina Amazon SES.

bounceSubType El subtipo de rebote, tal como determina AmazonSES.

bouncedRecipients Una lista que contiene información acerca de losdestinatarios del mensaje de correo electrónicooriginal que dio lugar a un rebote.

timestamp La fecha y la hora, en formato ISO8601 (AAAA-MM-DDThh:mm:ss.sZ), a la que el ISP envió lanotificación de rebote.



Note

Este campo solo aparece si se haadjuntado una notificación de estado deentrega (DSN) al rebote.

275



Un evento de rebote podría pertenecer a un único destinatario o a varios destinatarios. El campobouncedRecipients aloja una lista de objetos (un objeto por destinatario a quien pertenece el evento derebote) y siempre contendrá el campo siguiente.





action El valor del campo Action del DSN. Esto indicala acción que realiza el MTA de notificación comoresultado de su intento de entregar el mensaje aeste destinatario.


diagnosticCode El código de estado emitido por la MTAde notificación. Este es el valor del campoDiagnostic-Code del DSN. Este campo puedeestar ausente en el DSN (y, por lo tanto, tambiénausente en el JSON).

Tipos de rebote

Cada evento se rebote será uno de los tipos que se muestra en la tabla siguiente.

El sistema de publicación de eventos solo publica rebotes permanentes y rebotes temporales que ya novolverá a intentar Amazon SES. Al recibir rebotes marcados Permanent, debería eliminar las direccionesde correo electrónico correspondientes de su lista de correo; no podrá enviar a las mismas en el futuro.Los rebotes Transient se le envían cuando un mensaje ha tenido rebote temporal varias veces yAmazon SES ha dejado de intentar volver a enviarlo. Es posible que en el futuro pueda volver a enviarcorrectamente a una dirección que inicialmente ha dado lugar a un rebote Transient.


Undetermined Undetermined Amazon SES no ha podido determinar un motivoespecífico de rebote.

Permanent General Amazon SES recibió un rebote permanentegeneral. Si recibe este tipo de rebote, deberíaeliminar la dirección de correo electrónico deldestinatario de su lista de correo.

Permanent NoEmail Amazon SES recibió un rebote permanente porquela dirección de correo electrónico de destino

276


bounceType bounceSubType Descripciónno existe. Si recibe este tipo de rebote, deberíaeliminar la dirección de correo electrónico deldestinatario de su lista de correo.

Permanent Suppressed Amazon SES ha suprimido el envío a estadirección dado que tiene un historial reciente derebotes como dirección no válida. Para obtenerinformación acerca de cómo eliminar una direcciónde la lista de supresión, consulte Eliminación deuna dirección de correo electrónico de la lista desupresión de Amazon SES (p. 462).

Transient General Amazon SES recibió un rebote general. Es posibleque pueda enviar correctamente a este destinatarioen el futuro.

Transient MailboxFull Amazon SES ha recibido un rebote completo debandeja de entrada. Es posible que pueda enviarcorrectamente a este destinatario en el futuro.

Transient MessageTooLarge Amazon SES recibe un rebote de mensajedemasiado grande. Es posible que pueda enviarcorrectamente a este destinatario si reduce eltamaño del mensaje.

Transient ContentRejected Amazon SES ha recibido un rebote de contenidorechazado. Es posible que pueda enviarcorrectamente a este destinatario si cambia elcontenido del mensaje.

Transient AttachmentRejected Amazon SES ha recibido un rebote de archivoadjunto rechazado. Es posible que pueda enviarcorrectamente a este destinatario si elimina ocambia el archivo adjunto.

Objeto Complaint

El objeto JSON que contiene información acerca de un evento Complaint tiene los campos siguientes.


complainedRecipients Una lista que contiene información sobredestinatarios que podrían haber enviado lareclamación.

timestamp La fecha y la hora, en formato ISO8601 (AAAA-MM-DDThh:mm:ss.sZ), a la que el ISP envió lanotificación de reclamación.

feedbackId Un identificador único para la reclamación.


277





arrivalDate El valor del campo Arrival-Date o Received-Date del informe de retroalimentación en formatoISO8601 (AAAA-MM-DDThh:mm:ss.sZ). Estecampo puede estar ausente en el informe (y, por lotanto, también ausente en el JSON).


El campo complainedRecipients contiene una lista de destinatarios que podrían haber enviado lareclamación.

Important

Dado que la mayoría de los ISP redactan la dirección de correo electrónico del destinatario quepresentó la reclamación desde su notificación de reclamación, esta lista contiene informaciónacerca de los destinatarios que podrían haber enviado la reclamación, en función de losdestinatarios del mensaje original y el ISP desde el que hemos recibido la reclamación. AmazonSES realiza una búsqueda en el mensaje original para determinar esta lista de destinatarios.







abuse Indica correo electrónico no solicitado o algún otrotipo de abuso de correo electrónico.

auth-failure Informe de error de autenticación de correoelectrónico.

fraud Indica algún tipo de fraude o actividad de phishing.

not-spam Indica que la entidad que proporciona el informe noconsidera el mensaje como spam. Esto se puedeutilizar para corregir un mensaje que estaba maletiquetado o clasificado como spam.

278

https://www.iana.org/assignments/marf-parameters/marf-parameters.xml#marf-parameters-2




other Indica cualquier otra retroalimentación que noencaje en otros tipos registrados.

virus Notifica que se ha encontrado un virus en elmensaje de origen.

Objeto Delivery

El objeto JSON que contiene información acerca de un evento Delivery tendrá siempre los campossiguientes.


timestamp La fecha y la hora en la que Amazon SES entregóel correo electrónico al servidor de correo deldestinatario, en formato ISO8601 (AAAA-MM-DDThh:mm:ss.sZ).

processingTimeMillis El tiempo en milisegundos desde el momento enque Amazon SES acepta la solicitud del remitenteal momento en que Amazon SES transfiere elmensaje al servidor de correo del destinatario.

recipients Una lista de los destinatarios a los quecorresponden los eventos de entrega.

smtpResponse El mensaje de respuesta SMTP del ISP remotoque ha aceptado el correo electrónico desdeAmazon SES. Este mensaje variará por correoelectrónico, por receptor de servidor de correoelectrónico y por ISP de recepción.


Objeto Send

El objeto JSON que contiene información acerca de un evento send está siempre vacío.

Objeto Reject

El objeto JSON que contiene información acerca de un evento Reject tendrá siempre los campossiguientes.


reason La razón por la que se rechazó el correoelectrónico. El único valor posible es Badcontent, lo que significa que Amazon SESdetectó que el correo electrónico contenía un virus.Cuando se rechaza un mensaje, Amazon SESdetiene su procesamiento y no intenta entregarlo alservidor de correo del destinatario.

279


Objeto Open

El objeto JSON que contiene información acerca de un evento Open contendrá siempre los campossiguientes.


ipAddress La dirección IP del destinatario.

timestamp La fecha y la hora en la que se produjo el eventode apertura del correo electrónico, en formatoISO8601 (AAAA-MM-DDThh:mm:ss.sZ).

userAgent El agente del usuario del dispositivo o cliente decorreo electrónico que el destinatario utiliza paraabrir el correo electrónico.

Objeto Click

El objeto JSON que contiene información acerca de un evento Click contendrá siempre los campossiguientes.



timestamp La fecha y la hora en la que se produjo elevento de clic, en formato ISO8601 (AAAA-MM-DDThh:mm:ss.sZ).

userAgent El agente del usuario del cliente que el destinatariousó para hacer clic en un enlace en el correoelectrónico.

link La dirección URL del enlace en el que eldestinatario hizo clic.

linkTags Una lista de las etiquetas que se añadieron alenlace utilizando el atributo ses:tags. Paraobtener más información sobre la adición deetiquetas a enlaces en sus correos electrónicos,consulte P5. ¿Puedo etiquetar enlaces conidentificadores únicos? (p. 499) en la Preguntasfrecuentes sobre métricas de envío de correoelectrónico de Amazon SES (p. 496).

Ejemplos de datos de eventos de Amazon SES publicados en Kinesis DataFirehoseEsta sección proporciona ejemplos de cada tipo de registro de evento de envío de correo electrónico queAmazon SES publica para Kinesis Data Firehose.

Los tipos de evento son los siguientes:

• Registro de rebote (p. 281)• Registro de reclamación (p. 282)

280


• Registro de entrega (p. 283)• Registro de enviar correo electrónico (p. 285)• Registro de evento rechazar (p. 286)• Registro de evento abrir (p. 287)• Registro de evento clic (p. 288)

Registro de rebote

El siguiente es el ejemplo de un registro de evento bounce que Amazon SES publica en Kinesis DataFirehose.

{ "eventType":"Bounce", "bounce":{ "bounceType":"Permanent", "bounceSubType":"General", "bouncedRecipients":[ { "emailAddress":"[email protected]", "action":"failed", "status":"5.1.1", "diagnosticCode":"smtp; 550 5.1.1 user unknown" } ], "timestamp":"2017-08-05T00:41:02.669Z", "feedbackId":"01000157c44f053b-61b59c11-9236-11e6-8f96-7be8aexample-000000", "reportingMTA":"dsn; mta.example.com" }, "mail":{ "timestamp":"2017-08-05T00:40:02.012Z", "source":"Sender Name <[email protected]>", "sourceArn":"arn:aws:ses:us-east-1:123456789012:identity/[email protected]", "sendingAccountId":"123456789012", "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", "destination":[ "[email protected]" ], "headersTruncated":false, "headers":[ { "name":"From", "value":"Sender Name <[email protected]>" }, { "name":"To", "value":"[email protected]" }, { "name":"Subject", "value":"Message sent from Amazon SES" }, { "name":"MIME-Version", "value":"1.0" }, { "name":"Content-Type", "value":"multipart/alternative; boundary=\"----=_Part_7307378_1629847660.1516840721503\"" } ], "commonHeaders":{

281


"from":[ "Sender Name <[email protected]>" ], "to":[ "[email protected]" ], "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", "subject":"Message sent from Amazon SES" }, "tags":{ "ses:configuration-set":[ "ConfigSet" ], "ses:source-ip":[ "192.0.2.0" ], "ses:from-domain":[ "example.com" ], "ses:caller-identity":[ "ses_user" ] } }}

Registro de reclamación

El siguiente es el ejemplo de un registro de evento complaint que Amazon SES publica en Kinesis DataFirehose.

{ "eventType":"Complaint", "complaint": { "complainedRecipients":[ { "emailAddress":"[email protected]" } ], "timestamp":"2017-08-05T00:41:02.669Z", "feedbackId":"01000157c44f053b-61b59c11-9236-11e6-8f96-7be8aexample-000000", "userAgent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/60.0.3112.90 Safari/537.36", "complaintFeedbackType":"abuse", "arrivalDate":"2017-08-05T00:41:02.669Z" }, "mail":{ "timestamp":"2017-08-05T00:40:01.123Z", "source":"Sender Name <[email protected]>", "sourceArn":"arn:aws:ses:us-east-1:123456789012:identity/[email protected]", "sendingAccountId":"123456789012", "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", "destination":[ "[email protected]" ], "headersTruncated":false, "headers":[ { "name":"From", "value":"Sender Name <[email protected]>" }, { "name":"To", "value":"[email protected]"

282


}, { "name":"Subject", "value":"Message sent from Amazon SES" }, { "name":"MIME-Version","value":"1.0" }, { "name":"Content-Type", "value":"multipart/alternative; boundary=\"----=_Part_7298998_679725522.1516840859643\"" } ], "commonHeaders":{ "from":[ "Sender Name <[email protected]>" ], "to":[ "[email protected]" ], "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", "subject":"Message sent from Amazon SES" }, "tags":{ "ses:configuration-set":[ "ConfigSet" ], "ses:source-ip":[ "192.0.2.0" ], "ses:from-domain":[ "example.com" ], "ses:caller-identity":[ "ses_user" ] } }}

Registro de entrega

El siguiente es el ejemplo de un registro de evento delivery que Amazon SES publica en Kinesis DataFirehose.

{ "eventType": "Delivery", "mail": { "timestamp": "2016-10-19T23:20:52.240Z", "source": "[email protected]", "sourceArn": "arn:aws:ses:us-east-1:123456789012:identity/[email protected]", "sendingAccountId": "123456789012", "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", "destination": [ "[email protected]" ], "headersTruncated": false, "headers": [ { "name": "From", "value": "[email protected]" }, {

283


"name": "To", "value": "[email protected]" }, { "name": "Subject", "value": "Message sent from Amazon SES" }, { "name": "MIME-Version", "value": "1.0" }, { "name": "Content-Type", "value": "text/html; charset=UTF-8" }, { "name": "Content-Transfer-Encoding", "value": "7bit" } ], "commonHeaders": { "from": [ "[email protected]" ], "to": [ "[email protected]" ], "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", "subject": "Message sent from Amazon SES" }, "tags": { "ses:configuration-set": [ "ConfigSet" ], "ses:source-ip": [ "192.0.2.0" ], "ses:from-domain": [ "example.com" ], "ses:caller-identity": [ "ses_user" ], "ses:outgoing-ip": [ "192.0.2.0" ], "myCustomTag1": [ "myCustomTagValue1" ], "myCustomTag2": [ "myCustomTagValue2" ] } }, "delivery": { "timestamp": "2016-10-19T23:21:04.133Z", "processingTimeMillis": 11893, "recipients": [ "[email protected]" ], "smtpResponse": "250 2.6.0 Message received", "reportingMTA": "mta.example.com" }}

284


Registro de enviar correo electrónico

El siguiente es el ejemplo de un registro de evento send que Amazon SES publica en Kinesis DataFirehose.

{ "eventType": "Send", "mail": { "timestamp": "2016-10-14T05:02:16.645Z", "source": "[email protected]", "sourceArn": "arn:aws:ses:us-east-1:123456789012:identity/[email protected]", "sendingAccountId": "123456789012", "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", "destination": [ "[email protected]" ], "headersTruncated": false, "headers": [ { "name": "From", "value": "[email protected]" }, { "name": "To", "value": "[email protected]" }, { "name": "Subject", "value": "Message sent from Amazon SES" }, { "name": "MIME-Version", "value": "1.0" }, { "name": "Content-Type", "value": "multipart/mixed; boundary=\"----=_Part_0_716996660.1476421336341\"" }, { "name": "X-SES-MESSAGE-TAGS", "value": "myCustomTag1=myCustomTagValue1, myCustomTag2=myCustomTagValue2" } ], "commonHeaders": { "from": [ "[email protected]" ], "to": [ "[email protected]" ], "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", "subject": "Message sent from Amazon SES" }, "tags": { "ses:configuration-set": [ "ConfigSet" ], "ses:source-ip": [ "192.0.2.0" ], "ses:from-domain": [ "example.com" ], "ses:caller-identity": [ "ses_user"

285


], "myCustomTag1": [ "myCustomTagValue1" ], "myCustomTag2": [ "myCustomTagValue2" ] } }, "send": {}}

Registro de evento rechazar

El siguiente es el ejemplo de un registro de evento reject que Amazon SES publica en Kinesis DataFirehose.

{ "eventType": "Reject", "mail": { "timestamp": "2016-10-14T17:38:15.211Z", "source": "[email protected]", "sourceArn": "arn:aws:ses:us-east-1:123456789012:identity/[email protected]", "sendingAccountId": "123456789012", "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", "destination": [ "[email protected]" ], "headersTruncated": false, "headers": [ { "name": "From", "value": "[email protected]" }, { "name": "To", "value": "[email protected]" }, { "name": "Subject", "value": "Message sent from Amazon SES" }, { "name": "MIME-Version", "value": "1.0" }, { "name": "Content-Type", "value": "multipart/mixed; boundary=\"qMm9M+Fa2AknHoGS\"" }, { "name": "X-SES-MESSAGE-TAGS", "value": "myCustomTag1=myCustomTagValue1, myCustomTag2=myCustomTagValue2" } ], "commonHeaders": { "from": [ "[email protected]" ], "to": [ "[email protected]" ], "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", "subject": "Message sent from Amazon SES"

286


}, "tags": { "ses:configuration-set": [ "ConfigSet" ], "ses:source-ip": [ "192.0.2.0" ], "ses:from-domain": [ "example.com" ], "ses:caller-identity": [ "ses_user" ], "myCustomTag1": [ "myCustomTagValue1" ], "myCustomTag2": [ "myCustomTagValue2" ] } }, "reject": { "reason": "Bad content" }}

Registro de evento abrir

El siguiente es el ejemplo de un registro de evento open que Amazon SES publica en Kinesis DataFirehose.

{ "eventType": "Open", "mail": { "commonHeaders": { "from": [ "[email protected]" ], "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", "subject": "Message sent from Amazon SES", "to": [ "[email protected]" ] }, "destination": [ "[email protected]" ], "headers": [ { "name": "X-SES-CONFIGURATION-SET", "value": "ConfigSet" }, { "name": "From", "value": "[email protected]" }, { "name": "To", "value": "[email protected]" }, { "name": "Subject", "value": "Message sent from Amazon SES"

287


}, { "name": "MIME-Version", "value": "1.0" }, { "name": "Content-Type", "value": "multipart/alternative; boundary=\"XBoundary\"" } ], "headersTruncated": false, "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", "sendingAccountId": "123456789012", "source": "[email protected]", "tags": { "ses:caller-identity": [ "ses-user" ], "ses:configuration-set": [ "ConfigSet" ], "ses:from-domain": [ "example.com" ], "ses:source-ip": [ "192.0.2.0" ] }, "timestamp": "2017-08-09T21:59:49.927Z" }, "open": { "ipAddress": "192.0.2.1", "timestamp": "2017-08-09T22:00:19.652Z", "userAgent": "Mozilla/5.0 (iPhone; CPU iPhone OS 10_3_3 like Mac OS X) AppleWebKit/603.3.8 (KHTML, like Gecko) Mobile/14G60" }}

Registro de evento clic

El siguiente es el ejemplo de un registro de evento click que Amazon SES publica en Kinesis DataFirehose.

{ "eventType": "Click", "click": { "ipAddress": "192.0.2.1", "link": "http://docs.aws.amazon.com/ses/latest/DeveloperGuide/send-email-smtp.html", "linkTags": { "samplekey0": [ "samplevalue0" ], "samplekey1": [ "samplevalue1" ] }, "timestamp": "2017-08-09T23:51:25.570Z", "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/60.0.3112.90 Safari/537.36" }, "mail": { "commonHeaders": { "from": [ "[email protected]"

288


], "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", "subject": "Message sent from Amazon SES", "to": [ "[email protected]" ] }, "destination": [ "[email protected]" ], "headers": [ { "name": "X-SES-CONFIGURATION-SET", "value": "ConfigSet" }, { "name": "From", "value": "[email protected]" }, { "name": "To", "value": "[email protected]" }, { "name": "Subject", "value": "Message sent from Amazon SES" }, { "name": "MIME-Version", "value": "1.0" }, { "name": "Content-Type", "value": "multipart/alternative; boundary=\"XBoundary\"" }, { "name": "Message-ID", "value": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000" } ], "headersTruncated": false, "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", "sendingAccountId": "123456789012", "source": "[email protected]", "tags": { "ses:caller-identity": [ "ses_user" ], "ses:configuration-set": [ "ConfigSet" ], "ses:from-domain": [ "example.com" ], "ses:source-ip": [ "192.0.2.0" ] }, "timestamp": "2017-08-09T23:50:05.795Z" }}

289


Interpretación de datos de eventos de Amazon SES desdeAmazon SNSAmazon SES publica los eventos de envío de correo electrónico a Amazon Simple Notification Service(Amazon SNS) como registros JSON. Amazon SNS entrega a continuación notificaciones a los puntos deenlace suscritos al tema de Amazon SNS asociado al destino de evento. Para obtener más informaciónacerca de la configuración de temas y suscripciones en Amazon SNS, consulte Introducción en la Guíapara desarrolladores de Amazon Simple Notification Service.

Para obtener una descripción del contenido de registros y registros de ejemplo, consulte las seccionessiguientes.

• Contenido de registros de eventos (p. 290)• Ejemplos de registros de evento (p. 298)

Contenido de datos de eventos de Amazon SES publicados en Amazon SNSAmazon SES publica los registros de eventos de envío de correo electrónico en Amazon SimpleNotification Service en formato JSON.

El objeto JSON de nivel superior contiene una cadena eventType, un objeto mail y un objeto bounce,complaint, delivery, send, reject, open, click o failure en función del tipo de evento.

Temas de esta sección:• Objeto JSON de nivel superior (p. 290)• Objeto Mail (p. 291)• Objeto Bounce (p. 292)• Objeto Complaint (p. 295)• Objeto Delivery (p. 296)• Objeto Send (p. 297)• Objeto Reject (p. 297)• Objeto Open (p. 297)• Objeto Click (p. 297)• Objeto Failure (p. 298)


El objeto JSON de nivel superior en un registro de eventos de envío de correo electrónico contiene lossiguientes campos.


eventType Una cadena que describe el tipo de evento.Valores posibles: Delivery, Send, Reject,Open, Click, Bounce, Complaint o RenderingFailure.

mail Un objeto JSON que contiene información acercadel mensaje de correo electrónico que produjo elevento.

bounce Este campo solo está presente si eventType esBounce. Contiene información sobre el rebote.

290

https://docs.aws.amazon.com/sns/latest/dg/GettingStarted.html



complaint Este campo solo está presente si eventTypees Complaint. Contiene información sobre lareclamación.

delivery Este campo solo está presente si eventType esDelivery. Contiene información sobre la entrega.

send Este campo solo está presente si eventType esSend.

reject Este campo solo está presente si eventType esReject. Contiene información sobre el rechazo.

open Este campo solo está presente si eventType esOpen. Contiene información sobre el evento deapertura.

click Este campo solo está presente si eventType esClick. Contiene información sobre el evento declic.

failure Este campo solo está presente si eventTypees Rendering Failure. Contiene informaciónsobre el evento de error de presentación.

Objeto Mail

Cada registro de evento de envío de correo electrónico contiene información acerca del correo electrónicooriginal en el objeto mail. El objeto JSON que contiene información acerca de un objeto mail tiene loscampos siguientes.


timestamp La fecha y la hora, en formato ISO8601 (AAAA-MM-DDThh:mm:ss.sZ), en la que se envió elmensaje.


Note


source La dirección de correo electrónico desde la quese envió el mensaje (la dirección MAIL FROM delsobre).

sourceArn El nombre de recurso de Amazon (ARN) de laidentidad que se utilizó para enviar el correoelectrónico. En el caso de una autorización de

291


Nombre del campo Descripciónenvío, el sourceArn es el ARN de la identidadde que el propietario de la identidad autorizóutilizar al remitente delegado para enviar el correoelectrónico. Para obtener más información acercade la autorización de envío, consulte Uso deautorización de envío (p. 141).



headersTruncated Una cadena que especifica si los encabezadosestán truncados en la notificación, que se producesi los encabezados tienen un tamaño superior a 10KB. Los posibles valores son true y false.

headers Una lista de los encabezados originales del correoelectrónico. Cada encabezado de la lista tiene uncampo name y un campo value.

Note

Cualquier ID de mensaje dentro delcampo headers procede del mensajeoriginal que transfirió a Amazon SES. ElID de mensaje que Amazon SES asignóseguidamente al mensaje está en elcampo messageId del objeto mail.

commonHeaders Una lista de los encabezados originales delcorreo electrónico utilizados habitualmente. Cadaencabezado de la lista tiene un campo name y uncampo value.

Note


Objeto Bounce

El objeto JSON que contiene información acerca de un evento Bounce tiene los campos siguientes.


bounceType El tipo de rebote, tal como determina Amazon SES.

292



bounceSubType El subtipo de rebote, tal como determina AmazonSES.

bouncedRecipients Una lista que contiene información acerca de losdestinatarios del mensaje de correo electrónicooriginal que dio lugar a un rebote.

timestamp La fecha y la hora, en formato ISO8601 (AAAA-MM-DDThh:mm:ss.sZ), a la que el ISP envió lanotificación de rebote.



Note

Este campo solo aparece si se haadjuntado una notificación de estado deentrega (DSN) al rebote.


Un evento de rebote podría pertenecer a un único destinatario o a varios destinatarios. El campobouncedRecipients incluye una lista de objetos (un objeto por destinatario cuya dirección de correoelectrónico produjo un rebote) y contiene el campo siguiente.





action El valor del campo Action del DSN. Esto indicala acción que realiza el MTA de notificación comoresultado de su intento de entregar el mensaje aeste destinatario.


diagnosticCode El código de estado emitido por la MTAde notificación. Este es el valor del campoDiagnostic-Code del DSN. Este campo puede

293


Nombre del campo Descripciónestar ausente en el DSN (y, por lo tanto, tambiénausente en el JSON).

Tipos de rebote

Cada evento de rebote es de uno de los tipos que se muestran en la tabla siguiente.

El sistema de publicación de eventos solo publica rebotes permanentes y rebotes temporales que ya novolverá a intentar Amazon SES. Al recibir rebotes marcados Permanent, debería eliminar las direccionesde correo electrónico correspondientes de su lista de correo; no podrá enviar a las mismas en el futuro.Los rebotes Transient se le envían cuando un mensaje ha tenido rebote temporal varias veces yAmazon SES ha dejado de intentar volver a enviarlo. Es posible que en el futuro pueda volver a enviarcorrectamente a una dirección que inicialmente ha dado lugar a un rebote Transient.


Undetermined Undetermined Amazon SES no ha podido determinar un motivoespecífico de rebote.

Permanent General Amazon SES recibió un rebote permanentegeneral. Si recibe este tipo de rebote, deberíaeliminar la dirección de correo electrónico deldestinatario de su lista de correo.

Permanent NoEmail Amazon SES recibió un rebote permanente porquela dirección de correo electrónico de destinono existe. Si recibe este tipo de rebote, deberíaeliminar la dirección de correo electrónico deldestinatario de su lista de correo.

Permanent Suppressed Amazon SES ha suprimido el envío a estadirección dado que tiene un historial reciente derebotes como dirección no válida. Para obtenerinformación acerca de cómo eliminar una direcciónde la lista de supresión, consulte Eliminación deuna dirección de correo electrónico de la lista desupresión de Amazon SES (p. 462).

Transient General Amazon SES recibió un rebote general. Es posibleque pueda enviar correctamente a este destinatarioen el futuro.

Transient MailboxFull Amazon SES ha recibido un rebote completo debandeja de entrada. Es posible que pueda enviarcorrectamente a este destinatario en el futuro.

Transient MessageTooLarge Amazon SES recibe un rebote de mensajedemasiado grande. Es posible que pueda enviarcorrectamente a este destinatario si reduce eltamaño del mensaje.

Transient ContentRejected Amazon SES ha recibido un rebote de contenidorechazado. Es posible que pueda enviarcorrectamente a este destinatario si cambia elcontenido del mensaje.

294



Transient AttachmentRejected Amazon SES ha recibido un rebote de archivoadjunto rechazado. Es posible que pueda enviarcorrectamente a este destinatario si elimina ocambia el archivo adjunto.

Objeto Complaint

El objeto JSON que contiene información acerca de un evento Complaint tiene los campos siguientes.


complainedRecipients Una lista que contiene información sobredestinatarios que podrían haber enviado lareclamación.

timestamp La fecha y la hora, en formato ISO8601 (AAAA-MM-DDThh:mm:ss.sZ), a la que el ISP envió lanotificación de reclamación.

feedbackId Un identificador único para la reclamación.





arrivalDate El valor del campo Arrival-Date o Received-Date del informe de retroalimentación en formatoISO8601 (AAAA-MM-DDThh:mm:ss.sZ). Estecampo puede estar ausente en el informe (y, por lotanto, también ausente en el JSON).


El campo complainedRecipients contiene una lista de destinatarios que podrían haber enviado lareclamación.

Important

La mayoría de los ISP redactan las direcciones de correo electrónico de los destinatarios queenvían reclamaciones. Por este motivo, el campo complainedRecipients incluye una lista detodos los destinatarios que han enviado el correo electrónico con una dirección en el dominio queemitió la notificación de reclamación.


295







abuse Indica correo electrónico no solicitado o algún otrotipo de abuso de correo electrónico.

auth-failure Informe de error de autenticación de correoelectrónico.

fraud Indica algún tipo de fraude o actividad de phishing.

not-spam Indica que la entidad que proporciona el informe noconsidera el mensaje como spam. Esto se puedeutilizar para corregir un mensaje que estaba maletiquetado o clasificado como spam.

other Indica cualquier otra retroalimentación que noencaje en otros tipos registrados.

virus Notifica que se ha encontrado un virus en elmensaje de origen.

Objeto Delivery

El objeto JSON que contiene información acerca de un evento Delivery tiene los campos siguientes.


timestamp La fecha y la hora en la que Amazon SES entregóel correo electrónico al servidor de correo deldestinatario, en formato ISO8601 (AAAA-MM-DDThh:mm:ss.sZ).

processingTimeMillis El tiempo en milisegundos desde el momento enque Amazon SES acepta la solicitud del remitenteal momento en que Amazon SES transfiere elmensaje al servidor de correo del destinatario.

recipients Una lista de los destinatarios a los quecorresponden los eventos de entrega.

smtpResponse El mensaje de respuesta SMTP del ISP remotoque ha aceptado el correo electrónico desdeAmazon SES. Este mensaje variará por correoelectrónico, por receptor de servidor de correoelectrónico y por ISP de recepción.

296






Objeto Send

El objeto JSON que contiene información acerca de un evento send está siempre vacío.

Objeto Reject

El objeto JSON que contiene información acerca de un evento Reject tiene los campos siguientes.


reason La razón por la que se rechazó el correoelectrónico. El único valor posible es Badcontent, lo que significa que Amazon SESdetectó que el correo electrónico contenía un virus.Cuando se rechaza un mensaje, Amazon SESdetiene su procesamiento y no intenta entregarlo alservidor de correo del destinatario.

Objeto Open

El objeto JSON que contiene información acerca de un evento Open tiene los campos siguientes.



timestamp La fecha y la hora en la que se produjo el eventode apertura del correo electrónico, en formatoISO8601 (AAAA-MM-DDThh:mm:ss.sZ).

userAgent El agente del usuario del dispositivo o cliente decorreo electrónico que el destinatario utiliza paraabrir el correo electrónico.

Objeto Click

El objeto JSON que contiene información acerca de un evento Click tiene los campos siguientes.



timestamp La fecha y la hora en la que se produjo elevento de clic, en formato ISO8601 (AAAA-MM-DDThh:mm:ss.sZ).

userAgent El agente del usuario del cliente que el destinatariousó para hacer clic en un enlace en el correoelectrónico.

297



link La dirección URL del enlace en el que eldestinatario hizo clic.

linkTags Una lista de las etiquetas que se añadieron alenlace utilizando el atributo ses:tags. Paraobtener más información sobre la adición deetiquetas a enlaces en sus correos electrónicos,consulte P5. ¿Puedo etiquetar enlaces conidentificadores únicos? (p. 499) en la Preguntasfrecuentes sobre métricas de envío de correoelectrónico de Amazon SES (p. 496).

Objeto Failure

El objeto JSON que contiene información acerca de un evento Rendering Failure tiene los campossiguientes.


templateName El nombre de la plantilla que se usó para enviar elcorreo electrónico.

errorMessage Un mensaje que proporciona más informaciónsobre el error de presentación.

Ejemplos de datos de eventos de Amazon SES publicados en Amazon SNS

Esta sección proporciona ejemplos de cada tipo de registro de evento de envío de correo electrónico queAmazon SES publica para Amazon SNS.

Temas de esta sección:• Registro de rebote (p. 298)• Registro de reclamación (p. 300)• Registro de entrega (p. 301)• Registro de enviar correo electrónico (p. 302)• Registro de evento rechazar (p. 303)• Registro de evento abrir (p. 305)• Registro de evento clic (p. 306)• Registro de eventos de errores de presentación (p. 307)

Registro de rebote

El siguiente es el ejemplo de un registro de evento bounce que Amazon SES publica en Amazon SNS.

{ "eventType":"Bounce", "bounce":{ "bounceType":"Permanent", "bounceSubType":"General",

298


"bouncedRecipients":[ { "emailAddress":"[email protected]", "action":"failed", "status":"5.1.1", "diagnosticCode":"smtp; 550 5.1.1 user unknown" } ], "timestamp":"2017-08-05T00:41:02.669Z", "feedbackId":"01000157c44f053b-61b59c11-9236-11e6-8f96-7be8aexample-000000", "reportingMTA":"dsn; mta.example.com" }, "mail":{ "timestamp":"2017-08-05T00:40:02.012Z", "source":"Sender Name <[email protected]>", "sourceArn":"arn:aws:ses:us-east-1:123456789012:identity/[email protected]", "sendingAccountId":"123456789012", "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", "destination":[ "[email protected]" ], "headersTruncated":false, "headers":[ { "name":"From", "value":"Sender Name <[email protected]>" }, { "name":"To", "value":"[email protected]" }, { "name":"Subject", "value":"Message sent from Amazon SES" }, { "name":"MIME-Version", "value":"1.0" }, { "name":"Content-Type", "value":"multipart/alternative; boundary=\"----=_Part_7307378_1629847660.1516840721503\"" } ], "commonHeaders":{ "from":[ "Sender Name <[email protected]>" ], "to":[ "[email protected]" ], "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", "subject":"Message sent from Amazon SES" }, "tags":{ "ses:configuration-set":[ "ConfigSet" ], "ses:source-ip":[ "192.0.2.0" ], "ses:from-domain":[ "example.com" ], "ses:caller-identity":[

299


"ses_user" ] } }}

Registro de reclamación

El siguiente es el ejemplo de un registro de evento complaint que Amazon SES publica en Amazon SNS.

{ "eventType":"Complaint", "complaint": { "complainedRecipients":[ { "emailAddress":"[email protected]" } ], "timestamp":"2017-08-05T00:41:02.669Z", "feedbackId":"01000157c44f053b-61b59c11-9236-11e6-8f96-7be8aexample-000000", "userAgent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/60.0.3112.90 Safari/537.36", "complaintFeedbackType":"abuse", "arrivalDate":"2017-08-05T00:41:02.669Z" }, "mail":{ "timestamp":"2017-08-05T00:40:01.123Z", "source":"Sender Name <[email protected]>", "sourceArn":"arn:aws:ses:us-east-1:123456789012:identity/[email protected]", "sendingAccountId":"123456789012", "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", "destination":[ "[email protected]" ], "headersTruncated":false, "headers":[ { "name":"From", "value":"Sender Name <[email protected]>" }, { "name":"To", "value":"[email protected]" }, { "name":"Subject", "value":"Message sent from Amazon SES" }, { "name":"MIME-Version","value":"1.0" }, { "name":"Content-Type", "value":"multipart/alternative; boundary=\"----=_Part_7298998_679725522.1516840859643\"" } ], "commonHeaders":{ "from":[ "Sender Name <[email protected]>" ], "to":[ "[email protected]" ],

300


"messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", "subject":"Message sent from Amazon SES" }, "tags":{ "ses:configuration-set":[ "ConfigSet" ], "ses:source-ip":[ "192.0.2.0" ], "ses:from-domain":[ "example.com" ], "ses:caller-identity":[ "ses_user" ] } }}

Registro de entrega

El siguiente es el ejemplo de un registro de evento delivery que Amazon SES publica en Amazon SNS.

{ "eventType": "Delivery", "mail": { "timestamp": "2016-10-19T23:20:52.240Z", "source": "[email protected]", "sourceArn": "arn:aws:ses:us-east-1:123456789012:identity/[email protected]", "sendingAccountId": "123456789012", "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", "destination": [ "[email protected]" ], "headersTruncated": false, "headers": [ { "name": "From", "value": "[email protected]" }, { "name": "To", "value": "[email protected]" }, { "name": "Subject", "value": "Message sent from Amazon SES" }, { "name": "MIME-Version", "value": "1.0" }, { "name": "Content-Type", "value": "text/html; charset=UTF-8" }, { "name": "Content-Transfer-Encoding", "value": "7bit" } ], "commonHeaders": { "from": [

301


"[email protected]" ], "to": [ "[email protected]" ], "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", "subject": "Message sent from Amazon SES" }, "tags": { "ses:configuration-set": [ "ConfigSet" ], "ses:source-ip": [ "192.0.2.0" ], "ses:from-domain": [ "example.com" ], "ses:caller-identity": [ "ses_user" ], "ses:outgoing-ip": [ "192.0.2.0" ], "myCustomTag1": [ "myCustomTagValue1" ], "myCustomTag2": [ "myCustomTagValue2" ] } }, "delivery": { "timestamp": "2016-10-19T23:21:04.133Z", "processingTimeMillis": 11893, "recipients": [ "[email protected]" ], "smtpResponse": "250 2.6.0 Message received", "reportingMTA": "mta.example.com" }}

Registro de enviar correo electrónico

El siguiente es el ejemplo de un registro de evento send que Amazon SES publica en Amazon SNS.

{ "eventType": "Send", "mail": { "timestamp": "2016-10-14T05:02:16.645Z", "source": "[email protected]", "sourceArn": "arn:aws:ses:us-east-1:123456789012:identity/[email protected]", "sendingAccountId": "123456789012", "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", "destination": [ "[email protected]" ], "headersTruncated": false, "headers": [ { "name": "From", "value": "[email protected]" },

302


{ "name": "To", "value": "[email protected]" }, { "name": "Subject", "value": "Message sent from Amazon SES" }, { "name": "MIME-Version", "value": "1.0" }, { "name": "Content-Type", "value": "multipart/mixed; boundary=\"----=_Part_0_716996660.1476421336341\"" }, { "name": "X-SES-MESSAGE-TAGS", "value": "myCustomTag1=myCustomTagValue1, myCustomTag2=myCustomTagValue2" } ], "commonHeaders": { "from": [ "[email protected]" ], "to": [ "[email protected]" ], "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", "subject": "Message sent from Amazon SES" }, "tags": { "ses:configuration-set": [ "ConfigSet" ], "ses:source-ip": [ "192.0.2.0" ], "ses:from-domain": [ "example.com" ], "ses:caller-identity": [ "ses_user" ], "myCustomTag1": [ "myCustomTagValue1" ], "myCustomTag2": [ "myCustomTagValue2" ] } }, "send": {}}

Registro de evento rechazar

El siguiente es el ejemplo de un registro de evento reject que Amazon SES publica en Amazon SNS.

{ "eventType": "Reject", "mail": { "timestamp": "2016-10-14T17:38:15.211Z", "source": "[email protected]",

303


"sourceArn": "arn:aws:ses:us-east-1:123456789012:identity/[email protected]", "sendingAccountId": "123456789012", "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", "destination": [ "[email protected]" ], "headersTruncated": false, "headers": [ { "name": "From", "value": "[email protected]" }, { "name": "To", "value": "[email protected]" }, { "name": "Subject", "value": "Message sent from Amazon SES" }, { "name": "MIME-Version", "value": "1.0" }, { "name": "Content-Type", "value": "multipart/mixed; boundary=\"qMm9M+Fa2AknHoGS\"" }, { "name": "X-SES-MESSAGE-TAGS", "value": "myCustomTag1=myCustomTagValue1, myCustomTag2=myCustomTagValue2" } ], "commonHeaders": { "from": [ "[email protected]" ], "to": [ "[email protected]" ], "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", "subject": "Message sent from Amazon SES" }, "tags": { "ses:configuration-set": [ "ConfigSet" ], "ses:source-ip": [ "192.0.2.0" ], "ses:from-domain": [ "example.com" ], "ses:caller-identity": [ "ses_user" ], "myCustomTag1": [ "myCustomTagValue1" ], "myCustomTag2": [ "myCustomTagValue2" ] } }, "reject": { "reason": "Bad content"

304


}}

Registro de evento abrir

El siguiente es el ejemplo de un registro de evento open que Amazon SES publica en Amazon SNS.

{ "eventType": "Open", "mail": { "commonHeaders": { "from": [ "[email protected]" ], "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", "subject": "Message sent from Amazon SES", "to": [ "[email protected]" ] }, "destination": [ "[email protected]" ], "headers": [ { "name": "X-SES-CONFIGURATION-SET", "value": "ConfigSet" }, { "name": "From", "value": "[email protected]" }, { "name": "To", "value": "[email protected]" }, { "name": "Subject", "value": "Message sent from Amazon SES" }, { "name": "MIME-Version", "value": "1.0" }, { "name": "Content-Type", "value": "multipart/alternative; boundary=\"XBoundary\"" } ], "headersTruncated": false, "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", "sendingAccountId": "123456789012", "source": "[email protected]", "tags": { "ses:caller-identity": [ "ses-user" ], "ses:configuration-set": [ "ConfigSet" ], "ses:from-domain": [ "example.com" ], "ses:source-ip": [

305


"192.0.2.0" ] }, "timestamp": "2017-08-09T21:59:49.927Z" }, "open": { "ipAddress": "192.0.2.1", "timestamp": "2017-08-09T22:00:19.652Z", "userAgent": "Mozilla/5.0 (iPhone; CPU iPhone OS 10_3_3 like Mac OS X) AppleWebKit/603.3.8 (KHTML, like Gecko) Mobile/14G60" }}

Registro de evento clic

El siguiente es el ejemplo de un registro de evento click que Amazon SES publica en Amazon SNS.

{ "eventType": "Click", "click": { "ipAddress": "192.0.2.1", "link": "http://docs.aws.amazon.com/ses/latest/DeveloperGuide/send-email-smtp.html", "linkTags": { "samplekey0": [ "samplevalue0" ], "samplekey1": [ "samplevalue1" ] }, "timestamp": "2017-08-09T23:51:25.570Z", "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/60.0.3112.90 Safari/537.36" }, "mail": { "commonHeaders": { "from": [ "[email protected]" ], "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", "subject": "Message sent from Amazon SES", "to": [ "[email protected]" ] }, "destination": [ "[email protected]" ], "headers": [ { "name": "X-SES-CONFIGURATION-SET", "value": "ConfigSet" }, { "name": "From", "value": "[email protected]" }, { "name": "To", "value": "[email protected]" }, { "name": "Subject", "value": "Message sent from Amazon SES"

306


}, { "name": "MIME-Version", "value": "1.0" }, { "name": "Content-Type", "value": "multipart/alternative; boundary=\"XBoundary\"" }, { "name": "Message-ID", "value": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000" } ], "headersTruncated": false, "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", "sendingAccountId": "123456789012", "source": "[email protected]", "tags": { "ses:caller-identity": [ "ses_user" ], "ses:configuration-set": [ "ConfigSet" ], "ses:from-domain": [ "example.com" ], "ses:source-ip": [ "192.0.2.0" ] }, "timestamp": "2017-08-09T23:50:05.795Z" }}

Registro de eventos de errores de presentación

El siguiente es el ejemplo de un registro de evento Rendering Failure que Amazon SES publica enAmazon SNS.

{ "eventType":"Rendering Failure", "mail":{ "timestamp":"2018-01-22T18:43:06.197Z", "source":"[email protected]", "sourceArn":"arn:aws:ses:us-east-1:123456789012:identity/[email protected]", "sendingAccountId":"123456789012", "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", "destination":[ "[email protected]" ], "headersTruncated":false, "tags":{ "ses:configuration-set":[ "ConfigSet" ] } }, "failure":{ "errorMessage":"Attribute 'attributeName' is not present in the rendering data.", "templateName":"MyTemplate" }}

307

Amazon Simple Email Service Developer GuideTutoriales

Tutoriales de publicación de eventos de Amazon SESEsta sección proporciona tutoriales en los que se muestra cómo utilizar la publicación de eventos deAmazon SES con los servicios de AWS que le permiten analizar y visualizar los datos.

Estos tutoriales se encuentran en las secciones siguientes.

• Analizar eventos de envío de correo electrónico con Amazon Redshift (p. 308)• Visualizar eventos de envío de correo electrónico con Amazon Elasticsearch Service y Kibana (p. 320)• Representar gráficamente eventos de envío de correo electrónico en CloudWatch (p. 330)• Analizar eventos de envío de correo electrónico con Amazon Kinesis Data Analytics (p. 333)

Analizar eventos de envío de correo electrónico con AmazonRedshiftEn este tutorial, usted publica eventos de envío de correo electrónico de Amazon SES a un flujo de entregade Amazon Kinesis Data Firehose que publica datos en Amazon Redshift. A continuación, se conecta a labase de datos de Amazon Redshift y utiliza una herramienta de consulta SQL para consultar la base dedatos para eventos de envío de correo electrónico de Amazon SES que cumplan determinados criterios.

Las secciones siguientes le guían a través del proceso.

• Requisitos previos (p. 308)• Paso 1: crear un clúster de Amazon Redshift (p. 309)• Paso 2: conexión al clúster de Amazon Redshift (p. 309)• Paso 3: Creación de una tabla de base de datos (p. 312)• Paso 4: crear un flujo de entrega de Kinesis Data Firehose (p. 314)• Paso 5: configurar un conjunto de configuración (p. 317)• Paso 6: enviar correos electrónicos (p. 318)• Paso 7: consultar eventos de envío de correo electrónico (p. 319)

Requisitos previos

Para este tutorial, necesitará lo siguiente:

• Una cuenta de AWS: para acceder a cualquier servicio web que ofrece AWS, primero debe crear unacuenta de AWS en https://aws.amazon.com/.

• Dirección de correo electrónico verificada: para enviar correos electrónicos utilizando Amazon SES, debeverificar su dirección de remitente ("From") o dominio para demostrar que le pertenece. Si está en elentorno de pruebas, también debe verificar sus direcciones de destinatario ("Para"). Puede verificar lasdirecciones de correo electrónico o los dominios completos, pero este tutorial requiere una dirección decorreo electrónico verificada para que pueda enviar un correo electrónico desde la consola de AmazonSES, que es la forma más sencilla de enviar un correo electrónico. Para obtener más información acercade cómo verificar una dirección de correo electrónico, consulte Verificación de direcciones de correoelectrónico en Amazon SES. (p. 47).

• Una herramienta de consulta SQL: Amazon Redshift no proporciona ni instala ninguna biblioteca oherramienta cliente de SQL, por lo que debe instalar una que pueda utilizar para acceder a los clústeresde Amazon Redshift que contienen sus eventos de Amazon SES. En este tutorial, utilizamos SQLWorkbench/J, una herramienta de consulta SQL gratuita, multiplataforma e independiente de lossistemas de gestión de base de datos (DBMS). Los pasos siguientes indican dónde acceder parainstalarla.

308

https://aws.amazon.com/

http://www.sql-workbench.net/



El siguiente procedimiento muestra cómo instalar SQL Workbench/J.

Para instalar SQL Workbench/J en el equipo cliente

1. Consulte la licencia de software de SQL Workbench/J.2. Vaya al sitio web de SQL Workbench/J y descargue el paquete adecuado para su sistema operativo.3. Vaya a Installing and starting SQL Workbench/J e instale SQL Workbench/J.

Important

Compruebe los requisitos previos de la versión de Java Runtime para SQL Workbench/J yasegúrese de estar utilizando esa versión. De lo contrario, esta aplicación del cliente no seejecutará.

4. Vaya a Configure a JDBC Connection y descargue un controlador JDBC de Amazon Redshift parapermitir que SQL Workbench/J se conecte con el clúster.

Paso siguiente

Paso 1: crear un clúster de Amazon Redshift (p. 309)

Paso 1: crear un clúster de Amazon RedshiftPara crear un clúster de Amazon Redshift, acceda a la consola de Amazon Redshift y seleccione LaunchCluster. Un asistente le guía para elegir opciones para su clúster y proporciona valores predeterminadospara la mayoría de opciones.

Para este tutorial sencillo, escriba el nombre de clúster y la contraseña y, a continuación, puede utilizartodos los valores predeterminados. No tiene que establecer ningún valor específico para la publicación deeventos de Amazon SES.

Important

El clúster que implementa para este tutorial se ejecutará en un entorno real. Su clúster acumularácargos en su cuenta de AWS mientras esté en ejecución. Para evitar cargos innecesarios, debeeliminar su clúster cuando termine de usarlo. Para obtener información sobre los precios, consultela página de precios de Amazon Redshift.

Paso siguiente

Paso 2: conexión al clúster de Amazon Redshift (p. 309)

Paso 2: conexión al clúster de Amazon RedshiftAhora se conectará a su clúster utilizando una herramienta cliente de SQL. Para este tutorial, deberáutilizar el cliente SQL Workbench/J que instaló en la sección de requisitos previos (p. 308).

Complete esta sección siguiendo estos pasos:

• Obtención de la cadena de conexión (p. 309)• Conexión a su clúster desde SQL Workbench/J (p. 310)

Obtención de la cadena de conexión

El siguiente procedimiento muestra cómo obtener la cadena de conexión que necesitará para conectarse asu clúster de Amazon Redshift desde SQL Workbench/J.

Para obtener su cadena de conexión

1. En el panel de navegación de la consola de Amazon Redshift, seleccione Clusters.

309

http://www.sql-workbench.net/manual/license.html#license-restrictions


http://www.sql-workbench.net/manual/install.html

https://docs.aws.amazon.com/redshift/latest/mgmt/configure-jdbc-connection.html

https://console.aws.amazon.com/redshift/

https://aws.amazon.com/redshift/pricing/


2. Para abrir el clúster, elija el nombre del clúster.3. En la pestaña Configuration, debajo de Cluster Database Properties, copie la URL del JDBC del

clúster.

Note

El punto de enlace para el clúster no está disponible hasta que este no se crea y se coloca esestado disponible.

Conexión a su clúster desde SQL Workbench/J

El siguiente procedimiento muestra cómo conectarse a su clúster desde SQL Workbench/J. Esteprocedimiento supone que ha instalado SQL Workbench/J en su equipo tal y como se describe enRequisitos previos (p. 308).

Para conectarse a su clúster desde SQL Workbench/J

1. Abra el SQL Workbench/J.2. Seleccione File y, luego, Connect window.3. Elija el botón Create a new connection profile.

4. En la casilla de texto New profile, escriba un nombre para el perfil.5. En la parte inferior de la ventana, a la izquierda, seleccione Manage Drivers.6. En el cuadro de diálogo Manage Drivers, seleccione el botón Create a new entry y, a continuación,

añada el controlador como se indica.

310


a. En el cuadro Name, escriba un nombre para el controlador.b. Junto a Library, seleccione el icono de carpeta.c. Acceda a la ubicación del controlador que descargó en Configure a JDBC Connection, seleccione

el controlador y, a continuación, elija Open.d. Seleccione Aceptar.

Volverá al cuadro de diálogo Select Connection Profile.7. Para Driver, seleccione el controlador que acaba de añadir.8. Para URL, pegue la URL de JDBC que copió desde la consola de Amazon Redshift.9. Para Username, escriba el nombre de usuario que eligió al configurar el clúster de Amazon

Redshift (p. 309).10. Para Password, escriba la contraseña que eligió al configurar el clúster de Amazon Redshift.11. Seleccione Autocommit.12. Para probar la conexión, elija Test.

Note

Si se supera el tiempo de espera de la conexión, es posible que tenga que añadir sudirección IP al grupo de seguridad que permite tráfico entrante desde direcciones IP. Paraobtener información adicional, consulte The Connection Is Refused or Fails en la AmazonRedshift Database Developer Guide.

311

https://docs.aws.amazon.com/redshift/latest/mgmt/configure-jdbc-connection.html

https://console.aws.amazon.com/redshift/

https://docs.aws.amazon.com/redshift/latest/mgmt/connecting-refusal-failure-issues.html


13. En la barra de menú superior, seleccione el botón Save profile list.14. Seleccione Aceptar.

SQL Workbench/J se conectará a su clúster de Amazon Redshift.

Paso siguiente

Paso 3: Creación de una tabla de base de datos (p. 312)

Paso 3: Creación de una tabla de base de datosDespués de conectarse a la base de datos inicial en Amazon Redshift, normalmente se utiliza la base dedatos inicial como punto de partida para la creación de una nueva base de datos. Sin embargo, en estetutorial sencillo, creamos una tabla para almacenar sus datos de publicación de eventos de Amazon SESdirectamente dentro de la base de datos inicial.

En este tutorial, supongamos que estamos interesados en los siguientes campos dentro de los registros deeventos de envío de correo electrónico (p. 272). Todos estos campos, excepto mail.tags.campaign,los proporciona automáticamente Amazon SES. Le presentamos el campo mail.tags.campaigncuando enviamos un correo electrónico usando campaign como etiqueta de mensaje en Paso 6: enviarcorreos electrónicos (p. 318).

• mail.messageId

• eventType

• mail.sendingAccountId

• mail.timestamp

• mail.destination

• mail.tags.ses:configuration-set

• mail.tags.campaign

312


Para acceder a esta información en su base de datos, debe crear una tabla. El siguiente procedimientomuestra cómo especificar esta información al crear la tabla en su base de datos.

Note

Suponemos que SQL Workbench/J se encuentra abierto actualmente en su equipo y que estáconectado a su clúster de Amazon Redshift, tal y como se describe en el paso anterior (p. 309).

Para crear una tabla utilizando SQL Workbench/J

1. En SQL Workbench/J, copie el siguiente código y péguelo en la ventana Statement 1.

create table ses ( message_id varchar(200) not null, event_type varchar(20) not null, sending_account_id char(12), timestamp varchar(50), destination text, configuration_set text, campaign text);

2. Coloque el cursor en la instrucción (en algún lugar antes del punto y coma) y, a continuación,seleccione el botón Execute current statement, tal y como se muestra en la siguiente ilustración.

3. En el panel Messages, compruebe que su tabla se ha creado correctamente.

Paso siguiente

Paso 4: crear un flujo de entrega de Kinesis Data Firehose (p. 314)

313


Paso 4: crear un flujo de entrega de Kinesis Data Firehose

Para publicar eventos de envío de correo electrónico a Amazon Kinesis Data Firehose, debe crear unflujo de entrega de Kinesis Data Firehose. Al configurar un flujo de entrega de Kinesis Data Firehose,selecciona dónde publica los datos Kinesis Data Firehose. En este tutorial, configuraremos Kinesis DataFirehose para publicar los datos en Amazon Redshift y elegiremos que Kinesis Data Firehose publique losregistros en Amazon S3 como paso intermedio. En el proceso, es necesario especificar cómo debe copiarAmazon Redshift los registros de Amazon S3 en la tabla que hemos creado en el paso anterior (p. 312).

Esta sección muestra cómo crear un flujo de entrega de Kinesis Data Firehose que envía datos a AmazonRedshift y cómo editar el flujo de entrega para especificar cómo debe copiar Amazon Redshift los datos depublicación de evento de Amazon SES en Amazon S3.

Note

Ya debe haber configurado el clúster de Amazon Redshift (p. 309), conectado a suclúster (p. 309) y creado una tabla de base de datos (p. 312), como se ha explicado en lospasos anteriores.

Creación de un flujo de entrega de Kinesis Data Firehose

El siguiente procedimiento muestra cómo crear un flujo de entrega de Kinesis Data Firehose que publicadatos a Amazon Redshift, utilizando Amazon S3 como la ubicación de datos intermediaria.

Para crear un flujo de entrega desde Kinesis Data Firehose a Amazon Redshift

1. Inicie sesión en Consola de administración de AWS y abra la consola de Kinesis Data Firehose enhttps://console.aws.amazon.com/firehose/.

2. Elija Create Delivery Stream.3. En la página Destination, seleccione las opciones siguientes.

• Destination: elija Amazon Redshift.• Delivery stream name: escriba un nombre para el flujo de entrega.• S3 bucket: elija New S3 bucket, escriba un nombre de bucket, elija la región y, a continuación, elija

Create Bucket.• Redshift cluster: elija el clúster de Amazon Redshift que creó en un paso anterior.• Redshift database: escriba dev, que es el nombre de base de datos predeterminado.• Redshift table: escriba ses, que es la tabla que ha creado en Paso 3: Creación de una tabla de base

de datos (p. 312).• Redshift table columns: deje este campo en blanco.• Redshift username: escriba el nombre de usuario que eligió al configurar el clúster de Amazon

Redshift (p. 309).• Redshift password: escriba la contraseña que eligió al configurar el clúster de Amazon Redshift.• Redshift COPY options: deje este campo vacío.• Retry duration: deje este campo con su valor predeterminado.• COPY command: déjelo con su valor predeterminado. Lo actualizará en el siguiente procedimiento.

4. Seleccione Siguiente.5. En la página Configuration, deje los campos con la configuración predeterminada para este tutorial

sencillo. El único paso debe hacer consiste en seleccionar una función de IAM que permita a KinesisData Firehose acceder a sus recursos, tal y como se explica en el siguiente procedimiento.

a. Para IAM Role, elija Select an IAM role.b. En el menú desplegable, en Create/Update existing IAM role, elija Firehose delivery IAM role.

314

https://console.aws.amazon.com/firehose/


Accederá a la consola de IAM.c. En la consola de IAM, deje los campos con su configuración predeterminada y, a continuación,

elija Allow.

Se le devolverá a los pasos de configuración de flujo de entrega de Kinesis Data Firehose en laconsola de Kinesis Data Firehose.

6. Seleccione Siguiente.7. En la página Review, revise su configuración y, a continuación, elija Create Delivery Stream.

Configuración de opciones de copia de Amazon Redshift

A continuación, debe especificar para Amazon Redshift cómo copiar los registros JSON de publicación deeventos de Amazon SES en la tabla de base de datos que ha creado en Paso 3: Creación de una tablade base de datos (p. 312). Para ello, debe editar las opciones de copia en el flujo de entrega de KinesisData Firehose.

Para este procedimiento, debe crear un archivo JSONPaths. Un archivo JSONPaths es un archivo detexto que especifica al comando COPY de Amazon Redshift cómo analizar los datos de origen JSON.Proporcionamos un archivo JSONPaths en el procedimiento. Para obtener más información acerca delos archivos JSONPaths, consulte COPY from JSON Format en la Amazon Redshift Database DeveloperGuide.

El archivo JSONPaths se carga en el bucket de Amazon S3 que ha configurado al crear el flujo de entregade Kinesis Data Firehose y, a continuación, edite las opciones COPY del flujo de entrega de Kinesis DataFirehose para utilizar el archivo JSONPaths que ha cargado. Estos pasos se explican en el procedimientosiguiente.

Para establecer las opciones del comando COPY de Amazon Redshift

1. Crear un archivo JSONPaths: en su equipo, cree un archivo denominado jsonpaths.json. Copie elsiguiente texto en el archivo y, a continuación, guarde el archivo.

315

https://docs.aws.amazon.com/redshift/latest/dg/copy-usage_notes-copy-from-json.html


{ "jsonpaths": [ "$.mail.messageId", "$.eventType", "$.mail.sendingAccountId", "$.mail.timestamp", "$.mail.destination", "$.mail.tags.ses:configuration-set", "$.mail.tags.campaign" ]}

2. Cargar el archivo JSONPaths en el bucket Amazon S3: vaya a la consola de Amazon S3 y cargueel archivo en el bucket que ha creado al configurar el flujo de entrega de Kinesis Data Firehose enCreación de un flujo de entrega de Kinesis Data Firehose (p. 314).

3. Definir el comando COPY en la configuración de la transmisión de entrega de Kinesis Data Firehose:ahora dispone de la información que necesita para definir la sintaxis del comando COPY que utilizaAmazon Redshift cuando coloca los datos en la tabla que ha creado. El siguiente procedimientomuestra cómo actualizar la información del comando COPY en la configuración del flujo de entrega deKinesis Data Firehose.

1. Vaya a la consola de Kinesis Data Firehose.2. En Redshift Delivery Streams, elija el flujo de entrega de Kinesis Data Firehose que ha creado para

la publicación de eventos de Amazon SES.3. En la página Details, elija Edit.4. En el recuadro Redshift COPY options, escriba el texto siguiente, reemplazando los siguientes

valores por los suyos propios:• S3-BUCKET-NAME: el nombre del bucket de Amazon S3 donde Kinesis Data Firehose coloca

sus datos para que acceda Amazon Redshift. Ha creado este bucket al configurar el flujode entrega de Kinesis Data Firehose en Paso 4: crear un flujo de entrega de Kinesis DataFirehose (p. 314). Un ejemplo es: my-bucket.

• REGION: la región en la que se encuentran sus recursos de Amazon SES Kinesis Data Firehose,Amazon S3 y Amazon Redshift. Un ejemplo es: us-west-2.

json 's3://S3-BUCKET-NAME/jsonpaths.json' region 'REGION';

5. Seleccione Save.

316




Paso siguiente

Paso 5: configurar un conjunto de configuración (p. 317)

Paso 5: configurar un conjunto de configuración

Para configurar Amazon SES para que publique sus eventos de envío de correo electrónico en AmazonKinesis Data Firehose, primero debe crear un conjunto de configuración y, a continuación, añadir undestino de evento de Kinesis Data Firehose al conjunto de configuración. Esta sección muestra cómocumplir estas tareas.

Si ya tiene un conjunto de configuración definido, puede añadir un destino de Kinesis Data Firehose a suconjunto de configuración existente. En este caso, vaya a Añadir un destino de evento de Kinesis DataFirehose (p. 317).

Creación de un conjunto de configuración

El procedimiento siguiente muestra cómo crear un conjunto de configuración.

Para crear un conjunto de configuración



Añadir un destino de evento de Kinesis Data Firehose

El siguiente procedimiento muestra cómo añadir un destino de evento de Kinesis Data Firehose en elconjunto de configuración que ha creado.

317




Para añadir un destino de evento de Kinesis Data Firehose al conjunto de configuración

1. Elija el conjunto de configuración de la lista de conjuntos de configuración.2. Para Add Destination, elija Select a destination type y, a continuación, elija Kinesis Data Firehose.3. En Name, escriba un nombre para el destino de evento.4. Seleccione todos los tipos de evento en Event types.5. Seleccione Enabled.6. En Stream, elija el flujo de entrega que ha creado en Paso 4: crear un flujo de entrega de Kinesis Data

Firehose (p. 314).7. En IAM role, elija Let SES make a new role y, a continuación, escriba un nombre para la función.8. Seleccione Save.9. Para salir de la página Edit Configuration Set, utilice el botón Atrás de su navegador.

Paso siguiente

Paso 6: enviar correos electrónicos (p. 318)

Paso 6: enviar correos electrónicos

Para que Amazon SES publique eventos asociados con un correo electrónico, debe especificar unconjunto de configuración al enviar el correo electrónico. También puede incluir etiquetas de mensaje paracategorizar el correo electrónico. Esta sección muestra cómo enviar un correo electrónico sencillo queespecifica un conjunto de configuración y etiquetas de mensaje utilizando la consola de Amazon SES.Puede enviar el correo electrónico al simulador de bandeja de correo de Amazon SES para que puedaprobar los rebotes, las reclamaciones y otros resultados del envío de correo electrónico.

Para enviar un correo electrónico utilizando la consola de Amazon SES


2. En el panel de navegación de la consola de Amazon SES, en Identity Management, elija EmailAddresses.

3. En la lista de identidades, seleccione la casilla de verificación de una dirección de correo electrónicoque ha verificado correctamente con Amazon SES (p. 47).

4. Elija Send a Test Email.5. En el cuadro de diálogo Send Test Email, para Email Format, elija Raw.6. Para la dirección To, escriba una dirección desde el simulador de bandeja de correo

de Amazon SES (p. 173), como [email protected] [email protected].

7. Copie y pegue el siguiente mensaje en su totalidad en el cuadro de texto Message, reemplazandoCONFIGURATION-SET-NAME por el nombre del conjunto de configuración que creó en Paso 5:configurar un conjunto de configuración (p. 317) y reemplazando FROM-ADDRESS por la direcciónverificada desde la que está enviando este correo electrónico.

X-SES-MESSAGE-TAGS: campaign=bookX-SES-CONFIGURATION-SET: CONFIGURATION-SET-NAMESubject: Amazon SES Event Publishing TestFrom: Amazon SES User <FROM-ADDRESS>MIME-Version: 1.0Content-Type: text/plain

This is a test message.

8. Elija Send Test Email.

318




9. Repita este procedimiento varias veces para generar varios eventos de envío de correo electrónico.Para algunos de los correos electrónicos, cambie el valor de la etiqueta de mensajes campaign aclothing para simular el envío para una campaña distinta de correo electrónico. De ese modo,al consultar la base de datos de Amazon Redshift para registros de eventos de envío de correoelectrónico en el último paso de este tutorial, puede experimentar con consultas en función de lacampaña de correo electrónico.

Paso siguiente

Paso 7: consultar eventos de envío de correo electrónico (p. 319)

Paso 7: consultar eventos de envío de correo electrónicoAhora que ha generado algunos eventos de envío de correo electrónico mediante el envío de correoselectrónicos con la configuración de mensajes y etiquetas, puede consultar los registros en AmazonRedshift.

Note

Suponemos que SQL Workbench/J se encuentra abierto actualmente en su equipo y estáconectado a su clúster de Amazon Redshift, tal y como se describe en Paso 2: conexión al clústerde Amazon Redshift (p. 309).

Para consultar los datos de eventos de envío de correo electrónico en Amazon Redshift desdeSQL Workbench/J

1. Para mostrar todos sus registros de envío de correo electrónico, copie la consulta siguiente y péguelaen la ventana Statement 1.

select * from ses;

2. Coloque el cursor en la instrucción (en algún lugar antes del punto y coma) y, a continuación,seleccione el botón Execute current statement.

Verá los registros de envío de correo electrónico de todos los mensajes de correo electrónico queha enviado en Paso 6: enviar correos electrónicos (p. 318). Los registros de la siguiente ilustraciónmuestran que nuestra campaña book ha tenido dos reclamaciones y que la campaña clothing hatenido un rebote.

3. Para contar los registros complaint para la campaña de tipo book, copie y pegue la siguienteconsulta en la ventana Statement 1.

select count(*) as numberOfComplaint from ses where event_type = 'Complaint' and campaign like '%book%';

319


4. Coloque el cursor en la instrucción (en algún lugar antes del punto y coma) y, a continuación,seleccione el botón Execute current statement.

Los resultados son los siguientes, muestran que la campaña de libros ha tenido dos reclamaciones.

Visualizar eventos de envío de correo electrónico con AmazonElasticsearch Service y KibanaElasticsearch es un motor de búsqueda y análisis y de código abierto para casos de uso como análisis deregistros, monitoreo de aplicaciones en tiempo real. Amazon Elasticsearch Service (Amazon ES) es unservicio de AWS que permite la implementación, el funcionamiento y el escalado de Elasticsearch en lanube de AWS. Puede utilizar Amazon ES para el análisis de los eventos de envío de correo electrónico deAmazon SES.

En este tutorial, publica eventos de envío de correo electrónico de Amazon SES a un flujo de entregade Amazon Kinesis Data Firehose que publica datos eventos en Amazon ES. A continuación, consultalos datos con Kibana, una herramienta de visualización de código abierto diseñada para funcionar conElasticsearch. Amazon ES incluye integración incorporada con Kibana.


• Requisitos previos (p. 320)• Paso 1: crear un clúster de Amazon ES (p. 321)• Paso 2: crear un flujo de entrega de Kinesis Data Firehose (p. 322)• Paso 3: configurar un conjunto de configuración (p. 323)• Paso 4: enviar correos electrónicos (p. 324)• Paso 5: visualización de datos en Kibana (p. 325)

Requisitos previos



• Dirección de correo electrónico verificada: para enviar correos electrónicos utilizando Amazon SES, debeverificar su dirección de remitente ("From") o dominio para demostrar que le pertenece. Si está en elentorno de pruebas, también debe verificar sus direcciones de destinatario ("Para"). Puede verificar lasdirecciones de correo electrónico o los dominios completos, pero este tutorial requiere una dirección decorreo electrónico verificada para que pueda enviar un correo electrónico desde la consola de AmazonSES, que es la forma más sencilla de enviar un correo electrónico. Para obtener más información acerca

320

https://www.elastic.co/products/kibana



de cómo verificar una dirección de correo electrónico, consulte Verificación de direcciones de correoelectrónico en Amazon SES. (p. 47).

Paso siguiente

Paso 1: crear un clúster de Amazon ES (p. 321)

Paso 1: crear un clúster de Amazon ES

Antes de configurar Amazon Kinesis Data Firehose para publicar los eventos de envío de correoelectrónico de Amazon SES en Amazon Elasticsearch Service (Amazon ES), debe crear un clúster deAmazon ES. En esta sección se muestra cómo crear un clúster de Amazon ES utilizando la consola deAmazon ES.

A fin de simplificar este tutorial, hemos elegido opciones básicas. Para obtener información sobre todas lasopciones disponibles, consulte la Guía para desarrolladores de Amazon Elasticsearch Service.

Important

El clúster que implementa para este tutorial se ejecutará en un entorno real. Su clúster acumularácargos en su cuenta de AWS mientras esté en ejecución. Para evitar cargos innecesarios, debeeliminar su clúster cuando termine de usarlo. Para obtener información sobre los precios, consultela página de precios de Amazon Elasticsearch Service.

Pasos para crear un clúster de Amazon ES

1. Inicie sesión en Consola de administración de AWS y abra la consola de Amazon ElasticsearchService en https://console.aws.amazon.com/es/.

2. En la consola de Amazon ES, elija Get started.3. En la página Define domain, en Domain Name, escriba un nombre para su dominio de Amazon ES.4. En Version, deje el campo Elasticsearch version en su valor predeterminado.5. Seleccione Siguiente.6. En la página Configure cluster, en Node configuration, elija las opciones siguientes.

• Instance count: escriba 1.• Instance type: elija t2.micro.elasticsearch (compatible con la capa gratuita).• Enable dedicated master: no habilite esta opción.• Enable zone awareness: no habilite esta opción.

7. En Storage configuration, elija las siguientes opciones.

• Storage type: elija EBS. Para la configuración de EBS, elija EBS volume type de General Purpose(SSD) y EBS volume size de 10.

• Automated snapshot start hour: elija Automated snapshots start hour 00:00 UTC (default).8. Seleccione Siguiente.9. En la página Set up access policy, para Set the domain access policy to, elija Allow open access to the

domain.

Important

Esta configuración simplifica las pruebas, pero no se recomienda para entornos deproducción. Para obtener información sobre la configuración de políticas de acceso, consulteConfiguring Access Policies en la Guía para desarrolladores de Amazon ElasticsearchService.

10. Seleccione Siguiente.

321

https://docs.aws.amazon.com/elasticsearch-service/latest/developerguide/what-is-amazon-elasticsearch-service.html

https://aws.amazon.com/elasticsearch-service/pricing/

https://console.aws.amazon.com/es/

https://docs.aws.amazon.com/elasticsearch-service/latest/developerguide/es-createupdatedomains.html#es-createdomain-configure-access-policies


11. En la página Review, revise la configuración y seleccione Confirm and create.

Note

El clúster tardará hasta diez minutos en implementarse.

Paso siguiente



Para publicar eventos de envío de correo electrónico a Amazon Kinesis Data Firehose, debe crear unflujo de entrega de Kinesis Data Firehose. Al configurar un flujo de entrega de Kinesis Data Firehose,selecciona dónde publica los datos Kinesis Data Firehose. En este tutorial, configuramos Kinesis DataFirehose para publicar los datos en Amazon Elasticsearch Service (Amazon ES).

En esta sección se muestra cómo crear un flujo de entrega de Kinesis Data Firehose utilizando la consolade Kinesis Data Firehose. A fin de simplificar este tutorial, hemos elegido opciones básicas. Para obtenerinformación acerca de todas las opciones disponibles, consulte Creating an Amazon Kinesis FirehoseDelivery Stream en la Guía para desarrolladores de Amazon Kinesis Data Firehose.

Note

Debe haber configurado un clúster de Amazon ES, tal como se explica en Paso 1: crear un clústerde Amazon ES (p. 321).

Para crear un flujo de entrega desde Kinesis Data Firehose a Amazon Elasticsearch Service



• Destination: elija Amazon Elasticsearch Service.• Delivery stream name: escriba un nombre para el flujo de entrega.• Elasticsearch domain: elija el dominio de Amazon ES que ha creado en Paso 1: crear un clúster de

Amazon ES (p. 321).• Index: escriba un nombre que desea utilizar para explorar sus datos de eventos de envío de correo

electrónico en Kibana. Puede elegir cualquier nombre, pero vamos a utilizar holiday-sale paraeste tutorial. Un índice es análogo a una base de datos. Por ejemplo, si desea una forma sencilla deacceder a eventos de cada una de sus campañas de correo electrónico por separado, puede utilizarun flujo de Kinesis Data Firehose e índice distinto para cada campaña.

• Index rotation: elija NoRotation.• Type: aunque este ajuste no es pertinente para este tutorial, debe elegir algo, por tanto escribaevents. Un tipo es una categoría o partición lógica de su índice.

• Retry duration (sec): introduzca 300.• Backup mode: elija Failed Documents Only.• S3 bucket: elija New S3 Bucket. Escriba un nombre para el bucket y elija la región que está

utilizando actualmente su consola.• S3 prefix: deje este campo vacío.

4. Seleccione Siguiente.5. En la página Configuration, deje los campos con la configuración predeterminada. El único paso debe

hacer consiste en seleccionar una función de IAM que permita a Kinesis Data Firehose acceder a susrecursos, tal y como se explica en el siguiente procedimiento.

322






Accederá a la consola de IAM.c. En la consola de IAM, deje los campos con su configuración predeterminada y, a continuación,

elija Allow.

Se le devolverá a los pasos de configuración de flujo de entrega de Kinesis Data Firehose en laconsola de Kinesis Data Firehose.

6. Seleccione Siguiente.7. En la página Review, revise su configuración y, a continuación, elija Create Delivery Stream.

Paso siguiente



Para configurar Amazon SES para que publique sus eventos de envío de correo electrónico en AmazonKinesis Data Firehose, primero debe crear un conjunto de configuración y, a continuación, añadir undestino de evento de Kinesis Data Firehose al conjunto de configuración. Esta sección muestra cómocumplir estas tareas.




323










Paso siguiente






2. En el panel Navigation de la consola de Amazon SES, en Identity Management, elija Email Addresses.3. En la lista de identidades, seleccione la casilla de verificación de una dirección de correo electrónico

que ha verificado correctamente con Amazon SES (p. 47).4. Elija Send a Test Email.5. En el cuadro de diálogo Send Test Email, para Email Format, elija Raw.6. Para la dirección To, escriba una dirección desde el simulador de bandeja de correo


324







X-SES-MESSAGE-TAGS: campaign=bookX-SES-CONFIGURATION-SET: CONFIGURATION-SET-NAMESubject: Amazon SES Event Publishing TestFrom: Amazon SES User <FROM-ADDRESS>MIME-Version: 1.0Content-Type: text/plain


8. Elija Send Test Email.9. Repita este procedimiento varias veces para generar varios eventos de envío de correo electrónico.

Para algunos de los correos electrónicos, cambie el valor de la etiqueta de mensajes campaign aclothing para simular el envío para una campaña distinta de correo electrónico.

Paso siguiente

Paso 5: visualización de datos en Kibana (p. 325)

Paso 5: visualización de datos en Kibana

Ahora que ha publicado algunos eventos de envío de correo electrónico de Amazon SES en AmazonElasticsearch Service (Amazon ES) mediante el envío de correos electrónicos con su conjunto deconfiguración y etiquetas de mensajes, puede visualizar los eventos con Kibana, una interfaz web deElasticsearch.

Esta sección muestra cómo encontrar sus eventos de envío de correo electrónico en Kibana, representargráficamente sus eventos de envío de correo electrónico por tipo de evento y encontrar las direccionesde correo electrónico con rebotes. Estos ejercicios resultan útiles, ya que monitorear los rebotes yreclamaciones es una parte importante del mantenimiento de la lista de correo.

• Consultar sus eventos de envío de correo electrónico (p. 325)• Representación gráfica de sus eventos de envío de correo electrónico por tipo (p. 327)• Buscar las direcciones de destinatarios con rebotes (p. 328)

Para consultar la documentación y los tutoriales de Kibana, consulte la Guía del usuario de Kibana.

Consultar sus eventos de envío de correo electrónico

El siguiente procedimiento muestra cómo ir a la interfaz de usuario de Kibana desde la consola de AmazonES. A continuación le muestra cómo ver los eventos de envío de correo electrónico asociados con el índiceque define al configurar su flujo de entrega de Amazon Kinesis Data Firehose en Paso 2: crear un flujo deentrega de Kinesis Data Firehose (p. 322).

Para ver sus eventos de envío de correo electrónico sin procesar en Kibana

1. Inicie sesión en Consola de administración de AWS y abra la consola de Amazon ElasticsearchService en https://console.aws.amazon.com/es/.

2. En My Elasticsearch domains, elija el dominio que creó en Paso 1: crear un clúster de AmazonES (p. 321).

3. Elija el enlace de Kibana.

325

https://www.elastic.co/guide/en/kibana/current/index.html

https://console.aws.amazon.com/es/


Se dirigirá a la interfaz web de Kibana.4. En la página Configure an index pattern, desactive la casilla de verificación Index contains time-based

events.5. En Index name or pattern, verifique que holiday-sale, el índice que creó en Paso 1: crear un

clúster de Amazon ES (p. 321), está presente. Si no está presente, escriba holiday-sale* en elcampo y, a continuación, elija Create.

Note

Si el botón Create no aparece, intente añadir un asterisco al final del patrón de índice.

6. Elija la pestaña Discover en el menú superior.7. En el cuadro de búsqueda debajo de la pestaña Discover, coloque el cursor detrás del asterisco (*) y,

a continuación, pulse Intro.

Kibana mostrará una lista de todos sus eventos de envío de correo electrónico.

326


Representación gráfica de sus eventos de envío de correo electrónico por tipo

Para obtener información sobre la salud global de su campaña de correo electrónico, puede compararvisualmente el número de resultados problemáticos (rebotes, reclamaciones y correos electrónicosrechazados) que haya recibido en su campaña. El siguiente procedimiento muestra cómo configurar ungráfico de barras verticales que muestra el recuento de cada tipo de evento de envío de correo electrónico.

Para representar gráficamente los eventos de envío de correo electrónico por tipo

1. Elija la pestaña Visualize en el menú superior.2. Elija Vertical bar chart.3. Elija From a new search. Si se le solicita un patrón de índice, elija holiday-sale*.4. En el panel de métricas, junto a Y-Axis, asegúrese de que la métrica se haya establecido en Count.5. En el panel Buckets, elija X-Axis.6. Para Aggregation, elija Terms. Terms hace referencia a los campos en sus documentos JSON en su

índice.7. Para Field, en String, elija eventType. Deje el resto de los campos con sus valores predeterminados.8. Junto a Options, seleccione el botón de reproducción. Se mostrará en la pantalla el gráfico de barras

con la comparación de tipos de eventos.

327


9. Para guardar la visualización, seleccione el icono de guardar en el grupo de iconos que se encuentraa la derecha de la barra de búsqueda.

10. Escriba un título como, por ejemplo, Todos los tipos de evento y, a continuación, seleccione Save.

Buscar las direcciones de destinatarios con rebotes

Ahora que ya dispone de una visualización de la salud de la campaña de correo electrónico global, puedevolver a los datos sin procesar y averiguar qué direcciones de destinatarios han presentado rebotes, tal ycomo se describe en el siguiente procedimiento.

Para ver las direcciones de correo electrónico que rebotan

1. Vaya a la pestaña Discover del menú superior.

Verá una lista de los registros de eventos sin procesar.

Note

Si la ventana principal indica que hay cero resultados de búsqueda, introduzca * en la barrade búsqueda y, a continuación, pulse Intro.

2. En el panel izquierdo, en Available Fields, coloque el cursor sobre eventType y, a continuación, elija elbotón add que aparece a su lado.

328


3. En la ventana principal, coloque el cursor sobre el encabezado de columna eventType y, acontinuación, elija la flecha para ordenar los tipos de evento por nombre.

Los eventos de rebote se moverán a la parte superior de la lista.

Note

Es posible que haya un pequeño retraso antes de que los eventos se vuelvan a ordenar.

4. En el panel izquierdo, en Available Fields, coloque el cursor sobre bounce.bouncedRecipients y, acontinuación, elija el botón add que aparece a su lado.

En la ventana principal, verá la dirección del destinatario y el motivo del rebote de cada evento derebote.

329


Representar eventos gráficamente en Amazon CloudWatchEn este tutorial, publicará eventos de envío de correo electrónico de Amazon SES en Amazon CloudWatchy, a continuación, representará los eventos gráficamente utilizando la consola de CloudWatch.


• Requisitos previos (p. 330)• Paso 1: configurar un conjunto de configuración (p. 331)• Paso 2: enviar correos electrónicos (p. 332)• Paso 3: representar gráficamente eventos (p. 333)

Requisitos previos




Paso siguiente


330




Para configurar Amazon SES para que publique sus eventos de envío de correo electrónico en AmazonCloudWatch, primero debe crear un conjunto de configuración y, a continuación, añadir un destino deevento de CloudWatch al conjunto de configuración. Esta sección muestra cómo cumplir estas tareas.

Si ya tiene un conjunto de configuración definido, puede añadir un destino de CloudWatch a su conjunto deconfiguración existente. En este caso, vaya a Añadir un destino de evento de CloudWatch (p. 331).






Añadir un destino de evento de CloudWatch

El siguiente procedimiento muestra cómo añadir un destino de evento de CloudWatch en el conjunto deconfiguración que ha creado.

Para añadir un destino de evento de CloudWatch a un conjunto de configuración


2. En el panel de navegación izquierdo, elija Configuration Sets.3. Elija el conjunto de configuración que creó en el procedimiento anterior.4. Para Add Destination, elija Select a destination type y, a continuación, elija CloudWatch.5. En Name, escriba un nombre para el destino de evento.6. Para Event types, elija Bounce y Complaint.7. Seleccione Enabled.8. Para Value Source, elija Message Tag.9. Para Dimension Name, escriba campaign.10. Para Default Value, escriba unknown.

331






11. Seleccione Save.12. Para salir de la página Edit Configuration Set, utilice el botón Atrás de su navegador.





2. En el panel Navigation de la consola de Amazon SES, en Identity Management, elija Email Addresses.3. En la lista de identidades, seleccione la casilla de verificación de una dirección de correo electrónico

que ha verificado correctamente con Amazon SES (p. 47).4. Elija Send a Test Email.5. En el cuadro de diálogo Send Test Email, para Email Format, elija Raw.6. Para la dirección To, escriba una dirección desde el simulador de bandeja de correo



X-SES-MESSAGE-TAGS: campaign=bookX-SES-CONFIGURATION-SET: CONFIGURATION-SET-NAMESubject: Amazon SES Event Publishing TestFrom: Amazon SES User <FROM-ADDRESS>

332




MIME-Version: 1.0Content-Type: text/plain


8. Elija Send Test Email.9. Repita este procedimiento varias veces para generar varios eventos de envío de correo electrónico.

Para algunos de los correos electrónicos, cambie el valor de la etiqueta de mensajes campaign aclothing para simular el envío para una campaña distinta de correo electrónico.

Paso siguiente

Paso 3: representar gráficamente eventos de envío de correo electrónico (p. 333)

Paso 3: representar gráficamente eventos de envío de correo electrónico

Ahora que ha publicado algunos eventos de envío de correo electrónico de Amazon SES en CloudWatchmediante el envío de correos electrónicos con su conjunto de configuración y etiquetas de mensajes,puede representar gráficamente métricas para dichos eventos utilizando la consola de CloudWatch.

Para representar gráficamente las métricas de eventos de envío de correo electrónico

1. Inicie sesión en la Consola de administración de AWS y abra la consola de CloudWatch en https://console.aws.amazon.com/cloudwatch/.

2. En el panel de navegación izquierdo, en Metrics.3. En la pestaña All metrics, seleccione SES.

También puede escribir SES en el campo de búsqueda.4. Elija Per configuration set.5. Seleccione la métrica que desea ver.

Aparece un gráfico en el panel de detalles.

Analizar eventos de envío de correo electrónico con AmazonKinesis Data AnalyticsAmazon Kinesis Data Analytics le permite procesar y analizar datos de streaming mediante SQL. Puedeutilizar Amazon Kinesis Data Analytics para el análisis de los eventos de envío de correo electrónico deAmazon SES.

En este tutorial, primero debe configurar un conjunto de configuración de Amazon SES para publicarsus eventos de envío de correo electrónico en un flujo de entrega de Amazon Kinesis Data Firehosey, a continuación, envía correos electrónicos a través de Amazon SES utilizando dicho conjunto deconfiguración. A continuación, configura Amazon Kinesis Data Analytics para capturar los eventos de envíode correo electrónico desde el flujo Kinesis Data Firehose y utiliza SQL para extraer información clave delos mensajes de correo electrónico que ha enviado.

Note

Este tutorial requiere que disponga de una aplicación que puede enviar un flujo constantede correos electrónicos a través de Amazon SES. Este requisito se explica en Requisitosprevios (p. 334).

Las secciones siguientes le guían a través del tutorial.

• Requisitos previos (p. 334)

333




• Paso 1: crear un flujo de entrega de Kinesis Data Firehose (p. 334)• Paso 2: configurar un conjunto de configuración (p. 336)• Paso 3: enviar correos electrónicos (p. 337)• Paso 4: crear una aplicación de Amazon Kinesis Data Analytics (p. 337)• Paso 5: ejecutar una consulta SQL (p. 341)• (Opcional) Paso 6: guardar resultados de consulta SQL (p. 342)

Requisitos previos

Para este tutorial, necesita lo siguiente:



• Email application: para utilizar Amazon Kinesis Data Analytics tal como se describe en este tutorial,debe enviar un flujo constante de correos electrónicos a través de Amazon SES para generar un flujoconstante de eventos de envío de correo electrónico. Esto permite a Amazon Kinesis Data Analyticsdetectar automáticamente el esquema y, a continuación, procesar los registros de eventos con SQL.Enviar un correo electrónico cada diez segundos durante cinco minutos es suficiente para este tutorial.

Important

Si no tiene una campaña existente de correo electrónico que enviar a destinatarios reales, lerecomendamos encarecidamente que envíe correos electrónicos a una dirección simulador debandeja de correo de Amazon SES (p. 173). Los correos electrónicos que envíe al simulador debandeja de correo no contabilizan para las tasas de rebotes y reclamaciones de Amazon SES opara su cuota de envío diaria.

Paso siguiente



Para analizar los eventos de envío de correo electrónico de Amazon SES con Amazon Kinesis DataAnalytics, debe configurar Amazon SES para publicar los eventos en un flujo de entrega de AmazonKinesis Data Firehose y, a continuación, configurar Amazon Kinesis Data Analytics para obtener los datosde eventos desde Kinesis Data Firehose.

Al configurar un flujo de entrega de Kinesis Data Firehose, selecciona el destino final de los datos. Susopciones de destino son Amazon Simple Storage Service (Amazon S3), Amazon Elasticsearch Service yAmazon Redshift. Si solo desea analizar los eventos de envío de correo electrónico con Amazon KinesisData Analytics, no importa el destino que elija. En este tutorial, configuramos Kinesis Data Firehose parapublicar los datos en Amazon S3, pero puede utilizar las demás opciones de destino si están en la mismaregión que su flujo de entrega de Kinesis Data Firehose y envío de Amazon SES.

En esta sección se muestra cómo crear un flujo de entrega de Kinesis Data Firehose utilizando la consolade Kinesis Data Firehose. Para este tutorial, elija opciones básicas. Para obtener información acerca de

334



todas las opciones disponibles, consulte Creating an Amazon Kinesis Firehose Delivery Stream en la Guíapara desarrolladores de Amazon Kinesis Data Firehose.

Para crear un flujo de entrega desde Kinesis Data Firehose a Amazon S3



• Destination: elija Amazon S3.• Delivery stream name: escriba un nombre para el flujo de entrega.• S3 bucket: elija un bucket existente o elija New S3 Bucket. Si crea un bucket nuevo, escriba un

nombre para el bucket y elija la región que está utilizando actualmente su consola.• S3 prefix: deje este campo vacío.

4. Seleccione Siguiente.5. En la página Configuration, deje los campos con la configuración predeterminada. El único paso

obligatorio consiste en seleccionar una función de IAM que permita a Kinesis Data Firehose acceder asus recursos, tal y como se indica a continuación:


Accede a la consola de IAM.c. En la consola de IAM, deje los campos con su configuración predeterminada y, a continuación,

elija Allow.

Se le devuelve a los pasos de configuración de flujo de entrega de Kinesis Data Firehose en laconsola de Kinesis Data Firehose.

6. Seleccione Siguiente.

335




7. En la página Review, revise su configuración y, a continuación, elija Create Delivery Stream.

Paso siguiente



Para configurar Amazon SES para que publique sus eventos de envío de correo electrónico en AmazonKinesis Data Firehose, debe crear un conjunto de configuración y, a continuación, añadir un destino deevento de Kinesis Data Firehose al conjunto de configuración. Esta sección describe cómo cumplir estastareas.



El procedimiento siguiente describe cómo crear un conjunto de configuración.









Paso siguiente


336




Paso 3: enviar correos electrónicosDado que este tutorial utiliza la consola de Amazon Kinesis Data Analytics para procesar y analizardatos de streaming, debe configurar un flujo constante de correos electrónicos a través de Amazon SES.Este tutorial supone que dispone de una aplicación que puede enviar estos correos electrónicos. Enviarun correo electrónico cada diez segundos durante cinco minutos es suficiente para este tutorial. Serecomienda encarecidamente que utilice una dirección de destinatario ("Para") del simulador de bandeja decorreo de Amazon SES (p. 173) como, por ejemplo, [email protected].

Para permitir la publicación de eventos para un correo electrónico, proporcione el nombre del conjuntode configuración establecido en Amazon SES al enviar el correo electrónico. Opcionalmente puedeincluir etiquetas de mensaje para categorizar el correo electrónico. Debería proporcionar esta informacióna Amazon SES como parámetros para el API de envío de correo electrónico, encabezados de correoelectrónico específicos de Amazon SES o encabezados personalizados en su mensaje de MIME. Paraobtener más información, consulte Send Email Using Amazon SES Event Publishing (p. 268).

Por ejemplo, podría añadir los siguientes encabezados de correo electrónico específicos de AmazonSES a su correo electrónico para simular una campaña de libros. Reemplace CONFIGURATION-SET-NAME por el nombre del conjunto de configuración que ha creado en Paso 2: configurar un conjunto deconfiguración (p. 336).

X-SES-CONFIGURATION-SET: CONFIGURATION-SET-NAMEX-SES-MESSAGE-TAGS: campaign=book

Paso siguiente

Paso 4: crear una aplicación de Amazon Kinesis Data Analytics (p. 337)

Paso 4: crear una aplicación de Amazon Kinesis Data AnalyticsAhora que ha configurado la publicación de eventos con Amazon SES, puede configurar Amazon KinesisData Analytics para capturar los datos de eventos de envío de correo electrónico desde su flujo de entregade Amazon Kinesis Data Firehose. Para hacerlo, debe crear una aplicación de Amazon Kinesis DataAnalytics.

El siguiente procedimiento muestra cómo utilizar la consola de Amazon Kinesis Data Analytics para crearuna aplicación que captura datos de eventos de envío de correo electrónico de Amazon SES desde su flujode entrega de Kinesis Data Firehose y, a continuación, cómo realizar una consulta SQL simplemente enlos datos para devolver los eventos del tipo "Enviar".

Note

Los eventos de envíos de correo electrónico de distintos tipos de evento (envío, rebote,reclamación y entrega) tienen diferentes esquemas JSON (p. 272). En un entorno deproducción, podría examinar varios campos de este esquema, pero en este tutorial, limitamosnuestro examen a un pequeño conjunto de campos que están presentes en todos los tipos deeventos.

Para crear una aplicación de Amazon Kinesis Data Analytics

1. Empiece a enviar un flujo constante de correos electrónicos configurados para la publicaciónde eventos a través de Amazon SES y continúe enviando correos electrónicos a través de esteprocedimiento. Esto es necesario para que Amazon Kinesis Data Analytics pueda detectarautomáticamente el esquema de los registros de eventos. Enviar un correo electrónico cada diezsegundos durante cinco minutos es suficiente para este tutorial. Para obtener más información,consulte Paso 3: enviar correos electrónicos (p. 337).

Después de que su programa de correo electrónico haya enviado algunos correos electrónicos, vayaal siguiente paso.

337


2. Inicie sesión en Consola de administración de AWS y abra la consola de Kinesis Data Analytics en https://console.aws.amazon.com/kinesisanalytics.

3. Elija Create new application.4. Introduzca un nombre y descripción de la aplicación y, a continuación, elija Save and continue.5. Elija Connect to a source.6. Elija el flujo de Kinesis Data Firehose que ha creado en Paso 2: configurar un conjunto de

configuración (p. 336).

Amazon Kinesis Data Analytics intenta descubrir el esquema de los registros de evento de envío decorreo electrónico en función de los registros de entrada. Si Amazon Kinesis Data Analytics muestraError discovering input schema, ello significa que Amazon Kinesis Data Analytics no ha enviadotodavía ningún registro de envío de correo electrónico. Seleccione Rediscover schema. Es posible quetenga que elegir este botón varias veces. Si el descubrimiento de esquema no tiene éxito despuésde varios intentos, asegúrese de que su aplicación de envío de correo electrónico esté enviandocorreos electrónicos de forma continua y que los correos electrónicos especifiquen un conjunto deconfiguración.

Cuando Amazon Kinesis Data Analytics detecta un esquema, muestra un mensaje de confirmación ymuestra los registros que ha detectado.

Important

No elija Save and continue. Esto provocará errores, ya que el esquema detectado no cumplelas restricciones de nomenclatura de SQL. Debe editar el esquema tal y como se describe enel siguiente paso.

7. Seleccione Edit schema.

8. En este tutorial, eliminamos la mayoría de las filas. Elija X junto a todas las filas excepto las filas conlos siguientes nombres de columna:

• eventType

338

https://console.aws.amazon.com/kinesisanalytics



• timestamp• messageId• to• ses:configuration-set

Important

No elija Save schema and update stream samples. Esto provocará errores, ya que elesquema detectado no cumple las restricciones de nomenclatura de SQL. Debe editar elesquema tal y como se describe en el siguiente paso.

9. Examine las entradas restantes en Column name y compárelas con los requisitos de nomenclatura deSQL como se indica a continuación:

• Format: tal como se describe en Identifiers en la Referencias de SQL en Amazon Kinesis DataAnalytics, los identificadores sin entrecomillar deben empezar por una letra o guion bajo y deben irseguidos de letras, dígitos o guiones bajos. Los nombres de etiquetas automática de Amazon SESno cumplen estos requisitos ya que contienen dos puntos y guiones. Los editará en el siguientepaso.

• Reserved words: los nombres de columna no deben tener conflictos con las palabras reservadas deSQL mostradas en Reserved Words and Keywords en la Referencias de SQL en Amazon KinesisData Analytics. Ejemplos de palabras clave reservadas que entran en conflicto con registros deeventos de Amazon SES son timestamp, value, date, from y to.

10. Edite los nombres de columna restantes para cumplir los requisitos de SQL de la siguiente manera:

• Cambie el nombre de ses:configuration-set a ses_configuration_set.• Cambie el nombre de timestamp a ses_timestamp.• Cambie el nombre de to a ses_to.

339

https://docs.aws.amazon.com/kinesisanalytics/latest/sqlref/sql-reference-identifiers.html

https://docs.aws.amazon.com/kinesisanalytics/latest/sqlref/sql-reference-reserved-words-keywords.html


11. Elija Save schema and update stream samples. Si detecta errores de validación, asegúrese de realizarcorrectamente el paso 10. Si encuentra el error No rows in source stream, asegúrese de que todavíaenvía el flujo de correo electrónico que empezó al inicio de este procedimiento y, a continuación, elijaRetrieve rows. Es posible que tenga que elegir Retrieve rows varias veces antes de que AmazonKinesis Data Analytics capture registros.

12. Una vez recuperadas correctamente las filas, elija Exit (done).

Paso siguiente

Paso 5: ejecutar una consulta SQL (p. 341)

340


Paso 5: ejecutar una consulta SQL

Ahora que ha creado una aplicación de Amazon Kinesis Data Analytics y la ha configurado para utilizar suflujo de entrega de Amazon Kinesis Data Firehose como origen, puede consultar los datos de evento deenvío de correo electrónico que recibe el flujo de entrega de Kinesis Data Firehose.

En este tema se muestra cómo ejecutar una consulta SQL en los datos de eventos de envío de correoelectrónico.

Important

Este procedimiento exige que siga enviando un flujo constante de correos electrónicosconfigurados para la publicación de eventos a través de Amazon SES, tal y como se describe enPaso 3: enviar correos electrónicos (p. 337).

Para ejecutar una consulta de SQL en Amazon Kinesis Data Analytics

1. Suponiendo que haya avanzado a este procedimiento después de completar el último paso (p. 337),vaya al menú superior de la consola de Amazon Kinesis Data Analytics y elija su aplicación.

2. Seleccione Go to SQL editor.

Amazon Kinesis Data Analytics intenta leer datos de eventos desde el flujo de Kinesis Data Firehose.Si encuentra el error No rows in source stream, asegúrese de que todavía envía el flujo de correoelectrónico que empezó al inicio de este procedimiento y, a continuación, elija Retrieve rows.

341


3. En el cuadro del editor de código, pegue lo siguiente.

CREATE OR REPLACE STREAM "DESTINATION_SQL_STREAM" ("eventType" VARCHAR(16), "ses_timestamp" timestamp, "messageId" VARCHAR(64), "ses_to" VARCHAR(64), "ses_configuration_set" VARCHAR(32));

CREATE OR REPLACE PUMP "STREAM_PUMP" AS INSERT INTO "DESTINATION_SQL_STREAM"

SELECT STREAM "eventType", "ses_timestamp", "messageId", "ses_to", "ses_configuration_set"FROM "SOURCE_SQL_STREAM_001"WHERE "eventType" = 'Send'

4. Elija Save and run SQL.

Una vez que Amazon Kinesis Data Analytics recupera y procesa los registros entrantes, verá una listade registros de evento de tipo "Send".

Paso siguiente

(Opcional) Paso 6: guardar resultados de consulta SQL (p. 342)

(Opcional) Paso 6: guardar resultados de consulta SQL

Puede configurar su aplicación de Amazon Kinesis Data Analytics para escribir el resultado de susconsultas SQL en un flujo de entrega de Amazon Kinesis Data Firehose. Para hacerlo, debe crear otro flujode entrega de Kinesis Data Firehose dado que no puede utilizar el mismo flujo de entrega como origen ydestino de una aplicación de Amazon Kinesis Data Analytics. Al igual que con cualquier flujo de entrega deKinesis Data Firehose, puede elegir Amazon Simple Storage Service (Amazon S3), Amazon ElasticsearchService o Amazon Redshift como destino.

El procedimiento siguiente muestra cómo configurar Amazon Kinesis Data Analytics para guardarlos resultados de consulta SQL en formato JSON a un flujo de entrega de Kinesis Data Firehose queescribe los datos en Amazon S3. A continuación, puede ejecutar una consulta SQL y acceder a los datosguardados.

342


Para guardar los resultados de consultas SQL en Amazon S3

1. Configure un nuevo flujo de Kinesis Data Firehose que utiliza Amazon S3 como destino. Es el mismoprocedimiento que Paso 1: crear un flujo de entrega de Kinesis Data Firehose (p. 334).

2. Vaya a la consola de Amazon Kinesis Data Analytics, elija la flecha junto a su aplicación y, acontinuación, elija Application details.

3. Elija Connect to a destination.

4. Elija el flujo de Kinesis Data Firehose que creó en el paso 1, deje el resto de las opciones con suconfiguración predeterminada y, a continuación, elija Save and continue.

En unos segundos, debe volver a la página principal de la aplicación.

343



5. Seleccione Go to SQL results.

6. Elija Save and run SQL para volver a ejecutar la consulta que ejecutó en Paso 5: ejecutar una consultaSQL (p. 341).

Amazon Kinesis Data Analytics intenta procesar datos de eventos que recibe desde el flujo de entregade Kinesis Data Firehose. Si encuentra el error No rows have arrived yet, asegúrese de que sigueenviando correos electrónicos de modo que Amazon Kinesis Data Analytics tenga eventos de envío decorreo electrónico que procesar.

344


A medida que Amazon Kinesis Data Analytics procesa registros, los resultados aparecerán en lapestaña Real-time analytics. Amazon Kinesis Data Analytics guarda automáticamente los resultadosen el bucket de Amazon S3 que especificó al configurar el flujo de entrega de Kinesis Data Firehoseen el paso 1.

7. Para recuperar los resultados, vaya a la consola de Amazon S3.8. Elija el bucket de Amazon S3 que está asociado al flujo de entrega de Kinesis Data Firehose que la

aplicación de Amazon Kinesis Data Analytics utiliza como su destino.9. Acceda a los datos que, de forma predeterminada, se organizan en una jerarquía de carpetas en

función de la fecha en que se guardaron en el bucket los resultados.

Si el bucket está vacío, espere unos minutos e inténtelo de nuevo. Se puede tardar varios minutos enobtener los datos desde Amazon Kinesis Data Analytics a su bucket de Amazon S3.

10. Elija un archivo y, a continuación, desde el menú Actions, elija Download.

345


Amazon Simple Email Service Developer GuideConfiguración de dominios personalizados de

mensajes abiertos y en los que se ha hecho clic

11. Siga las instrucciones que aparecen en pantalla para descargar el archivo en su equipo.12. En su equipo, abra el archivo con un editor de texto. Los registros están en formato JSON y cada

registro se encuentra entre llaves. El siguiente es un ejemplo de un archivo que contiene dos registros.

{"eventType":"Send","ses_timestamp":"2016-12-08 18:51:12.092","messageId":"EXAMPLE8dfc6695c-5f048b74-ca83-4052-8348-4e7da9669fc3-000000","ses_to":"[\"[email protected]\" ]","ses_configuration_set":"[\"MyConfigSet\" ]"}{"eventType":"Send","ses_timestamp":"2016-12-08 18:50:42.181","messageId":"EXAMPLEdfc5f485-d40a2543-2cac-4b84-8a8f-30bebdf3820c-000000","ses_to":"[\"[email protected]\" ]","ses_configuration_set":"[\"MyConfigSet\" ]"}

Configuración de dominios personalizados paragestionar seguimiento de mensajes abiertos y en losque se ha hecho clicCuando se utiliza la publicación de eventos (p. 259) para capturar los eventos de mensajes abiertosy en los que se ha hecho clic, Amazon SES realiza pequeños cambios en los correos electrónicos queenvía. Para capturar los eventos de mensajes abiertos, Amazon SES añade una imagen transparente de1 píxel por 1 pixel en la parte inferior de cada correo electrónico. Esta imagen tiene un nombre de archivoúnico para cada correo electrónico y está alojada en un servidor operado por Amazon SES. Para capturarlos eventos de clic en enlace, Amazon SES sustituye los enlaces de los mensajes de correo electrónicopor enlaces a un servidor operado por Amazon SES. Esto redirige inmediatamente el destinatario a sudestino previsto. Algunos clientes de Amazon SES podrían desear utilizar sus propios dominios, en lugarde los dominios que posee y opera Amazon SES, para crear una experiencia más coherente para susdestinatarios.

Puede configurar varios dominios personalizados para gestionar eventos de seguimiento de mensajesabiertos y en los que se ha hecho clic. Estos dominios personalizados están asociados a conjuntos deconfiguración. Cuando envíe un correo electrónico a través de un conjunto de configuración, si dichoconjunto de configuración está configurado para utilizar un dominio personalizado, entonces los enlacesde clic y mensaje abierto en dicho correo electrónico utilizan automáticamente el dominio personalizadoespecificado en dicho conjunto de configuración.

Esta sección contiene procedimientos para configurar un subdominio en un servidor de su propiedadpara redirigir automáticamente a los usuarios a los servidores de seguimiento de mensajes abiertos y enlos que se ha hecho clic operados por Amazon SES. La configuración de estos dominios conlleva dospasos. En primer lugar, debe configurar el propio subdominio y, a continuación, configure un conjunto deconfiguración para utilizar el dominio personalizado. Este tema contiene procedimientos para completarambos pasos.

Parte 1: Configurar un dominio para gestionar redirecciones deseguimiento de mensajes abiertos y en los que se ha hecho clicLos procedimientos específicos para configurar un dominio de redireccionamiento varían en función desu proveedor de servicios de alojamiento web (y su red de entrega de contenido, si utiliza un servidorHTTPS). Los procedimientos de las secciones siguientes ofrecen directrices generales en lugar de pasosespecíficos.

346



Opción 1: configuración de un dominio HTTP

Si planea utilizar un dominio HTTP para gestionar mensajes abiertos y en los que se ha hecho clic (encontraposición a un dominio HTTPS), el proceso para configurar el subdominio conlleva únicamentealgunos pasos.

Note

Si configura un dominio personalizado que utilice el protocolo HTTP y envía un correo electrónicoque contiene vínculos que utilizan el protocolo HTTPS, los clientes podrían ver un mensaje deadvertencia cuando hacen clic en los enlaces de su correo electrónico. Si tiene previsto enviarcorreos electrónicos que contengan enlaces que utilicen el protocolo HTTPS, debería utilizar undominio HTTPS para gestionar los eventos de seguimiento de mensajes abiertos y en los que seha hecho clic.

Si tiene previsto utilizar un subdominio HTTPS, siga los procedimientos descritos en Opción 2:configuración de un dominio HTTPS (p. 347) en su lugar.

Para configurar un subdominio HTTP para la gestión del seguimiento de mensajes abiertos y enlos que se ha hecho clic

1. Si aún no lo ha hecho, cree un subdominio que utilizar para enlaces de seguimiento de mensajesabiertos y en los que se ha hecho clic. Le recomendamos que cree un subdominio dedicadoespecíficamente a la gestión de estos enlaces.

2. Compruebe el subdominio para su uso con Amazon SES. Para obtener más información, consulteVerificación de dominios en Amazon SES (p. 59).

3. Modifique el registro de DNS del subdominio. En el registro DNS, añada un nuevo registro de CNAMEque redirija las solicitudes al dominio de seguimiento de Amazon SES. La dirección a la que redirijadepende de la región de AWS en la que utilice Amazon SES. La siguiente tabla contiene una lista dedominios de seguimiento para las regiones de AWS donde Amazon SES está disponible.

Región de AWS Dominio de seguimiento de AWS

EE.UU. Oeste (Oregón) r.us-west-2.awstrack.me

US East (N. Virginia) r.us-east-1.awstrack.me

UE (Irlanda) r.eu-west-1.awstrack.me

Note

En función de su proveedor de servicios de alojamiento web, puede tardar varios minutos enque los cambios que haga en el registro DNS del subdominio surtan efecto. Su proveedor deservicios de alojamiento web u organización de TI puede proporcionarle información adicionalacerca de estos retrasos.

Opción 2: configuración de un dominio HTTPS

Si tiene previsto utilizar un dominio HTTPS para la gestión del seguimiento de mensajes abiertos y en losque se ha hecho clic, debe realizar algunos pasos adicionales, aparte de los necesarios para configurar undominio HTTP (p. 347).

347



Para configurar un subdominio HTTPS para la gestión del seguimiento de mensajes abiertos y enlos que se ha hecho clic

1. Crear un subdominio que desea utilizar para enlaces de mensajes abiertos y en los que se ha hechoclic. Le recomendamos que cree un subdominio dedicado específicamente a la gestión de estosenlaces.

2. Compruebe el subdominio para su uso con Amazon SES. Para obtener más información, consulteVerificación de dominios en Amazon SES (p. 59).

3. Cree una nueva cuenta con una red de entrega de contenido (CDN), como Amazon CloudFront.4. Configure la CDN para redirigir solicitudes al dominio de seguimiento de Amazon SES. La dirección a

la que redirija depende de la región de AWS en la que utilice Amazon SES. La siguiente tabla contieneuna lista de dominios de seguimiento para las regiones de AWS donde Amazon SES está disponible.

Región de AWS Dominio de seguimiento de AWS

EE.UU. Oeste (Oregón) r.us-west-2.awstrack.me

US East (N. Virginia) r.us-east-1.awstrack.me

UE (Irlanda) r.eu-west-1.awstrack.me

5. Si utiliza Amazon CloudFront como CDN, complete los siguientes procedimientos:

a. En la página CloudFront Distributions (Distribuciones de CloudFront), seleccione la distribuciónque se corresponde con su CDN.

b. En la pestaña Behaviors, elija el comportamiento predeterminado y, a continuación, elija Edit.c. Para Cache Based on Selected Request Headers, elija All.d. Para Query String Forwarding and Caching, elija Forward all, cache based on all.e. (Opcional) Si desea utilizar un dominio personalizado para su distribución de CloudFront, en

lugar del dominio que asigna CloudFront, puede añadir un nombre de dominio alternativoa su distribución. Esta subdominio también debe verificarse en Amazon SES. Para obtenermás información, consulte Adding and Moving Alternate Domain Names en la Guía paradesarrolladores de Amazon CloudFront.

Si utiliza una red de entrega de contenido (CDN) que no sean CloudFront, es posible que tenga quecompletar pasos similares. Para obtener más información, consulte la documentación de su CDN.

6. Si utiliza Route 53 para administrar la configuración de DNS de su dominio y CloudFront como CDN,cree un registro de alias en Route 53 que haga referencia a su distribución de CloudFront (comod111111abcdef8.cloudfront.net). Para obtener más información, consulte Creación de registrosmediante la consola de Amazon Route 53, en la Guía para desarrolladores de Amazon Route 53.

De lo contrario, en la configuración de DNS de su subdominio, añada un registro CNAME que hagareferencia a la dirección de su CDN.

7. Adquiera un certificado SSL a partir de una autoridad de certificación de confianza. El certificadodebería cubrir tanto el subdominio que creó en el paso 1, así como la CDN que ha configurado en lospasos 3 a 5. Cargue el certificado en la CDN.

348

https://aws.amazon.com/cloudfront

https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/CNAMEs.html

https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resource-record-sets-creating.html

https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resource-record-sets-creating.html



Parte 2: Configurar un conjunto de configuración para hacerreferencia a un dominio de seguimiento de mensajes abiertos yen los que se ha hecho clic personalizadoDespués de configurar su dominio para gestionar redirecciones de seguimiento de mensajes abiertosy en los que se ha hecho clic, debe configurar un destino de eventos en un conjunto de configuraciónpara hacer referencia a su dominio personalizado. Puede completar este paso utilizando la consola deAmazon SES o la operación del API CreateConfigurationSetTrackingOptions. Esta seccióncontiene procedimientos para realizar estas tareas usando la consola de Amazon SES; para obtener másinformación sobre el uso del API, consulte CreateConfigurationSetTrackingOptions en la Amazon SimpleEmail Service API Reference.

Para crear un nuevo destino de eventos de conjunto de configuración que haga referencia a undominio de seguimiento personalizado


2. En la barra de navegación del lado izquierdo de la pantalla, elija Configuration Sets.3. Elija Create Configuration Set.4. Para Configuration Set Name, escriba un nombre para el conjunto de configuración y, a continuación,

elija Create Configuration Set.5. En la lista de conjuntos de configuración, seleccione el recuadro junto al conjunto de configuración que

creó en el paso anterior. En el menú Actions, elija Edit.6. En la pestaña Event Destinations, para Add Destination, elija un tipo de destino de evento. Para

obtener más información acerca de las opciones de este menú, consulte Paso 2: Añadir un destino deevento (p. 262).

7. Para Event types, elija Click, Open o ambos, dependiendo de los tipos de eventos cuyo seguimientodesee realizar.

8. Para Domain, elija Use your own subdomain.9. Para Select a verified domain, elija el dominio que desee utilizar para seguimiento de eventos de

mensajes abiertos y en los que se ha hecho clic. En el campo de texto a la izquierda del menú, puedeespecificar opcionalmente un subdominio del dominio principal.

10. Configure las demás opciones como lo haría normalmente. Para obtener más información acerca de laconfiguración de los destinos de evento, consulte Paso 2: Añadir un destino de evento (p. 262).


349

https://docs.aws.amazon.com/ses/latest/APIReference/API_CreateConfigurationSetTrackingOptions.html





Amazon Simple Email Service Developer GuideUso del panel de reputación

Monitorear su reputación deremitente de Amazon SES

Amazon SES supervisa de forma activa varias métricas que pueden dañar su reputación como remitente oque podrían provocar que sus tasas de envío de correo electrónico se reduzcan. Dos métricas importantesque tenemos en cuenta en este proceso son las tasas de rebotes y reclamaciones de su cuenta.Las cuentas con tasas de rebotes o reclamaciones excesivamente altas podrían ponerse a prueba osuspenderse. Para obtener más información, consulte Preguntas frecuentes sobre cumplimiento deAmazon SES (p. 477).

Debido a que la tasa de rebotes y reclamaciones es tan importante para el estado de su cuenta, AmazonSES incluye un panel de reputación que puede utilizar para realizar un seguimiento de estas métricas.El panel de reputación también puede mostrar información sobre factores no relacionados con rebotes oreclamaciones que podrían dañar su reputación de remitente. Por ejemplo, si envía correo electrónico auna trampa de spam conocida, verá un mensaje en este panel.

Esta sección contiene información acerca de cómo acceder al panel de reputación, interpretando lainformación que contiene y configurando sistemas para que le notifiquen de forma activa de los factoresque podrían afectar a su reputación de remitente.

En esta sección encontrará los temas siguientes:• Uso del panel de reputación para realizar un seguimiento de las tasas de rebote y de

reclamación (p. 350)• Mensajes del panel de reputación (p. 351)• Creación de alarmas de monitoreo de reputación en CloudWatch (p. 363)• Puesta en pausa automática del envío de correo electrónico (p. 365)

Uso del panel de reputación para realizarun seguimiento de las tasas de rebote y dereclamación

El panel de reputación contiene la misma información que el equipo de Amazon SES ve a la hora dedeterminar el estado de las cuentas individuales.

Para ver el panel de reputación


2. En el panel de navegación del lado izquierdo de la pantalla, elija Reputation Dashboard.

El panel muestra la siguiente información:

• Account status: una breve descripción del estado de su cuenta. Entre los valores posibles seincluyen:• Healthy: actualmente no hay ningún problema que afecte a su cuenta.

350

https://en.wikipedia.org/wiki/Spamtrap



Amazon Simple Email Service Developer GuideMensajes del panel de reputación

• Probation: su cuenta está en período de prueba. Si los problemas que han provocado que sucuenta esté en periodo de prueba no se resuelven antes de que finalice el período de prueba, sucuenta podría suspenderse.

• Pending end of probation decision: su cuenta está en período de prueba. Dada la naturaleza delos problemas que han dado lugar a este periodo de prueba, un miembro del equipo de AmazonSES debe revisar su cuenta antes de tomar alguna otra medida.

• Shutdown: su cuenta se ha cerrado. Mientras su cuenta esté cerrada, no podrá enviar correoelectrónico a través de Amazon SES. Puede recurrir esta decisión. Consulte Preguntas frecuentessobre cumplimiento de Amazon SES (p. 477) para obtener más información sobre el envío deun recurso.

• Pending shutdown: su cuenta está en período de prueba. Los problemas que han dado lugar aeste periodo de prueba no se han resuelto. Estos problemas podrían conllevar el cierre de sucuenta. No obstante, dada la naturaleza de su cuenta, un miembro del equipo de Amazon SESrevisará su cuenta antes de tomar alguna otra medida.

• Bounce Rate: el porcentaje de correos electrónicos enviados desde su cuenta que han dado lugar aun rebote permanente.

• Complaint Rate: el porcentaje de correos electrónicos enviados desde su cuenta que han dado lugara que los destinatarios los notifiquen como spam.

Note

Las secciones Bounce Rate y Complaint Rate incluyen además mensajes de estado parasus métricas respectivas. A continuación, se muestra una lista de mensajes de estado quepodrían mostrarse para estas métricas:• Healthy: la métrica se encuentra por debajo del umbral que podría dar lugar a que su

cuenta se coloque en período de prueba.• Almost healed: la métrica provocó que su cuenta se coloque en período de prueba.

Desde que comenzó la prueba, la métrica ha estado por debajo del ratio máximo. Si lamétrica permanece por debajo del ratio máximo, su estado podría cambiar a Healthyantes de que finalice el período de prueba.

• Probation: la métrica provocó que su cuenta se coloque a prueba y sigue por encima delratio máximo. Si el problema que ha provocado que la métrica supere el ratio máximo nose resuelve antes de que finalice el período de prueba, su cuenta podría suspenderse.

• Shutdown: la métrica provocó que la cuenta se suspendiera. A pesar de que su cuentase ha cerrado, no puede enviar correo electrónico a través de Amazon SES. Puederecurrir esta decisión. Para obtener información sobre el envío de un recurso, consultePreguntas frecuentes sobre cumplimiento de Amazon SES (p. 477).

• Pending shutdown: la métrica provocó que la cuenta se coloque en período de prueba.Los problemas que han dado lugar a este periodo de prueba no se han resuelto. Estosproblemas podrían conllevar el cierre de su cuenta. Un miembro del equipo de AmazonSES revisará su cuenta antes de tomar alguna medida adicional.

• Other Notifications: si su cuenta está experimentando problemas relacionados con la reputaciónque no están relacionados con rebotes o reclamaciones, aquí se mostrará un mensaje breve. Paraobtener más información sobre las notificaciones que se pueden mostrar en esta área, consulteMensajes del panel de reputación (p. 351).

Mensajes del panel de reputaciónEl panel de reputación de Amazon SES ofrece métricas importantes relacionadas con su cuenta. En lassiguientes secciones se describen los mensajes que podrían aparecer en este panel y se ofrecen consejose información que podría utilizar para resolver los problemas relacionados con la reputación del remitente.

Esta sección contiene información acerca de los siguientes tipos de notificaciones:

351

Amazon Simple Email Service Developer GuideMensajes de estado general

• Mensajes de estado (p. 352)• Notificación de tasa de rebotes (p. 353)• Notificación de tasa de reclamaciones (p. 354)• Notificación de organización antispam (p. 355)• Notificaciones de retroalimentación directa (p. 355)• Notificación de lista de bloqueo de dominios (p. 356)• Notificación de revisión interna (p. 357)• Notificación de proveedor de bandeja de correo (p. 359)• Notificaciones de retroalimentación de destinatario (p. 359)• Notificación de cuenta relacionada (p. 360)• Notificación de trampa de spam (p. 361)• Notificación de sitio vulnerable (p. 362)• Otras notificaciones (p. 363)

Mensajes de estadoCuando se utiliza el panel de reputación, verá un mensaje que describe el estado de su cuenta de AmazonSES. A continuación se muestra una lista de posibles valores de estado de la cuenta:

• Healthy: actualmente no hay ningún problema que afecte a su cuenta.• Probation: su cuenta está en período de prueba. Si los problemas que han provocado que su cuenta

esté en periodo de prueba no se resuelven antes de que finalice el período de prueba, su cuenta podríasuspenderse.

• Pending end of probation decision: su cuenta está en período de prueba. Dada la naturaleza de losproblemas que han dado lugar a este periodo de prueba, un miembro del equipo de Amazon SES deberevisar su cuenta antes de tomar alguna otra medida.

• Shutdown: su cuenta se ha cerrado. Mientras su cuenta esté cerrada, no podrá enviar correo electrónicoa través de Amazon SES. Puede recurrir esta decisión. Consulte Preguntas frecuentes sobrecumplimiento de Amazon SES (p. 477) para obtener más información sobre el envío de un recurso.

• Pending shutdown: su cuenta está en período de prueba. Los problemas que han dado lugar a esteperiodo de prueba no se han resuelto. Estos problemas podrían conllevar el cierre de su cuenta. Noobstante, dada la naturaleza de su cuenta, un miembro del equipo de Amazon SES revisará su cuentaantes de tomar alguna otra medida.

Además, las secciones Bounce Rate y Complaint Rate de los resúmenes de estado de visualización delpanel de reputación para sus métricas respectivas. A continuación se muestra una lista de posibles valoresde estado de la métrica:

• Healthy: la métrica se encuentra por debajo del umbral que podría dar lugar a que su cuenta se coloqueen período de prueba.

• Almost healed: la métrica provocó que su cuenta se coloque en período de prueba. Desde que comenzóla prueba, la métrica ha estado por debajo del ratio máximo. Si la métrica permanece por debajo del ratiomáximo, su estado podría cambiar a Healthy antes de que finalice el período de prueba.

• Probation: la métrica provocó que su cuenta se coloque a prueba y sigue por encima del ratio máximo.Si el problema que ha provocado que la métrica supere el ratio máximo no se resuelve antes de quefinalice el período de prueba, su cuenta podría suspenderse.

• Shutdown: la métrica provocó que la cuenta se suspendiera. A pesar de que su cuenta se ha cerrado,no puede enviar correo electrónico a través de Amazon SES. Puede recurrir esta decisión. Para obtenerinformación sobre el envío de un recurso, consulte Preguntas frecuentes sobre cumplimiento de AmazonSES (p. 477).

352

Amazon Simple Email Service Developer GuideNotificación de tasa de rebotes

• Pending shutdown: la métrica provocó que la cuenta se coloque en período de prueba. Los problemasque han dado lugar a este periodo de prueba no se han resuelto. Estos problemas podrían conllevar elcierre de su cuenta. Un miembro del equipo de Amazon SES revisará su cuenta antes de tomar algunamedida adicional.

Notificación de tasa de rebotesEsta sección contiene información adicional acerca de las notificaciones de la tasa de rebotes mostradasen el panel de reputación de Amazon SES.

¿Por qué ha recibido esta notificación?Amazon SES recomienda que los remitentes mantengan las tasas de rebote por debajo de 5%; dado quelas tasas superiores al 10%, se pondrán a prueba y podrían correr el riesgo de suspensión.

La tasa de rebotes se basa en el número de rebotes permanentes generados por su cuenta de AmazonSES. Un rebote permanente se produce cuando un correo electrónico se envía a una dirección que noexiste. Los rebotes temporales, que se producen cuando la dirección de un destinatario no puede recibirel mensaje temporalmente, no se tienen en cuenta en este cálculo. Los correos electrónicos con reboteenviados a direcciones y dominios verificados, así como los correos electrónicos enviados al simulador debandeja de entrada de Amazon SES, tampoco se tienen en cuenta en este cálculo.

La mayoría de los proveedores de correo electrónico interpretan una tasa elevada de rebotes como unaseñal de que el remitente no está administrando correctamente su lista de destinatarios y que el remitentepodría estar enviando correo electrónico no solicitado. Dado que los proveedores de correo electrónico setoman en serio las tasas de rebote, Amazon SES toma medidas rápidas a fin de proteger su reputación deremitente.

Qué puede hacer para resolver el problemaSi aún no lo ha hecho, implemente un proceso para capturar y administrar rebotes y reclamaciones.Es obligatorio que todas las cuentas de Amazon SES implementen estos procesos. Para obtener másinformación, consulte Métricas de éxito para los programas de correo electrónico (p. 448).

A continuación, determine qué direcciones de correo electrónico presentan rebotes y cree e implementeun plan para reducir o eliminar dichos rebotes. Si su cuenta ya se ha cerrado, envíe un mensaje de correoelectrónico a [email protected] para solicitar una lista de reclamaciones recientes.

Si su cuenta está en período de pruebaSi, al final del período de prueba, la tasa de rebotes de su cuenta sigue estando por encima del 10%,suspenderemos su cuenta de Amazon SES.

Si ha implementado los cambios que considera que resolverán el problema, envíe un correo electrónico [email protected] desde la dirección de correo electrónico asociada a su cuenta de AWS.En su correo electrónico, describa los cambios que ha implementado. Si estamos de acuerdo en que loscambios reducirán su tasa de rebote, ajustaremos nuestros cálculos para tener en cuenta solo los rebotesrecibidos después de haber implementado sus cambios.

Si su cuenta se suspendePuede recurrir esta suspensión; consulte Enforcement FAQ (p. 481) para obtener información adicional.

Cuando haya implementado los cambios que considera que resolverán el problema, envíe un correoelectrónico a [email protected] desde la dirección de correo electrónico asociada a su

353




Amazon Simple Email Service Developer GuideNotificación de tasa de reclamaciones

cuenta de AWS. Incluya detalles de las medidas que ha tomado para resolver este problema, así comodetalles de sus planes para garantizar que este problema no se vuelva a producir. Tendremos en cuentasu recurso y cambiaremos el estado de su cuenta si es necesario.

Notificación de tasa de reclamacionesEsta sección contiene información adicional acerca de las notificaciones de la tasa de reclamacionesmostradas en el panel de reputación de Amazon SES.

¿Por qué ha recibido esta notificación?Amazon SES recomienda que los remitentes mantengan las tasas de reclamaciones por debajo de 0,1%;dado que las tasas superiores al 0,5%, se pondrán a prueba y podrían correr el riesgo de suspensión.

La tasa de reclamaciones se basa en el número de informes de reclamaciones generados por los correoselectrónicos enviados desde su cuenta de Amazon SES. No todos los proveedores de correo electrónicosuministran a Amazon SES información acerca del número de reclamaciones que reciben, por lo que estevalor se ajusta en función del número de proveedores que proporcionan esta información.

La mayoría de los proveedores de correo electrónico interpretan una tasa de reclamaciones elevada comouna señal de que el remitente está enviando correo electrónico no deseado o no solicitado. Dado quelos proveedores de correo electrónico se toman en serio las tasas de reclamaciones, Amazon SES tomamedidas rápidas a fin de proteger su reputación de remitente.

Qué puede hacer para resolver el problemaSi aún no lo ha hecho, implemente un proceso para capturar y administrar rebotes y reclamaciones.Es obligatorio que todas las cuentas de Amazon SES implementen estos procesos. Para obtener másinformación, consulte Métricas de éxito para los programas de correo electrónico (p. 448).

A continuación, determine cuáles de los mensajes que envía dan lugar a reclamaciones e implementeun plan para reducir estas reclamaciones. Si su cuenta ya se ha cerrado, envíe un mensaje de correoelectrónico a [email protected] para solicitar una lista de reclamaciones recientes.

Aunque debe dejar de enviar de inmediato a aquellas direcciones que hayan presentado reclamaciones,es importante que identifique los factores que hacen que los destinatarios reclamen. Después de identificarestos factores, ajuste su comportamiento de envío de correo electrónico para corregirlo.

Si su cuenta está en período de pruebaSi, al final del período de prueba, la tasa de reclamaciones para su cuenta sigue estando por encima del0,5%, suspenderemos su cuenta de Amazon SES.

Si ha implementado los cambios que considera que resolverán el problema, envíe un correo electrónico [email protected] desde la dirección de correo electrónico asociada a su cuenta de AWS.En su correo electrónico, describa los cambios que ha implementado. Si estamos de acuerdo en que loscambios reducirán su tasa de reclamaciones, ajustaremos nuestros cálculos para tener en cuenta solo lasreclamaciones recibidas después de haber implementado sus cambios.


Cuando haya implementado los cambios que considera que resolverán el problema, envíe un correoelectrónico a [email protected] desde la dirección de correo electrónico asociada a sucuenta de AWS. Incluya detalles de las medidas que ha tomado para resolver este problema, así como

354




Amazon Simple Email Service Developer GuideNotificación de organización antispam

detalles de sus planes para garantizar que este problema no se vuelva a producir. Tendremos en cuentasu recurso y cambiaremos el estado de su cuenta si es necesario.

Notificación de organización antispamEsta sección contiene información adicional acerca de las notificaciones de organización antispammostradas en el panel de reputación de Amazon SES.

¿Por qué ha recibido esta notificación?Una organización antispam reconocida ha informado de que sus sistemas han marcado parte de loscontenidos que se envían desde su cuenta de Amazon SES como correo no solicitado o problemático.

Amazon SES no dispone de información detallada relativa a los mensajes específicos que han provocadoque la organización antispam marquen su contenido como problemático. No podemos facilitarle el nombrede la organización que generó el informe. Normalmente, las organizaciones antispam tienen en cuentauna combinación de los siguientes factores: retroalimentación del destinatario, métricas de implicaciónde mensajes, intentos de entrega a direcciones no válidas, contenido marcado por los filtros de spam eincidencias de trampas de spam. Esto no es una lista exhaustiva; otros factores podrían hacer que estasorganizaciones marquen su contenido.

Qué puede hacer para resolver el problemaPara solucionar este problema, tiene que determinar qué aspectos de su programa de envío de correoelectrónico podrían hacer que la organización antispam marque su correo electrónico como problemático.Tiene que cambiar su programa de envío para resolver estos problemas.

Si su cuenta está en período de pruebaSi, al final del período de prueba, la organización antispam sigue marcando sus mensajes comoproblemáticos, suspenderemos su cuenta de Amazon SES.

Si ha implementado los cambios que considera que resolverán el problema, envíe un correo electrónico [email protected] desde la dirección de correo electrónico asociada a su cuenta de AWS.En su mensaje, proporcione detalles de los cambios que ha realizado. Cuando recibimos esta información,ampliamos el período de prueba para garantizar que solo analizamos las notificaciones de la organizaciónantispam que hemos recibido después de que haya implementado los cambios. Si, al final de este períodode prueba ampliado, su cuenta ya no está en la lista de la organización antispam, podríamos eliminar laprueba de su cuenta.


Cuando haya implementado los cambios que considera que resolverán el problema, envíe un correoelectrónico a [email protected] desde la dirección de correo electrónico asociada a sucuenta de AWS. Incluya detalles de las medidas que ha tomado para resolver este problema, así comodetalles de sus planes para garantizar que este problema no se vuelva a producir. Tendremos en cuentasu recurso y cambiaremos el estado de su cuenta si es necesario.

Notificaciones de retroalimentación directaEsta sección contiene información adicional acerca de las notificaciones de comentarios directosmostradas en el panel de reputación de Amazon SES.

355



Amazon Simple Email Service Developer GuideNotificación de lista de bloqueo de dominios

¿Por qué ha recibido esta notificación?Un número importante de usuarios se ha puesto en contacto con Amazon SES directamente para informarde mensajes que han recibido de una dirección o dominio asociados a su cuenta de Amazon SES. Estetipo de retroalimentación no es visible en las reclamaciones notificadas por los proveedores de bandeja decorreo directamente y no se incluyen en la métrica de rebotes y reclamaciones que se muestra en el panelde reputación.

Para proteger la privacidad de los usuarios que han notificado estos problemas, no podemos proporcionarsus direcciones de correo electrónico.

Los destinatarios podrían quejarse a Amazon SES cuando reciben mensajes a los que no se han suscrito,cuando no reciben el tipo de correo que esperaban recibir, cuando no encuentran útil o interesante elcorreo electrónico que reciben, cuando no reconocen que se registraron para recibir los mensajes ocuando reciben demasiados mensajes. Esta lista no es exhaustiva; los factores que son relevantes en sucaso dependen de su programa de envío de correo electrónico específico.

Qué puede hacer para resolver el problemaLe recomendamos que implemente una doble estrategia de confirmación, tal y como se describe enCreación y mantenimiento de sus listas (p. 452), para adquirir nuevas direcciones y que solo envíecorreos electrónicos a aquellas direcciones que hayan completado el proceso de confirmación doble.

Además, debe eliminar de sus listas aquellas direcciones que no hayan interactuado con sus correoselectrónicos recientemente. Puede utilizar el seguimiento de mensajes abiertos y en los que se ha hechoclic, tal como se describe en Monitoreo de la actividad de envío de Amazon SES (p. 230), para determinarqué usuarios están visualizando e interactuando con el contenido que envía.

Si su cuenta está en período de pruebaSi, al final del período de prueba, Amazon SES sigue recibiendo un volumen importante de reclamacionesdirectas sobre los mensajes enviados desde su cuenta, suspenderemos su cuenta de Amazon SES.

Si ha implementado los cambios que considera que resolverán el problema, envíe un correo electrónico [email protected] desde la dirección de correo electrónico asociada a su cuenta de AWS.En su mensaje, proporcione detalles de los cambios que ha realizado. Cuando recibimos esta información,ampliamos el período de prueba para garantizar que solo analizamos la cantidad de retroalimentacióndirecta que hemos recibido después de que haya implementado los cambios. Al final de este períodode prueba ampliado, si la cantidad de retroalimentación directa se ha reducido o eliminado, podríamoseliminar la prueba de su cuenta.



Notificación de lista de bloqueo de dominiosEsta sección contiene información adicional acerca de las notificaciones de lista de bloqueo de dominiosmostradas en el panel de reputación de Amazon SES.

356



Amazon Simple Email Service Developer GuideNotificación de revisión interna

¿Por qué ha recibido esta notificación?Los correos electrónicos enviados desde su cuenta de Amazon SES contienen referencias a dominios quese han incluido en una lista de bloqueo de dominios acreditada. Los dominios de estas listas suelen estarasociados a comportamientos abusivos o malintencionados. Los dominios en cuestión podrían estar o noen los dominios desde los que envía correo electrónico. Los mensajes que incluyen referencias o enlacesa un dominio de una lista de bloqueo o que incluyen imágenes alojadas en dicho dominio, también podríanestar marcadas.

Amazon SES no puede proporcionar los nombres de los dominios que hacen que el mensaje aparezcamarcado o identificar qué correos electrónicos se han marcado de esta forma.

Qué puede hacer para resolver el problemaCree una lista de todos los dominios a los que se hace referencia en los mensajes de correo electrónicoque envíe a través de Amazon SES y, a continuación, utilice la herramienta Spamhaus Domain Lookup enhttps://www.spamhaus.org/lookup/ para determinar qué dominios a los que se hace referencia en su correoelectrónico están en la lista de bloqueo de dominios. Es posible que en esta lista de bloqueo haya más deun dominio al que se hace referencia en los correos electrónicos que envíe.

Amazon SES no esté afiliado a la lista de bloqueo de dominios de Spamhaus y no garantiza la exactitud delos dominios de esta lista. La lista de bloqueo de dominios de Spamhaus y la herramienta Domain LookupTool son propiedad de Spamhaus Project, que es responsable de su funcionamiento y mantenimiento.

Si su cuenta está en período de pruebaSi, al final del período de prueba, una parte importante del correo electrónico que envíe a través deAmazon SES sigue conteniendo referencias a dominios en la lista de bloqueo, suspenderemos su cuentade Amazon SES.

Si ha implementado los cambios que considera que resolverán el problema, envíe un correo electrónico [email protected] desde la dirección de correo electrónico asociada a su cuenta de AWS. Ensu mensaje, proporcione detalles de los cambios que ha realizado. Cuando recibamos esta información,ampliaremos el período de prueba para garantizar que solo analizamos el número de dominios en lista debloqueo presentes en su correo electrónico después de que haya implementado los cambios. Al final deeste período de prueba ampliado, si la cantidad de notificaciones de lista de bloqueo de dominios se hareducido o eliminado, podríamos eliminar la prueba de su cuenta.



Notificación de revisión internaEsta sección contiene información adicional acerca de las notificaciones de revisión interna mostradas enel panel de reputación de Amazon SES.

¿Por qué ha recibido esta notificación?Una revisión exhaustiva de su cuenta identificó diversas características que pueden provocar que losproveedores de buzones de correo o los destinatarios identifiquen sus mensajes como spam.

357

https://www.spamhaus.org/lookup/

https://www.spamhaus.org/



Amazon Simple Email Service Developer GuideNotificación de revisión interna

Para proteger nuestro proceso de detección de abusos, no podemos revelar los factores específicos quehan llevado a marcar a su cuenta de este modo.

Los factores habituales que pueden dar lugar a esta determinación son, entre otros, los siguientes:

• Mensajes marcados por los sistemas antispam comerciales.• Contenido de mensaje que implica que el destinatario no ha solicitado explícitamente el correo

electrónico.• Discrepancias entre el remitente del mensaje y la marca que aparece en el cuerpo del correo electrónico.• Contenido que no aclara quién es el remitente.• Envío de mensajes que tratan con contenido asociado con correo electrónico no solicitado.• Patrones de formato asociados a correo electrónico no solicitado.• Envío desde dominios con mala reputación o hacer referencia a los mismos.

Esta lista no es exhaustiva; los motivos concretos de esta notificación podrían ser una combinación decualquiera de estos factores o bien podría ser algún motivo no incluido en la lista.

Qué puede hacer para resolver el problemaLas siguientes sugerencias podrían ayudar a reducir la gravedad del problema:

• Asegúrese de que los únicos destinatarios con quienes se pone en contacto sean aquellos que hayansolicitado de forma explícita recibir sus correos electrónicos.

• No compre, alquile o tome prestadas listas de destinatarios de correo electrónico nunca.• No intente ocultar su identidad o el propósito de la comunicación en los mensajes que envía.• Cree una lista de todos los dominios a los que se hace referencia en los mensajes de correo electrónico

que envíe a través de Amazon SES y, a continuación, utilice la herramienta Spamhaus Domain Lookupen https://www.spamhaus.org/lookup/ para determinar si alguno de estos dominios están en la lista debloqueo de dominios de Spamhaus.

• Asegúrese de que está siguiendo las prácticas recomendadas del sector a la hora de diseñar susmensajes de correo electrónico.

Esta lista no es exhaustiva, pero debería ayudarle a identificar algunos de los factores más comunes quepueden dar lugar al marcado de su correo electrónico.

Amazon SES no esté afiliado a la lista de bloqueo de dominios de Spamhaus y no garantiza la exactitud delos dominios de esta lista. La lista de bloqueo de dominios de Spamhaus y la herramienta Domain LookupTool son propiedad de Spamhaus Project, que es responsable de su funcionamiento y mantenimiento.

Si su cuenta está a prueba o se ha suspendidoCuando haya implementado los cambios que considera que resolverán el problema, envíe un correoelectrónico a [email protected] desde la dirección de correo electrónico asociada a sucuenta de AWS. Incluya detalles de las medidas que ha tomado para resolver este problema, así comodetalles de sus planes para garantizar que este problema no se vuelva a producir. Tendremos en cuentasu recurso y cambiaremos el estado de su cuenta si es necesario.

Si, después de la prueba o cierre aparece en la lista, detectamos el problema de nuevo, su cuenta podríaestar sujeta a una prueba o cierre adicional. Los incidentes repetidos podrían dar lugar a que su cuentaAmazon SES se desactive de forma permanente.

Consulte Preguntas frecuentes sobre cumplimiento de Amazon SES (p. 477) para obtener másinformación sobre la prueba y la suspensión de cuentas de Amazon SES.

358


https://www.spamhaus.org/


Amazon Simple Email Service Developer GuideNotificación de proveedor de bandeja de correo

Notificación de proveedor de bandeja de correoEsta sección contiene información adicional acerca de las notificaciones de proveedor de bandeja decorreo mostradas en el panel de reputación de Amazon SES.

¿Por qué ha recibido esta notificación?Un destacado proveedor de bandeja de correo nos ha informado que se está enviando correo no solicitadoo malintencionado desde una dirección o dominio asociado con su cuenta de Amazon SES.

No podemos compartir la identidad de la organización que generó este informe. Además, no tenemosinformación sobre los factores específicos que han provocado que el proveedor de bandeja de correoemita el informe. Normalmente, los proveedores de bandeja de correo toman este tipo de determinacióna partir de retroalimentación de los clientes, métricas de compromiso de clientes, intentos de entregas adirecciones no válidas y contenido marcado por filtros de spam. Esta lista no es exhaustiva; es posible quehaya otros factores que hayan provocado que el proveedor de bandeja de correo marque su contenido.

Qué puede hacer para resolver el problemaPara solucionar este problema, tiene que determinar qué aspectos de su programa de envío de correoelectrónico podrían haber provocado que los proveedores de bandeja de correo marquen su correo comoproblemático. Seguidamente debe cambiar su programa de envío para resolver estos problemas.

Si su cuenta está en período de pruebaSi, al final del período de prueba, los proveedores de bandeja de correo siguen marcando su correoelectrónico como problemático, podríamos suspender su cuenta de Amazon SES.

Si ha implementado los cambios que considera que resolverán el problema, envíe un correo electrónico [email protected] desde la dirección de correo electrónico asociada a su cuenta de AWS. Ensu mensaje, proporcione detalles de los cambios que ha realizado. Cuando recibamos esta información,ampliaremos el período de prueba para garantizar que solo analizamos el número de notificaciones deproveedor de bandeja de correo que recibimos después de implementar los cambios. Al final de esteperíodo de prueba ampliado, si el proveedor de bandeja de correo deja de notificar su cuenta comoproblemática, podríamos eliminar la prueba de su cuenta.



Notificaciones de retroalimentación de destinatarioEsta sección contiene información adicional acerca de las notificaciones de retroalimentación dedestinatario mostradas en el panel de reputación de Amazon SES.

¿Por qué ha recibido esta notificación?Un importante proveedor de bandeja de correo nos ha informado de que un gran número de sus usuariosestán notificando correo electrónico no solicitado enviado desde su cuenta de Amazon SES. Este tipo deretroalimentación no es visible en las reclamaciones notificadas por los proveedores de bandeja de correodirectamente y no se incluyen en las notificaciones de rebote y reclamaciones de Amazon SES.

359



Amazon Simple Email Service Developer GuideNotificación de cuenta relacionada

Un gran número de reclamaciones puede tener un impacto negativo en todos los usuarios de AmazonSES. Para proteger su reputación y la de otros clientes de Amazon SES, tomamos medidas de inmediatocuando una cuenta recibe un determinado número de reclamaciones.

No podemos proporcionar una lista de direcciones de correo electrónico específicas que notifiquen sucorreo electrónico no solicitado. Además, no podemos compartir el nombre del proveedor de bandeja decorreo que nos ha informado de este problema.

Qué puede hacer para resolver el problemaPara solucionar este problema, debe determinar qué aspectos de su programa de envío de correoelectrónico pueden estar provocando que los destinatarios reclamen por los mensajes de correoelectrónico que reciben de usted. Después de identificar estos factores, cambie sus prácticas de envío decorreo electrónico para corregirlo.

Para conseguir nuevas direcciones, le recomendamos que implemente una doble estrategia deconfirmación, tal y como se describe en las direcciones Creación y mantenimiento de sus listas (p. 452).Le recomendamos que solo envíe correo electrónico a aquellas direcciones que hayan completado unproceso de confirmación doble.


Si su cuenta está en período de pruebaSi, al final del período de prueba, el proveedor de bandeja de correo sigue notificando un número dereclamaciones importante, suspenderemos su cuenta de Amazon SES.

Si ha implementado los cambios que considera que resolverán el problema, envíe un correo electrónico [email protected] desde la dirección de correo electrónico asociada a su cuenta de AWS. Ensu mensaje, proporcione detalles de los cambios que ha realizado. Cuando recibamos esta información,ampliaremos el período de prueba para garantizar que solo analizamos el número de reclamaciones deproveedor de bandeja de correo que recibimos después de implementar los cambios. Al final de esteperíodo de prueba ampliado, si el número de reclamaciones de proveedor de correo se ha reducido oeliminado, podríamos eliminar la prueba de su cuenta.



Notificación de cuenta relacionadaEsta sección contiene información adicional acerca de las notificaciones de cuenta relacionadas mostradasen el panel de reputación de Amazon SES.

¿Por qué ha recibido esta notificación?Hemos detectado graves problemas relacionados con los correos electrónicos que se envían desde otracuenta de Amazon SES. Creemos que la cuenta problemática está relacionada con su cuenta de AWS, porlo que hemos adoptado medidas para evitar problemas similares.

360



Amazon Simple Email Service Developer GuideNotificación de trampa de spam

Qué puede hacer para resolver el problemaLa cuenta relacionada debería haber recibido un correo electrónico en el que se describen los problemasque han provocado la suspensión. En primer lugar, corrija los problemas en la cuenta relacionada.

Cuando haya implementado los cambios que considera que resolverán el problema, envíe un correoelectrónico a [email protected] desde la dirección de correo electrónico asociada a sucuenta de AWS. Incluya detalles de las medidas que ha tomado para resolver este problema, así comodetalles de sus planes para garantizar que este problema no se vuelva a producir. Si estamos de acuerdocon su valoración, podríamos levantar la suspensión o prueba en su cuenta.

Notificación de trampa de spamEsta sección contiene información adicional acerca de las notificaciones de trampa de spam mostradas enel panel de reputación de Amazon SES.

¿Por qué ha recibido esta notificación?Una organización antispam de terceros nos ha informado de que sus direcciones de trampa de spam hanrecibido recientemente correo electrónico de una dirección o dominios verificados asociados a su cuentade Amazon SES.

Una trampa de spam es una dirección de correo electrónico inactiva que se utiliza exclusivamente paraatraer correo electrónico no solicitado (spam). Un gran número de informes de trampa de spam puedetener un impacto negativo en todos los usuarios de Amazon SES. Para proteger su reputación y la deotros clientes de Amazon SES, tomamos medidas de inmediato cuando una cuenta envía un volumendeterminado de correo electrónico en direcciones de trampa de spam.

Qué puede hacer para resolver el problemaNo podemos revelar las direcciones de correo electrónico asociadas con la trampa de spam que haencontrado. Estas direcciones son vigiladas estrechamente por las organizaciones que las poseen y, unavez que las direcciones son conocidas, dejan de ser útiles.

El envío de correo electrónico a direcciones de trampa de spam indica que hay un problema con laforma en que adquiere las direcciones de correo electrónico de sus clientes. Por ejemplo, las listas dedirecciones de correo electrónico compradas pueden contener direcciones de trampa de spam, por loque el envío a las listas adquiridas o alquiladas está prohibida por los términos de servicio de AmazonSES. Para conseguir nuevas direcciones, le recomendamos que implemente una doble estrategia deconfirmación, tal y como se describe en las direcciones Creación y mantenimiento de sus listas (p. 452).Le recomendamos que solo envíe correo electrónico a aquellas direcciones que hayan completado unproceso de confirmación doble.


Si su cuenta está en período de pruebaSi, al final del período de prueba, los mensajes enviados desde su cuenta se siguen enviando adirecciones de trampa de spam, suspenderemos su cuenta de Amazon SES.

Si ha implementado los cambios que considera que resolverán el problema, envíe un correo electrónico [email protected] desde la dirección de correo electrónico asociada a su cuenta de AWS.

361



Amazon Simple Email Service Developer GuideNotificación de sitio vulnerable

En su mensaje, proporcione detalles de los cambios que ha realizado. Cuando recibimos esta información,ampliamos el período de prueba para garantizar que solo analizamos el número de informes de trampa despam que recibimos después de implementar los cambios. Al final de este período de prueba ampliado, siel número de informes de trampa de spam se ha reducido o eliminado, podríamos eliminar la prueba de sucuenta.



Notificación de sitio vulnerableEsta sección contiene información adicional acerca de las notificaciones de sitio vulnerable mostradas enel panel de reputación de Amazon SES.

¿Por qué ha recibido esta notificación?Una revisión global ha encontrado que se envían mensajes desde su cuenta que no creemos que pretendaenviar. Los proveedores de bandeja de correo y los destinatarios marcarán muy probablemente estosmensajes como spam.

Con mucha frecuencia en estas situaciones, un tercero está abusando de una característica de su sitioweb para enviar correo electrónico no deseado. Por ejemplo, si el sitio web contiene una función "enviarpor correo electrónico a un amigo", "póngase en contacto con nosotros", "invitar a un amigo" o similar, untercero podría utilizar esta funcionalidad para enviar correo electrónico no solicitado.

Qué puede hacer para resolver el problemaEn primer lugar, identifique las características de su sitio web o aplicaciones que podrían permitir aterceros enviar correos electrónicos mediante Amazon SES sin su conocimiento. Para solicitar unamuestra de los mensajes que creemos se han enviado de esta manera, envíenos un correo electrónico [email protected].

A continuación, modifique su aplicación o sitio web para evitar el envío no solicitado. Por ejemplo, añadaun CAPTCHA, limite la velocidad a la que se pueden enviar correos electrónicos, elimine la posibilidad deque los usuarios envíen contenido personalizado, obligue a los usuarios a iniciar sesión para enviar correoelectrónico y elimine la posibilidad de que la aplicación genere varias notificaciones simultáneas.

Si su cuenta está a prueba o se ha suspendidoCuando haya implementado los cambios que considera que resolverán el problema, envíe un correoelectrónico a [email protected] desde la dirección de correo electrónico asociada a sucuenta de AWS. Incluya detalles de las medidas que ha tomado para resolver este problema, así comodetalles de sus planes para garantizar que este problema no se vuelva a producir. Tendremos en cuentasu recurso y cambiaremos el estado de su cuenta si es necesario.

Si, después de la prueba o cierre aparece en la lista, detectamos el problema de nuevo, su cuenta podríaestar sujeta a una prueba o cierre adicional. Los incidentes repetidos podrían dar lugar a que su cuentaAmazon SES se desactive de forma permanente.

362




Amazon Simple Email Service Developer GuideOtras notificaciones

Consulte Preguntas frecuentes sobre cumplimiento de Amazon SES (p. 477) para obtener másinformación sobre la prueba y la suspensión de cuentas de Amazon SES.

Otras notificacionesEsta sección contiene información adicional acerca de otras notificaciones mostradas en el panel dereputación de Amazon SES.

¿Por qué ha recibido esta notificación?Una revisión automática o humana ha identificado problemas que no están incluidos en las seccionesanteriores de este documento.

Qué puede hacer para resolver el problemaConsulte el correo electrónico que ha recibido del equipo de control de Amazon SES si desea obtener másinformación sobre el problema específico. Si es posible, corrija este problema y envíe un correo electrónicoa [email protected] desde la dirección de correo electrónico asociada a su cuenta de AWS.En su correo electrónico, describa los cambios que ha implementado. En función de su situación específicay de la naturaleza de los problemas que descubramos, podríamos levantar su período de prueba o lasuspensión.

Creación de alarmas de monitoreo de reputación enCloudWatch

Amazon SES publica automáticamente dos métricas relacionadas con la reputación en AmazonCloudWatch: Reputation.BounceRate y Reputation.ComplaintRate. Puede utilizar estas métricaspara crear alarmas que le avisarán cuando sus tasas de rebotes o reclamaciones alcancen niveles quepodrían afectar a su capacidad de enviar correo electrónico.

Los valores de Reputation.BounceRate y Reputation.ComplaintRate son números decimalesentre 0 y 1. Multiplique por 100 cualquiera de estas métricas para determinar el porcentaje de correoselectrónicos que rebotan o que dan lugar a reclamaciones.

Para crear una alarma de CloudWatch

1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon SNS en https://console.aws.amazon.com/sns/v2/home.

2. Cree un nuevo tema de Amazon SNS y, a continuación, suscríbase al mismo utilizando su puntode enlace preferido (como, por ejemplo, correo electrónico o SMS). Para obtener más información,consulte Create a Topic y Subscribe to a Topic en la Guía para desarrolladores de Amazon SimpleNotification Service.

3. Abra la consola de CloudWatch en https://console.aws.amazon.com/cloudwatch/.4. En el panel de navegación del lado izquierdo de la pantalla, elija Alarms.5. Elija Create Alarm.6. En CloudWatch Metrics by Category, elija SES Metrics.7. En Metric name, seleccione la métrica para la que desea crear la alarma.

Por ejemplo, si desea crear una alarma cuando la tasa de rebote alcance un determinado nivel, elijaReputation.BounceRate. Si desea crear una alarma cuando la tasa de reclamaciones alcance undeterminado nivel, elija Reputation.ComplaintRate.

Seleccione Siguiente.

363


https://console.aws.amazon.com/sns/v2/home




https://docs.aws.amazon.com/sns/latest/dg/

https://docs.aws.amazon.com/sns/latest/dg/


Amazon Simple Email Service Developer GuideCreación de alarmas mediante CloudWatch

Note

Las métricas de reputación podrían no aparecer en CloudWatch si la cuenta no hatenido rebotes ni reclamaciones. Si no ve las métricas Reputation.BounceRate oReputation.ComplaintRate en esta página, utilice el simulador de bandeja de correo deAmazon SES (p. 173) para simular un evento de rebote o de reclamación. Después desimular un evento de rebote o de reclamación, es posible que tenga que esperar unosminutos hasta que aparezcan las métricas de reputación en CloudWatch.

8. En Alarm Threshold, para Name, escriba un nombre para la alarma.9. En el área de umbral de la alarma, especifique el valor que debería hacer que CloudWatch emita una

alarma.

Si va a crear una alarma para monitorizar la tasa de rebotes, tenga en cuenta que Amazon SESrecomienda mantener una tasa de rebotes por debajo del 5%, y que una tasa por encima del 10%pone a su cuenta en riesgo de suspensión. Por este motivo, debería configurar CloudWatch paraactivar una alarma cuando la tasa de rebotes sea mayor o igual que 0,05 (5%), tal como se muestraen la imagen siguiente.

Si va a crear una alarma para monitorizar la tasa de reclamaciones, tenga en cuenta que Amazon SESrecomienda mantener una tasa de reclamaciones por debajo del 0,1%, y que una tasa por encima del0,5% pone a su cuenta en riesgo de suspensión. Por este motivo, debería configurar CloudWatch paraactivar una alarma cuando la tasa de reclamaciones sea mayor o igual que 0,001 (0,1%), tal como semuestra en la imagen siguiente.

10. En Additional settings, para Treat missing data as, elija ignore (maintain the alarm state).11. En Alarm Preview, para Period, elija un periodo de alarma.

Note

Amazon SES envía las métricas Reputation.BounceRate yReputation.ComplaintRate a CloudWatch cada 15 minutos. Por este motivo, le

364

Amazon Simple Email Service Developer GuidePuesta en pausa automática del envío de correo electrónico

recomendamos que elija un periodo de alarma de 15 minutos como mínimo. No obtendráningún beneficio si elige un periodo de alarma de menos de 15 minutos.

12. En Actions, en Whenever this alarm, elija State is ALARM. Para Send notification to, elija el tema queha creado y al que se ha suscrito en el paso 2.

13. Elija Create Alarm.

Note

Estos procedimientos omiten alguna información sobre la configuración opcional para alarmas deCloudWatch. Para ver instrucciones detalladas, consulte Creating Amazon CloudWatch Alarms enla Guía del usuario de Amazon CloudWatch.

Puesta en pausa automática del envío de correoelectrónico

Para proteger su reputación como remitente, puede poner en pausa temporalmente el envío de correoelectrónico para los mensajes enviados mediante conjuntos de configuración específicos o para todos losmensajes enviados desde su cuenta de Amazon SES en una región de AWS específica.

Mediante Amazon CloudWatch y Lambda, puede crear una solución que ponga en pausa automáticamenteel envío de correo electrónico cuando sus métricas de reputación (como el porcentaje de rebotes o dereclamaciones) superen determinados umbrales. Este tema contiene procedimientos para configurar estasolución.

Temas de esta sección:• Poner en pausa automáticamente el envío de correo electrónico en su cuenta de Amazon

SES (p. 365)• Puesta en pausa automática del envío de correo electrónico para un conjunto de

configuración (p. 370)

Poner en pausa automáticamente el envío de correoelectrónico en su cuenta de Amazon SESLos procedimientos de esta sección explican los pasos para configurar Amazon SES, Amazon SNS,Amazon CloudWatch y AWS Lambda para poner en pausa automáticamente el envío de correo electrónicopara una cuenta de Amazon SES de una sola región de AWS. Si envía correo electrónico desde variasregiones, repita los procedimientos de esta sección para cada región en la que desee implementar estasolución.

Temas de esta sección:• Parte 1: Crear un rol de IAM (p. 366)• Parte 2: Crear la función de Lambda: (p. 366)• Parte 3: Volver a habilitar el envío de correo electrónico en su cuenta (p. 367)• Parte 4: Crear un tema de Amazon SNS (p. 368)• Parte 5: Crear una alarma de CloudWatch (p. 368)• Parte 6: Probar la solución (p. 369)

365

https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html

https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/

Amazon Simple Email Service Developer GuidePoner en pausa automáticamente el envío de

correo electrónico en su cuenta de Amazon SES

Parte 1: Crear un rol de IAMEl primer paso para configurar la puesta en pausa automática del envío de correo electrónico es crear unrol de IAM que pueda ejecutar la operación de API UpdateAccountSendingEnabled.

Para crear la función de IAM

1. Abra la consola de IAM, en https://console.aws.amazon.com/iam/.2. Seleccione Roles en el panel de navegación.3. Elija Create role.4. En Select type of trusted entity, elija AWS service.5. En Choose the service that will use this role, elija Lambda. Elija Next: Permissions.6. En la página Attach permissions policies, elija las siguientes políticas:

• AWSLambdaBasicExecutionRole• AmazonSESFullAccess

Tip

Utilice el cuadro de búsqueda de la parte superior de la lista de políticas para buscarrápidamente estas políticas.

Elija Next: Review.7. En la página Review, en Name, escriba un nombre para el rol. Elija Create role.

Parte 2: Crear la función de Lambda:Después de crear un rol de IAM, puede crear la función de Lambda que detiene el envío de correoelectrónico para la cuenta.

Para crear la función de Lambda

1. Abra la consola de AWS Lambda en https://console.aws.amazon.com/lambda/.2. Utilice el selector de regiones para elegir la región en la que desea implementar esta función de

Lambda.

Note

Esta función solo detiene el envío de correo electrónico en la región de AWS que seleccioneen este paso. Si envía correo electrónico desde más de una región, repita los procedimientosde esta sección para cada región en la que desee poner en pausa automáticamente el envíode correo electrónico.

3. Elija Create function.4. En Create function, elija Author from scratch.5. En Author from scratch, haga lo siguiente:

• En Name, escriba un nombre para la función de Lambda.• En Runtime, elija Node.js 6.10.• En Role, elija Choose an existing role.• En Existing role, elija el rol de IAM que creó en the section called “Parte 1: Crear un rol de

IAM” (p. 366).

366


https://console.aws.amazon.com/lambda/



Elija Create function.6. En Function code, en el editor de código, pegue el código siguiente:

'use strict';

var aws = require('aws-sdk');

// Create a new SES object. var ses = new aws.SES();

// Specify the parameters for this operation. In this case, there is only one// parameter to pass: the Enabled parameter, with a value of false// (Enabled = false disables email sending, Enabled = true enables it).var params = { Enabled: false};

exports.handler = (event, context, callback) => { // Pause sending for your entire SES account ses.updateAccountSendingEnabled(params, function(err, data) { if(err) { console.log(err.message); } else { console.log(data); } });};

Seleccione Save.7. Elija Test. Si aparece la ventana Configure test event, escriba un nombre en el campo Event name y, a

continuación, elija Create.8. Asegúrese de que en la barra de notificación de la parte superior de la página se indica Execution

result: succeeded. Si la función no se pudo ejecutar, haga lo siguiente:

• Compruebe que el rol de IAM que ha creado en the section called “Parte 1: Crear un rol deIAM” (p. 366) contiene las políticas correctas.

• Compruebe que el código de la función de Lambda no contiene ningún error. El editor de código deLambda resalta automáticamente los errores de sintaxis y otros posibles problemas.

Parte 3: Volver a habilitar el envío de correo electrónico en sucuentaUn efecto secundario de probar la función de Lambda en the section called “Parte 2: Crear la funciónde Lambda:” (p. 366) es que el envío de correo electrónico de su cuenta de Amazon SES se pone enpausa. En la mayoría de los casos, no conviene poner en pausa el envío de la cuenta hasta que se activala alarma de CloudWatch.

Los procedimientos de esta sección vuelven a habilitar el envío de correo electrónico en su cuenta deAmazon SES. Para completar estos procedimientos, debe instalar y configurar la AWS Command LineInterface. Para obtener más información, consulte la Guía del usuario de AWS Command Line Interface.

Para volver a habilitar el envío de correo electrónico

1. En la línea de comandos, escriba el comando siguiente para volver a activar el envío de correoelectrónico para su cuenta: aws ses update-account-sending-enabled --enabled --region us-west-2

367




Note

Sustituya us-west-2 en el comando anterior por el nombre de la región para la que deseareactivar el envío de correo electrónico.

2. En la línea de comandos, escriba el siguiente comando para comprobar el estado de envío de correoelectrónico para su cuenta: aws ses get-account-sending-enabled --region us-west-2

Si ve el siguiente resultado, entonces ha habilitado correctamente el envío de correo electrónico en sucuenta:

{ "Enabled": true }

Parte 4: Crear un tema de Amazon SNSPara que CloudWatch ejecute su función de Lambda cuando se active una alarma, primero debe crear untema de Amazon SNS y suscribir la función de Lambda a ese tema.

Para crear el tema de Amazon SNS

1. Abra la consola de Amazon SNS en https://console.aws.amazon.com/sns/v2/home.2. Utilice el selector de regiones para elegir la región en la que desea poner en pausa automáticamente

el envío de correo electrónico.3. En el panel de navegación, elija Topics.4. Elija Create new topic.5. En la ventana Create new topic, para Topic name, escriba un nombre para el tema. También puede

incluir un nombre más descriptivo en el campo Display name.

Elija Create new topic.6. En la lista de temas, active la casilla situada junto al tema que creó en el paso anterior. En el menú

Actions, seleccione Subscribe to topic.7. En la ventana Create subscription, seleccione estas opciones:

• En Protocol, elija AWS Lambda.• En Endpoint, elija la función de Lambda que creó en the section called “Parte 2: Crear la función de

Lambda:” (p. 366).• En Version or alias, elija default.

8. Seleccione Create subscription.

Parte 5: Crear una alarma de CloudWatchEsta sección contiene los procedimientos para crear una alarma de CloudWatch que se activa cuandouna métrica alcanza un determinado umbral. Cuando se activa la alarma, se envía una notificación altema de Amazon SNS que creó en the section called “Parte 4: Crear un tema de Amazon SNS” (p. 368),que a su vez ejecuta la función de Lambda que creó en the section called “Parte 2: Crear la función deLambda:” (p. 366).


1. Abra la consola de CloudWatch en https://console.aws.amazon.com/cloudwatch/.

368





2. Utilice el selector de regiones para elegir la región en la que desea poner en pausa automáticamenteel envío de correo electrónico.

3. En el panel de navegación, elija Alarms.4. Elija Create Alarm.5. En la ventana Create Alarm, en SES Metrics, elija Account Metrics.6. En Metric Name, elija una de las siguientes opciones:

• Reputation.BounceRate: elija esta métrica si desea poner en pausa el envío de correo electrónicopara su cuenta cuando el total de rebotes permanentes de su cuenta supere el umbral definido.

• Reputation.ComplaintRate: elija esta métrica si desea poner en pausa el envío de correo electrónicopara su cuenta cuando el total de reclamaciones de su cuenta supere el umbral definido.

Seleccione Siguiente.7. Realice los pasos siguientes:

• En Alarm Threshold, para Name, escriba un nombre para la alarma.• En Whenever: Reputation.BounceRate o en Whenever: Reputation.ComplaintRate, especifique el

umbral que provocará la activación de la alarma.

Note

Su cuenta se coloca automáticamente en modo de prueba si el porcentaje de rebotes(mensajes devueltos) supera el 10%, o si el porcentaje de reclamaciones supera el 0,5%.Cuando especifique el porcentaje de rebotes o reclamaciones que hacen que se active laalarma de CloudWatch, le recomendamos que utilice valores inferiores a estos porcentajespara evitar que su cuenta se coloque en periodo de prueba.

• En Actions, en Whenever this alarm, elija State is ALARM. En Send notification to, seleccioneel tema de Amazon SNS que creó en the section called “Parte 4: Crear un tema de AmazonSNS” (p. 368).

Elija Create Alarm.

Parte 6: Probar la soluciónAhora puede probar la alarma para asegurarse de que se ejecuta la función de Lambda cuando tiene elestado ALARM. Puede utilizar la operación de API SetAlarmState para cambiar temporalmente el estadode la alarma.

Los procedimientos de esta sección son opcionales, pero le recomendamos que los realice paraasegurarse de que toda la solución está configurada correctamente.


Note

Sustituya us-west-2 en el comando anterior por el nombre de la región que ha especificadoen el paso anterior.

Si el envío está activado para su cuenta, puede ver el siguiente resultado:

{ "Enabled": true }

369

Amazon Simple Email Service Developer GuidePuesta en pausa automática del envío de correo

electrónico para un conjunto de configuración

2. En la línea de comandos, escriba el siguiente comando para cambiar temporalmente el estado de laalarma a ALARM: aws cloudwatch set-alarm-state --alarm-name MiAlarma --state-value ALARM --state-reason "Probar la ejecución de la función de Lambda" --region us-west-2

Sustituya MyAlarm en el comando anterior por el nombre de la alarma que creó en la the sectioncalled “Parte 5: Crear una alarma de CloudWatch” (p. 368) y sustituya us-west-2 por la región enla que desea poner en pausa automáticamente el envío de correo electrónico.

Note

Cuando ejecute este comando, el estado de la alarma pasa de OK a ALARM y luego otra vez aOK al cabo de unos segundos. Puede ver estos cambios de estado en la pestaña History de laalarma en la consola de CloudWatch o mediante la operación DescribeAlarmHistory.


Si la función de Lambda se ha ejecutado correctamente, se muestra el resultado siguiente:

{ "Enabled": false}

4. Realice los pasos de the section called “Parte 3: Volver a habilitar el envío de correo electrónico en sucuenta” (p. 367) para volver a habilitar el envío de correo electrónico en su cuenta.

Puesta en pausa automática del envío de correoelectrónico para un conjunto de configuraciónPuede configurar Amazon SES para exportar métricas de reputación específicas de mensajes decorreo electrónico enviados mediante un conjunto de configuración específico a Amazon CloudWatch.A continuación, puede utilizar estas métricas para crear alarmas de CloudWatch específicas de estosconjuntos de configuración. Cuando estas alarmas superen determinados umbrales, puede poneren pausa automáticamente el envío de mensajes de correo electrónico que utilizan los conjuntos deconfiguración especificados, sin que esto afecte a las funcionalidades generales de envío de correo de sucuenta de Amazon SES.

Note

La solución que se describe en esta sección detiene el envío de correo electrónico para unconjunto de configuración específico de una sola región de AWS. Si envía correo electrónicodesde varias regiones, repita los procedimientos de esta sección para cada región en la quedesee implementar esta solución.

Temas de esta sección:• Parte 1: Habilitar los informes de métricas de reputación de un conjunto de configuración (p. 371)• Parte 2: Crear un rol de IAM (p. 371)• Parte 3: Crear la función de Lambda: (p. 371)• Parte 4: Volver a habilitar el envío de correo electrónico para el conjunto de configuración (p. 372)• Parte 5: Crear un tema de Amazon SNS (p. 373)• Parte 6: Crear una alarma de CloudWatch (p. 374)• Parte 7: Probar la solución (p. 375)

370

https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_DescribeAlarmHistory.html



Parte 1: Habilitar los informes de métricas de reputación de unconjunto de configuraciónAntes de poder configurar Amazon SES para poner en pausa automáticamente el envío de correoelectrónico para un conjunto de configuración, primero debe habilitar la exportación de métricas dereputación del conjunto de configuración.

Para habilitar la exportación de métricas de rebotes y reclamaciones para el conjunto de configuración,realice los pasos de the section called “Exportación de métricas de reputación” (p. 228).

Parte 2: Crear un rol de IAMEl primer paso para configurar la puesta en pausa automática del envío de correo electrónico es crear unrol de IAM que pueda ejecutar la operación de API UpdateConfigurationSetSendingEnabled.

Para crear la función de IAM

1. Abra la consola de IAM, en https://console.aws.amazon.com/iam/.2. Seleccione Roles en el panel de navegación.3. Elija Create role.4. En Select type of trusted entity, elija AWS service.5. En Choose the service that will use this role, elija Lambda. Elija Next: Permissions.6. En la página Attach permissions policies, elija las siguientes políticas:

• AWS LambdaBasicExecutionRole• AmazonSESFullAccess

Tip

Utilice el cuadro de búsqueda de la parte superior de la lista de políticas para buscarrápidamente estas políticas.

Elija Next: Review.7. En la página Review, en Name, escriba un nombre para el rol. Elija Create role.

Parte 3: Crear la función de Lambda:Después de crear un rol de IAM, puede crear la función de Lambda que detiene el envío de correoelectrónico para el conjunto de configuración.

Para crear la función de Lambda

1. Abra la consola de AWS Lambda en https://console.aws.amazon.com/lambda/.2. Utilice el selector de regiones para elegir la región en la que desea implementar esta función de

Lambda.Note

Esta función solo detiene el envío de correo electrónico para los conjuntos de configuraciónde la región de AWS que seleccione en este paso. Si envía correo electrónico desde más deuna región, repita los procedimientos de esta sección para cada región en la que desee poneren pausa automáticamente el envío de correo electrónico.

3. Elija Create function.4. En Create function, elija Author from scratch.

371





5. En Author from scratch, haga lo siguiente:

• En Name, escriba un nombre para la función de Lambda.• En Runtime, elija Node.js 6.10.• En Role, elija Choose an existing role.• En Existing role, elija el rol de IAM que creó en the section called “Parte 2: Crear un rol de

IAM” (p. 371).

Elija Create function.6. En Function code, en el editor de código, pegue el código siguiente:

'use strict';



// Specify the parameters for this operation. In this example, you pass the // Enabled parameter, with a value of false (Enabled = false disables email // sending, Enabled = true enables it). You also pass the ConfigurationSetName// parameter, with a value equal to the name of the configuration set for // which you want to pause email sending.var params = { ConfigurationSetName: ConfigSet, Enabled: false};

exports.handler = (event, context, callback) => { // Pause sending for a configuration set ses.updateConfigurationSetSendingEnabled(params, function(err, data) { if(err) { console.log(err.message); } else { console.log(data); } });};

Reemplace ConfigSet en el código anterior por el nombre del conjunto de configuración. SeleccioneSave.

7. Elija Test. Si aparece la ventana Configure test event, escriba un nombre en el campo Event name y, acontinuación, elija Create.

8. Asegúrese de que en la barra de notificación de la parte superior de la página se indica Executionresult: succeeded. Si la función no se pudo ejecutar, haga lo siguiente:

• Compruebe que el rol de IAM que ha creado en the section called “Parte 2: Crear un rol deIAM” (p. 371) contiene las políticas correctas.

• Compruebe que el código de la función de Lambda no contiene ningún error. El editor de código deLambda resalta automáticamente los errores de sintaxis y otros posibles problemas.

Parte 4: Volver a habilitar el envío de correo electrónico para elconjunto de configuraciónUn efecto secundario de probar la función de Lambda en the section called “Parte 3: Crear la función deLambda:” (p. 371) es que el envío de correo electrónico para el conjunto de configuración se pone en

372



pausa. En la mayoría de los casos, no conviene poner en pausa el envío para el conjunto de configuraciónhasta que se activa la alarma de CloudWatch.

Los procedimientos de esta sección vuelven a habilitar el envío de correo electrónico para su conjunto deconfiguración. Para completar estos procedimientos, debe instalar y configurar la AWS Command LineInterface. Para obtener más información, consulte la Guía del usuario de AWS Command Line Interface.

Para volver a habilitar el envío de correo electrónico

1. En la línea de comandos, escriba el siguiente comando para volver a habilitar el envío de correoelectrónico para el conjunto de configuración: aws ses update-configuration-set-sending-enabled --configuration-set-name ConfigSet --enabled --region us-west-2

En el comando anterior, sustituya ConfigSet por el nombre del conjunto de configuración para el quedesea poner en pausa el envío de correo electrónico y sustituya us-west-2 por la región en la quedesea poner en pausa automáticamente el envío de correo electrónico.

2. En la línea de comandos, escriba el comando siguiente para asegurarse de que el envío de correoelectrónico está activado: aws ses describe-configuration-set --configuration-set-name ConfigSet --region us-west-2

Verá una salida similar a la siguiente:

{ "ConfigurationSet": { "Name": "ConfigSet" }, "ReputationOptions": { "ReputationMetricsEnabled": true, "SendingEnabled": true } }

Si el valor de SendingEnabled es true, el envío de correo electrónico para el conjunto deconfiguración se ha vuelto a habilitar correctamente.

Parte 5: Crear un tema de Amazon SNSPara que CloudWatch ejecute la función de Lambda cuando se active una alarma, primero debe crear untema de Amazon SNS y suscribir la función de Lambda a ese tema.

Para crear el tema de Amazon SNS

1. Abra la consola de Amazon SNS en https://console.aws.amazon.com/sns/v2/home.2. Utilice el selector de regiones para elegir la región en la que desea poner en pausa automáticamente

el envío de correo electrónico.3. En el panel de navegación, elija Topics.4. Elija Create new topic.5. En la ventana Create new topic, para Topic name, escriba un nombre para el tema. También puede

incluir un nombre más descriptivo en el campo Display name.

Elija Create new topic.6. En la lista de temas, active la casilla situada junto al tema que creó en el paso anterior. En el menú

Actions, seleccione Subscribe to topic.7. En la ventana Create subscription, seleccione estas opciones:

• En Protocol, elija AWS Lambda.

373





• En Endpoint, elija la función de Lambda que creó en the section called “Parte 3: Crear la función deLambda:” (p. 371).

• En Version or alias, elija default.8. Seleccione Create subscription.

Parte 6: Crear una alarma de CloudWatchEsta sección contiene los procedimientos para crear una alarma de CloudWatch que se activa cuandouna métrica alcanza un determinado umbral. Cuando se activa la alarma, se envía una notificación altema de Amazon SNS que creó en the section called “Parte 5: Crear un tema de Amazon SNS” (p. 373),que a su vez ejecuta la función de Lambda que creó en the section called “Parte 3: Crear la función deLambda:” (p. 371).


1. Abra la consola de CloudWatch en https://console.aws.amazon.com/cloudwatch/.2. Utilice el selector de regiones para elegir la región en la que desea poner en pausa automáticamente

el envío de correo electrónico.3. En el panel de navegación de la izquierda, elija Alarms.4. Elija Create Alarm.5. En la ventana Create Alarm, en SES Metrics, elija Configuration Set Metrics.6. En la columna ses:configuration-set, busque el conjunto de configuración para el que desea crear una

alarma. En Metric Name, elija una de las siguientes opciones:

• Reputation.BounceRate: elija esta métrica si desea poner en pausa el envío de correo electrónicopara el conjunto de configuración cuando el total de rebotes permanentes del conjunto deconfiguración supere el umbral definido.

• Reputation.ComplaintRate: elija esta métrica si desea poner en pausa el envío de correo electrónicopara el conjunto de configuración cuando el total de reclamaciones del conjunto de configuraciónsupere el umbral definido.

Seleccione Siguiente.7. Realice los pasos siguientes:

• En Alarm Threshold, para Name, escriba un nombre para la alarma.• En Whenever: Reputation.BounceRate o en Whenever: Reputation.ComplaintRate, especifique el

umbral que provocará la activación de la alarma.

Note

Si el porcentaje de rebotes (mensajes devueltos) de su cuenta de Amazon SES supera el10% o si el porcentaje de reclamaciones de su cuenta de Amazon SES supera el 0,5%, sucuenta de Amazon SES pasa automáticamente al modo de prueba. Cuando especifique elporcentaje de rebotes o reclamaciones que hacen que se active la alarma de CloudWatch,le recomendamos que utilice valores bastante inferiores a estos porcentajes para evitar quesu cuenta se coloque en periodo de prueba.

• En Actions, en Whenever this alarm, elija State is ALARM. En Send notification to, seleccioneel tema de Amazon SNS que creó en the section called “Parte 5: Crear un tema de AmazonSNS” (p. 373).

Elija Create Alarm.

374




Parte 7: Probar la soluciónAhora puede probar la alarma para asegurarse de que se ejecuta la función de Lambda cuando tieneel estado ALARM. Puede utilizar la operación SetAlarmState de API de CloudWatch para cambiartemporalmente el estado de la alarma.

Los procedimientos de esta sección son opcionales, pero le recomendamos que los realice paracomprobar que toda la solución está configurada correctamente.

Para probar la solución

1. En la línea de comandos, escriba el siguiente comando para comprobar el estado de envío de correoelectrónico para el conjunto de configuración: aws ses describe-configuration-set --configuration-set-name ConfigSet --region us-west-2

Si el envío está habilitado para el conjunto de configuración, se muestra el resultado siguiente:

{ "ConfigurationSet": { "Name": "ConfigSet" }, "ReputationOptions": { "ReputationMetricsEnabled": true, "SendingEnabled": true } }

Si el valor de SendingEnabled es true, el envío de correo electrónico está habilitado actualmentepara el conjunto de configuración.

2. En la línea de comandos, escriba el siguiente comando para cambiar temporalmente el estado de laalarma a ALARM: aws cloudwatch set-alarm-state --alarm-name MiAlarma --state-value ALARM --state-reason "Probar la ejecución de la función de Lambda" --region us-west-2

Reemplace MiAlarma en el comando anterior por el nombre de la alarma que creó en the sectioncalled “Parte 6: Crear una alarma de CloudWatch” (p. 374).

Note

Cuando ejecute este comando, el estado de la alarma pasa de OK a ALARM y luego otra vez aOK al cabo de unos segundos. Puede ver estos cambios de estado en la pestaña History de laalarma en la consola de CloudWatch o mediante la operación DescribeAlarmHistory.

3. En la línea de comandos, escriba el siguiente comando para comprobar el estado de envío de correoelectrónico para el conjunto de configuración: aws ses describe-configuration-set --configuration-set-name ConfigSet

Si la función de Lambda se ha ejecutado correctamente, se muestra el resultado siguiente:

{ "ConfigurationSet": { "Name": "ConfigSet" }, "ReputationOptions": { "ReputationMetricsEnabled": true, "SendingEnabled": false } }

375

https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_DescribeAlarmHistory.html



Si el valor de SendingEnabled es false, el envío de correo electrónico para el conjuntode configuración está deshabilitado, lo que indica que la función de Lambda se ha ejecutadocorrectamente.

4. Realice los pasos de the section called “Parte 4: Volver a habilitar el envío de correo electrónico parael conjunto de configuración” (p. 372) para volver a habilitar el envío de correo electrónico para elconjunto de configuración.

376

Amazon Simple Email Service Developer GuideCreación de políticas de IAM para acceso a Amazon SES

Control del acceso a Amazon SESPuede utilizar AWS Identity and Access Management (IAM) con Amazon Simple Email Service (AmazonSES) para especificar qué acciones del API de Amazon SES puede realizar un usuario, grupo o función deIAM. (En este tema hacemos referencia a estas entidades colectivamente como usuario). También puedecontrolar qué direcciones de correo electrónico puede utilizar el usuario para las direcciones de remitente("From"), destinatario y "Return-Path" de los correos electrónicos.

Por ejemplo, puede crear una política de IAM que permita a los usuarios de su organización enviarcorreos electrónicos, pero no llevar a cabo acciones administrativas tales como estadísticas de envíode comprobación. Otro ejemplo, puede escribir una política que permita a un usuario enviar correoselectrónicos a través de Amazon SES desde su cuenta, pero solo si utilizan una dirección de remitente("From") específica.

Para utilizar IAM, defina una política de IAM, que es un documento que define de forma explícita lospermisos y adjunta la política a un usuario. Para obtener información sobre cómo crear políticas de IAM,consulte la Guía del usuario de IAM. Aparte de aplicar las restricciones que establezca en su política, nohay cambios en el modo en que los usuarios interactúan con Amazon SES o en cómo Amazon SES lleva acabo las solicitudes.

Note

También puede controlar el acceso a Amazon SES utilizando políticas de autorización de envío.Mientras que las políticas de IAM restringen lo que pueden hacer los usuarios de IAM individuales,el envío de políticas de autorización restringe cómo se pueden utilizar las identidades verificadas.Además, solo las políticas de autorización de envío pueden otorgar acceso entre cuentas. Paraobtener más información acerca de la autorización de envío, consulte Uso de autorización deenvío con Amazon SES (p. 141).

Si busca información sobre cómo generar credenciales SMTP de Amazon SES para un usuario de IAMexistente, consulte Obtener sus credenciales de SMTP de Amazon SES (p. 75).

Creación de políticas de IAM para acceso aAmazon SES

En esta sección se explica cómo puede utilizar las políticas de IAM específicamente con Amazon SES.Para obtener información sobre cómo crear políticas de IAM en general consulte la Guía del usuario deIAM.

Existen tres razones por las que podría utilizar IAM con Amazon SES:

• Para restringir la acción de envío de correo electrónico.• Para restringir las direcciones "From", de destinatario y de "Return-Path" de los correos electrónicos que

el usuario envía.• Para controlar aspectos generales del uso del API, como el periodo de tiempo durante el que se permite

que un usuario llame a los API que está autorizado a utilizar.

Restringir la acciónPara controlar qué acciones de Amazon SES puede realizar un usuario, utilice el elemento Action deuna política de IAM. Puede establecer el elemento Action en cualquier acción de API de Amazon SES

377

https://docs.aws.amazon.com/IAM/latest/UserGuide/policies_overview.html

https://docs.aws.amazon.com/IAM/latest/UserGuide/AccessPolicyLanguage_ElementDescriptions.html

https://docs.aws.amazon.com/IAM/latest/UserGuide/AccessPolicyLanguage_ElementDescriptions.html

Amazon Simple Email Service Developer GuideRestricción de direcciones de correo electrónico

poniendo como prefijo en el nombre del API la cadena en minúsculas ses:. Por ejemplo, puede establecerAction en ses:SendEmail, ses:GetSendStatisticso ses:* (para todas las acciones).

A continuación, en función de Action, especifique el elemento Resource de la siguiente manera:

Si el elemento Action solo permite el acceso a API de envío de correo electrónico (es decir,ses:SendEmail o ses:SendRawEmail):

• Para permitir al usuario enviar desde cualquier identidad en su cuenta de AWS, defina Resource en *• Para limitar las identidades desde las que puede enviar el usuario, defina Resource en los ARN(s) de

las identidades que permite utilizar al usuario.

Si el elemento Action permite el acceso a todos los API:

• Si no desea limitar las identidades desde las que puede enviar el usuario, defina Resource en *• Si desea limitar las identidades desde las que un usuario puede enviar, tiene que crear dos políticas (o

dos instrucciones dentro de una política):• Una con Action definida en una lista explícita de los API no de envío de correo electrónico yResource establecido en *

• Una con Action establecido en uno de los API de envío de correo electrónico (ses:SendEmailo ses:SendRawEmail) y Resource definido en los ARN de las identidades que permite utilizar alusuario.

Para obtener una lista de acciones de Amazon SES disponibles, consulte la Amazon Simple EmailService API Reference. Si el usuario de IAM utilizará la interfaz de SMTP, debe permitir el acceso ases:SendRawEmail como mínimo.

Restricción de direcciones de correo electrónicoSi desea restringir al usuario a direcciones de correo electrónico específicas, puede utilizar un bloqueCondition. En el bloque Condition, debe especificar las condiciones utilizando claves de condición taly como se describe en la Guía del usuario de IAM. Mediante el uso de claves de condición, podrá controlarlas siguientes direcciones de correo electrónico:

Note

Estas claves de condición de dirección de correo electrónico se aplican únicamente a los APIindicados en la siguiente tabla.

Clave de condición Descripción API

ses:Recipients Restringe las direcciones deldestinatario, que incluyen lasdirecciones To:, "CC" y "BCC".

SendEmail, SendRawEmail

ses:FromAddress Restringe la dirección deremitente ("From").

SendEmail, SendRawEmail,SendBounce

ses:FromDisplayName Restringe la dirección deremitente ("From") que se utilizacomo nombre de visualización.


ses:FeedbackAddress Restringe la dirección "Return-Path", que es la dirección dondese pueden enviar los rebotesy las reclamaciones mediante


378




Amazon Simple Email Service Developer GuideRestricción del uso de API general

Clave de condición Descripción APIreenvío de retroalimentaciónde correo electrónico. Paraobtener información acerca delreenvío de retroalimentaciónde correo electrónico, consulteNotificaciones de AmazonSES a través de correoelectrónico (p. 237).

Restricción del uso de API generalMediante el uso de condiciones de claves a escala de AWS, puede restringir el acceso a Amazon SESen función de aspectos como, por ejemplo, la fecha y la hora a la que se permite el acceso a los API alusuario. Amazon SES implementa solo las siguientes claves de políticas a escala de AWS:

• aws:CurrentTime

• aws:EpochTime

• aws:SecureTransport

• aws:SourceIp

• aws:UserAgent

Para obtener más información sobre estas claves, consulte la Guía del usuario de IAM.

Ejemplos de políticas de IAM para Amazon SESEn este tema se ofrecen ejemplos de políticas que permiten a un usuario acceder a Amazon SES, perosolo en determinadas condiciones.

Ejemplos de políticas de esta sección:• Permitir el acceso completo a todas las acciones de Amazon SES (p. 379)• Permitir el acceso solo a acciones de envío de correo electrónico (p. 380)• Restricción del periodo de tiempo de envío (p. 380)• Restricción de las direcciones de destinatario (p. 381)• Restricción de la dirección de remitente ("From") (p. 381)• Restricción del nombre de visualización del remitente de correo electrónico (p. 382)• Restringir el destino de retroalimentación de rebotes y reclamaciones (p. 382)

Permitir el acceso completo a todas las acciones deAmazon SESLa siguiente política le permite a un usuario llamar a cualquier acción de Amazon SES.

{ "Version":"2012-10-17",

379


Amazon Simple Email Service Developer GuidePermitir el acceso solo a acciones

de envío de correo electrónico

"Statement":[ { "Effect":"Allow", "Action":[ "ses:*" ], "Resource":"*" } ]}

Permitir el acceso solo a acciones de envío de correoelectrónicoLa siguiente política permite a un usuario enviar correos electrónicos a través de Amazon SES, pero nopermite al usuario llevar a cabo acciones administrativas como, por ejemplo, el acceso a las estadísticasde envío de Amazon SES.

{ "Version":"2012-10-17", "Statement":[ { "Effect":"Allow", "Action":[ "ses:SendEmail", "ses:SendRawEmail" ], "Resource":"*" } ]}

Restricción del periodo de tiempo de envíoLa siguiente política permite a un usuario llamar a los API de envío de correo electrónico de Amazon SESsolo durante el mes de septiembre de 2018.

{ "Version":"2012-10-17", "Statement":[ { "Effect":"Allow", "Action":[ "ses:SendEmail", "ses:SendRawEmail" ], "Resource":"*", "Condition":{ "DateGreaterThan":{ "aws:CurrentTime":"2018-08-31T12:00Z" }, "DateLessThan":{ "aws:CurrentTime":"2018-10-01T12:00Z" } } } ]}

380

Amazon Simple Email Service Developer GuideRestricción de las direcciones de destinatario

Restricción de las direcciones de destinatarioLa siguiente política permite a un usuario llamar a los API de envío de correo electrónico de Amazon SES,pero solo a direcciones de destinatario en el dominio example.com.

{ "Version":"2012-10-17", "Statement":[ { "Effect":"Allow", "Action":[ "ses:SendEmail", "ses:SendRawEmail" ], "Resource":"*", "Condition":{ "ForAllValues:StringLike":{ "ses:Recipients":[ "*@example.com" ] } } } ]}

Restricción de la dirección de remitente ("From")La siguiente política permite a un usuario llamar a los API de envío de correo electrónico de Amazon SES,pero solo si la dirección de remitente ("From") es [email protected].

{ "Version":"2012-10-17", "Statement":[ { "Effect":"Allow", "Action":[ "ses:SendEmail", "ses:SendRawEmail" ], "Resource":"*", "Condition":{ "StringEquals":{ "ses:FromAddress":"[email protected]" } } } ]}

La siguiente política permite a un usuario llamar al API SendBounce, pero solo si la dirección de remitente("From") es [email protected].

{ "Version":"2012-10-17", "Statement":[ { "Effect":"Allow", "Action":[ "ses:SendBounce"

381

https://docs.aws.amazon.com/ses/latest/APIReference/API_SendBounce.html

Amazon Simple Email Service Developer GuideRestricción del nombre de visualización

del remitente de correo electrónico

], "Resource":"*", "Condition":{ "StringEquals":{ "ses:FromAddress":"[email protected]" } } } ]}

Restricción del nombre de visualización del remitentede correo electrónicoLa siguiente política permite a un usuario llamar a los API de envío de correo electrónico de Amazon SES,pero solo si el nombre de visualización de la dirección de remitente ("From") incluye Marketing.

{ "Version":"2012-10-17", "Statement":[ { "Effect":"Allow", "Action":[ "ses:SendEmail", "ses:SendRawEmail" ], "Resource":"*", "Condition":{ "StringLike":{ "ses:FromDisplayName":"Marketing" } } } ]}

Restringir el destino de retroalimentación de rebotes yreclamacionesLa siguiente política permite a un usuario llamar a los API de envío de correo electrónico deAmazon SES, pero solo si la dirección "Return-Path" del correo electrónico se ha establecido [email protected].

{ "Version":"2012-10-17", "Statement":[ { "Effect":"Allow", "Action":[ "ses:SendEmail", "ses:SendRawEmail" ], "Resource":"*", "Condition":{ "StringEquals":{ "ses:FeedbackAddress":"[email protected]" } }

382

Amazon Simple Email Service Developer GuideRestringir el destino de retroalimentación

de rebotes y reclamaciones

} ]}

383

Amazon Simple Email Service Developer GuideInformación de Amazon SES en CloudTrail

Registro de llamadas al API deAmazon SES utilizando AWSCloudTrail

Amazon SES está integrado con CloudTrail, un servicio que captura las llamadas al API realizadas por oen nombre de Amazon SES en su cuenta de AWS y envía los archivos de registro al bucket de AmazonS3 que especifique. CloudTrail captura las llamadas al API realizadas desde la consola de Amazon SESo desde el API de Amazon SES. Mediante la información recopilada por CloudTrail puede determinar lasolicitud que se realizó a Amazon SES, la dirección IP de origen desde la que se realizó la solicitud, quiénrealizó la solicitud, cuándo la realizó, etcétera. Para obtener más información sobre CloudTrail, incluidocómo configurarlo y habilitarlo, consulte la AWS CloudTrail User Guide.

Información de Amazon SES en CloudTrailSi el registro de CloudTrail está habilitado en su cuenta de AWS, las llamadas al API realizadas a unsubconjunto de acciones de Amazon SES se registran en archivos de registro. Los registros de AmazonSES se escriben junto con los de otros servicios de AWS en un archivo de registro. CloudTrail determinacuándo crear y escribir en un nuevo archivo en función del período de tiempo y del tamaño del archivo.

Se admiten las siguientes acciones:

• CloneReceiptRuleSet• CreateReceiptFilter• CreateReceiptRule• CreateReceiptRuleSet• DeleteIdentity• DeleteIdentityPolicy• DeleteReceiptFilter• DeleteReceiptRule• DeleteReceiptRuleSet• DeleteVerifiedEmailAddress• DescribeActiveReceiptRuleSet• DescribeReceiptRule• DescribeReceiptRuleSet• GetIdentityDkimAttributes• GetIdentityNotificationAttributes• GetIdentityPolicies• GetIdentityVerificationAttributes• GetSendQuota• GetSendStatistics• ListIdentities• ListIdentityPolicies

384

https://docs.aws.amazon.com/awscloudtrail/latest/userguide/

https://docs.aws.amazon.com/ses/latest/APIReference/API_CloneReceiptRuleSet.html

https://docs.aws.amazon.com/ses/latest/APIReference/API_CreateReceiptFilter.html


https://docs.aws.amazon.com/ses/latest/APIReference/API_CreateReceiptRuleSet.html


https://docs.aws.amazon.com/ses/latest/APIReference/API_DeleteIdentityPolicy.html

https://docs.aws.amazon.com/ses/latest/APIReference/API_DeleteReceiptFilter.html

https://docs.aws.amazon.com/ses/latest/APIReference/API_DeleteReceiptRule.html

https://docs.aws.amazon.com/ses/latest/APIReference/API_DeleteReceiptRuleSet.html

https://docs.aws.amazon.com/ses/latest/APIReference/API_DeleteVerifiedEmailAddress.html

https://docs.aws.amazon.com/ses/latest/APIReference/API_DescribeActiveReceiptRuleSet.html

https://docs.aws.amazon.com/ses/latest/APIReference/API_DescribeReceiptRule.html

https://docs.aws.amazon.com/ses/latest/APIReference/API_DescribeReceiptRuleSet.html

https://docs.aws.amazon.com/ses/latest/APIReference/API_GetIdentityDkimAttributes.html



https://docs.aws.amazon.com/ses/latest/APIReference/API_GetIdentityVerificationAttributes.html

https://docs.aws.amazon.com/ses/latest/APIReference/API_GetSendQuota.html

https://docs.aws.amazon.com/ses/latest/APIReference/API_GetSendStatistics.html


https://docs.aws.amazon.com/ses/latest/APIReference/API_ListIdentityPolicies.html

Amazon Simple Email Service Developer GuideEntradas de archivos de registro de Amazon SES

• ListReceiptFilters• ListReceiptRuleSets• ListVerifiedEmailAddresses• PutIdentityPolicy• ReorderReceiptRuleSet• SetActiveReceiptRuleSet• SetReceiptRulePosition• SetIdentityDkimEnabled• SetIdentityFeedbackForwardingEnabled• SetIdentityHeadersInNotificationsEnabled• SetIdentityNotificationTopic• UpdateReceiptRule• VerifyDomainDkim• VerifyDomainIdentity• VerifyEmailAddress• VerifyEmailIdentity

Cada entrada de log contiene información sobre quién generó la solicitud. La información de identidad delusuario que figura en el log le ayudará a determinar si la solicitud se hizo con credenciales de usuario deIAM o raíz, con credenciales de seguridad temporales para un rol o un usuario federado, o mediante otroservicio de AWS. Para obtener más información, consulte el campo userIdentity en Referencia de eventosde CloudTrail.

Puede almacenar los archivos de log en su bucket todo el tiempo que desee, y también puede definirreglas de ciclo de vida de Amazon S3 para archivar o eliminar archivos de log automáticamente. De formapredeterminada, los archivos de log se cifran mediante cifrado en el lado de servidor de Amazon S3 (SSE).

Puede hacer que CloudTrail publique notificaciones de Amazon SNS cuando se entreguen los nuevosarchivos de log si desea actuar rápidamente al recibir un archivo de log. Para obtener más información,consulte Configuring Amazon SNS Notifications.

También puede agregar archivos de registro de Amazon SES de varias regiones de AWS y de variascuentas de AWS en un solo bucket de Amazon S3. Para obtener más información, consulte AggregatingCloudTrail Log Files to a Single Amazon S3 Bucket.

Entradas de archivos de registro de Amazon SESLos archivos log de CloudTrail contienen una o varias entradas de log, cada una de las cuales estácompuesta por varios eventos con formato JSON. Una entrada de log representa una única solicitud decualquier origen e incluye información sobre la acción solicitada, los parámetros, la fecha y la hora de laacción, etcétera. No se garantiza que las entradas de log sigan un orden específico; es decir, no son unrastro de stack ordenado de las llamadas públicas a la API.

En el siguiente ejemplo se muestra un log de CloudTrail.

{ "Records": [ { "awsRegion": "us-west-2", "eventID": "0ffa308d-1467-4259-8be3-c749753be325", "eventName": "DeleteIdentity", "eventSource": "ses.amazonaws.com",

385

https://docs.aws.amazon.com/ses/latest/APIReference/API_ListReceiptFilters.html

https://docs.aws.amazon.com/ses/latest/APIReference/API_ListReceiptRuleSets.html

https://docs.aws.amazon.com/ses/latest/APIReference/API_ListVerifiedEmailAddresses.html

https://docs.aws.amazon.com/ses/latest/APIReference/API_PutIdentityPolicy.html

https://docs.aws.amazon.com/ses/latest/APIReference/API_ReorderReceiptRuleSet.html

https://docs.aws.amazon.com/ses/latest/APIReference/API_SetActiveReceiptRuleSet.html


https://docs.aws.amazon.com/ses/latest/APIReference/API_SetIdentityDkimEnabled.html


https://docs.aws.amazon.com/ses/latest/APIReference/API_SetIdentityHeadersInNotificationsEnabled.html



https://docs.aws.amazon.com/ses/latest/APIReference/API_VerifyDomainDkim.html

https://docs.aws.amazon.com/ses/latest/APIReference/API_VerifyDomainIdentity.html

https://docs.aws.amazon.com/ses/latest/APIReference/API_VerifyEmailAddress.html


https://docs.aws.amazon.com/awscloudtrail/latest/userguide/event_reference_top_level.html

https://docs.aws.amazon.com/awscloudtrail/latest/userguide/event_reference_top_level.html

https://docs.aws.amazon.com/awscloudtrail/latest/userguide/getting_notifications_top_level.html

https://docs.aws.amazon.com/awscloudtrail/latest/userguide/aggregating_logs_top_level.html

https://docs.aws.amazon.com/awscloudtrail/latest/userguide/aggregating_logs_top_level.html


"eventTime": "2015-02-02T21:34:50Z", "eventType": "AwsApiCall", "eventVersion": "1.02", "recipientAccountId": "111122223333", "requestID": "50b87bfe-ab23-11e4-9106-5b36376f9d12", "requestParameters": { "identity": "amazon.com" }, "responseElements": null, "sourceIPAddress": "192.0.2.0", "userAgent": "aws-sdk-java/unknown-version", "userIdentity": { "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "accountId": "111122223333", "arn": "arn:aws:iam::111122223333:root", "principalId": "111122223333", "type": "Root" } }, { "awsRegion": "us-west-2", "eventID": "17bb827a-dc8c-4156-90b1-c214e1d135c9", "eventName": "DeleteVerifiedEmailAddress", "eventSource": "ses.amazonaws.com", "eventTime": "2015-02-04T00:57:15Z", "eventType": "AwsApiCall", "eventVersion": "1.02", "recipientAccountId": "111122223333", "requestID": "c29fb5c1-ac08-11e4-8ff5-a56a3119e253", "requestParameters": { "emailAddress": "[email protected]" }, "responseElements": null, "sourceIPAddress": "192.0.2.0", "userAgent": "aws-sdk-java/unknown-version", "userIdentity": { "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "accountId": "111122223333", "arn": "arn:aws:iam::111122223333:root", "principalId": "111122223333", "type": "Root" } }, { "awsRegion": "us-west-2", "eventID": "0b311e38-b5c6-43b3-9a39-5fbf0c2d0d99", "eventName": "GetIdentityDkimAttributes", "eventSource": "ses.amazonaws.com", "eventTime": "2015-02-02T21:34:50Z", "eventType": "AwsApiCall", "eventVersion": "1.02", "recipientAccountId": "111122223333", "requestID": "50f92e80-ab23-11e4-9106-5b36376f9d12", "requestParameters": { "identities": [ "example.com" ] }, "responseElements": null, "sourceIPAddress": "192.0.2.0", "userAgent": "aws-sdk-java/unknown-version", "userIdentity": { "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "accountId": "111122223333", "arn": "arn:aws:iam::111122223333:root", "principalId": "111122223333",

386


"type": "Root" } }, { "awsRegion": "us-west-2", "eventID": "bf695be8-1c67-45b0-8f10-fd56afee09dd", "eventName": "GetIdentityNotificationAttributes", "eventSource": "ses.amazonaws.com", "eventTime": "2015-02-02T21:34:50Z", "eventType": "AwsApiCall", "eventVersion": "1.02", "recipientAccountId": "111122223333", "requestID": "5133ed92-ab23-11e4-9106-5b36376f9d12", "requestParameters": { "identities": [ "example.com" ] }, "responseElements": null, "sourceIPAddress": "192.0.2.0", "userAgent": "aws-sdk-java/unknown-version", "userIdentity": { "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "accountId": "111122223333", "arn": "arn:aws:iam::111122223333:root", "principalId": "111122223333", "type": "Root" } }, { "awsRegion": "us-west-2", "eventID": "8f9aed63-b03a-4d30-a880-33ae0c6b7786", "eventName": "GetIdentityVerificationAttributes", "eventSource": "ses.amazonaws.com", "eventTime": "2015-02-04T00:57:16Z", "eventType": "AwsApiCall", "eventVersion": "1.02", "recipientAccountId": "111122223333", "requestID": "c2d23773-ac08-11e4-8ff5-a56a3119e253", "requestParameters": { "identities": [ "example.com" ] }, "responseElements": null, "sourceIPAddress": "192.0.2.0", "userAgent": "aws-sdk-java/unknown-version", "userIdentity": { "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "accountId": "111122223333", "arn": "arn:aws:iam::111122223333:root", "principalId": "111122223333", "type": "Root" } }, { "awsRegion": "us-west-2", "eventID": "60ef4f01-9826-4fb4-828e-8c36dda81f40", "eventName": "GetSendQuota", "eventSource": "ses.amazonaws.com", "eventTime": "2015-02-04T01:03:27Z", "eventType": "AwsApiCall", "eventVersion": "1.02", "recipientAccountId": "111122223333", "requestID": "a0760648-ac09-11e4-8ff5-a56a3119e253", "requestParameters": null,

387


"responseElements": null, "sourceIPAddress": "192.0.2.0", "userAgent": "aws-sdk-java/unknown-version", "userIdentity": { "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "accountId": "111122223333", "arn": "arn:aws:iam::111122223333:root", "principalId": "111122223333", "type": "Root" } }, { "awsRegion": "us-west-2", "eventID": "0fe5eef3-0c28-4480-808e-307b21404a78", "eventName": "GetSendStatistics", "eventSource": "ses.amazonaws.com", "eventTime": "2015-02-02T21:34:51Z", "eventType": "AwsApiCall", "eventVersion": "1.02", "recipientAccountId": "111122223333", "requestID": "51644c64-ab23-11e4-9106-5b36376f9d12", "requestParameters": null, "responseElements": null, "sourceIPAddress": "192.0.2.0", "userAgent": "aws-sdk-java/unknown-version", "userIdentity": { "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "accountId": "111122223333", "arn": "arn:aws:iam::111122223333:root", "principalId": "111122223333", "type": "Root" } }, { "awsRegion": "us-west-2", "eventID": "6eb8178e-69c3-4a93-8af0-2a5a0f5f209e", "eventName": "ListIdentities", "eventSource": "ses.amazonaws.com", "eventTime": "2015-02-04T01:03:27Z", "eventType": "AwsApiCall", "eventVersion": "1.02", "recipientAccountId": "111122223333", "requestID": "a0a4de7a-ac09-11e4-8ff5-a56a3119e253", "requestParameters": { "identityType": "Domain", "maxItems": 10 }, "responseElements": null, "sourceIPAddress": "192.0.2.0", "userAgent": "aws-sdk-java/unknown-version", "userIdentity": { "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "accountId": "111122223333", "arn": "arn:aws:iam::111122223333:root", "principalId": "111122223333", "type": "Root" } }, { "awsRegion": "us-west-2", "eventID": "a18a9745-d06a-43e9-aad0-8eee4de50f48", "eventName": "ListVerifiedEmailAddresses", "eventSource": "ses.amazonaws.com", "eventTime": "2015-02-02T21:34:51Z", "eventType": "AwsApiCall", "eventVersion": "1.02",

388


"recipientAccountId": "111122223333", "requestID": "51ad8a66-ab23-11e4-9106-5b36376f9d12", "requestParameters": null, "responseElements": null, "sourceIPAddress": "192.0.2.0", "userAgent": "aws-sdk-java/unknown-version", "userIdentity": { "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "accountId": "111122223333", "arn": "arn:aws:iam::111122223333:root", "principalId": "111122223333", "type": "Root" } }, { "awsRegion": "us-west-2", "eventID": "da975f45-e68b-4499-8e3f-31a89140e0c9", "eventName": "SetIdentityDkimEnabled", "eventSource": "ses.amazonaws.com", "eventTime": "2015-02-04T01:01:24Z", "eventType": "AwsApiCall", "eventVersion": "1.02", "recipientAccountId": "111122223333", "requestID": "5731c4ab-ac09-11e4-8ff5-a56a3119e253", "requestParameters": { "dkimEnabled": true, "identity": "example.com" }, "responseElements": null, "sourceIPAddress": "192.0.2.0", "userAgent": "aws-sdk-java/unknown-version", "userIdentity": { "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "accountId": "111122223333", "arn": "arn:aws:iam::111122223333:root", "principalId": "111122223333", "type": "Root" } }, { "awsRegion": "us-west-2", "eventID": "5d817126-dadb-436f-b480-f9843289f487", "eventName": "SetIdentityFeedbackForwardingEnabled", "eventSource": "ses.amazonaws.com", "eventTime": "2015-02-02T21:34:51Z", "eventType": "AwsApiCall", "eventVersion": "1.02", "recipientAccountId": "111122223333", "requestID": "51dd4cf8-ab23-11e4-9106-5b36376f9d12", "requestParameters": { "forwardingEnabled": true, "identity": "example.com" }, "responseElements": null, "sourceIPAddress": "192.0.2.0", "userAgent": "aws-sdk-java/unknown-version", "userIdentity": { "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "accountId": "111122223333", "arn": "arn:aws:iam::111122223333:root", "principalId": "111122223333", "type": "Root" } }, { "awsRegion": "us-west-2",

389


"eventID": "5d817126-dadb-436f-b480-f9843289f487", "eventName": "SetIdentityHeadersInNotificationsEnabled", "eventSource": "ses.amazonaws.com", "eventTime": "2015-02-02T21:34:51Z", "eventType": "AwsApiCall", "eventVersion": "1.02", "recipientAccountId": "111122223333", "requestID": "51dd4cf8-ab23-11e4-9106-5b36376f9d12", "requestParameters": { "enabled": true, "identity": "example.com", "notificationType": "Bounce" }, "responseElements": null, "sourceIPAddress": "192.0.2.0", "userAgent": "aws-sdk-java/unknown-version", "userIdentity": { "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "accountId": "111122223333", "arn": "arn:aws:iam::111122223333:root", "principalId": "111122223333", "type": "Root" } }, { "awsRegion": "us-west-2", "eventID": "1a31fd43-55ba-4ce7-b3fe-55659e8144c0", "eventName": "SetIdentityNotificationTopic", "eventSource": "ses.amazonaws.com", "eventTime": "2015-02-04T00:59:21Z", "eventType": "AwsApiCall", "eventVersion": "1.02", "recipientAccountId": "111122223333", "requestID": "0d553aac-ac09-11e4-8ff5-a56a3119e253", "requestParameters": { "identity": "example.com", "notificationType": "Bounce", "snsTopic": "arn:aws:sns:us-west-2:123456789100:MyTopic" }, "responseElements": null, "sourceIPAddress": "192.0.2.0", "userAgent": "aws-sdk-java/unknown-version", "userIdentity": { "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "accountId": "111122223333", "arn": "arn:aws:iam::111122223333:root", "principalId": "111122223333", "type": "Root" } }, { "awsRegion": "us-west-2", "eventID": "aec73edb-6dac-4503-81bb-cca1102f959e", "eventName": "VerifyDomainDkim", "eventSource": "ses.amazonaws.com", "eventTime": "2015-02-02T21:34:52Z", "eventType": "AwsApiCall", "eventVersion": "1.02", "recipientAccountId": "111122223333", "requestID": "52215ada-ab23-11e4-9106-5b36376f9d12", "requestParameters": { "domain": "example.com" }, "responseElements": { "dkimTokens": [ "3r2ultrqtelopya3v2apjulcvz7z5n5o",

390


"yexya47xmy5f3j3e7vgm6pcrcmayu6nu", "wtlduqduorhmb2vdt2m53yqlcj2m6tpw" ] }, "sourceIPAddress": "192.0.2.0", "userAgent": "aws-sdk-java/unknown-version", "userIdentity": { "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "accountId": "111122223333", "arn": "arn:aws:iam::111122223333:root", "principalId": "111122223333", "type": "Root" } }, { "awsRegion": "us-west-2", "eventID": "33b3e2eb-7ba3-460b-a127-a5f4cedb4469", "eventName": "VerifyDomainIdentity", "eventSource": "ses.amazonaws.com", "eventTime": "2015-02-04T00:59:21Z", "eventType": "AwsApiCall", "eventVersion": "1.02", "recipientAccountId": "111122223333", "requestID": "0d9c2ebe-ac09-11e4-8ff5-a56a3119e253", "requestParameters": { "disableEmailNotifications": false, "domain": "example.com" }, "responseElements": { "verificationToken": "pmBGN/7MjnfhTKUZ06Enqq1PeGUaOkw8lGhcfwefcHU=" }, "sourceIPAddress": "192.0.2.0", "userAgent": "aws-sdk-java/unknown-version", "userIdentity": { "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "accountId": "111122223333", "arn": "arn:aws:iam::111122223333:root", "principalId": "111122223333", "type": "Root" } }, { "awsRegion": "us-west-2", "eventID": "eb2e1616-2b7b-4cd2-b6dc-29f83fc1789f", "eventName": "VerifyEmailAddress", "eventSource": "ses.amazonaws.com", "eventTime": "2015-02-02T21:34:53Z", "eventType": "AwsApiCall", "eventVersion": "1.02", "recipientAccountId": "111122223333", "requestID": "5265ddec-ab23-11e4-9106-5b36376f9d12", "requestParameters": { "emailAddress": "[email protected]" }, "responseElements": null, "sourceIPAddress": "192.0.2.0", "userAgent": "aws-sdk-java/unknown-version", "userIdentity": { "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "accountId": "111122223333", "arn": "arn:aws:iam::111122223333:root", "principalId": "111122223333", "type": "Root" } }, {

391


"awsRegion": "us-west-2", "eventID": "5613b0ff-d6c6-4526-9b53-a603a9231725", "eventName": "VerifyEmailIdentity", "eventSource": "ses.amazonaws.com", "eventTime": "2015-02-04T01:05:33Z", "eventType": "AwsApiCall", "eventVersion": "1.02", "recipientAccountId": "111122223333", "requestID": "eb2ff803-ac09-11e4-8ff5-a56a3119e253", "requestParameters": { "emailAddress": "[email protected]" }, "responseElements": null, "sourceIPAddress": "192.0.2.0", "userAgent": "aws-sdk-java/unknown-version", "userIdentity": { "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "accountId": "111122223333", "arn": "arn:aws:iam::111122223333:root", "principalId": "111122223333", "type": "Root" } } ]}

392


Uso de credenciales con AmazonSES

Para interactuar con Amazon Simple Email Service (Amazon SES), usa credenciales de seguridad paraverificar quién es usted y si tiene permiso para interactuar con Amazon SES. Existen distintos tipos decredenciales y las credenciales que utilice dependerán de lo que desea hacer. Por ejemplo, utilice clavesde acceso de AWS al enviar un correo electrónico mediante el API de Amazon SES y las credenciales deSMTP cuando envíe un correo electrónico utilizando la interfaz SMTP de Amazon SES.

La siguiente tabla muestra los tipos de credenciales que podría utilizar con Amazon SES, en función de loque está haciendo.

Si desea acceder a... Utilice estascredenciales

De qué constan lascredenciales

Cómo obtener las credenciales

API de Amazon SES

(Podría accederal API de AmazonSES directa oindirectamentea través de unSDK de AWS, laAWS CommandLine Interface, o laHerramientas deAWS para WindowsPowerShell).

Claves de acceso deAWS

ID de clave deacceso y clave deacceso secreta

Consulte Access Keys en el AWSGeneral Reference.

Note

En el caso de lasprácticas recomendadasde seguridad, utilicelas claves de accesode usuario de AWSIdentity and AccessManagement (IAM) enlugar de las claves deacceso de la cuenta deAWS. Las credencialesde su cuenta de AWSle conceden accesocompleto a todos losrecursos de AWS,por lo que deberíaalmacenarlos enun lugar seguro y,en su lugar, utilizarlas credenciales deusuario IAM parainteracción diaria conAWS. Para obtenermás información,consulte Root AccountCredentials vs. IAMUser Credentialsen el AWS GeneralReference.

Interfaz de SMTP deAmazon SES

Credenciales deSMTP

Nombre de usuario ycontraseña

Consulte Obtener suscredenciales de SMTP deAmazon SES (p. 75).

393

https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#access-keys-and-secret-access-keys

https://docs.aws.amazon.com/general/latest/gr/root-vs-iam.html







Note

Aunque las credencialesde SMTP de AmazonSES son diferentes delas claves de accesode AWS y las claves deacceso de usuario deIAM, las credencialesde SMTP de AmazonSES son un en realidadun tipo de credencialesde IAM. Un usuariode IAM puede crearcredenciales de SMTPde Amazon SES, pero elpropietario de la cuentaraíz debe garantizar quela política de usuario deIAM les otorga permisopara acceder a lassiguientes acciones deIAM: "iam:ListUsers","iam:CreateUser","iam:CreateAccessKey"e "iam:PutUserPolicy".

394





Consola de AmazonSES

Nombre de usuario ycontraseña de IAM

O BIEN

Dirección de correoelectrónico ycontraseña

Nombre de usuario ycontraseña de IAM

O BIEN

Dirección de correoelectrónico ycontraseña

Consulte IAM User Name andPassword y Email Address andPassword en AWS GeneralReference.

Note

Como prácticarecomendada deseguridad, utilice unnombre de usuariode IAM en lugar deuna dirección decorreo electrónicoy contraseña. Lacombinación dedirección de correoelectrónico y contraseñason para su cuenta deAWS, por lo que ha dealmacenarlos en unlugar seguro en lugarde utilizarlos para lainteracción diaria conAWS. Para obtenermás información,consulte Root AccountCredentials vs. IAMUser Credentialsen el AWS GeneralReference.

Para obtener más información acerca de los diferentes tipos de credenciales de seguridad de AWS(excepto las credenciales de SMTP, que se utilizan solo para Amazon SES), consulte AWS SecurityCredentials en el AWS General Reference.

395

https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#iam-user-name-and-password

https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#iam-user-name-and-password

https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#email-and-password-for-your-AWS-account

https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#email-and-password-for-your-AWS-account






Amazon Simple Email Service Developer GuideAPI de consulta

Con la API de Amazon SESPuede acceder al API de Amazon SES utilizando un SDK de AWS, que envuelve la funcionalidad de bajonivel del API de Amazon SES con tipos de datos de nivel superior y llamadas a funciones que se encargande los detalles. También puede realizar solicitudes sin procesar al API de consulta de Amazon SES através de HTTPS. Para obtener información general sobre el API de consulta, consulte API de consulta deAmazon SES (p. 396). Las operaciones individuales del API se describen en el Amazon Simple EmailService API Reference.

Esta sección contiene los siguientes temas:

• the section called “API de consulta” (p. 396)• the section called “Códigos de error del API” (p. 401)

API de consulta de Amazon SESEn esta sección se describe cómo realizar solicitudes de consulta a Amazon SES. Los distintos temas ledarán a conocer la interfaz Query de Amazon SES, los componentes de una solicitud, cómo autenticar unasolicitud y el contenido de las respuestas.

• Para obtener más información acerca de las solicitudes de consulta, consulte Solicitudes de consulta yAmazon SES (p. 396).

• Para obtener información acerca de la autenticación de solicitudes, consulte Autenticación de solicitudesy Amazon SES (p. 399).

• Para ver ejemplos de solicitudes GET y POST, consulte Ejemplos de GET y POST para AmazonSES (p. 399).

• Para obtener más información acerca de respuestas de consulta, consulte Respuestas de consulta yAmazon SES (p. 400).

Solicitudes de consulta y Amazon SESAmazon SES admite solicitudes de consulta para acciones del servicio. Las solicitudes de consulta sonsolicitudes HTTPS sencillas que utilizan el método GET o POST. Las solicitudes de consulta debencontener un parámetro Action que indique la acción que se va a realizar.

Important

Por motivos de seguridad, Amazon SES no es compatible con las solicitudes de HTTP. Debeutilizar HTTPS en su lugar.

Estructura de una solicitud GETEsta guía presenta solicitudes GET de Amazon SES como direcciones URL. Cada URL consta de loselementos siguientes:

• Punto de enlace: el recurso en el que actúa la solicitud. Para obtener una lista de puntos de enlace deAmazon SES, consulte Regiones y Amazon SES (p. 439).

• Acción: la acción que desea realizar en el punto de enlace; por ejemplo, enviar un mensaje.• Parámetros: los parámetros de la solicitud.

A continuación se muestra un ejemplo de solicitud GET para enviar un mensaje con el punto de enlace deAmazon SES en la región EE.UU. Oeste (Oregón).

396




Amazon Simple Email Service Developer GuideSolicitudes de consulta

https://email.us-west-2.amazonaws.com?Action=SendEmail&Source=user%40example.com&Destination.ToAddresses.member.1=allan%40example.com&Message.Subject.Data=This%20is%20the%20subject%20line.&Message.Body.Text.Data=Hello.%20I%20hope%20you%20are%20having%20a%20good%20day.

Important

Como las solicitudes GET son direcciones URL, debe codificar en la URL los valores de losparámetros. Por ejemplo, en la solicitud de ejemplo anterior, el valor del parámetro Source es enrealidad [email protected]. Sin embargo, en las URL no se permite el carácter "@", por lo quecada "@" se codifica en la URL como "%40".

Para que los ejemplos GET sean más fáciles de leer, esta guía los presenta en el siguiente formatoanalizado.

https://email.us-west-2.amazonaws.com?Action=SendEmail&Source=user%40example.com&Destination.ToAddresses.member.1=allan%40example.com&Message.Subject.Data=This%20is%20the%20subject%20line.&Message.Body.Text.Data=Hello.%20I%20hope%20you%20are%20having%20a%20good%20day.

La primera línea representa el punto de enlace de la solicitud. Después del punto de enlace hay un signode interrogación (?) que separa el punto de enlace de los parámetros. Cada parámetro está separado delsiguiente por un signo ampersand (&).

El parámetro Action indica la acción que se va a llevar a cabo. Para obtener una lista completa de lasacciones y los parámetros que se utilizan con cada acción, consulte la Amazon Simple Email Service APIReference.

Algunas operaciones toman listas de parámetros. Por ejemplo, cuando se envía un correo electrónicoa varios destinatarios, puede proporcionar una lista de direcciones de correo electrónico. Especifiqueeste tipo de lista con la notación param.n, donde los valores de n son enteros a partir de 1. Por ejemplo,especificaría la primera dirección "To:" usando Destination.ToAddresses.1, la segunda conDestination.ToAddresses.2, etc.

En Amazon SES, los espacios no están permitidos en ninguno de los valores de parámetros. En esta guía,cualquier ejemplo de valor de parámetro de solicitud de consulta que incluya espacios se muestra en unade las dos diferentes formas:

• Codificado en URL (como %20).• Representado por un signo más ("+"). Dentro de una solicitud de consulta, un signo está reservado como

la notación abreviada para un espacio. (Si desea incluir un signo más literal, sin interpretar en algúnparámetro, debe codificar la URL como %2B).

Note

Cada solicitud deberá ir acompañada de un encabezado HTTP X-Amzn-Authorization. Paraobtener más información, consulte Autenticación de solicitudes y Amazon SES (p. 399).

Estructura de una solicitud POSTAmazon SES también acepta solicitudes POST. Con una solicitud POST, los parámetros de consultase envían como un formulario en el cuerpo de la solicitud HTTP tal y como se describe en el siguienteprocedimiento.

397



Amazon Simple Email Service Developer GuideSolicitudes de consulta

Para crear una solicitud POST

1. Reúna los nombres y los valores de los parámetros de consulta en un formulario.

Ponga los parámetros y los valores juntos como haría para una solicitud GET (con un signoampersand para separar cada nombre-valor). El siguiente ejemplo muestra una solicitud SendEmailcon los saltos de línea que utilizamos en esta guía para facilitar la lectura de la información.

Action=SendEmail&[email protected]&[email protected]&Message.Subject.Data=This is the subject line.&Message.Body.Text.Data=Hello. I hope you are having a good day.

2. Codifique el formulario con URL de acuerdo con la sección de envío de formulario de la especificaciónHTML.

Para obtener más información, consulte http://www.w3.org/MarkUp/html-spec/html-spec_toc.html#SEC8.2.1.

Action=SendEmail&Source=user%40example.com&Destination.ToAddresses.member.1=allan%40example.com&Message.Subject.Data=This%20is%20the%20subject%20line.&Message.Body.Text.Data=Hello.%20I%20hope%20you%20are%20having%20a%20good%20day.

3. Proporcione el formulario resultante como el cuerpo de la solicitud POST.4. Incluya los siguientes encabezados HTTP en la solicitud:

• Content-Type, con el valor definido en application/x-www-form-urlencoded• Content-Length

• Date

• X-Amzn-Authorization (Para obtener más información, consulte Autenticación de solicitudes yAmazon SES (p. 399).)

5. Envíe la solicitud completada.

POST / HTTP/1.1Date: Thu, 26 May 2011 06:49:50 GMTHost: email.us-west-2.amazonaws.comContent-Type: application/x-www-form-urlencodedX-Amzn-Authorization: AWS3 AWSAccessKeyId=AKIAIOSFODNN7EXAMPLE,Signature=lBP67vCvGlDMBQ=dofZxg8E8SUEXAMPLE,Algorithm=HmacSHA256,SignedHeaders=Date;HostContent-Length: 230

Action=SendEmail&Source=user%40example.com&Destination.ToAddresses.member.1=allan%40example.com&Message.Subject.Data=This%20is%20the%20subject%20line.&Message.Body.Text.Data=Hello.%20I%20hope%20you%20are%20having%20a%20good%20day.

El encabezado X-Amzn-Authorization que proporcione es el mismo encabezado que proporcionaría sienviara una solicitud GET.

398

http://www.w3.org/MarkUp/html-spec/html-spec_toc.html#SEC8.2.1

http://www.w3.org/MarkUp/html-spec/html-spec_toc.html#SEC8.2.1

Amazon Simple Email Service Developer GuideAutenticación de solicitudes

Note

Normalmente, el cliente HTTP añade otros elementos a la solicitud HTTP tal como requierela versión de HTTP que el cliente utiliza. En los ejemplos de esta guía no se incluyen esoselementos adicionales.

Autenticación de solicitudes y Amazon SESCuando realice una solicitud al API de Amazon SES, debe justificar ser realmente el titular de la cuentapara que Amazon SES puede verificar su identidad y si está registrado para utilizar los servicios ofrecidospor AWS. Si no se supera alguna de las pruebas, Amazon SES devuelve un error y no procesa la solicitud.

Amazon SES admite Signature versión 3 y versión 4. Se prefiere la versión 4. Para obtener másinformación cómo el uso de Signature versión 4, consulte Signature Version 4 Signing Process en la AWSGeneral Reference.

Ejemplos de GET y POST para Amazon SESA continuación, se muestran ejemplos de solicitudes GET y POST, utilizando el API de consulta.

Solicitud GET de ejemploA continuación, se muestra un ejemplo del aspecto que podría tener una solicitud GET, incluida la firmacalculada. Observe que todos los parámetros se han codificado en URL.

https://email.us-west-2.amazonaws.com/?Action=SendEmail&Source=user%40example.com&Destination.ToAddresses.member.1=allan%40example.com&Message.Subject.Data=This%20is%20the%20subject%20line.&Message.Body.Text.Data=Hello.%20I%20hope%20you%20are%20having%20a%20good%20day.&AWSAccessKeyId=AKIAIOSFODNN7EXAMPLE&Signature=RhU864jFu893mg7g9N9j9nr6h7EXAMPLE&Algorithm=HMACSHA256

Solicitud POST de ejemploA continuación, se muestra un ejemplo del aspecto que podría tener una solicitud POST, antes de calcularla firma. Observe que todos los parámetros se han codificado en URL.

POST / HTTP/1.1Host: email.us-west-2.amazonaws.comContent-Type: application/x-www-form-urlencodedDate: Tue, 25 May 2010 21:20:27 +0000Content-Length: 174

Action=SendRawEmail&Destinations.member.1=allan%40example.com&RawMessage.Data=RnJvbTp1c2VyQGV4YW1wbGUuY29tDQpTdWJqZWN0OiBUZXN0DQoNCk1lc3 ...

El valor de RawMessage.Data es una representación cifrada en base64 del texto siguiente.

From:[email protected]: Test

Message sent using SendRawEmail.

399

https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html

Amazon Simple Email Service Developer GuideRespuestas de consulta

A continuación se presenta la solicitud POST completa para SendRawEmail, con el encabezado X-Amzn-Authorization. Ninguno de los encabezados debe estar codificado en URL.

POST / HTTP/1.1Host: email.us-west-2.amazonaws.comContent-Type: application/x-www-form-urlencodedDate: Tue, 25 May 2010 21:20:27 +0000Content-Length: 174X-Amzn-Authorization: AWS3-HTTPS AWSAccessKeyId=AKIAIOSFODNN7EXAMPLE,Algorithm=HMACSHA256,Signature=lBP67vCvGl ...

Action=SendRawEmail&Destinations.member.1=allan%40example.com&RawMessage.Data=RnJvbTp1c2VyQGV4YW1wbGUuY29tDQpTdWJqZWN0OiBUZXN0DQoNCk1lc3 ...

Respuestas de consulta y Amazon SESComo respuesta a una solicitud de consulta, Amazon SES devuelve una estructura de datos XML quecontiene los resultados de la solicitud.

Cada respuesta de Amazon SES incluye un ID de solicitud en un elemento RequestId. El valor es unacadena única que asigna AWS. Si alguna vez tiene problemas con una determinada solicitud, AWS lesolicitará el ID de solicitud para ayudar a solucionar el problema.

Las respuestas de Amazon SES correctas también incluyen uno o más identificadores de mensaje. Puedeimagina un ID de mensaje como un recibo de mensaje de correo electrónico que envía Amazon SES. Si unmensaje se rechaza o se rebota, el ID de mensaje aparecerá en las notificaciones de reclamación o reboteque reciba; a continuación puede utilizar el ID de mensaje para identificar cualquier mensaje de correoelectrónico problemático que haya enviado y tomar las medidas correctivas.

Estructura de una respuesta correctaSi la solicitud se ha realizado correctamente, el elemento de respuesta principal tiene el mismo nombreque la acción, pero se le añade "Response". Por ejemplo, SendEmailResponse es el elemento derespuesta que se devuelve para una solicitud SendEmail que se ha realizado correctamente. Esteelemento contiene los siguientes elementos secundarios:

• ResponseMetadata, que contiene el elemento secundario RequestId.• Un elemento opcional que contiene resultados específicos de la acción. Por ejemplo, el elementoSendEmailResponse incluye un elemento denominado SendEmailResult.

El esquema XML describe el mensaje de respuesta XML para cada acción de Amazon SES.

A continuación se muestra un ejemplo de una respuesta correcta.

<SendEmailResponse xmlns="https://email.amazonaws.com/doc/2010-03-31/"> <SendEmailResult> <MessageId>000001271b15238a-fd3ae762-2563-11df-8cd4-6d4e828a9ae8-000000</MessageId> </SendEmailResult> <ResponseMetadata> <RequestId>fd3ae762-2563-11df-8cd4-6d4e828a9ae8</RequestId> </ResponseMetadata></SendEmailResponse>

400

Amazon Simple Email Service Developer GuideCódigos de error del API

Estructura de una respuesta de errorSi una solicitud no se realiza correctamente, el elemento de respuesta principal se denominaErrorResponse con independencia de la acción a la que se llamó. Este elemento contiene un elementoError y un elemento RequestId. Cada Error incluye lo siguiente:

• Un elemento Type que identifica si el error correspondía al receptor o al remitente• Un elemento Code que identifica el tipo de error que se produjo• Un elemento Message que describe la condición de error en un formato fácil de leer• Un elemento Detail que podría aportar detalles adicionales sobre el error o estar vacío

A continuación se muestra un ejemplo de una respuesta de error.

<ErrorResponse> <Error> <Type> Sender </Type> <Code> ValidationError </Code> <Message> Value null at 'message.subject' failed to satisfy constraint: Member must not be null </Message> </Error> <RequestId> 42d59b56-7407-4c4a-be0f-4c88daeea257 </RequestId></ErrorResponse>

Códigos de error del API devueltos por AmazonSES.

Este tema contiene una lista de códigos de error devueltos por el API de consulta de Amazon SES(HTTPS). Para obtener más información sobre el API de Amazon SES, consulte el Amazon Simple EmailService API Reference.

Debe volver a intentar las solicitudes HTTPS que reciban errores 5xx. En este caso, para reducir laprobabilidad de generar duplicados, le recomendamos que aplique un método de reintento exponencialcon espera progresivamente más largas (5, 10 y 30 segundos) entre tiempos de espera consecutivos. Si latercera llamada de reintentos no se realiza correctamente, realice otro conjunto de reintentos transcurridos20 minutos. Para ver un ejemplo de implementación que utilice una política de reintentos exponencial conAmazon SES, consulte How to handle a "Throttling - Maximum sending rate exceeded" error en el blog deAmazon SES.

Note

Los SDK de AWS implementan la lógica de reintentos automáticamente.

Los errores de cliente (4xx) indican que es preciso revisar la solicitud para corregir el problema antes dereintentarla. Por ejemplo, si sus credenciales de autenticación de AWS no son válidos, debe actualizarsu configuración para utilizar las credenciales adecuadas antes de volver a intentar enviar el correoelectrónico.

401




https://docs.aws.amazon.com/general/latest/gr/api-retries.html


Error Descripción Código de estadoHTTPS

Acciones que devuelveeste código

ConfigurationSetDoesNotExistEl conjunto deconfiguraciónespecificado noexiste. Un conjunto deconfiguración es unparámetro opcional queutiliza para publicareventos de envío decorreo electrónico.Para obtener másinformación, consulteUso del monitoreoutilizando la publicaciónde eventos de AmazonSES (p. 259).

400 SendEmail,SendRawEmail

IncompleteSignature The request signaturedoes not conform toAWS standards.

400 Todos

InternalFailure El procesamiento dela solicitud ha devueltoun error debido a unerror o una excepcióndesconocidos.

500 Todos

InvalidAction La acción u operaciónsolicitada no es válida.Compruebe que laacción se ha escritocorrectamente.

400 Todos

InvalidClientTokenId El certificado X.509 o elID de clave de accesode AWS proporcionadono existen en nuestrosregistros.

403 Todos

InvalidParameterCombinationLos parámetros queno deben utilizarseconjuntamente seutilizan de formaconjunta.

400 Todos

InvalidParameterValue Se ha proporcionadoun valor no válido ofuera de rango para elparámetro de entrada.

400 Todos

InvalidQueryParameter La cadena de consultade AWS está malformada, no cumple losestándares de AWS.

400 Todos

402




MailFromDomainNotVerifiedEl mensaje no se hapodido enviar porqueAmazon SES no hapodido leer el registroMX necesario parautilizar el dominio MAILFROM especificado.


MalformedQueryString La cadena de consultacontiene un error desintaxis.

404 Todos

MessageRejected Indica que la acción hafallado y el mensaje nose ha podido enviar.Compruebe la pilade errores para veruna descripción de loque ha provocado elerror. Para obtener másinformación acercade los problemas quepueden provocar esteerror, consulte Erroresde envío de correoelectrónico de AmazonSES (p. 456).


MissingAction Falta un parámetroobligatorio o una acciónen la solicitud.

400 Todos

MissingAuthenticationTokenLa solicitud debecontener un certificadoX.509 o un ID de clavede acceso de AWSválido (registrado).

403 Todos

MissingParameter No se ha facilitado unparámetro necesariopara la acciónespecificada.

400 Todos

OptInRequired El ID de clave deacceso de AWSnecesita una suscripciónal servicio.

403 Todos

403




RequestExpired La solicitud llegó alservicio más de 15minutos después de lamarca de fecha en lasolicitud o más de 15minutos después de lafecha de vencimientode la solicitud (porejemplo, para las URLprefirmadas) o la marcade fecha de la solicitudcorresponde a una horafutura en más de 15minutos.

400 Todos

ServiceUnavailable La solicitud nose ha ejecutadocorrectamente debidoa un error temporal delservidor.

503 Todos

Limitación controlada La solicitud se denegódebido a una limitacióncontrolada.

400 Todos

404

Amazon Simple Email Service Developer GuideEnvío de correo electrónico mediante los SDK de AWS

Ejemplos de código de Amazon SESEsta sección contiene ejemplos de código que le ayudarán a empezar con Amazon SES para enviar correoelectrónico y administrar su cuenta de Amazon SES. Hay ejemplos de código disponibles en los siguienteslenguajes: C#, Go, Java, PHP, Python y Ruby.

Elija uno de los siguientes enlaces para ver ejemplos de código para dicha tarea:• Envío de correo electrónico mediante los SDK de AWS (p. 405)• Envío de correo electrónico utilizando la interfaz de SMTP de Amazon SES (p. 416)• Envío de correo electrónico sin procesar mediante los SDK de AWS (p. 427)• Verificación de varias direcciones de correo electrónico (p. 435)• Generación de credenciales de SMTP a partir de credenciales de IAM existentes (p. 436)

Envío de correo electrónico mediante los SDK deAWS

Los SDK de AWS contienen métodos integrados para interactuar con Amazon SES y otros servicios deAWS diversos. Si pretende utilizar Amazon SES junto con otros servicios de AWS, le recomendamos queutilice un SDK. Para obtener más información acerca de los SDK de AWS, consulte Herramientas paraAmazon Web Services

En esta sección, encontrará ejemplos de código en varios lenguajes de programación que demuestran elproceso de envío de correo electrónico a través de Amazon SES utilizando los SDK de AWS.

C#

El siguiente ejemplo de código es una solución completa para el envío de correo electrónico a travésde Amazon SES utilizando el AWS SDK para .NET. Este código ejemplo supone que ha instaladoel AWS SDK para .NET y que ha creado un archivo de credenciales compartidas. Para obtener másinformación acerca de cómo crear un archivo de credenciales compartidas, consulte Crear un archivode credenciales compartidas (p. 31).

Important

Utilice un archivo de credenciales compartido para pasar su ID de clave de acceso y clave deacceso secreta de AWS. Como alternativa al uso de un archivo de credenciales compartido,puede especificar su ID de clave de acceso y clave de acceso secreta de AWS en SDK Store.Para obtener más información, consulte Configuración de las credenciales de AWS en laAWS SDK para .NET Developer Guide. Este ejemplo no funciona a menos que especifiquelas credenciales mediante uno de estos métodos.

using Amazon;using System;using System.Collections.Generic;using Amazon.SimpleEmail;using Amazon.SimpleEmail.Model;

namespace AmazonSESSample { class Program { // Replace [email protected] with your "From" address. // This address must be verified with Amazon SES. static readonly string senderAddress = "[email protected]";

405

https://docs.microsoft.com/en-us/dotnet/csharp/csharp

https://golang.org/

https://docs.oracle.com/javase/8/

http://php.net/

https://www.python.org/

https://www.ruby-lang.org/

https://aws.amazon.com/tools/?nc1=h_ls#sdk


https://aws.amazon.com/sdk-for-net/

https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/net-dg-config-creds.html


// Replace [email protected] with a "To" address. If your account // is still in the sandbox, this address must be verified. static readonly string receiverAddress = "[email protected]";

// The configuration set to use for this email. If you do not want to use a // configuration set, comment out the following property and the // ConfigurationSetName = configSet argument below. static readonly string configSet = "ConfigSet";

// The subject line for the email. static readonly string subject = "Amazon SES test (AWS SDK for .NET)";

// The email body for recipients with non-HTML email clients. static readonly string textBody = "Amazon SES Test (.NET)\r\n" + "This email was sent through Amazon SES " + "using the AWS SDK for .NET."; // The HTML body of the email. static readonly string htmlBody = @"<html><head></head><body> <h1>Amazon SES Test (AWS SDK for .NET)</h1> <p>This email was sent with <a href='https://aws.amazon.com/ses/'>Amazon SES</a> using the <a href='https://aws.amazon.com/sdk-for-net/'> AWS SDK for .NET</a>.</p></body></html>";

static void Main(string[] args) { // Replace USWest2 with the AWS Region you're using for Amazon SES. // Acceptable values are EUWest1, USEast1, and USWest2. using (var client = new AmazonSimpleEmailServiceClient(RegionEndpoint.USWest2)) { var sendRequest = new SendEmailRequest { Source = senderAddress, Destination = new Destination { ToAddresses = new List<string> { receiverAddress } }, Message = new Message { Subject = new Content(subject), Body = new Body { Html = new Content { Charset = "UTF-8", Data = htmlBody }, Text = new Content { Charset = "UTF-8", Data = textBody } } }, // If you are not using a configuration set, comment // or remove the following line ConfigurationSetName = configSet };

406


try { Console.WriteLine("Sending email using Amazon SES..."); var response = client.SendEmail(sendRequest); Console.WriteLine("The email was sent successfully."); } catch (Exception ex) { Console.WriteLine("The email was not sent."); Console.WriteLine("Error message: " + ex.Message);

} }

Console.Write("Press any key to continue..."); Console.ReadKey(); } }}

Go

El siguiente ejemplo de código es una solución completa para el envío de correo electrónico através de Amazon SES utilizando el AWS SDK for Go. En este ejemplo de código se supone que hainstalado el AWS SDK for Go y que ha creado un archivo de credenciales compartidas. Para obtenermás información acerca de cómo crear un archivo de credenciales compartidas, consulte Crear unarchivo de credenciales compartidas (p. 31).

Important

Utilice un archivo de credenciales compartido para pasar su ID de clave de acceso y clave deacceso secreta de AWS. Como alternativa al uso de un archivo de credenciales compartido,puede especificar su ID de clave de acceso y clave de acceso secreta de AWS mediante laconfiguración de variables de entorno (AWS_ACCESS_KEY_ID y AWS_SECRET_ACCESS_KEY,respectivamente). Este ejemplo no funciona a menos que especifique las credencialesmediante uno de estos métodos.

package main

import ( "fmt" //go get -u github.com/aws/aws-sdk-go "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/ses" "github.com/aws/aws-sdk-go/aws/awserr")

const ( // Replace [email protected] with your "From" address. // This address must be verified with Amazon SES. Sender = "[email protected]" // Replace [email protected] with a "To" address. If your account // is still in the sandbox, this address must be verified. Recipient = "[email protected]"

// Specify a configuration set. If you do not want to use a configuration // set, comment out the following constant and the // ConfigurationSetName: aws.String(ConfigurationSet) argument below ConfigurationSet = "ConfigSet" // Replace us-west-2 with the AWS Region you're using for Amazon SES.

407

https://aws.amazon.com/sdk-for-go/


AwsRegion = "us-west-2" // The subject line for the email. Subject = "Amazon SES Test (AWS SDK for Go)" // The HTML body for the email. HtmlBody = "<h1>Amazon SES Test Email (AWS SDK for Go)</h1><p>This email was sent with " + "<a href='https://aws.amazon.com/ses/'>Amazon SES</a> using the " + "<a href='https://aws.amazon.com/sdk-for-go/'>AWS SDK for Go</a>.</p>" //The email body for recipients with non-HTML email clients. TextBody = "This email was sent with Amazon SES using the AWS SDK for Go." // The character encoding for the email. CharSet = "UTF-8")

func main() { // Create a new session and specify an AWS Region. sess, err := session.NewSession(&aws.Config{ Region:aws.String(AwsRegion)}, ) // Create an SES client in the session. svc := ses.New(sess) // Assemble the email. input := &ses.SendEmailInput{ Destination: &ses.Destination{ CcAddresses: []*string{ }, ToAddresses: []*string{ aws.String(Recipient), }, }, Message: &ses.Message{ Body: &ses.Body{ Html: &ses.Content{ Charset: aws.String(CharSet), Data: aws.String(HtmlBody), }, Text: &ses.Content{ Charset: aws.String(CharSet), Data: aws.String(TextBody), }, }, Subject: &ses.Content{ Charset: aws.String(CharSet), Data: aws.String(Subject), }, }, Source: aws.String(Sender), // Comment or remove the following line if you are not using a configuration set ConfigurationSetName: aws.String(ConfigurationSet), }

// Attempt to send the email. result, err := svc.SendEmail(input) // Display error messages if they occur. if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() {

408


case ses.ErrCodeMessageRejected: fmt.Println(ses.ErrCodeMessageRejected, aerr.Error()) case ses.ErrCodeMailFromDomainNotVerifiedException: fmt.Println(ses.ErrCodeMailFromDomainNotVerifiedException, aerr.Error()) case ses.ErrCodeConfigurationSetDoesNotExistException: fmt.Println(ses.ErrCodeConfigurationSetDoesNotExistException, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) } return } fmt.Println("Email Sent!") fmt.Println(result)}

Java

El siguiente ejemplo de código es una solución completa para el envío de correo electrónico a travésde Amazon SES utilizando el AWS SDK for Java. En este ejemplo de código se supone que hainstalado el AWS SDK for Java y que ha creado un archivo de credenciales compartidas. Para obtenermás información acerca de cómo crear un archivo de credenciales compartidas, consulte Crear unarchivo de credenciales compartidas (p. 31).

package com.amazonaws.samples;

import java.io.IOException;

import com.amazonaws.regions.Regions;import com.amazonaws.services.simpleemail.AmazonSimpleEmailService;import com.amazonaws.services.simpleemail.AmazonSimpleEmailServiceClientBuilder;import com.amazonaws.services.simpleemail.model.Body;import com.amazonaws.services.simpleemail.model.Content;import com.amazonaws.services.simpleemail.model.Destination;import com.amazonaws.services.simpleemail.model.Message;import com.amazonaws.services.simpleemail.model.SendEmailRequest;


// Replace [email protected] with your "From" address. // This address must be verified with Amazon SES. static final String FROM = "[email protected]";

// Replace [email protected] with a "To" address. If your account // is still in the sandbox, this address must be verified. static final String TO = "[email protected]";

// The configuration set to use for this email. If you do not want to use a // configuration set, comment the following variable and the // .withConfigurationSetName(CONFIGSET); argument below. static final String CONFIGSET = "ConfigSet";

// The subject line for the email. static final String SUBJECT = "Amazon SES test (AWS SDK for Java)"; // The HTML body for the email. static final String HTMLBODY = "<h1>Amazon SES test (AWS SDK for Java)</h1>"

409



+ "<p>This email was sent with <a href='https://aws.amazon.com/ses/'>" + "Amazon SES</a> using the <a href='https://aws.amazon.com/sdk-for-java/'>" + "AWS SDK for Java</a>";

// The email body for recipients with non-HTML email clients. static final String TEXTBODY = "This email was sent through Amazon SES " + "using the AWS SDK for Java.";

public static void main(String[] args) throws IOException {

try { AmazonSimpleEmailService client = AmazonSimpleEmailServiceClientBuilder.standard() // Replace US_WEST_2 with the AWS Region you're using for // Amazon SES. .withRegion(Regions.US_WEST_2).build(); SendEmailRequest request = new SendEmailRequest() .withDestination( new Destination().withToAddresses(TO)) .withMessage(new Message() .withBody(new Body() .withHtml(new Content() .withCharset("UTF-8").withData(HTMLBODY)) .withText(new Content() .withCharset("UTF-8").withData(TEXTBODY))) .withSubject(new Content() .withCharset("UTF-8").withData(SUBJECT))) .withSource(FROM) // Comment or remove the next line if you are not using a // configuration set .withConfigurationSetName(CONFIGSET); client.sendEmail(request); System.out.println("Email sent!"); } catch (Exception ex) { System.out.println("The email was not sent. Error message: " + ex.getMessage()); } }}

JavaScript

El siguiente ejemplo de código es una solución completa para el envío de correo electrónico a travésde Amazon SES utilizando el AWS SDK for JavaScript in Node.js. En este ejemplo de código sesupone que ha instalado el SDK para JavaScript en Node.js. Asimismo, debe crear un archivo deconfiguración que contenga su ID de clave de acceso de AWS, la clave de acceso secreta y la regiónde AWS preferida. Para obtener más información sobre la creación de este archivo, consulte LoadingCredentials in Node.js from a JSON File.

Important


'use strict';


// Provide the full path to your config.json file.

410

https://aws.amazon.com/sdk-for-node-js/

https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/loading-node-credentials-json-file.html

https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/loading-node-credentials-json-file.html


aws.config.loadFromPath('./config.json');

// Replace [email protected] with your "From" address.// This address must be verified with Amazon SES.const sender = "Sender Name <[email protected]>";

// Replace [email protected] with a "To" address. If your account // is still in the sandbox, this address must be verified.const recipient = "[email protected]";

// Specify a configuration set. If you do not want to use a configuration// set, comment the following variable, and the // ConfigurationSetName : configuration_set argument below.const configuration_set = "ConfigSet";

// The subject line for the email.const subject = "Amazon SES Test (AWS SDK for JavaScript in Node.js)";

// The email body for recipients with non-HTML email clients.const body_text = "Amazon SES Test (SDK for JavaScript in Node.js)\r\n" + "This email was sent with Amazon SES using the " + "AWS SDK for JavaScript in Node.js."; // The HTML body of the email.const body_html = `<html><head></head><body> <h1>Amazon SES Test (SDK for JavaScript in Node.js)</h1> <p>This email was sent with <a href='https://aws.amazon.com/ses/'>Amazon SES</a> using the <a href='https://aws.amazon.com/sdk-for-node-js/'> AWS SDK for JavaScript in Node.js</a>.</p></body></html>`;

// The character encoding for the email.const charset = "UTF-8";


// Specify the parameters to pass to the API.var params = { Source: sender, Destination: { ToAddresses: [ recipient ], }, Message: { Subject: { Data: subject, Charset: charset }, Body: { Text: { Data: body_text, Charset: charset }, Html: { Data: body_html, Charset: charset } } }, ConfigurationSetName: configuration_set

411


};

//Try to send the email.ses.sendEmail(params, function(err, data) { // If something goes wrong, print an error message. if(err) { console.log(err.message); } else { console.log("Email sent! Message ID: ", data.MessageId); }});

PHP

El siguiente ejemplo de código es una solución completa para el envío de correo electrónico a travésde Amazon SES utilizando el AWS SDK para PHP. En este ejemplo de código se supone que hainstalado el AWS SDK para PHP y que ha creado un archivo de credenciales compartidas. Paraobtener más información acerca de cómo crear un archivo de credenciales compartidas, consulteCrear un archivo de credenciales compartidas (p. 31).

Important


<?php

// Replace path_to_sdk_inclusion with the path to the SDK as described in // https://docs.aws.amazon.com/aws-sdk-php/v3/guide/getting-started/basic-usage.htmldefine('REQUIRED_FILE','path_to_sdk_inclusion'); // Replace [email protected] with your "From" address. // This address must be verified with Amazon SES.define('SENDER', '[email protected]');

// Replace [email protected] with a "To" address. If your account // is still in the sandbox, this address must be verified.define('RECIPIENT', '[email protected]');

// Specify a configuration set. If you do not want to use a configuration// set, comment the following variable, and the // 'ConfigurationSetName' => CONFIGSET argument below.define('CONFIGSET','ConfigSet');

// Replace us-west-2 with the AWS Region you're using for Amazon SES.define('REGION','us-west-2');

define('SUBJECT','Amazon SES test (AWS SDK for PHP)');

define('HTMLBODY','<h1>AWS Amazon Simple Email Service Test Email</h1>'. '<p>This email was sent with <a href="https://aws.amazon.com/ses/">'. 'Amazon SES</a> using the <a href="https://aws.amazon.com/sdk-for-php/">'. 'AWS SDK for PHP</a>.</p>');define('TEXTBODY','This email was send with Amazon SES using the AWS SDK for PHP.');

define('CHARSET','UTF-8');


412



use Aws\Ses\SesClient;use Aws\Ses\Exception\SesException;


try { $result = $client->sendEmail([ 'Destination' => [ 'ToAddresses' => [ RECIPIENT, ], ], 'Message' => [ 'Body' => [ 'Html' => [ 'Charset' => CHARSET, 'Data' => HTMLBODY, ], 'Text' => [ 'Charset' => CHARSET, 'Data' => TEXTBODY, ], ], 'Subject' => [ 'Charset' => CHARSET, 'Data' => SUBJECT, ], ], 'Source' => SENDER, // If you are not using a configuration set, comment or delete the // following line 'ConfigurationSetName' => CONFIGSET,]); $messageId = $result->get('MessageId'); echo("Email sent! Message ID: $messageId"."\n");

} catch (SesException $error) { echo("The email was not sent. Error message: ".$error->getAwsErrorMessage()."\n");}

?>

Python

El siguiente ejemplo de código es una solución completa para el envío de correo electrónico a travésde Amazon SES utilizando el AWS SDK for Python (Boto). En este ejemplo de código se supone queha instalado el AWS SDK for Python (Boto) y que ha creado un archivo de credenciales compartidas.Para obtener más información acerca de cómo crear un archivo de credenciales compartidas, consulteCrear un archivo de credenciales compartidas (p. 31).

Important



413







# The subject line for the email.SUBJECT = "Amazon SES Test (SDK for Python)"

# The email body for recipients with non-HTML email clients.BODY_TEXT = ("Amazon SES Test (Python)\r\n" "This email was sent with Amazon SES using the " "AWS SDK for Python (Boto)." ) # The HTML body of the email.BODY_HTML = """<html><head></head><body> <h1>Amazon SES Test (SDK for Python)</h1> <p>This email was sent with <a href='https://aws.amazon.com/ses/'>Amazon SES</a> using the <a href='https://aws.amazon.com/sdk-for-python/'> AWS SDK for Python (Boto)</a>.</p></body></html> """

# The character encoding for the email.CHARSET = "UTF-8"


# Try to send the email.try: #Provide the contents of the email. response = client.send_email( Destination={ 'ToAddresses': [ RECIPIENT, ], }, Message={ 'Body': { 'Html': { 'Charset': CHARSET, 'Data': BODY_HTML, }, 'Text': { 'Charset': CHARSET, 'Data': BODY_TEXT, }, }, 'Subject': {

414


'Charset': CHARSET, 'Data': SUBJECT, }, }, Source=SENDER, # If you are not using a configuration set, comment or delete the # following line ConfigurationSetName=CONFIGURATION_SET, )# 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'])

Ruby

El siguiente ejemplo de código es una solución completa para el envío de correo electrónico a travésde Amazon SES utilizando el AWS SDK parar Ruby. En este ejemplo de código se supone que hainstalado el AWS SDK parar Ruby y que ha creado un archivo de credenciales compartidas. Paraobtener más información acerca de cómo crear un archivo de credenciales compartidas, consulteCrear un archivo de credenciales compartidas (p. 31).

Important


require 'aws-sdk'

# Replace [email protected] with your "From" address.# This address must be verified with Amazon SES.sender = "[email protected]"


# Specify a configuration set. If you do not want to use a configuration# set, comment the following variable and the # configuration_set_name: configsetname argument below. configsetname = "ConfigSet" # Replace us-west-2 with the AWS Region you're using for Amazon SES.awsregion = "us-west-2"

# The subject line for the email.subject = "Amazon SES test (AWS SDK for Ruby)"

# The HTML body of the email.htmlbody = '<h1>Amazon SES test (AWS SDK for Ruby)</h1>'\ '<p>This email was sent with <a href="https://aws.amazon.com/ses/">'\ 'Amazon SES</a> using the <a href="https://aws.amazon.com/sdk-for-ruby/">'\ 'AWS SDK for Ruby</a>.'

# The email body for recipients with non-HTML email clients. textbody = "This email was sent with Amazon SES using the AWS SDK for Ruby."

415


Amazon Simple Email Service Developer GuideEnvío de correo electrónico utilizando la interfaz de SMTP

# Specify the text encoding scheme.encoding = "UTF-8"



# Provide the contents of the email. resp = ses.send_email({ destination: { to_addresses: [ recipient, ], }, message: { body: { html: { charset: encoding, data: htmlbody, }, text: { charset: encoding, data: textbody, }, }, subject: { charset: encoding, data: subject, }, }, source: sender, # Comment or remove the following line if you are not using # a configuration set configuration_set_name: configsetname, }) puts "Email sent!"

# If something goes wrong, display an error message.rescue Aws::SES::Errors::ServiceError => error puts "Email not sent. Error message: #{error}"

end

Envío de correo electrónico utilizando la interfaz deSMTP de Amazon SES

Varios lenguajes de programación incluyen bibliotecas estándar para el envío de correos electrónicosmediante SMTP. Puede utilizar estas bibliotecas para crear aplicaciones de envío de correo electrónicoque sean ligeras y muy configurables.

En esta sección, encontrará ejemplos de código en varios lenguajes de programación que demuestran elproceso de envío de correo electrónico a través de Amazon SES utilizando la interfaz SMTP. Siempre quesea posible, estos ejemplos de código utilizan bibliotecas estándar.

C#

El siguiente ejemplo de código es una solución completa para el envío de correo electrónico a travésde la interfaz de SMTP de Amazon SES utilizando C#. Para ejecutar este ejemplo de código, debe

416


obtener las credenciales de SMTP; para obtener más información, consulte Obtener sus credencialesde SMTP de Amazon SES (p. 75).

using System;using System.Net;using System.Net.Mail;

namespace AmazonSESSample{ class Program { static void Main(string[] args) { // Replace [email protected] with your "From" address. // This address must be verified with Amazon SES. const String FROM = "[email protected]"; const String FROMNAME = "Sender Name";

// Replace [email protected] with a "To" address. If your account // is still in the sandbox, this address must be verified. const String TO = "[email protected]";

// Replace smtp_username with your Amazon SES SMTP user name. const String SMTP_USERNAME = "smtp_username";

// Replace smtp_password with your Amazon SES SMTP user name. const String SMTP_PASSWORD = "smtp_password";

// (Optional) the name of a configuration set to use for this message. // If you comment out this line, you also need to remove or comment out // the "X-SES-CONFIGURATION-SET" header below. const String CONFIGSET = "ConfigSet";

// If you're using Amazon SES in a region other than US West (Oregon), // replace email-smtp.us-west-2.amazonaws.com with the Amazon SES SMTP // endpoint in the appropriate Region. const String HOST = "email-smtp.us-west-2.amazonaws.com"; // The port you will connect to on the Amazon SES SMTP endpoint. We // are choosing port 587 because we will use STARTTLS to encrypt // the connection. const int PORT = 587;

// The subject line of the email const String SUBJECT = "Amazon SES test (SMTP interface accessed using C#)"; // The body of the email const String BODY = "<h1>Amazon SES Test</h1>" + "<p>This email was sent through the "+ "<a href='https://aws.amazon.com/ses'>Amazon SES</a> SMTP interface " + "using the .NET System.Net.Mail library.</p>";

// Create and build a new MailMessage object MailMessage message = new MailMessage(); message.IsBodyHtml = true; message.From = new MailAddress(FROM,FROMNAME); message.To.Add(new MailAddress(TO)); message.Subject = SUBJECT; message.Body = BODY; // Comment or delete the next line if you are not using a configuration set message.Headers.Add("X-SES-CONFIGURATION-SET", CONFIGSET);

// Create and configure a new SmtpClient

417


SmtpClient client = new SmtpClient(HOST, PORT); // Pass SMTP credentials client.Credentials = new NetworkCredential(SMTP_USERNAME, SMTP_PASSWORD); // Enable SSL encryption client.EnableSsl = true;

// Send the email. try { Console.WriteLine("Attempting to send email..."); client.Send(message); Console.WriteLine("Email sent!"); } catch (Exception ex) { Console.WriteLine("The email was not sent."); Console.WriteLine("Error message: " + ex.Message); }

// Wait for a key press so that you can see the console output Console.Write("Press any key to continue..."); Console.ReadKey(); } }}

Go

El siguiente ejemplo de código es una solución completa para el envío de correo electrónico a travésde la interfaz de SMTP de Amazon SES utilizando Go. Para ejecutar este ejemplo de código, debeobtener las credenciales de SMTP; para obtener más información, consulte Obtener sus credencialesde SMTP de Amazon SES (p. 75). Asimismo, debe instalar el paquete Gomail.

package main

import ( "fmt" "gopkg.in/gomail.v2" //go get gopkg.in/gomail.v2)

const ( // Replace [email protected] with your "From" address. // This address must be verified with Amazon SES. Sender = "[email protected]" SenderName = "Sender Name" // Replace [email protected] with a "To" address. If your account // is still in the sandbox, this address must be verified. Recipient = "[email protected]"

// Replace SmtpUser with your Amazon SES SMTP user name. SmtpUser = "SmtpUser" // Replace SmtpPass with your Amazon SES SMTP password. SmtpPass = "SmtpPass" // The name of the configuration set to use for this message. // If you comment out or remove this variable, you will also need to // comment out or remove the header below. ConfigSet = "ConfigSet" // If you're using Amazon SES in an AWS Region other than US West (Oregon),

418

https://github.com/go-gomail/gomail


// replace email-smtp.us-west-2.amazonaws.com with the Amazon SES SMTP // endpoint in the appropriate region. Host = "email-smtp.us-west-2.amazonaws.com" Port = 587 // The subject line for the email. Subject = "Amazon SES Test (Gomail)" // The HTML body for the email. HtmlBody = "<html><head><title>SES Sample Email</title></head><body>" + "<h1>Amazon SES Test Email (Gomail)</h1>" + "<p>This email was sent with " + "<a href='https://aws.amazon.com/ses/'>Amazon SES</a> using " + "the <a href='https://github.com/go-gomail/gomail/'>Gomail " + "package</a> for <a href='https://golang.org/'>Go</a>.</p>" + "</body></html>" //The email body for recipients with non-HTML email clients. TextBody = "This email was sent with Amazon SES using the Gomail package." // The tags to apply to this message. Separate multiple key-value pairs // with commas. // If you comment out or remove this variable, you will also need to // comment out or remove the header on line 80. Tags = "genre=test,genre2=test2" // The character encoding for the email. CharSet = "UTF-8"

)

func main() { // Create a new message. m := gomail.NewMessage() // Set the main email part to use HTML. m.SetBody("text/html", HtmlBody) // Set the alternative part to plain text. m.AddAlternative("text/plain", TextBody)

// Construct the message headers, including a Configuration Set and a Tag. m.SetHeaders(map[string][]string{ "From": {m.FormatAddress(Sender,SenderName)}, "To": {Recipient}, "Subject": {Subject}, // Comment or remove the next line if you are not using a configuration set "X-SES-CONFIGURATION-SET": {ConfigSet}, // Comment or remove the next line if you are not using custom tags "X-SES-MESSAGE-TAGS": {Tags}, }) // Send the email. d := gomail.NewPlainDialer(Host, Port, SmtpUser, SmtpPass) // Display an error message if something goes wrong; otherwise, // display a message confirming that the message was sent. if err := d.DialAndSend(m); err != nil { fmt.Println(err) } else { fmt.Println("Email sent!") }}

419


Java

El siguiente ejemplo de código es una solución completa para el envío de correo electrónico a travésde la interfaz de SMTP de Amazon SES utilizando Java. Para ejecutar este ejemplo de código, debeobtener las credenciales de SMTP; para obtener más información, consulte Obtener sus credencialesde SMTP de Amazon SES (p. 75). A su vez, también debe descargar el API JavaMail.

import java.util.Properties;

import javax.mail.Message;import javax.mail.Session;import javax.mail.Transport;import javax.mail.internet.InternetAddress;import javax.mail.internet.MimeMessage;


// Replace [email protected] with your "From" address. // This address must be verified. static final String FROM = "[email protected]"; static final String FROMNAME = "Sender Name"; // Replace [email protected] with a "To" address. If your account // is still in the sandbox, this address must be verified. static final String TO = "[email protected]"; // Replace smtp_username with your Amazon SES SMTP user name. static final String SMTP_USERNAME = "smtp_username"; // Replace smtp_password with your Amazon SES SMTP password. static final String SMTP_PASSWORD = "smtp_password"; // The name of the Configuration Set to use for this message. // If you comment out or remove this variable, you will also need to // comment out or remove the header below. static final String CONFIGSET = "ConfigSet"; // Amazon SES SMTP host name. This example uses the US West (Oregon) region. // See https://docs.aws.amazon.com/ses/latest/DeveloperGuide/regions.html#region-endpoints // for more information. static final String HOST = "email-smtp.us-west-2.amazonaws.com"; // The port you will connect to on the Amazon SES SMTP endpoint. static final int PORT = 587; static final String SUBJECT = "Amazon SES test (SMTP interface accessed using Java)"; static final String BODY = String.join( System.getProperty("line.separator"), "<h1>Amazon SES SMTP Email Test</h1>", "<p>This email was sent with Amazon SES using the ", "<a href='https://github.com/javaee/javamail'>Javamail Package</a>", " for <a href='https://www.java.com'>Java</a>." );

public static void main(String[] args) throws Exception {

// Create a Properties object to contain connection configuration information. Properties props = System.getProperties(); props.put("mail.transport.protocol", "smtp"); props.put("mail.smtp.port", PORT); props.put("mail.smtp.starttls.enable", "true"); props.put("mail.smtp.auth", "true");

420



// Create a Session object to represent a mail session with the specified properties. Session session = Session.getDefaultInstance(props);

// Create a message with the specified information. MimeMessage msg = new MimeMessage(session); msg.setFrom(new InternetAddress(FROM,FROMNAME)); msg.setRecipient(Message.RecipientType.TO, new InternetAddress(TO)); msg.setSubject(SUBJECT); msg.setContent(BODY,"text/html"); // Add a configuration set header. Comment or delete the // next line if you are not using a configuration set msg.setHeader("X-SES-CONFIGURATION-SET", CONFIGSET); // Create a transport. Transport transport = session.getTransport(); // Send the message. try { System.out.println("Sending..."); // Connect to Amazon SES using the SMTP username and password you specified above. transport.connect(HOST, SMTP_USERNAME, SMTP_PASSWORD); // Send the email. transport.sendMessage(msg, msg.getAllRecipients()); System.out.println("Email sent!"); } catch (Exception ex) { System.out.println("The email was not sent."); System.out.println("Error message: " + ex.getMessage()); } finally { // Close and terminate the connection. transport.close(); } }}

Perl

El siguiente ejemplo de código es una solución completa para el envío de correo electrónico a travésde la interfaz de SMTP de Amazon SES utilizando Perl. Para ejecutar este ejemplo de código, debeobtener las credenciales de SMTP; para obtener más información, consulte Obtener sus credencialesde SMTP de Amazon SES (p. 75). También debe instalar los módulos Email::Sender, Email::MIME yTry::Tiny de CPAN.

#!/usr/bin/perl use warnings;use strict;use Email::Sender::Simple qw(sendmail);use Email::Sender::Transport::SMTP;use Email::MIME;use Try::Tiny;

# Replace [email protected] with your "From" address. # This address must be verified.my $sender = 'Sender name <[email protected]>';

421

https://metacpan.org/pod/Email::Sender

https://metacpan.org/pod/Email::MIME

https://metacpan.org/pod/Try::Tiny

https://www.cpan.org/


# Replace [email protected] with a "To" address. If your account # is still in the sandbox, this address must be verified.my $recipient = '[email protected]';

# Replace smtp_username with your Amazon SES SMTP user name.my $smtp_username = "smtp_username";

# Replace smtp_password with your Amazon SES SMTP password.my $smtp_password = "smtp_password";

# (Optional) the name of a configuration set to use for this message.# If you comment out this line, you also need to remove or comment out# the "X-SES-CONFIGURATION-SET:" header below.my $configset = "ConfigSet";

# If you're using Amazon SES in an AWS Region other than US West (Oregon), # replace email-smtp.us-west-2.amazonaws.com with the Amazon SES SMTP # endpoint in the appropriate region.my $host = "email-smtp.us-west-2.amazonaws.com";my $port = 587;

# The subject line of the email.my $subject = "Amazon SES Test (Perl)";

# The HTML body for the email.my $htmlbody = <<'END_HTML';<html> <head></head> <body> <h1>Amazon SES SMTP Email Test</h1> <p>This email was sent with Amazon SES using the <a href='https://www.perl.org/'>Perl</a> <a href='http://search.cpan.org/~rjbs/Email-Sender-1.300031/'> Email::Sender</a> library.</p> </body></html>END_HTML

# The email body for recipients with non-HTML email clients.my $textbody = "Amazon SES Test\r\n" . "This message was sent with Amazon SES using the Perl " . "Email::Sender module.";

# Create the SMTP transport.my $transport = Email::Sender::Transport::SMTP->new( host => "$host", port => "$port", ssl => 'starttls', sasl_username => "$smtp_username", sasl_password => "$smtp_password",);

# Build a multipart MIME message with an HTML part and a text part.my $message = Email::MIME->create( attributes => { content_type => 'multipart/alternative', charset => 'UTF-8', }, header_str => [ From => "$sender", To => "$recipient", Subject => "$subject", ], parts => [ Email::MIME->create( attributes => { content_type => 'text/plain' },

422


body => "$textbody", ), Email::MIME->create( attributes => { content_type => 'text/html' }, body => "$htmlbody", ) ],);

# Add the configuration set header to the MIME message.$message->header_str_set( 'X-SES-CONFIGURATION-SET' => "$configset" );

# Try to send the email using the sendmail function from # Email::Sender::Simple.try { sendmail($message, { transport => $transport });# If something goes wrong, print an error message.} catch { die "Error sending email: $_";};

PHP

El siguiente ejemplo de código es una solución completa para el envío de correo electrónico a travésde la interfaz de SMTP de Amazon SES utilizando PHP. Para ejecutar este ejemplo de código,debe obtener las credenciales de SMTP; para obtener más información, consulte Obtener suscredenciales de SMTP de Amazon SES (p. 75). Asimismo, debe instalar el paquete PHPMailerutilizando Composer.

<?php

// Modify the path in the require statement below to refer to the // location of your Composer autoload.php file.require 'path_to_sdk_inclusion';

// Instantiate a new PHPMailer $mail = new PHPMailer;

// Tell PHPMailer to use SMTP$mail->isSMTP();

// Replace [email protected] with your "From" address. // This address must be verified with Amazon SES.$mail->setFrom('[email protected]', 'Sender Name');

// Replace [email protected] with a "To" address. If your account // is still in the sandbox, this address must be verified.// Also note that you can include several addAddress() lines to send// email to multiple recipients.$mail->addAddress('[email protected]', 'Recipient Name');

// Replace smtp_username with your Amazon SES SMTP user name.$mail->Username = 'smtp_username';

// Replace smtp_password with your Amazon SES SMTP password.$mail->Password = 'smtp_password'; // Specify a configuration set. If you do not want to use a configuration// set, comment or remove the next line.$mail->addCustomHeader('X-SES-CONFIGURATION-SET', 'ConfigSet'); // If you're using Amazon SES in a region other than US West (Oregon), // replace email-smtp.us-west-2.amazonaws.com with the Amazon SES SMTP // endpoint in the appropriate region.

423

https://packagist.org/packages/phpmailer/phpmailer

https://getcomposer.org/


$mail->Host = 'email-smtp.us-west-2.amazonaws.com';

// The subject line of the email$mail->Subject = 'Amazon SES test (SMTP interface accessed using PHP)';

// The HTML-formatted body of the email$mail->Body = '<h1>Email Test</h1> <p>This email was sent through the <a href="https://aws.amazon.com/ses">Amazon SES</a> SMTP interface using the <a href="https://github.com/PHPMailer/PHPMailer"> PHPMailer</a> class.</p>';

// Tells PHPMailer to use SMTP authentication$mail->SMTPAuth = true;

// Enable TLS encryption over port 587$mail->SMTPSecure = 'tls';$mail->Port = 587;

// Tells PHPMailer to send HTML-formatted email$mail->isHTML(true);

// The alternative email body; this is only displayed when a recipient// opens the email in a non-HTML email client. The \r\n represents a // line break.$mail->AltBody = "Email Test\r\nThis email was sent through the Amazon SES SMTP interface using the PHPMailer class.";

if(!$mail->send()) { echo "Email not sent. " , $mail->ErrorInfo , PHP_EOL;} else { echo "Email sent!" , PHP_EOL;}?>

Python

El siguiente ejemplo de código es una solución completa para el envío de correo electrónico a travésde la interfaz de SMTP de Amazon SES utilizando Python. Para ejecutar este ejemplo de código, debeobtener las credenciales de SMTP; para obtener más información, consulte Obtener sus credencialesde SMTP de Amazon SES (p. 75).

import smtplib import email.utilsfrom email.mime.multipart import MIMEMultipartfrom email.mime.text import MIMEText

# Replace [email protected] with your "From" address. # This address must be verified.SENDER = '[email protected]' SENDERNAME = 'Sender Name'

# Replace [email protected] with a "To" address. If your account # is still in the sandbox, this address must be verified.RECIPIENT = '[email protected]'

# Replace smtp_username with your Amazon SES SMTP user name.USERNAME_SMTP = "smtp_username"

# Replace smtp_password with your Amazon SES SMTP password.PASSWORD_SMTP = "smtp_password"

# (Optional) the name of a configuration set to use for this message.# If you comment out this line, you also need to remove or comment out

424


# the "X-SES-CONFIGURATION-SET:" header below.CONFIGURATION_SET = "ConfigSet"

# If you're using Amazon SES in an AWS Region other than US West (Oregon), # replace email-smtp.us-west-2.amazonaws.com with the Amazon SES SMTP # endpoint in the appropriate region.HOST = "email-smtp.us-west-2.amazonaws.com"PORT = 587

# The subject line of the email.SUBJECT = 'Amazon SES Test (Python smtplib)'

# The email body for recipients with non-HTML email clients.BODY_TEXT = ("Amazon SES Test\r\n" "This email was sent through the Amazon SES SMTP " "Interface using the Python smtplib package." )

# The HTML body of the email.BODY_HTML = """<html><head></head><body> <h1>Amazon SES SMTP Email Test</h1> <p>This email was sent with Amazon SES using the <a href='https://www.python.org/'>Python</a> <a href='https://docs.python.org/3/library/smtplib.html'> smtplib</a> library.</p></body></html> """

# Create message container - the correct MIME type is multipart/alternative.msg = MIMEMultipart('alternative')msg['Subject'] = SUBJECTmsg['From'] = email.utils.formataddr((SENDERNAME, SENDER))msg['To'] = RECIPIENT# Comment or delete the next line if you are not using a configuration setmsg.add_header('X-SES-CONFIGURATION-SET',CONFIGURATION_SET)

# Record the MIME types of both parts - text/plain and text/html.part1 = MIMEText(BODY_TEXT, 'plain')part2 = MIMEText(BODY_HTML, 'html')

# Attach parts into message container.# According to RFC 2046, the last part of a multipart message, in this case# the HTML message, is best and preferred.msg.attach(part1)msg.attach(part2)

# Try to send the message.try: server = smtplib.SMTP(HOST, PORT) server.ehlo() server.starttls() #stmplib docs recommend calling ehlo() before & after starttls() server.ehlo() server.login(USERNAME_SMTP, PASSWORD_SMTP) server.sendmail(SENDER, RECIPIENT, msg.as_string()) server.close()# Display an error message if something goes wrong.except Exception as e: print ("Error: ", e)else: print ("Email sent!")

425


Ruby

El siguiente ejemplo de código es una solución completa para el envío de correo electrónico a travésde la interfaz de SMTP de Amazon SES utilizando Ruby. Para ejecutar este ejemplo de código, debeobtener las credenciales de SMTP; para obtener más información, consulte Obtener sus credencialesde SMTP de Amazon SES (p. 75).

require 'net/smtp'

# Replace [email protected] with your "From" address.# This address must be verified with Amazon SES.sender = "[email protected]"senderName = "Sender Name"


# Replace smtp_username with your Amazon SES SMTP user name.smtp_username = "smtp_username"

# Replace smtp_password with your Amazon SES SMTP password.smtp_password = "smtp_password"

# (Optional) the name of a configuration set to use for this message.# If you comment out this line, you also need to remove or comment out# the "X-SES-CONFIGURATION-SET" header below.configSet = "ConfigSet"

# If you're using Amazon SES in an AWS Region other than US West (Oregon), # replace email-smtp.us-west-2.amazonaws.com with the Amazon SES SMTP # endpoint in the appropriate region.server = "email-smtp.us-west-2.amazonaws.com"port = 587

# The subject line of the email.subject = "Amazon SES Test (Ruby Net::SMTP library)"

# Specify the headers and body of the message as a variable.message = [ #Remove the next line if you are not using a configuration set "X-SES-CONFIGURATION-SET: #{configSet}", "Content-Type: text/html; charset=UTF-8", "Content-Transfer-Encoding: 7bit", "From: #{senderName} <#{sender}>", "To: #{recipient}", "Subject: #{subject}", "", "<h1>Amazon SES Test (Ruby Net::SMTP library)</h1>", "<p>This email was sent with \ <a href='https://aws.amazon.com/ses/'>\ Amazon SES</a> using the Ruby Net::SMTP library.</p>" ].join("\n") # Create a new SMTP object called "smtp."smtp = Net::SMTP.new(server, port)

# Tell the smtp object to connect using TLS.smtp.enable_starttls

# Open an SMTP session and log in to the server using SMTP authentication.smtp.start(server,smtp_username,smtp_password, :login)

# Try to send the message.begin

426

Amazon Simple Email Service Developer GuideEnvío de correo electrónico sin

procesar mediante los SDK de AWS

smtp.send_message(message, sender, recipient) puts "Email sent!"# Print an error message if something goes wrong.rescue => e puts eend

Envío de correo electrónico sin procesar mediantelos SDK de AWS

Los SDK de AWS contienen métodos integrados para interactuar con Amazon SES y otros servicios deAWS diversos. Si pretende utilizar Amazon SES junto con otros servicios de AWS, le recomendamos queutilice un SDK. Para obtener más información acerca de los SDK de AWS, consulte Herramientas paraAmazon Web Services

En esta sección, encontrará ejemplos de código en varios lenguajes de programación que demuestran elproceso de envío de correo electrónico sin procesar a través de Amazon SES utilizando los SDK de AWS.

Java

El siguiente ejemplo de código muestra cómo utilizar la biblioteca JavaMail y el AWS SDK for Javapara crear y enviar un correo electrónico sin procesar que contiene una parte en HTML, una parte detexto y un archivo adjunto.

En este ejemplo de código se supone que ha instalado AWS SDK for Java y que ha creado un archivode credenciales compartidas. Para obtener más información acerca de cómo crear un archivo decredenciales compartidas, consulte Crear un archivo de credenciales compartidas (p. 31).

Important


import java.io.ByteArrayOutputStream;import java.io.IOException;import java.io.PrintStream;import java.nio.ByteBuffer;import java.util.Properties;

// JavaMail libraries. Download the JavaMail API from // https://javaee.github.io/javamail. After you download the jar file, // include it in the build path for your project. import javax.activation.DataHandler;import javax.activation.DataSource;import javax.activation.FileDataSource;import javax.mail.Message;import javax.mail.MessagingException;import javax.mail.Session;import javax.mail.internet.AddressException;import javax.mail.internet.InternetAddress;import javax.mail.internet.MimeBodyPart;import javax.mail.internet.MimeMessage;import javax.mail.internet.MimeMultipart;import javax.mail.internet.MimeUtility;

427



https://javaee.github.io/javamail/

https://aws.amazon.com/sdk-for-java



// AWS SDK libraries. Download the AWS SDK for Java // from https://aws.amazon.com/sdk-for-javaimport com.amazonaws.regions.Regions;import com.amazonaws.services.simpleemail.AmazonSimpleEmailService;import com.amazonaws.services.simpleemail.AmazonSimpleEmailServiceClientBuilder;import com.amazonaws.services.simpleemail.model.RawMessage;import com.amazonaws.services.simpleemail.model.SendRawEmailRequest;


// Replace [email protected] with your "From" address. // This address must be verified with Amazon SES. private static String SENDER = "Sender Name <[email protected]>";

// Replace [email protected] with a "To" address. If your account // is still in the sandbox, this address must be verified. private static String RECIPIENT = "[email protected]";

// Specify a configuration set. If you do not want to use a configuration // set, comment the following variable, and the // ConfigurationSetName=CONFIGURATION_SET argument below. private static String CONFIGURATION_SET = "ConfigSet";

// The subject line for the email. private static String SUBJECT = "Customer service contact info";

// The full path to the file that will be attached to the email. // If you are using Windows, escape backslashes as shown in this variable. private static String ATTACHMENT = "C:\\Users\\sender\\customers-to-contact.xlsx";

// The email body for recipients with non-HTML email clients. private static String BODY_TEXT = "Hello,\r\n" + "Please see the attached file for a list " + "of customers to contact.";

// The HTML body of the email. private static String BODY_HTML = "<html>" + "<head></head>" + "<body>" + "<h1>Hello!</h1>" + "<p>Please see the attached file for a " + "list of customers to contact.</p>" + "</body>" + "</html>";

public static void main(String[] args) throws AddressException, MessagingException, IOException { String DefaultCharSet = MimeUtility.getDefaultJavaCharset(); Session session = Session.getDefaultInstance(new Properties()); // Create a new MimeMessage object. MimeMessage message = new MimeMessage(session); // Add subject, from and to lines. message.setSubject(SUBJECT, "UTF-8"); message.setFrom(new InternetAddress(SENDER)); message.setRecipients(Message.RecipientType.TO, InternetAddress.parse(RECIPIENT));

// Create a multipart/alternative child container. MimeMultipart msg_body = new MimeMultipart("alternative"); // Create a wrapper for the HTML and text parts. MimeBodyPart wrap = new MimeBodyPart();

428



// Define the text part. MimeBodyPart textPart = new MimeBodyPart(); // Encode the text content and set the character encoding. This step is // necessary if you're sending a message with characters outside the // ASCII range. textPart.setContent(MimeUtility .encodeText(BODY_TEXT,DefaultCharSet,"B"), "text/plain; charset=UTF-8"); textPart.setHeader("Content-Transfer-Encoding", "base64"); // Define the HTML part. MimeBodyPart htmlPart = new MimeBodyPart(); // Encode the HTML content and set the character encoding. htmlPart.setContent(MimeUtility .encodeText(BODY_HTML,DefaultCharSet,"B"),"text/html; charset=UTF-8"); htmlPart.setHeader("Content-Transfer-Encoding", "base64"); // Add the text and HTML parts to the child container. msg_body.addBodyPart(textPart); msg_body.addBodyPart(htmlPart); // Add the child container to the wrapper object. wrap.setContent(msg_body); // Create a multipart/mixed parent container. MimeMultipart msg = new MimeMultipart("mixed"); // Add the parent container to the message. message.setContent(msg); // Add the multipart/alternative part to the message. msg.addBodyPart(wrap); // Define the attachment MimeBodyPart att = new MimeBodyPart(); DataSource fds = new FileDataSource(ATTACHMENT); att.setDataHandler(new DataHandler(fds)); att.setFileName(fds.getName()); // Add the attachment to the message. msg.addBodyPart(att);

// Try to send the email. try { System.out.println("Attempting to send an email through Amazon SES " +"using the AWS SDK for Java...");

// Instantiate an Amazon SES client, which will make the service // call with the supplied AWS credentials. AmazonSimpleEmailService client = AmazonSimpleEmailServiceClientBuilder.standard() // Replace US_WEST_2 with the AWS Region you're using for // Amazon SES. .withRegion(Regions.US_WEST_2).build(); // Print the raw email content on the console PrintStream out = System.out; message.writeTo(out);

// Send the email. ByteArrayOutputStream outputStream = new ByteArrayOutputStream(); message.writeTo(outputStream); RawMessage rawMessage = new RawMessage(ByteBuffer.wrap(outputStream.toByteArray()));

429



SendRawEmailRequest rawEmailRequest = new SendRawEmailRequest(rawMessage) .withConfigurationSetName(CONFIGURATION_SET); client.sendRawEmail(rawEmailRequest); System.out.println("Email sent!"); // Display an error if something goes wrong. } catch (Exception ex) { System.out.println("Email Failed"); System.err.println("Error message: " + ex.getMessage()); ex.printStackTrace(); } }}

PHP

El siguiente ejemplo de código muestra cómo utilizar el paquete PHPMailer y el AWS SDK para PHPpara crear y enviar un correo electrónico sin procesar que contiene una parte en HTML, una parte detexto y un archivo adjunto.

En este ejemplo de código se supone que ha instalado el paquete PHPMailer mediante Composer.También se supone que ha instalado el AWS SDK para PHP y que ha creado un archivo decredenciales compartidas. Para obtener más información acerca de cómo crear un archivo decredenciales compartidas, consulte Crear un archivo de credenciales compartidas (p. 31).

Important


<?phprequire 'vendor/autoload.php';use PHPMailer\PHPMailer\PHPMailer;use Aws\Ses\SesClient;use Aws\Ses\Exception\SesException;

// Replace [email protected] with your "From" address. // This address must be verified with Amazon SES.$sender = '[email protected]'; $sendername = 'Sender Name';

// Replace [email protected] with a "To" address. If your account // is still in the sandbox, this address must be verified.$recipient = '[email protected]';

// Specify a configuration set.$configset = 'ConfigSet';

// Replace us-west-2 with the AWS Region you're using for Amazon SES.$region = 'us-west-2';

$subject = 'List of customers to contact';

$htmlbody = <<<EOD<html><head></head><body><h1>Hello!</h1><p>Please see the attached file for a list of customers to contact.</p>

430

https://github.com/PHPMailer/PHPMailer


https://packagist.org/packages/phpmailer/phpmailer

https://getcomposer.org/



</body></html>EOD;

$textbody = <<<EODHello,Please see the attached file for a list of customers to contact.EOD;

// The full path to the file that will be attached to the email. $att = 'path/to/customers-to-contact.xlsx';

// Create an SesClient.$client = SesClient::factory(array( 'version'=> 'latest', 'region' => $region));

// Create a new PHPMailer object.$mail = new PHPMailer;

// Add components to the email.$mail->setFrom($sender, $sendername);$mail->addAddress($recipient);$mail->Subject = $subject;$mail->Body = $htmlbody;$mail->AltBody = $textbody;$mail->addAttachment($att);$mail->addCustomHeader('X-SES-CONFIGURATION-SET', $configset);

// Attempt to assemble the above components into a MIME message.if (!$mail->preSend()) { echo $mail->ErrorInfo;} else { // Create a new variable that contains the MIME message. $message = $mail->getSentMIMEMessage();}

// Try to send the message.try { $result = $client->sendRawEmail([ 'RawMessage' => [ 'Data' => $message ] ]); // If the message was sent, show the message ID. $messageId = $result->get('MessageId'); echo("Email sent! Message ID: $messageId"."\n");} catch (SesException $error) { // If the message was not sent, show a message explaining what went wrong. echo("The email was not sent. Error message: " .$error->getAwsErrorMessage()."\n");}

?>

Python

El siguiente ejemplo de código muestra cómo utilizar el paquete email de Python y el AWS SDK forPython (Boto) para crear y enviar un correo electrónico sin procesar que contiene una parte en HTML,una parte de texto y un archivo adjunto.

En este ejemplo de código se supone que ha instalado el AWS SDK for Python (Boto) y que ha creadoun archivo de credenciales compartidas. Para obtener más información acerca de cómo crear unarchivo de credenciales compartidas, consulte Crear un archivo de credenciales compartidas (p. 31).

431

https://docs.python.org/3/library/email.html





Important


import osimport boto3from botocore.exceptions import ClientErrorfrom email.mime.multipart import MIMEMultipartfrom email.mime.text import MIMETextfrom email.mime.application import MIMEApplication





# The subject line for the email.SUBJECT = "Customer service contact info"

# The full path to the file that will be attached to the email.ATTACHMENT = "path/to/customers-to-contact.xlsx"

# The email body for recipients with non-HTML email clients.BODY_TEXT = "Hello,\r\nPlease see the attached file for a list of customers to contact."

# The HTML body of the email.BODY_HTML = """\<html><head></head><body><h1>Hello!</h1><p>Please see the attached file for a list of customers to contact.</p></body></html>"""

# The character encoding for the email.CHARSET = "utf-8"


# Create a multipart/mixed parent container.msg = MIMEMultipart('mixed')# Add subject, from and to lines.msg['Subject'] = SUBJECT msg['From'] = SENDER

432



msg['To'] = RECIPIENT

# Create a multipart/alternative child container.msg_body = MIMEMultipart('alternative')

# Encode the text and HTML content and set the character encoding. This step is# necessary if you're sending a message with characters outside the ASCII range.textpart = MIMEText(BODY_TEXT.encode(CHARSET), 'plain', CHARSET)htmlpart = MIMEText(BODY_HTML.encode(CHARSET), 'html', CHARSET)

# Add the text and HTML parts to the child container.msg_body.attach(textpart)msg_body.attach(htmlpart)

# Define the attachment part and encode it using MIMEApplication.att = MIMEApplication(open(ATTACHMENT, 'rb').read())

# Add a header to tell the email client to treat this part as an attachment,# and to give the attachment a name.att.add_header('Content-Disposition','attachment',filename=os.path.basename(ATTACHMENT))

# Attach the multipart/alternative child container to the multipart/mixed# parent container.msg.attach(msg_body)

# Add the attachment to the parent container.msg.attach(att)#print(msg)try: #Provide the contents of the email. response = client.send_raw_email( Source=SENDER, Destinations=[ RECIPIENT ], RawMessage={ 'Data':msg.as_string(), }, ConfigurationSetName=CONFIGURATION_SET )# 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'])

Ruby

El siguiente ejemplo de código muestra cómo utilizar la gema MIME de Ruby y el AWS SDK pararRuby para crear y enviar un correo electrónico sin procesar que contiene una parte en HTML, unaparte de texto y un archivo adjunto.

En este ejemplo de código se supone que ha instalado el AWS SDK parar Ruby y la gema MIME,y que ha creado un archivo de credenciales compartidas. Para obtener más información acercade cómo crear un archivo de credenciales compartidas, consulte Crear un archivo de credencialescompartidas (p. 31).

Important

Utilice un archivo de credenciales compartido para pasar su ID de clave de acceso y clave deacceso secreta de AWS. Como alternativa al uso de un archivo de credenciales compartido,puede especificar su ID de clave de acceso y clave de acceso secreta de AWS mediante la

433

https://rubygems.org/gems/mime/versions/0.4.4





configuración de variables de entorno (AWS_ACCESS_KEY_ID y AWS_SECRET_ACCESS_KEY,respectivamente). Este ejemplo no funciona a menos que especifique las credencialesmediante uno de estos métodos.

require 'base64' #standard libraryrequire 'aws-sdk' #gem install aws-sdkrequire 'mime' #gem install mime

# Replace [email protected] with your "From" address.# This address must be verified with Amazon SES.sender = "[email protected]"sendername = "Sender Name"


# Specify a configuration set. configsetname = "ConfigSet" # Replace us-west-2 with the AWS Region you're using for Amazon SES.awsregion = "us-west-2"

# The subject line for the email.subject = "Customer service contact info"

# The full path to the file that will be attached to the email.attachment = "path/to/customers-to-contact.xlsx"

# The email body for recipients with non-HTML email clients. textbody = """Hello,Please see the attached file for a list of customers to contact."""

# The HTML body of the email.htmlbody = """<html><head></head><body><h1>Hello!</h1><p>Please see the attached file for a list of customers to contact.</p></body></html>"""

# Create a new MIME text object that contains the base64-encoded content of the# file that will be attached to the message.file = MIME::Application.new(Base64::encode64(open(attachment,"rb").read))

# Specify that the file is a base64-encoded attachment to ensure that the # receiving client handles it correctly. file.transfer_encoding = 'base64'file.disposition = 'attachment'

# Create a MIME Multipart Mixed object. This object will contain the body of the# email and the attachment.msg_mixed = MIME::Multipart::Mixed.new

# Create a MIME Multipart Alternative object. This object will contain both the# HTML and plain text versions of the email.msg_body = MIME::Multipart::Alternative.new

# Add the plain text and HTML content to the Multipart Alternative part.msg_body.add(MIME::Text.new(textbody,'plain'))

434

Amazon Simple Email Service Developer GuideVerificación de varias direcciones de correo electrónico

msg_body.add(MIME::Text.new(htmlbody,'html'))

# Add the Multipart Alternative part to the Multipart Mixed part.msg_mixed.add(msg_body)

# Add the attachment to the Multipart Mixed part.msg_mixed.attach(file, 'filename' => attachment)

# Create a new Mail object that contains the entire Multipart Mixed object. # This object also contains the message headers.msg = MIME::Mail.new(msg_mixed)msg.to = { recipient => nil }msg.from = { sender => sendername }msg.subject = subjectmsg.headers.set('X-SES-CONFIGURATION-SET',configsetname)



# Provide the contents of the email. resp = ses.send_raw_email({ raw_message: { data: msg.to_s } }) # If the message was sent, show the message ID. puts "Email sent! Message ID: " + resp[0].to_s

# If the message was not sent, show a message explaining what went wrong.rescue Aws::SES::Errors::ServiceError => error puts "Email not sent. Error message: #{error}"

end

Verificación de varias direcciones de correoelectrónico

Si está realizando la migración a Amazon SES desde otra solución de envío de correo electrónico, esposible que ya tenga una larga lista de direcciones de correo electrónico que desea utilizar para enviarcorreo electrónico. El script de Python de este ejemplo acepta como entrada una lista de direcciones decorreo electrónico con formato JSON. En el siguiente ejemplo se muestra la estructura del archivo deentrada:

[ { "email":"[email protected]" }, { "email":"[email protected]" }, { "email":"[email protected]" }]

435

Amazon Simple Email Service Developer GuideGenerar credenciales de SMTP

El script siguiente lee el archivo de entrada e intenta validar todas las direcciones de correo electrónico quecontiene. En este ejemplo de código se supone que ha instalado el AWS SDK for Python (Boto) y que hacreado un archivo de credenciales compartidas. Para obtener más información acerca de cómo crear unarchivo de credenciales compartidas, consulte Crear un archivo de credenciales compartidas (p. 31).

import json #Python standard libraryimport boto3 #sudo pip install boto3from botocore.exceptions import ClientError

# The full path to the file that contains the identities to be verified. # The input file must be JSON-formatted. See# https://docs.aws.amazon.com/ses/latest/DeveloperGuide/sample-code-bulk-verify.html # for a sample input file.FILE_INPUT = '/path/to/identities.json'


# Create a new SES resource specify a region.client = boto3.client('ses',region_name=AWS_REGION)

# Read the file that contains the identities to be verified.with open(FILE_INPUT) as data_file: data = json.load(data_file)

# Iterate through the array from the input file. Each time an object named# 'email' is found, run the verify_email_identity operation against the value # of that object.for i in data: try: response = client.verify_email_identity( EmailAddress=i['email'] ) # Display an error if something goes wrong. except ClientError as e: print(e.response['Error']['Message']) # Otherwise, show the request ID of the verification message. else: print('Verification email sent to ' + i['email'] + '. Request ID: ' + response['ResponseMetadata']['RequestId'])

Generación de credenciales de SMTP a partir decredenciales de IAM existentes

Para enviar un correo electrónico utilizando la interfaz SMTP de Amazon SES, debe crear un nombrede usuario y una contraseña de SMTP. La forma más sencilla de crear un nombre de usuario y unacontraseña de SMTP es utilizar la consola de Amazon SES. Para obtener más información, consulteObtención de credenciales de SMTP de Amazon SES utilizando la consola de Amazon SES (p. 76).

Algunos lenguajes de programación incluyen bibliotecas que puede utilizar para convertir una clave deacceso secreta de IAM en una contraseña de SMTP. Si ya tiene un usuario de IAM que desea utilizar paraenviar correo electrónico a través de la interfaz de SMTP, puede utilizar estos ejemplos de código paraconvertir la clave de acceso secreta de AWS para ese usuario en una contraseña de SMTP.

Antes de ejecutar estos ejemplos, guarde la clave de acceso secreta de AWS que desea convertir en unavariable de entorno llamada AWS_SECRET_ACCESS_KEY. Estos ejemplos de código pasan su contraseñade SMTP convertida como salida. Esta contraseña y el nombre de usuario de SMTP (que es el mismo quesu ID de clave de acceso de AWS) son sus credenciales de SMTP de Amazon SES.

436


Bash

#!/usr/bin/env bash

# These variables are required to calculate the SMTP password.VERSION='\x02'MESSAGE='SendRawEmail'

# Check to see if OpenSSL is installed. If not, exit with errors.if ! [[ -x "$(command -v openssl)" ]]; then echo "Error: OpenSSL isn't installed." >&2 exit 1# If OpenSSL is installed, check to see that the environment variable has a# length greater than 0. If not, exit with errors.elif [[ -z "${AWS_SECRET_ACCESS_KEY}" ]]; then echo "Error: Couldn't find environment variable AWS_SECRET_ACCESS_KEY." >&2 exit 1fi

# If we made it this far, all of the required elements exist.# Calculate the SMTP password.(echo -en $VERSION; echo -n $MESSAGE \ | openssl dgst -sha256 -hmac $AWS_SECRET_ACCESS_KEY -binary) \ | openssl enc -base64

Java

import javax.crypto.Mac;import javax.crypto.spec.SecretKeySpec;import javax.xml.bind.DatatypeConverter;

public class SesSmtpCredentialGenerator { // Put your AWS secret access key in this environment variable. private static final String KEY_ENV_VARIABLE = "AWS_SECRET_ACCESS_KEY"; // Used to generate the HMAC signature. Do not modify. private static final String MESSAGE = "SendRawEmail"; // Version number. Do not modify. private static final byte VERSION = 0x02;

public static void main(String[] args) { // Get the AWS secret access key from environment variable AWS_SECRET_ACCESS_KEY. String key = System.getenv(KEY_ENV_VARIABLE); if (key == null) { System.out.println("Error: Cannot find environment variable AWS_SECRET_ACCESS_KEY."); System.exit(0); } // Create an HMAC-SHA256 key from the raw bytes of the AWS secret access key. SecretKeySpec secretKey = new SecretKeySpec(key.getBytes(), "HmacSHA256");

try { // Get an HMAC-SHA256 Mac instance and initialize it with the AWS secret access key. Mac mac = Mac.getInstance("HmacSHA256"); mac.init(secretKey);

// Compute the HMAC signature on the input data bytes. byte[] rawSignature = mac.doFinal(MESSAGE.getBytes());

// Prepend the version number to the signature.

437


byte[] rawSignatureWithVersion = new byte[rawSignature.length + 1]; byte[] versionArray = {VERSION}; System.arraycopy(versionArray, 0, rawSignatureWithVersion, 0, 1); System.arraycopy(rawSignature, 0, rawSignatureWithVersion, 1, rawSignature.length);

// To get the final SMTP password, convert the HMAC signature to base 64. String smtpPassword = DatatypeConverter.printBase64Binary(rawSignatureWithVersion); System.out.println(smtpPassword); } catch (Exception ex) { System.out.println("Error generating SMTP password: " + ex.getMessage()); } }}

Python

import os #required to fetch environment variblesimport hmac #required to compute the HMAC keyimport hashlib #required to create a SHA256 hashimport base64 #required to encode the computed keyimport sys #required for system functions (exiting, in this case)

# Fetch the environment variable called AWS_SECRET_ACCESS_KEY, which contains# the secret access key for your IAM user.key = os.getenv('AWS_SECRET_ACCESS_KEY',0)

# These varibles are used when calculating the SMTP password. You shouldn't# change them.message = 'SendRawEmail'version = '\x02'

# See if the environment variable exists. If not, quit and show an error.if key == 0: sys.exit("Error: Can't find environment variable AWS_SECRET_ACCESS_KEY.")

# Compute an HMAC-SHA256 key from the AWS secret access key.signatureInBytes = hmac.new(key.encode('utf-8'),message.encode('utf-8'),hashlib.sha256).digest()# Prepend the version number to the signature.signatureAndVersion = version.encode('utf-8') + signatureInBytes# Base64-encode the string that contains the version number and signature.smtpPassword = base64.b64encode(signatureAndVersion)# Decode the string and print it to the console.print(smtpPassword.decode('utf-8'))

438

Amazon Simple Email Service Developer GuidePuntos de conexión de Amazon SES

Regiones y Amazon SESAl utilizar Amazon Simple Email Service (Amazon SES), se conecta a una URL que proporciona un puntode enlace para el API de Amazon SES o la interfaz de SMTP. Amazon SES tiene puntos de enlace envarias regiones de AWS. Para reducir la latencia de la red, es buena idea elegir un punto de enlace máscercano a su aplicación.

Este tema contiene información que necesita conocer al utilizar puntos de enlace de Amazon SES envarias regiones de AWS. En él se explican los siguientes temas:

• Puntos de conexión de Amazon SES (p. 439)• Selección de una región para uso con Amazon SES (p. 440)• Entorno de pruebas y aumentos de límites de envío (p. 441)• Verificación (p. 441)• Configuración de Easy DKIM (p. 441)• Lista de supresión (p. 441)• Notificaciones de retroalimentación (p. 442)• Credenciales SMTP (p. 442)• Autorización de envío (p. 442)• Dominios MAIL FROM personalizados (p. 442)• Recepción de correos electrónicos (p. 443)

Para obtener información general sobre las regiones de AWS, consulte AWS Regions and Endpoints en laReferencia general de AWS.

Puntos de conexión de Amazon SESLas siguientes secciones muestran las regiones de AWS en las que está disponible Amazon SES y lospuntos de enlace correspondientes para el envío y la recepción de correos electrónicos.

Puntos de enlace de envío de correo electrónicoEn la siguiente tabla se muestran los puntos de enlace que utiliza para el envío de correo electrónico.

Nombre de laregión

Región Punto deenlace de API(HTTPS)

Punto de conexión SMTP

US East (N.Virginia)

us-east-1 email.us-east-1.amazonaws.com

email-smtp.us-east-1.amazonaws.com

EE.UU. Oeste(Oregón)

us-west-2 email.us-west-2.amazonaws.com

email-smtp.us-west-2.amazonaws.com

UE (Irlanda) eu-west-1 email.eu-west-1.amazonaws.com

email-smtp.eu-west-1.amazonaws.com

439

https://docs.aws.amazon.com/general/latest/gr/rande.html

Amazon Simple Email Service Developer GuidePuntos de enlace de recepción de correo electrónico

Puntos de enlace de recepción de correo electrónicoEn la siguiente tabla se muestran los puntos de enlace que utiliza para la recepción de correo electrónico.

Nombre de la región Región Punto de conexión SMTP

US East (N. Virginia) us-east-1 inbound-smtp.us-east-1.amazonaws.com

EE.UU. Oeste (Oregón) us-west-2 inbound-smtp.us-west-2.amazonaws.com

UE (Irlanda) eu-west-1 inbound-smtp.eu-west-1.amazonaws.com

Selección de una región para uso con Amazon SESEn las secciones siguientes se describe cómo seleccionar una región en función del método que utilizapara llamar a Amazon SES.

API de Amazon SESAl utilizar el API de Amazon SES, debe especificar un punto de enlace en la solicitud de consulta. Estepunto de enlace determina la región de AWS que está utilizando. Para obtener más información, consulteSolicitudes de consulta y Amazon SES (p. 396).

Interfaz de SMTP de Amazon SESLa interfaz de SMTP es solo para el envío de correo electrónico. Al utilizar la interfaz de SMTP, el puntode enlace de SMTP que especifique en su código o configuración determina la región de AWS que estáutilizando. Para obtener más información, consulte Conexión al punto de enlace de SMTP de AmazonSES (p. 80).

Consola de Amazon SESAl utilizar la consola de Amazon SES, puede cambiar el punto de enlace haciendo clic en el nombre de laregión en la esquina superior derecha de la barra de navegación, tal y como se muestra en la siguientecaptura de pantalla.

440

Amazon Simple Email Service Developer GuideEntorno de pruebas y aumentos de límites de envío

Entorno de pruebas y aumentos de límites de envíoEl estado del entorno de pruebas y los límites de envío se aplican según la región. Debe solicitar unaumento de límite de envío para cada región de manera individual. Al abrir un SES Sending LimitsIncrease case en el servicio de atención al cliente, el formulario tiene un menú que se utiliza paraseleccionar la región de AWS para la que se solicita un aumento del límite de envío. Para obtener másinformación sobre el aumento de sus límites de envío, consulte Apertura de un caso de SES SendingLimits Increase (p. 139).

VerificaciónAntes de enviar correo electrónico a través de Amazon SES, debe verificar que usted es propietario de lasdirecciones de correo electrónico o dominios con Amazon SES. El estado de verificación para cada regiónes independiente, tal y como se describe en las secciones siguientes.

Verificación de dirección de correo electrónicoDebe verificar la dirección de correo electrónico de cada remitente de forma independiente para cadaregión que desea utilizar. Por ejemplo, si verifica una dirección de correo electrónico en la región EE.UU.Oeste (Oregón), podrá enviar desde la misma al conectarse a un punto de enlace de Amazon SES en laregión EE.UU. Oeste (Oregón), pero no podrá enviar desde ella usando un punto de enlace en la regiónUS East (N. Virginia) hasta que verifique la dirección de correo electrónico en la región de US East (N.Virginia). Para obtener más información acerca de la verificación de direcciones de correo electrónico,consulte Verificación de direcciones de correo electrónico en Amazon SES. (p. 47).

Verificación de dominioAl igual que la verificación de dirección de correo electrónico, la verificación de dominios se aplica a cadaregión por separado. Debe realizar el procedimiento de verificación de dominios para cada región en laque desee enviar desde un determinado dominio. Por ejemplo, si desea enviar correo electrónico desdeexample.com tanto desde el punto de enlace de la región EE.UU. Oeste (Oregón) y desde el punto deenlace de la región US East (N. Virginia), deberá añadir dos registros TXT a su configuración DNS, unregistro para cada región. Puede generar estos registros utilizando la consola de Amazon SES con laregión adecuada seleccionada o el punto de enlace del API de Amazon SES que se corresponda con laregión que desee. Para obtener más información sobre la verificación de dominios, consulte Verificación dedominios en Amazon SES (p. 59).

Configuración de Easy DKIMDebe realizar el procedimiento de configuración de Easy DKIM para cada región en la que desea utilizarEasy DKIM. Es decir, para cada región, debe utilizar la consola de Amazon SES o el API de Amazon SESpara generar registros TXT, añada los registros TXT a su configuración de DNS y, a continuación, utilice elAPI de Amazon SES o la consola de Amazon SES para habilitar la firma DKIM para su identidad de envíoelegida (dirección de correo electrónico o dominio) en esa región. Para obtener más información acerca dela configuración de Easy DKIM, consulte Easy DKIM en Amazon SES (p. 126).

Lista de supresiónAunque cada región tiene una lista de supresión independiente, si suprime una dirección de la lista desupresión de una región, la dirección se elimina de la lista de supresión de todas las regiones. Puede

441



Amazon Simple Email Service Developer GuideNotificaciones de retroalimentación

eliminar direcciones de la lista de supresión mediante la consola de Amazon SES. Para obtener másinformación acerca de la lista de supresión, consulte Eliminación de una dirección de correo electrónico dela lista de supresión de Amazon SES (p. 462).

Notificaciones de retroalimentaciónExisten dos puntos importantes a tener en cuenta acerca de cómo configurar las notificaciones deretroalimentación en varias regiones:

• La configuración de identidad verificada, como, por ejemplo, si recibe retroalimentación por correoelectrónico o a través de Amazon Simple Notification Service (Amazon SNS), se aplica únicamente a laregión en la que los define. Por ejemplo, si verifica [email protected] en las regiones EE.UU. Oeste(Oregón) y US East (N. Virginia) y desea recibir correos electrónicos rebotados a través de notificacionesde Amazon SNS, debe utilizar el API de Amazon SES o la consola de Amazon SES para configurar lasnotificaciones de retroalimentación de Amazon SNS para [email protected] en ambas regiones.

• Los temas de Amazon SNS que utilice para reenvío de retroalimentación deben estar dentro de la mismaregión en la que está utilizando Amazon SES.

Credenciales SMTPPuede usar el mismo conjunto de credenciales de SMTP en todas las regiones. Para obtener másinformación acerca de las credenciales de SMTP, consulte Obtener sus credenciales de SMTP de AmazonSES (p. 75).

Dominios MAIL FROM personalizadosPuede utilizar el mismo dominio MAIL FROM personalizado para identidades verificadas en distintasregiones de AWS. Si es lo que desea hacer, todavía debe publicar un único registro MX en el servidorDNS para el dominio MAIL FROM. Los rebotes devueltos por los ISP irán al punto de enlace deretroalimentación de Amazon SES en la región especificada en el registro MX primero y, a continuación,Amazon SES redirigirá los rebotes a la identidad verificada en la región que envió el correo electrónico.

Utilice la configuración de registro MX que proporciona Amazon SES durante la configuración MAILFROM personalizada para una identidad en una de las regiones. El proceso de configuración MAIL FROMpersonalizado se describe en Configuración de un dominio MAIL FROM (p. 66). Como referencia, puedebuscar los puntos de enlace de retroalimentación para todas las regiones en la siguiente tabla.

Nombre de la región Puntos de enlace de retroalimentaciónpara configuraciones de envío MAIL FROMpersonalizadas

US East (N. Virginia) feedback-smtp.us-east-1.amazonses.com

EE.UU. Oeste (Oregón) feedback-smtp.us-west-2.amazonses.com

UE (Irlanda) feedback-smtp.eu-west-1.amazonses.com

Autorización de envíoEl remitente delegado debe enviar los correos electrónicos desde la región de AWS en la que se verifica laidentidad del propietario de identidad. La política de autorización de envío que otorga permiso al remitente

442

Amazon Simple Email Service Developer GuideRecepción de correos electrónicos

delegado debe estar adjunta a la identidad en dicha región. Para obtener más información acerca de laautorización de envío, consulte Uso de autorización de envío con Amazon SES (p. 141).

Recepción de correos electrónicosAl recibir correo electrónico con Amazon SES, todos los recursos que utilice deben estar en la mismaregión que el punto de enlace de Amazon SES.

Note

Para obtener una lista de puntos de enlace para recepción de correo electrónico de Amazon SES,consulte Puntos de enlace de recepción de correo electrónico (p. 440).

Por ejemplo, si utiliza el punto de enlace de Amazon SES en EE.UU. Oeste (Oregón) y, a continuación,cualquier bucket de Amazon S3, tema de Amazon SNS, clave de AWS KMS y función de Lambda queutilice también debe estar en EE.UU. Oeste (Oregón). Del mismo modo, para recibir correo con AmazonSES dentro de una región, debe disponer de un conjunto de reglas de recepción activas dentro de dicharegión.

443

Amazon Simple Email Service Developer GuideLímites relacionados con el envío de correo electrónico

Límites en Amazon SESEn este tema se muestran los límites de Amazon Simple Email Service (Amazon SES).

Límites relacionados con el envío de correoelectrónico

En las siguientes tablas se muestran los límites relacionados con el envío de correo electrónico.

Límites de envíoNote

Los límites de envío se basan en los destinatarios en lugar de en los mensajes.

Límite Descripción

Los límites de envío en el entorno depruebas

• Cuota de envío: 200 mensajes de correo electrónico en unperiodo de 24 horas.

• Ratio máximo de envío: 1 correo electrónico por segundo.

Note

La tasa de aceptación de mensajes en AmazonSES podría ser inferior al ratio máximo de envío.

Para aumentar sus límites de envío, abra un caso de límitede envío de SES en el servicio de atención al cliente. Paraobtener más información, consulte Salir del entorno depruebas de Amazon SES (p. 72).

Límites de mensajes


El tamaño máximo de mensaje(incluidos los archivos adjuntos)

10 MB por mensaje (en codificación base64).

Campos de encabezado aceptados Amazon SES acepta todos los encabezados de correoelectrónico que siguen el formato descrito en RFC 822.

Tipos de archivos adjuntos aceptados Amazon SES acepta todos los tipos de archivos adjuntosexcepto para archivos adjuntos con extensiones de archivo

444


Amazon Simple Email Service Developer GuideLímites de remitentes y destinatarios

Límite Descripciónmostradas en Apéndice: tipos de archivos adjuntos noadmitidos (p. 503).

Límites de remitentes y destinatarios


Dirección de remitente Tanto dentro como fuera del entorno de pruebas, tiene queverificar las direcciones de correo electrónico o dominios"From", "Source", "Sender" y "Return-Path", aunque no"Reply-To".

Dirección del destinatario En el entorno de pruebas, se deben verificar todas lasdirecciones de destinatario ("To") excepto las direcciones delsimulador de bandeja de correo de Amazon SES. Si no deseaverificar las direcciones "To", abra un caso de límite de envíode SES en el servicio de atención al cliente. Para obtenermás información, consulte Salir del entorno de pruebas deAmazon SES (p. 72).

Número máximo de destinatarios pormensaje

50 destinatarios por mensaje.Un destinatario es cualquier dirección "To", "CC" o "BCC".

Número máximo de identidades quepuede verificar

10 000 identidades (dominios o direcciones de correoelectrónico en cualquier combinación) por región de AWS.

Límites relacionados con la publicación de evento deenvío de correo electrónico


Número máximo de conjuntos deconfiguración

10 000

Número máximo de destinos de eventopor conjunto de configuración

10

Número máximo de dimensiones pordestino de evento de CloudWatch

10

Límites de plantilla de correo electrónico


Número máximo de plantillas de correoelectrónico para cada región de AWS

10 000

Tamaño máximo de la plantilla 500 KB

445

Amazon Simple Email Service Developer GuideLímites relacionados con Amazon EC2


Número máximo de los valores desustitución en cada plantilla

Sin límite

Número máximo de destinatarios paracada correo electrónico con plantilla

50 destinos. Un destino es cualquier dirección de correoelectrónico en los campos "Para", "CC" o "CCO".

Note

El número de destinos con los que puede ponerseen contacto en una única llamada al API podría estarlimitado por el ratio máximo de envío de su cuenta.

Límites relacionados con Amazon EC2


Envío de correo electrónico a través delpuerto 25

Amazon EC2 limita el tráfico de correo electrónico a través delpuerto 25 de forma predeterminada. Para evitar tiempos deinactividad al enviar correo electrónico a través del punto deenlace de SMTP de Amazon SES desde Amazon EC2, utiliceun puerto diferente (587 o 2587) o rellene una Solicitud deeliminación de limitaciones de envío de correo electrónico.

Límites relacionados con la recepción de correoelectrónico

En la siguiente tabla se muestran los límites relacionados con la recepción de correo electrónico.


Número máximo de reglas por conjuntode reglas de recepción

100

Número máximo de acciones por reglade recepción

10

Número máximo de destinatarios porregla de recepción

100

Número máximo de conjuntos de reglasde recepción por cuenta de AWS

20

Número máximo de filtros de direcciónIP por cuenta de AWS

100

Tamaño máximo de correo electrónico(incluidos encabezados) que se puedealmacenar en un bucket de Amazon S3

30 MB

Tamaño máximo de correo electrónico(incluidos encabezados) que se puede

150 KB

446



Amazon Simple Email Service Developer GuideLímites generales

Límite Descripciónpublicar utilizando una notificación deAmazon SNS

Límites generalesEn la siguiente tabla se muestran los límites que se aplican tanto al envío como a la recepción de correoelectrónico.

Límites de API de Amazon SES


Tasa a la que puede llamar a accionesdel API de Amazon SES

Todas las acciones (excepto SendEmail y SendRawEmail)están limitadas a una solicitud por segundo. Para obtenermás información sobre el API de Amazon SES, consulteAmazon Simple Email Service API Reference.

447


Amazon Simple Email Service Developer GuideMétricas de éxito

Prácticas recomendadas para elenvío de un correo electrónicoutilizando Amazon SES

El modo en que gestione sus comunicaciones por correo electrónico con los clientes se denominaprograma de correo electrónico. Hay varios factores que pueden dar lugar al éxito o al fracaso de suprograma de correo electrónico; estos factores puede resultar confusos o misteriosos al principio. Sinembargo, si entiende cómo se entrega de correo electrónico y sigue algunas prácticas recomendadas,puede aumentar las probabilidades de que su correo electrónico llegue con éxito a las bandejas de entradade sus clientes.

Temas• Métricas de éxito para los programas de correo electrónico (p. 448)• Consejos y prácticas recomendadas (p. 451)

Métricas de éxito para los programas de correoelectrónico

Existen varias métricas que pueden ayudarle a medir el éxito de su programa de correo electrónico.

Esta sección ofrece información sobre los siguientes temas:• Rebotes (p. 448)• Reclamaciones (p. 449)• Calidad del mensaje (p. 450)

RebotesUn rebote se produce cuando un correo electrónico no se puede entregar al destinatario esperado.Existen dos tipos de rebotes: rebotes permanentes y rebotes temporales. Un rebote permanente seproduce cuando el correo electrónico no se puede entregar debido a un problema persistente, como, porejemplo, cuando no existe la dirección de correo electrónico. Un rebote temporal se produce cuando unproblema temporal impide la entrega de un mensaje de correo electrónico. Los rebotes temporales puedenproducirse cuando la bandeja de entrada de un destinatario está llena o cuando el servidor de recepciónno está disponible temporalmente. Amazon SES gestiona rebotes temporales intentando volver a enviarmensajes de correo con rebote temporal durante un determinado periodo de tiempo.

Es fundamental que supervise el número de rebotes permanentes en su programa de correo electrónicoy que retire las direcciones de correo electrónico con rebotes permanentes de su lista de destinatarios.Cuando los receptores de correo electrónico detectan una alta tasa de rebotes permanentes, suponemosque no conoce a sus destinatarios bien. En consecuencia, una tasa de rebotes permanentes elevadapuede afectar negativamente a la capacidad de entrega de sus mensajes de correo electrónico.

Las siguientes directrices le pueden ayudar a evitar los rebotes y a mejorar su reputación de remitente:

• Intente mantener su tasa de rebotes permanentes por debajo del 5%. Mientras menor sea el número derebotes permanentes en su programa de correo electrónico, más probable será que los ISP vean sus

448

Amazon Simple Email Service Developer GuideReclamaciones

mensajes como legítimos y valiosos. Esta tasa debería considerarse un objetivo razonable y alcanzable,pero no es una regla universal en todos los proveedores de servicios de Internet.

• No alquile ni compre nunca listas de direcciones de correo electrónico. Estas listas pueden contenerun gran número de direcciones no válidas, lo que podría hacer que sus tasas de rebotes permanentesaumenten de manera notable. Además, estas listas podrían contener trampas de spam: direcciones decorreo electrónico utilizadas específicamente para capturar remitentes ilegítimos. Si sus mensajes caenen una trampa de spam, sus tasas de envío y su reputación de remitente podría verse perjudicadas demanera irrevocable.

• Mantenga la lista actualizada. Si no ha enviado correo electrónico a sus destinatarios desde hacemucho tiempo, pruebe a validar los estados de sus clientes a través de algún otro medio (por ejemplo, laactividad de inicio de sesión del sitio web o historial de compras).

• Si no dispone de un método de verificación de los estados de sus clientes, considere la posibilidad deenviar una correo electrónico de recuperación. Un correo electrónico de recuperación normal indica queno ha tenido noticias del cliente desde hace tiempo y anima al cliente a confirmar que todavía desearecibir su correo electrónico. Después de enviar correo electrónico de recuperación, elimine a todos losdestinatarios que no hayan respondido a partir de sus listas.

Cuando reciba rebotes, es fundamental que responda a ellos de forma adecuada respetando las reglassiguientes:

• Si una dirección de correo electrónico presenta rebotes permanentes, elimine de inmediato esadirección de sus listas. No intente volver a enviar mensajes a direcciones con rebotes permanentes. Losrebotes permanentes repetidos se acumulan y, en última instancia, dañan su reputación en el ISP deldestinatario.

• Asegúrese de que la dirección que utiliza para recibir las notificaciones de rebote sea capaz de recibircorreo electrónico. Para obtener más información sobre la configuración de notificaciones de rebotes yreclamaciones, consulte Monitoreo utilizando notificaciones de Amazon SES (p. 236).

• Si su correo electrónico entrante le llega desde un ISP, en lugar de a través de sus propios servidoresinternos, un flujo de las notificaciones de rebote puede acabar en su carpeta de spam o se puedeeliminar por completo. Idealmente, no debe utilizar una dirección de correo electrónico alojada pararecibir rebotes. Si es necesario, sin embargo, compruebe la carpeta de spam a menudo y no marque losmensajes de rebotes como spam. En Amazon SES, puede especificar la dirección a la que se envían lasnotificaciones de rebote.

• Normalmente, un rebote proporciona la dirección del buzón que rechaza la entrega. Sin embargo, sinecesita datos más detallados para asignar la dirección de un destinatario a una determinada campañade correo electrónico, incluya un encabezado X con un valor del que pueda realizar un seguimientoen su sistema de seguimiento interno. Para obtener más información, consulte Apéndice: campos deencabezado (p. 502).

ReclamacionesUna reclamación se produce cuando un destinatario de correo electrónico hace clic en el botón "Marcarcomo spam" (o equivalente) en su cliente de correo electrónico basado en web. Si acumula un grannúmero de estas reclamaciones, el ISP supone que está enviando spam. Esto tiene un impacto negativoen su tasa de capacidad de entrega y en su reputación de remitente. Algunos, pero no todos, de losproveedores de servicios de Internet le avisarán cuando se notifique una reclamación; esto se conocecomo un bucle de retroalimentación. Amazon SES le reenvía automáticamente las reclamaciones de losISP que ofrecen bucles de retroalimentación.

Las siguientes directrices le puede ayudar a evitar las reclamaciones y a mejorar su reputación deremitente:

• Intente mantener su tasa de reclamaciones por debajo del 0,1%. Mientras menor sea el número dereclamaciones en su programa de correo electrónico, más probable será que los ISP vean sus mensajes

449

Amazon Simple Email Service Developer GuideCalidad del mensaje

como legítimos y valiosos. Esta tasa debería considerarse un objetivo razonable y alcanzable, pero noes una regla universal en todos los proveedores de servicios de Internet.

• Si un cliente se queja de un correo electrónico de marketing, debe dejar de enviar inmediatamentecorreos electrónicos de marketing a dicho cliente. Sin embargo, si su programa de correo electrónicotambién incluye otros tipos de correos electrónicos (como, por ejemplo, correos electrónicos denotificaciones o transaccionales), puede ser aceptable seguir enviando estos tipos de mensajes aldestinatario que realizó la reclamación.

• Al igual que ocurre con los rebotes permanentes, si dispone de una lista a la que no haya enviado correoelectrónico desde hace algún tiempo, asegúrese de que sus destinatarios entiendan por qué estánrecibiendo sus mensajes. Le recomendamos que envíe un mensaje de bienvenida que les recuerdequién es usted y por qué desea ponerse en contacto con ellos.

Cuando reciba las reclamaciones, es fundamental que responda a las mismas de forma adecuadarespetando las reglas siguientes:

• Asegúrese de que la dirección que utiliza para recibir las notificaciones de reclamación sea capaz derecibir correo electrónico. Para obtener más información sobre la configuración de notificaciones derebotes y reclamaciones, consulte Monitoreo utilizando notificaciones de Amazon SES (p. 236).

• Asegúrese de que sus notificaciones de reclamación no la marque como spam su ISP o sistema decorreo electrónico.

• Las notificaciones de reclamaciones suelen contener el cuerpo del correo electrónico; esto es diferentede las notificaciones de rebote, que solo incluyen los encabezados de correo electrónico. Sin embargo,en las notificaciones de reclamaciones, se quita la dirección de correo electrónico de la personaque formuló la reclamación. Utilice los encabezados X personalizados o identificadores especialesincrustados en el cuerpo de correo electrónico para que pueda identificar la dirección de correoelectrónico que presentó la reclamación. Esta técnica facilita identificar las direcciones que reclamaronpara que pueda eliminarlas de su lista de destinatarios.

Calidad del mensajeLos receptores de correo electrónico utilizan filtros de contenido para detectar determinados atributos ensus mensajes para identificar si su mensaje es legítimo. Estos filtros de contenido revisan automáticamenteel contenido de sus mensajes para identificar características comunes de mensajes no deseados omalintencionados. Amazon SES utiliza tecnologías de filtrado de contenido que ayudan a detectar ybloquear los mensajes que contienen malware antes de que se envíen.

Si los filtros de contenido de un receptor de correo electrónico determinan que su mensaje contiene lascaracterísticas de spam o correo electrónico malintencionado, su mensaje probablemente marcará ydesviará de las bandejas de entrada de los destinatarios.

Recuerde lo siguiente a la hora de diseñar su correo electrónico:

• Los filtros de contenido modernos son inteligentes, se adaptan y cambian de forma continua. No sebasan en un conjunto de reglas predefinidas. Los servicios de terceros como ReturnPath o Litmuspueden ayudar a identificar contenido en su correo electrónico que podría activar los filtros de contenido.

• Si el correo electrónico contiene enlaces, compruebe las direcciones URL de dichos enlaces en listasnegras, como las que se encuentran en URIBL.com y SURBL.org.

• Evite el uso de acortadores de enlaces. Los remitentes malintencionados podrían utilizar los acortadoresde enlaces para ocultar el destino real de un enlace. Cuando los ISP observan que se utilizan con finesperversos los servicios de acortamiento de enlaces, incluso los más reputados, podrían incluir en la listanegra dichos servicios también. Si su correo electrónico contiene un enlace a un servicio acortador deenlace en la lista negra, no llegará a las bandejas de entrada de sus clientes y el éxito de su campaña decorreo electrónico se resiente.

• Pruebe cada enlace de su correo electrónico para asegurarse de que apunte a la página deseada.

450

https://returnpath.com/

https://litmus.com/

http://uribl.com/

http://www.surbl.org/

Amazon Simple Email Service Developer GuideConsejos y prácticas recomendadas

• Asegúrese de que su sitio web incluya los documentos de Política de privacidad y Términos de uso yque dichos documentos estén actualizados. Es una buena práctica enlazar a estos documentos de cadamensaje de correo electrónico que envíe. Proporcionar enlaces a estos documentos demuestra que notiene nada que ocultar a sus clientes, lo que pueden contribuir a forjar una relación de confianza.

• Si tiene previsto enviar contenido con mucha frecuencia (como, por ejemplo, mensajes con "ofertasdiarias"), asegúrese de que el contenido de su correo electrónico sea diferente en cada implementación.Al enviar mensajes con mucha frecuencia, debe asegurarse de que los mensajes sean oportunos yrelevantes, en lugar de repetitivos y molestos.

Consejos y prácticas recomendadasIncluso cuando tenga en cuenta el mayor interés para sus clientes, es posible que encuentre situacionesque afecten a la capacidad de entrega de sus mensajes. Las siguientes secciones contienenrecomendaciones para ayudarle a garantizar que sus comunicaciones por correo electrónico lleguen a laaudiencia deseada.

Recomendaciones generales• Póngase en el lugar del cliente. Plantéese si el mensaje que está enviando es algo que desearía recibir

en su propia bandeja de entrada. Si la respuesta no es un "¡sí!" entusiasta probablemente no deberíaenviarlo.

• Algunos sectores tiene una reputación de mala calidad o incluso de prácticas de correo electrónicomalintencionadas. Si participa en los siguientes sectores, debe monitorear su reputación con atención yresolver los problemas de forma inmediata:• Hipotecas domésticas• Créditos• Productos farmacéuticos y suplementos• Alcohol y tabaco• Ocio para adultos• Casinos y juegos de azar• Programas de trabajo desde casa

Consideraciones sobre dominios y direcciones deremitente ("From")• Piense detenidamente sobre las direcciones desde las que envía correo electrónico. La dirección de

remitente ("From") es uno de los primeros elementos de información que ven sus destinatarios y, porlo tanto, pueden dejar una primera impresión duradera. Además, algunos proveedores de servicios deInternet asocian su reputación con su dirección de remitente ("From").

• Considere la posibilidad de utilizar subdominios para los distintos tipos de las comunicaciones. Porejemplo, suponga que va a enviar correo electrónico desde el dominio example.com y que desea enviartanto mensajes de marketing como de transacciones. En lugar de enviar todos sus mensajes desdeexample.com, envíe sus mensajes de marketing desde un subdominio como marketing.example.comy sus mensajes de transacciones desde un subdominio como orders.example.com. Los subdominiosúnicos desarrollan sus propias reputaciones. El uso de subdominios reduce el riesgo de dañar sureputación si, por ejemplo, las comunicaciones de marketing caen en una trampa de spam o activan unfiltro de contenido.

• Si tiene previsto enviar un gran número de mensajes, no envíe los mensajes desde una direcciónbasada en ISP como, por ejemplo, [email protected]. Si un ISP observa un gran volumen demensajes de correo electrónico procedentes de [email protected], dicho correo electrónico se trata

451

Amazon Simple Email Service Developer GuideAutenticación

de manera distinta a un correo electrónico que provenga de un dominio de envío de correo electrónicosaliente de su propiedad.

• Trabaje con su registro de dominios para garantizar que la información WHOIS de su dominio seacorrecta. Mantener un registro de WHOIS honrado y actualizado demuestra que valora la transparencia ypermite a los usuarios identificar rápidamente si su dominio es legítimo o no.

• Evite utilizar dirección no-reply como, por ejemplo, [email protected], como dirección de remitente("From") o de respuesta ("Reply-to"). Utilizando una dirección de correo electrónico no-reply@ envía asus destinatarios un mensaje claro: que no les está ofreciendo una forma de ponerse en contacto conusted y que no le interesan sus comentarios.

Autenticación• Autentique su dominio con SPF (p. 124) y SenderID. Estos métodos de autenticación confirman a los

destinatarios de correo electrónico que cada correo electrónico que envía procede realmente del dominioque dice proceder.

• Firme su correo electrónico saliente con DKIM (p. 126). Este paso confirma a los destinatarios que elcontenido no se ha cambiado en tránsito entre el emisor y el receptor.

• Puede probar su configuración de autenticación para SPF y DKIM enviando un correo electrónico a unadirección de correo electrónico basada en ISP que posea, como, por ejemplo, una cuenta personal deGmail o Hotmail y, a continuación, visualizar los encabezados del mensaje. Los encabezados indican sisus intentos de autenticar y firmar el mensaje se han realizado correctamente.

Creación y mantenimiento de sus listas• Aplicar un doble estrategia de confirmación. Cuando los usuarios se registren para recibir su correo

electrónico, envíeles un mensaje con un enlace de confirmación y no empiece a enviarles correoelectrónico hasta que confirmen su dirección de correo electrónico haciendo clic en el enlace. Unaestrategia de confirmación doble ayuda a reducir el número de rebotes permanente derivados de errorestipográficos.

• Al recopilar las direcciones de correo electrónico con un formulario basado en web, lleve a cabouna validación mínima en estas direcciones de envío una vez enviadas. Por ejemplo, asegúrese deque las direcciones que recopila estén bien formadas (es decir, que se encuentran en el [email protected]) y que hacen referencia a dominios con registros MX válidos.

• Tenga cuidado al permitir que una entrada definida por el usuario se transfiera a Amazon SES sincomprobar. Los registros en foros y los envíos de formularios presentan riesgos únicos, ya que elcontenido está completamente generado por el usuario y los spammers pueden rellenar formularioscon su propio contenido. Es responsabilidad suya asegurarse de que solo envía correo electrónico concontenido de alta calidad.

• Es muy improbable que un alias estándar (por ejemplo, postmaster@, abuse@ o noc@) se suscriba asu correo electrónico de forma intencionada. Asegúrese de que solo envía mensajes a personas realesque realmente desean recibirlos. Esta regla se da especialmente en el caso de alias estándar, que sereservan habitualmente para guardianes de correo electrónico. Estos alias se pueden añadir de formamalintencionada a su lista como forma de sabotaje, a fin de dañar la reputación.

Conformidad• Tenga en cuenta de los reglamentos y de la legislación antispam y de marketing de correo electrónico en

los países y regiones donde envía correo electrónico. Es usted responsable de garantizar que el correoelectrónico que envía cumpla con estas leyes. En esta guía no se explican estas leyes, por lo que esimportante que las investigue. Para obtener un listado de leyes, consulte Email Spam Legislation byCountry en Wikipedia.

452

https://en.wikipedia.org/wiki/Email_spam_legislation_by_country

https://en.wikipedia.org/wiki/Email_spam_legislation_by_country

Amazon Simple Email Service Developer GuideConformidad

• Consulte siempre a un abogado para obtener asesoramiento jurídico.

453

Amazon Simple Email Service Developer GuideProblemas generales

Solución de problemas de AmazonSES

Esta sección contiene los siguientes temas que podrían ayudarle cuando encuentre problemas:

• Para obtener una lista de problemas de entrega comunes que podría encontrar al enviar correoelectrónico, junto con las medidas correctivas que puede tomar, consulte Problemas de entrega deAmazon SES (p. 455).

• Para obtener una descripción de los problemas que los destinatarios podrían encontrar al recibir uncorreo electrónico que se envió a través de Amazon SES, consulte Problemas con correos electrónicosrecibidos de Amazon SES (p. 456).

• Para ver una lista de los errores que pueden producirse al enviar un correo electrónico con AmazonSES, consulte Errores de envío de correo electrónico de Amazon SES (p. 456).

• Para obtener información sobre los problemas de verificación de dominio que podría encontrarse,consulte Problemas de verificación de dirección de correo electrónico y dominios de AmazonSES (p. 458).

• Para solucionar problemas de Easy DKIM, consulte Problemas de DKIM de Amazon SES (p. 461).• Para soluciones de problemas con notificaciones de rebotes, reclamaciones y entregas, consulte

Problemas de notificación de Amazon SES (p. 462).• Para obtener información acerca de cómo eliminar una dirección de correo electrónico de la lista de

supresión, consulte Eliminación de una dirección de correo electrónico de la lista de supresión deAmazon SES (p. 462).

• Para obtener sugerencias sobre cómo aumentar la velocidad de envío de correo electrónico alrealizar varias llamadas a Amazon SES utilizando el API o la interfaz de SMTP, consulte Aumento deldesempeño con Amazon SES (p. 463).

• Para soluciones a problemas comunes que podría encontrar cuando utilice Amazon SES a travésde su interfaz de Simple Mail Transfer Protocol (SMTP), consulte Problemas de SMTP con AmazonSES (p. 464).

• Para obtener una lista de códigos de respuesta de SMTP que una aplicación cliente puede recibir deAmazon SES, consulte Códigos de respuesta del SMTP devueltos por Amazon SES. (p. 467).

• Para una lista de códigos de error devueltos por el API de consulta de Amazon SES (HTTPS), consulteCódigos de error del API devueltos por Amazon SES. (p. 401).

• Para obtener una descripción de problemas de cumplimiento comunes y cómo gestionarlos, consultePreguntas frecuentes sobre cumplimiento de Amazon SES (p. 477).

• Para obtener información sobre cómo afectan a su envío con Amazon SES las listas negras de IP,consulte Preguntas frecuentes sobre la lista negra de IP de Amazon SES (p. 493).

Si llama al API de Amazon SES directamente, consulte el Amazon Simple Email Service API Referencepara los errores de HTTP que podría recibir.

Problemas generales de Amazon SESLa información de esta página explicará y ayudará a diagnosticar los problemas que podría experimentar alutilizar Amazon SES.

454


Amazon Simple Email Service Developer GuideLos cambios que realizo no son visibles de inmediato

Los cambios que realizo no son visibles de inmediatoAl ser un servicio al que se obtiene acceso a través de equipos de centros de datos de todo el mundo,Amazon SES utiliza un modelo de computación distribuida llamado consistencia final. Cualquier cambioque realice en Amazon SES (o en otros servicios de AWS) tardará en aparecer en todos los puntos deenlace posibles. Este retraso se debe en parte al tiempo que se tarda en enviar los datos de un servidor aotro y entre regiones de todo el mundo. En la mayoría de los casos, este retraso no durará más de unosminutos.

Algunos ámbitos en los que podría observar un retraso incluyen:

• Creación y modificación de conjuntos de configuración: al crear o modificar un conjunto de configuración(por ejemplo, si se asocia un grupo de IP dedicadas con una configuración existente (p. 227)), es posibleque haya un breve retraso desde el momento en que se crea o modifica hasta el momento en que dichoscambios están activos.

• Creación y modificación de destinos de eventos: al crear o modificar un destino de evento (porejemplo, para decirle a Amazon SES que envíe su correo electrónico enviando datos a otro servicio deAWS (p. 259)), podría haber un retraso entre el momento en que crea o modifica el destino de evento yel momento en que los eventos de envío de correo electrónico llegan a su destino especificado.

Problemas de entrega de Amazon SESDespués de realizar una solicitud correcta a Amazon SES, el mensaje suele enviarse de inmediato. Enotras ocasiones, podría haber un breve retraso. En cualquier caso, puede tener la certeza de que su correoelectrónico se enviará.

Cuando Amazon SES envía su mensaje, sin embargo, diversos factores podrían impedir que se envíecorrectamente y en algunos casos sabría que ha fallado la entrega solo cuando el mensaje que envía nollega. Utilice el siguiente proceso para resolver esta situación.

Si un correo electrónico no llega, pruebe lo siguiente:

• Verifique que ha realizado una solicitud SendEmail o SendRawEmail para el correo electrónicoen cuestión y que ha recibido una respuesta correcta. (Consulte Estructura de una respuestacorrecta (p. 400) para ver un ejemplo.) Si realiza estas solicitudes mediante programación, compruebelos registros de software para asegurarse de que el programa ha realizado la solicitud y ha recibido unarespuesta correcta.

• Lea el artículo del blog Three places where your email could get delayed when sending through SES, yaque el problema podría ser en realidad un retraso en lugar de una falta de entrega.

• Compruebe la dirección de correo electrónico del remitente (la dirección del remitente "From") paracomprobar que es válida. Compruebe también la dirección Return-Path, que es donde se envíanlos mensajes de rebote. Si su correo electrónico tiene rebotes, allí encontrará un mensaje de errorexplicativo.

• Compruebe Panel de estado del servicio de AWS para confirmar que no hay un problema conocido conAmazon SES.

• Póngase en contacto con el destinatario del correo electrónico o el ISP del destinatario. Compruebeque el destinatario está utilizando la dirección de correo electrónico correcta y pregunte si ha habidoproblemas de entrega conocidos con el ISP del destinatario. Además, determine si el correo electrónicollegó pero se filtró como spam.

• Si se ha registrado en un Plan de AWS Support de pago, puede abrir un nuevo caso de soportetécnico. En su correspondencia con nosotros, le rogamos que nos envíe las direcciones de destinatariopertinentes, junto con cualquier ID de solicitud o ID de mensaje devueltos de las respuestas SendEmailo SendRawEmail.

455

https://wikipedia.org/wiki/Eventual_consistency

https://aws.amazon.com//blogs/messaging-and-targeting/three-places-where-your-email-could-get-delayed-when-sending-through-ses/

http://status.aws.amazon.com/

https://aws.amazon.com/premiumsupport/

Amazon Simple Email Service Developer GuideProblemas con correos electrónicos recibidos

• Espere a ver si el problema es en realidad un retraso, no un error de entrega permanente. Para combatirlos spammers, algunos proveedores de servicios de Internet rechazan temporalmente los mensajesentrantes de servidores de correo electrónico de envío desconocidos. Este proceso, denominadoinclusión en lista gris, puede provocar un retraso en la entrega. Amazon SES volverá intentar estosmensajes. Si la inclusión en la lista gris es el problema, el ISP podría aceptar el correo electrónico enuno de estos reintentos.

Problemas con correos electrónicos recibidos deAmazon SES

El siguiente problema puede surgir cuando un destinatario recibe un correo electrónico enviado a travésde Amazon SES. Si busca información de resolución de problemas en los que un destinatario no recibe uncorreo electrónico, consulte Problemas de entrega de Amazon SES (p. 455).

• Un cliente de correo electrónico del destinatario muestra "sent via amazonses.com" como origen delcorreo electrónico: algunos clientes de correo electrónico muestran el dominio "via" cuando el dominiodel remitente no coincide con el dominio desde el que se envió en realidad el correo electrónico (en estecaso, amazonses.com). Para obtener más información sobre los motivos, consulte esta explicación deGoogle. Como alternativa, puede configurar correo identificado con claves de dominio (DKIM), que esuna buena práctica de todas formas. Cuando autentica sus correos electrónicos con DKIM, los clientesde correo electrónico no suelen mostrar el dominio "via" porque la firma DKIM muestra que el correoelectrónico procede del dominio declarado. Para obtener información acerca de cómo configurar DKIM,consulte Autenticación de correo electrónico con DKIM en Amazon SES (p. 126).

• Su correo electrónico no se muestra correctamente en un cliente de correo electrónico del destinatario• Si su correo electrónico no contiene caracteres ASCII, debe construir el correo electrónico en formato

Multipurpose Internet Mail Extensions (MIME) y envíelo por medio del API SendRawEmail. Paraobtener más información, consulte Envío de correo electrónico sin procesar mediante el API deAmazon SES (p. 108).

• Su correo electrónico podría contener MIME con un formato incorrecto. Asegúrese de cumplir conRFC 2047. Por ejemplo, debería utilizar campos de encabezado y una codificación de cuerpo delmensaje adecuados.

• El cliente o el servidor de correo electrónico del destinatario podrían imponer limitaciones sobre elcontenido representado.

Errores de envío de correo electrónico de AmazonSES

En este tema se revisan tipos de errores específicos de envío de correo electrónico que podría encontrarseal enviar un correo electrónico a través de Amazon SES. Si intenta enviar un correo electrónico a través deAmazon SES y la llamada a Amazon SES falla, Amazon SES devuelve un mensaje de error a su aplicacióny no envía el correo electrónico. La forma en que observa este mensaje de error depende de la forma enque llama a Amazon SES.

• Si llama al API de Amazon SES directamente, la acción de consulta devolverá un error. El error podríaser MessageRejected o uno de los errores que se especifican en el tema Common Errors de laAmazon Simple Email Service API Reference.

• Si llama a Amazon SES utilizando un SDK de AWS que utilice un lenguaje de programación que admitaexcepciones, Amazon SES podría lanzar una excepción. El tipo de excepción depende del SDK y delerror. Por ejemplo, la excepción podría ser un Amazon SES MessageRejectedException (el nombre

456

https://support.google.com/mail/answer/1311182?hl=en;

https://support.google.com/mail/answer/1311182?hl=en;

http://tools.ietf.org/html/rfc2047

http://tinyurl.com/bfzl8s6

Amazon Simple Email Service Developer GuideErrores de envío de correo electrónico

real puede variar en función del SDK) o una excepción general de AWS. Independientemente del tipo deexcepción, el tipo de error y el mensaje de error de la excepción podrían darle más información.

• Si llama a Amazon SES a través de su interfaz SMTP, la forma en que experimente el error dependede la aplicación. Algunas aplicaciones podrían mostrar un mensaje de error específico, otras no. Paraver una lista de códigos de respuesta de SMTP, consulte Códigos de respuesta del SMTP devueltos porAmazon SES. (p. 467).

Note

Cuando su llamada a Amazon SES para enviar un correo electrónico devuelve un error, no se lefacturará dicho correo electrónico.

A continuación se indican los tipos de problemas específicos de Amazon SES que pueden hacer queAmazon SES devuelva un error cuando se intenta enviar un correo electrónico. Estos errores se añaden aerrores de AWS generales como MalformedQueryString tal y como se especifica en el tema CommonErrors de la Amazon Simple Email Service API Reference.

• La dirección de correo electrónico no está verificada. Las siguientes identidades no han superado lacomprobación en la región región: identidad1, identidad2, identidad3: está intentando enviar correoelectrónico desde una dirección de correo electrónico o dominio que no ha verificado con AmazonSES (p. 47). Este error podría corresponder a la dirección "From", "Source", "Sencer" o "Return-Path". Sisu cuenta sigue todavía en el entorno de pruebas de Amazon SES (p. 72), también debe verificar todaslas direcciones de correo electrónico de cada destinatario excepto los destinatarios que proporciona elsimulador de bandeja de correo de Amazon SES (p. 173). Si Amazon SES no puede mostrar todas lasidentidades fallidas, el mensaje de error termina con puntos suspensivos.

Note

Amazon SES tiene puntos de enlace en varias regiones de AWS (p. 439) y el estado deverificación de dirección de correo electrónico es independiente para cada región de AWS.Debe completar el proceso de verificación para cada remitente en las regiones de AWS quedesee utilizar.

• Cliente suspendido: se ha bloqueado el envío de correo electrónico utilizando Amazon SES de su cuentade AWS. Todavía puede acceder a la consola de Amazon SES y llevar a cabo cualquier actividad (porejemplo, puede seguir consultando sus métricas de envío y reputación), excepto el envío de correoelectrónico; si intenta enviar un correo electrónico, recibirá este mensaje de error.

Si esto ocurre, debe haber recibido un correo electrónico de Amazon SES en la dirección de correoelectrónico asociada a su cuenta de AWS que le informa del problema. Para recurrir la suspensión yrestablecer los privilegios de envío de correo electrónico, siga las instrucciones en el correo electrónico.Tendrá que explicar en detalle por qué cree que la propia suspensión ha sido un error o los cambios quehaya realizado para garantizar que no se vuelva a producir el mismo problema.

• Limitación controlada: Amazon SES está limitando la velocidad a la que puede enviar mensajes. Esposible que su aplicación esté intentando enviar demasiados correos electrónicos o enviar correoelectrónico a un ritmo demasiado rápido. En estos casos, el error podría ser similar al siguiente:• Cuota de mensajes diaria superada: ha enviado el número máximo de mensajes permitidos en un

período de 24 horas. Si ha superado su cuota diaria, tendrá que esperar hasta el próximo periodo de24 horas antes de poder enviar más mensajes.

• Ratio máximo de envío superado: está intentando enviar más correos electrónicos por segundo de loque permite su ratio máximo de envío. Si ha superado la tasa de envío, puede seguir enviando correoelectrónico, pero tendrá que reducir la tasa de envío. Para obtener más información, consulte How tohandle a "Throttling - Maximum sending rate exceeded" error en el Blog de AWS sobre mensajería yselección de destinatarios.

Debería monitorear periódicamente su actividad de envío para ver lo cerca que está de sus límitesde envío. Para obtener más información, consulte Monitoreo de sus límites de envío de Amazon

457





Amazon Simple Email Service Developer GuideProblemas de verificación

SES (p. 137). Para obtener información general sobre los límites de envío, consulte Administrar suslímites de envío de Amazon SES (p. 136). Para obtener información sobre cómo aumentar sus límites deenvío, consulte Aumento de los límites de envío de Amazon SES (p. 139).

Important

Si el texto de error que explica el error de limitación controlada no está relacionado con quesupere la cuota diaria o el ratio máximo de envío, entonces podría haber un problema en todoel sistema que está provocando una reducción de las capacidades de envío. Para obtenerinformación sobre el estado del servicio, vaya al Panel de estado del servicio de AWS.

• No se han especificado destinatarios: no se han proporcionado destinatarios.• Hay caracteres no ASCII en la dirección de correo electrónico: la cadena de la dirección de correo

electrónico debe ser ASCII de 7 bits. Si desea enviar a direcciones de correo electrónico que contengancaracteres Unicode en la parte de dominio de una dirección o bien desde ellas, debe cifrar el dominioutilizando Punycode. Punycode no se permite en la parte local de la dirección de correo electrónico(la parte delante del signo @) ni en el nombre de "remitente descriptivo". Si desea utilizar caracteresUnicode en el nombre de "remitente descriptivo", debe codificar el nombre de "remitente descriptivo"utilizando la sintaxis de palabra cifrada MIME, tal y como se describe en Envío de correo electrónico sinprocesar mediante el API de Amazon SES (p. 108). Para obtener más información acerca de Punycode,consulte RFC 3492.

• El dominio MAIL FROM no se ha verificado: Amazon SES no ha podido leer el registro MX necesariopara utilizar el dominio MAIL FROM especificado. Para obtener información sobre la edición de laconfiguración de dominio MAIL FROM personalizado para una identidad, consulte Edición de un dominioMAIL FROM con Amazon SES (p. 69).

• El conjunto de configuración no existe: en conjunto de configuración que ha especificado no existe.Un conjunto de configuración es un parámetro opcional que utiliza para publicar eventos de envío decorreo electrónico. Para obtener más información, consulte Uso del monitoreo utilizando la publicaciónde eventos de Amazon SES (p. 259).

Problemas de verificación de dirección de correoelectrónico y dominios de Amazon SES

Para verificar una dirección de correo electrónico o dominio con Amazon SES, inicia el proceso utilizandola consola de Amazon SES o bien el API de Amazon SES. Esta sección contiene información que podríaayudarle a resolver problemas con el proceso de verificación.

Problemas comunes de verificación de correoelectrónicoEl correo electrónico de verificación no llegóSi completa los procedimientos en Verificación de direcciones de correo electrónico en AmazonSES. (p. 47) pero no recibe el correo electrónico de verificación en el plazo de unos minutos, lleve a cabolas siguientes tareas de solución de problemas:

• Compruebe la carpeta de correo no deseado o spam de su cliente de correo electrónico.• Confirme que la dirección que intenta verificar es capaz de recibir correo electrónico. Envíe un correo

electrónico de prueba a la dirección que desee verificar desde una dirección de correo electrónicoindependiente.

• Consulte la lista de direcciones verificadas en la consola de Amazon SES. Confirme que no haya erroresen la dirección de correo electrónico que desea verificar.

458


http://tools.ietf.org/html/rfc3492

https://console.aws.amazon.com/ses/home#verified-senders-email:

Amazon Simple Email Service Developer GuideProblemas comunes de verificación de dominio

Problemas comunes de verificación de dominioSi intenta verificar un dominio mediante el procedimiento indicado en Verificación de dominios enAmazon SES (p. 59) y encuentra problemas, revise las causas posibles y las soluciones que aparecen acontinuación.

• Su proveedor de DNS no permite guiones bajos en nombre de registro TXT: puede omitir _amazonsesdel nombre de registro TXT.

• Desea verificar el mismo dominio varias veces y no puede tener varios registros TXT con el mismonombre: es posible que tenga que verificar su dominio más de una vez, ya que está enviando enregiones distintas o está enviando desde varias cuentas de AWS desde el mismo dominio en la mismaregión. Si su proveedor de DNS no le permite tener varios registros TXT con el mismo nombre, existendos soluciones temporales. La primera solución, si su proveedor de DNS lo permite, consiste en asignarvarios valores al registro TXT. Por ejemplo, si Amazon Route 53 administra su DNS, puede configurarvarios valores para el mismo registro TXT de la siguiente manera:1. En la consola de Route 53, elija el registro TXT _amazonses que añadió cuando verificó su dominio

en la primera región.2. En el cuadro Value, pulse Intro después del primer valor.3. Añada el valor para la región adicional y guarde el conjunto de registros.

La otra solución es que si sólo necesita verificar su dominio dos veces, puede verificarlo una vez con_amazonses TXT en el nombre de registro TXT y la otra vez puede omitir _amazonses del nombre deregistro por completo. No obstante, le recomendamos la solución anterior como práctica recomendada.

• Su dirección de correo electrónico la proporciona un servicio de correo electrónico basado en web sobreel que no tiene ningún control: no puede verificar correctamente un dominio que no sea de su propiedad.Por ejemplo, si desea enviar correo electrónico a través de Amazon SES desde una dirección deGmail, tiene que verificar que dicha dirección de correo electrónico específicamente; no puede verificargmail.com. Para obtener más información sobre la verificación de una dirección de correo electrónicoindividual, consulte Verificación de direcciones de correo electrónico en Amazon SES. (p. 47).

• Amazon SES notifica que la verificación de dominio ha fallado: recibe un correo electrónico de "Errorde verificación de dominio" de Amazon SES y el dominio indica un estado con "error" en la pestañaDomains de la consola de Amazon SES. Esto significa que Amazon SES no puede encontrar elregistro TXT necesario en su servidor de DNS. Verifique que el registro TXT necesario esté publicadocorrectamente en su servidor DNS utilizando el procedimiento de Cómo comprobar la configuración de laverificación de dominios (p. 460) y busque los siguientes errores posibles:• Su proveedor DNS adjuntó el nombre de dominio al final del registro TXT: añadir un registro TXT que

ya contiene el nombre de dominio (como, por ejemplo, _amazonses.example.com) podría dar lugar ala duplicación del nombre de dominio (como, por ejemplo, _amazonses.example.com.example.com).Para evitar la duplicación del nombre de dominio, añada un punto al final del nombre de dominio en elregistro TXT. Esto indicará a su proveedor de DNS que el nombre de registro es completo (es decir, yano está relacionado con el nombre de dominio) y evitará que el proveedor de DNS anexe un nombrede dominio adicional.

• Recibe un correo electrónico de Amazon SES que indica que su verificación de dominio se ha revocado(o se revocará): Amazon SES ya no puede encontrar el registro TXT necesario en su servidor de DNS.El correo electrónico de notificación le informará de la duración en la que debe volver a publicar elregistro TXT antes de que se revoque el estado de verificación del dominio.

Note

Puede revisar la información de registro TXT necesaria en la consola de Amazon SESutilizando las siguientes instrucciones. En el panel de navegación, en Identities, elija Domains.En la lista de dominios, elija (no solo amplíe) el dominio para mostrar la configuración deverificación del dominio, que incluye el nombre de registro TXT y su valor.

459

Amazon Simple Email Service Developer GuideCómo comprobar la configuración

de la verificación de dominios

Si se revoca su estado de verificación de dominio, debe reiniciar el procedimiento de verificación enVerificación de dominios en Amazon SES (p. 59) desde el principio, de igual modo que si el dominiorevocado fuera un dominio completamente nuevo. Después de publicar el registro TXT en su servidorDNS, verifique que el registro TXT esté correctamente publicado utilizando Cómo comprobar laconfiguración de la verificación de dominios (p. 460).

Cómo comprobar la configuración de la verificación dedominiosPuede comprobar que su registro TXT de verificación del dominio de Amazon SES se publiquecorrectamente en su servidor DNS utilizando el siguiente procedimiento. Este procedimiento utiliza laherramienta nslookup, que está disponible para Windows y Linux. En Linux, también puede utilizar dig.

Los comandos de estas instrucciones se ejecutaron en Windows 7 y el dominio de ejemplo que utilizamoses ses-example.com ejemplo.

En este procedimiento, primero encuentre los servidores de DNS que sirven a su dominio y, acontinuación, consulte los servidores para ver los registros TXT. Usted consulta los servidores DNS quesirven a su dominio porque dichos servidores contienen la información más actualizada para su dominio,que puede tardar tiempo en propagarse a otros servidores de DNS.

Para verificar que su registro TXT de verificación de dominio se publica en su servidor DNS

1. Encuentre los servidores de nombres de su dominio siguiendo estos pasos.

a. Vaya a la línea de comando. Para acceder a la línea de comando en Windows 7, elija Start y, acontinuación, escriba cmd. En los sistemas operativos basados en Linux, abra una ventana determinal.

b. En el símbolo del sistema, escriba lo siguiente, donde <domain> es su dominio. Esto mostrará unlistado de todos los nombres de servidor que sirven a su dominio.

nslookup -type=NS <domain>

Si su dominio fuera ses-example.com, este comando tendría el siguiente aspecto:

nslookup -type=NS ses-example.com

La salida del comando enumerará los servidores de nombre que sirven a su dominio. Consultaráa uno de estos servidores en el siguiente paso.

2. Verifique que el registro TXT se ha publicado correctamente siguiendo estos pasos.

a. En el símbolo del sistema, escriba lo siguiente, donde <domain> es su dominio y <name server>es uno de los servidores de nombres que encontró en el paso 1.

nslookup -type=TXT _amazonses.<domain> <name server>

En nuestro ejemplo ses-example.com, si un servidor de nombres que encontramos en el paso 1se llamara ns1.name-server.net, escribiríamos lo siguiente:

nslookup -type=TXT _amazonses.ses-example.com ns1.name-server.net

b. En la salida del comando, verifique que la cadena que sigue a text = coincide con el valor TXTque ve a la hora de elegir el dominio en la lista de las identidades de la consola de Amazon SES.

460

http://en.wikipedia.org/wiki/Nslookup

http://en.wikipedia.org/wiki/Dig_(command)

Amazon Simple Email Service Developer GuideProblemas de DKIM

En nuestro ejemplo, estamos buscando un registro TXT en _amazonses.ses-example.com con unvalor de fmxqxT/icOYx4aA/bEUrDPMeax9/s3frblS+niixmqk=. Si el registro está publicadocorrectamente, esperaríamos que el comando tuviera la siguiente salida:

_amazonses.ses-example.com text = "fmxqxT/icOYx4aA/bEUrDPMeax9/s3frblS+niixmqk="

Problemas de DKIM de Amazon SESSi intenta configurar Easy DKIM mediante el procedimiento indicado en Easy DKIM en AmazonSES (p. 126) y encuentra problemas, revise las causas posibles y las soluciones que aparecen acontinuación.

• Puede configurar Easy DKIM de forma satisfactoria, pero sus mensajes no llevan la firma de DKIM: losposibles problemas son:• Asegúrese de que Easy DKIM esté habilitado para la identidad correcta. Para habilitar Easy DKIM

para una identidad en la consola de Amazon SES, elija una dirección de correo electrónico o dominioen la lista de las identidades. En la página de detalles de la dirección de correo electrónico o dominio,expanda DKIM y, a continuación, elija Enable para habilitar DKIM.

• Podría enviar desde una dirección de correo electrónico verificada individualmente que no tengahabilitada la firma de DKIM. Si configura Easy DKIM para un dominio, se aplicará a todas lasdirecciones de correo electrónico en dicho dominio excepto para las direcciones de correo electrónicoque haya verificado individualmente. Las direcciones de correo electrónico verificadas individualmenteutilizan ajustes independientes. Si este es el problema, elimine la dirección de correo electrónico desu lista de identidad (su configuración se heredará de la configuración del dominio verificado) o bienhabilite Easy DKIM para la dirección de correo electrónico tal como se ha explicado con anterioridad.

• Si utiliza Amazon SES en varias regiones o con varias cuentas de AWS, deberá realizar elprocedimiento de configuración Easy DKIM descrito en Easy DKIM en Amazon SES (p. 126) paracada región y cuenta para la que desea utilizar Easy DKIM. Amazon SES generará un conjunto únicode registros de DNS para cada combinación de dominio/cuenta/región. Tendrá que añadir todos estosregistros al servidor DNS. Si elimina los registros DNS necesarios para una región o cuenta específica,Amazon SES deshabilitará la firma de DKIM solo para esa cuenta en dicha región y le avisaremos porcorreo electrónico para que pueda tomar medidas.

• Los detalles de DKIM de su dominio en la consola de Amazon SES muestran DKIM: waiting on senderverification... DKIM Verification Status: pending verification: su estado de DKIM está pendiente, lo quesignifica que Amazon SES no ha detectado aún los registros de CNAME requeridos en su servidor deDNS, que debería haber publicado durante el procedimiento de configuración de Easy DKIM (Easy DKIMen Amazon SES (p. 126)). Si su estado de DKIM es pendiente, consulte los siguientes artículos en elblog de Blog de AWS sobre mensajería y selección de destinatarios:• DKIM Troubleshooting Series: Your DKIM Status is Pending• DKIM Troubleshooting Series: Your DKIM Status is Still Pending

• Cuando se consulta, sus servidores de DNS devuelven correctamente los registros CNAME de DKIMde Amazon SES, pero devuelven SERVFAIL para los registros TXT: su proveedor de DNS podríatener problemas a la hora de redirigir registros CNAME. Tenga en cuenta que Amazon SES y los ISPconsultan registros TXT. Para cumplir con la especificación de DKIM, sus servidores de DNS deben sercapaces de responder a las consultas de registros TXT, así como a consultas de registros CNAME. Sisu proveedor de DNS no puede responder a las consultas de registros TXT, una alternativa consiste enutilizar Amazon Route 53 para su alojamiento DNS.

• Sus correos electrónicos tienen firma DKIM, pero la firma de DKIM no realiza la validación: consulte DKIM Troubleshooting Series: Why is My Signature Not Validating? en el Blog de AWS sobre mensajeríay selección de destinatarios.

• Recibe un correo electrónico de Amazon SES que indica que su configuración de DKIM se ha revocado(o se revocará): esto significa que Amazon SES ya no puede encontrar los registros CNAME necesarios

461

https://aws.amazon.com//blogs/messaging-and-targeting/dkim-troubleshooting-series-your-dkim-status-is-pending/

https://aws.amazon.com//blogs/messaging-and-targeting/dkim-troubleshooting-series-your-dkim-status-is-still-pending/

https://aws.amazon.com//blogs/messaging-and-targeting/dkim-troubleshooting-series-why-is-my-signature-not-validating/

https://aws.amazon.com//blogs/messaging-and-targeting/dkim-troubleshooting-series-why-is-my-signature-not-validating/

Amazon Simple Email Service Developer GuideProblemas de notificación

en su servidor de DNS. El correo electrónico de notificación le informará de la duración en la que debevolver a publicar los registros CNAME antes de que se revoque el estado de configuración de DKIM yse deshabilite la firma DKIM. Si su configuración de DKIM se revoca, debe reiniciar el procedimiento deconfiguración de DKIM Easy DKIM en Amazon SES (p. 126) desde el principio.

• No tiene habilitada la firma de DKIM, aunque sus encabezados de mensaje contienen una firma DKIM: lafirma de DKIM que ve contiene d = amazonses.com y la añadirá Amazon SES automáticamente.

• Los correos electrónicos contienen dos firmas DKIM: la firma DKIM adicional, que contiene d =amazonses.com, la añadirá Amazon SES automáticamente. Puede omitirla.

Problemas de notificación de Amazon SESSi tiene un problema con las notificaciones de rebotes, reclamaciones o notificaciones, revise las posiblescausas y soluciones que aparecen a continuación.

• Recibe notificaciones de rebotes a través de Amazon SNS, pero no sabe a qué destinatarioscorresponden las notificaciones: en el futuro, para asociar una notificación de rebote con un determinadodestinatario, dispone de las siguientes opciones:• Habida cuenta de que Amazon SES no mantiene ID de mensajes personalizados que haya añadido,

almacene una correspondencia entre un identificador y el ID de mensaje de Amazon SES que AmazonSES transfiera de vuelta cuando se acepta el correo electrónico.

• En cada llamada a Amazon SES, envíe a un único destinatario, en lugar de enviar un único mensaje avarios destinatarios.

• Puede habilitar el reenvío de retroalimentación por correo electrónico, que le reenviará el mensaje derebote completo.

• Puede recibir notificaciones de reclamaciones a través Amazon SNS o reenvío de retroalimentaciónpor correo electrónico, pero no sabe a qué destinatarios corresponden las notificaciones: algunosISP redactan la dirección de correo electrónico del destinatario que ha reclamado antes de transferirla notificación de reclamación notificación a Amazon SES. Para permitirle encontrar la dirección decorreo electrónico del destinatario, la mejor opción consiste en almacenar su propia asignación entreun identificador y el ID de mensaje de Amazon SES que Amazon SES le transfiere cuando se acepta elcorreo electrónico. Tenga en cuenta que Amazon SES no mantiene ningún ID de mensaje personalizadoque añada.

• Desea configurar notificaciones para ir a un tema de Amazon SNS que no es de su propiedad: elpropietario de dicho tema debe configurar una política de acceso de Amazon SNS que permita a sucuenta llamar a la acción SNS:Publish de su tema. Para obtener información sobre cómo controlar elacceso a su tema de Amazon SNS a través del uso de políticas de IAM, consulte Managing Access toYour Amazon SNS Topics en la Guía para desarrolladores de Amazon Simple Notification Service.

Eliminación de una dirección de correo electrónicode la lista de supresión de Amazon SES

Amazon SES mantiene una lista de supresión de direcciones de correo electrónico de remitentes que hanprovocado un rebote permanente recientemente para cualquier cliente de Amazon SES. Si intenta enviarun correo electrónico a través de Amazon SES a una dirección incluida en la lista de supresión, la llamadaa Amazon SES tendrá éxito, pero Amazon SES tratará el correo como rebote permanente en lugar deintentar enviarlo. Al igual que con el rebote permanente, las devoluciones de la lista de supresión se tienenen cuenta en la cuota de envío y en la tasa de mensajes devueltos. Una dirección de correo electrónicopuede permanecer en la lista de supresión un máximo de 14 días.

462



Amazon Simple Email Service Developer GuideAumento del desempeño

La única forma de saber si una dirección está en la lista de supresión es que recibirá un rebote de listade supresión cuando envíe a la misma. No existe la posibilidad de consultar la lista de supresión deantemano.

Important

Al igual que en el caso de una dirección de correo electrónico con rebote permanente, debeeliminar las direcciones que provocan un rebote de lista de supresión de su lista de correo amenos que esté absolutamente seguro de la dirección es válida, ya que los rebotes de la lista desupresión se contabilizan en su tasa de rebotes y una tasa de rebotes elevada supone un riesgode cierre de su cuenta. Si elimina una dirección de la lista de supresión cuando no hay duda deque no se puede entregar, entonces la próxima vez que u otro cliente de Amazon SES envíe uncorreo electrónico a esa dirección, devolverá un rebote permanente y la dirección volverá a la listade supresión.

Si está seguro de que una dirección de la lista de supresión es válida, puede eliminarla de la lista utilizandoel siguiente procedimiento. Aunque cada región de AWS tiene una lista de supresión independiente, sisuprime una dirección de la lista de supresión de una región, la dirección se elimina de la lista de supresiónde todas las regiones.

Para eliminar una dirección de correo electrónico de la lista de supresión


2. En el panel de navegación, elija Suppression List Removal.3. En el campo Email Address, escriba la dirección de correo electrónico que desea quitar de la lista de

supresión.4. En el campo Type characters, escriba los caracteres que ve en la imagen de arriba.5. Elija Enviar.

Después de enviar el formulario, puede rellenar el formulario para otra dirección de correo electrónico. Lassolicitudes de eliminación de la lista de supresión se procesan de inmediato.

Aumento del desempeño con Amazon SESAl enviar correos electrónicos, puede llamar Amazon SES con la frecuencia que permita su ratio máximode envío. (Para obtener más información sobre el ratio máximo de envío, consulte Administrar suslímites de envío de Amazon SES (p. 136)). Sin embargo, cada llamada a Amazon SES tarda tiempo encompletarse.

Si realiza varias llamadas a Amazon SES utilizando el API de Amazon SES o la interfaz de SMTP, esposible que desee plantearse los siguientes consejos para mejorar su desempeño:

• Mida el desempeño actual para identificar cuellos de botella: una posible prueba de desempeño implicael envío de varios correos electrónicos de prueba lo más rápidamente posible dentro de un bucle decódigo en su aplicación. Mida la latencia de ida y vuelta de cada solicitud SendEmail. A continuación,lance gradualmente instancias adicionales de la aplicación en la misma máquina y analice el impacto enla latencia de red. Es posible que también desee ejecutar esta prueba en varias máquinas y en distintasredes para ayudar a identificar los posibles cuellos de botella en los recursos de las máquinas o loscuellos de botella de red que puedan existir.

• (Solo API) Plantéese utilizar conexiones HTTP persistentes: en lugar de incurrir en los costos quesupone establecer una nueva conexión HTTP independiente para cada solicitud del API, utilicelas conexiones HTTP persistentes. Es decir, vuelva a utilizar la misma conexión HTTP para variassolicitudes de API.

463



Amazon Simple Email Service Developer GuideProblemas con las SMTP

• Considere la posibilidad de utilizar varios subprocesos: cuando una aplicación utiliza un único hilo, elcódigo de aplicación llama al API de Amazon SES y, a continuación, espera de forma sincrónica unarespuesta del API. El envío de correos electrónicos suele ser una operación vinculada a E/S y realizarel trabajo desde varios subprocesos ofrece un mejor desempeño. Puede enviar de forma simultáneautilizando tantos subprocesos de ejecución como desee.

• Considere la posibilidad de utilizar varios procesos: el uso de varios procesos puede contribuir aaumentar el desempeño, ya que tendrá más conexiones activas simultáneas para Amazon SES. Porejemplo, puede segmentar sus correos electrónicos previstos en varios buckets y, a continuación,ejecutar varias instancias de su script de envío de correo electrónico simultáneamente.

• Plantéese la posibilidad de utilizar un relé de correo local: su aplicación puede transmitir mensajesrápidamente a su servidor de correo local, lo que puede contribuir a almacenar los mensajes en elbúfer y a transmitirlos de forma asíncrona a Amazon SES. Algunos servidores de correo admiten lasimultaneidad de entrega, lo que significa que incluso aunque la aplicación esté generando correoselectrónicos para el servidor de correo en un solo subproceso, el servidor de correo utilizará variossubprocesos al enviar a Amazon SES. Para obtener más información, consulte Integración de AmazonSES con su servidor de correo electrónico existente (p. 87).

• Plantéese alojar su aplicación más cerca del punto de enlace del API de Amazon SES: es posible quedesee plantearse el alojamiento en un centro de datos próximo al punto de enlace del API de AmazonSES o una instancia de Amazon EC2 en la misma región de AWS que el punto de enlace del API deAmazon SES. Esto podría ayudar a reducir la latencia de red entre su aplicación y Amazon SES ymejorar el desempeño. Para obtener una lista de puntos de enlace de Amazon SES, consulte Regionesy Amazon SES (p. 439).

• Plantéese la posibilidad de utilizar varias máquinas: en función de la configuración en su equipo host, esposible que haya un límite en el número de conexiones HTTP simultáneas a una única dirección IP, quepodría limitar los beneficios del paralelismo, una vez se supera un determinado número de conexionessimultáneas en una única máquina. Si se trata de un cuello de botella, es posible que desee realizarsolicitudes de Amazon SES simultáneas utilizando varias máquinas.

• Plantéese la posibilidad de utilizar el API de consulta de Amazon SES en lugar del punto de enlacede SMTP: el uso del API de consulta de Amazon SES le permite enviar la solicitud de envío de correoelectrónico a través de una única llamada de red, mientras que interactuar con el punto de enlace deSMTP implica una conversación de SMTP que consta de varias solicitudes de red (por ejemplo, EHLO,MAIL FROM, RCPT TO, DATA, QUIT). Para obtener más información acerca del API de consulta deAmazon SES consulte Uso del API de Amazon SES para enviar correo electrónico (p. 107).

• Utilice el simulador de bandeja de correo de Amazon SES para probar su desempeño máximo: paraprobar cualquier cambio que pueda implementar, puede utilizar el simulador de bandeja de correo. Elsimulador de bandeja de correo puede ayudarle a determinar el desempeño máximo del sistema singastar su cuota de envío diaria. Para obtener información sobre el simulador de bandeja de correo,consulte Probar el envío de correo electrónico en Amazon SES (p. 173).

Si va a acceder a Amazon SES a través de su interfaz de SMTP, consulte Problemas de SMTP conAmazon SES (p. 464) para ver problemas específicos relacionados con SMTP que puedan afectar alrendimiento.

Problemas de SMTP con Amazon SESSi está teniendo problemas para enviar correo electrónico a través de la interfaz de Simple Mail TransferProtocol (SMTP) de Amazon SES, revise las posibles causas y soluciones que aparecen a continuación.Para obtener información general acerca del envío de correo electrónico mediante la interfaz SMTP deAmazon SES, consulte Uso de la interfaz de SMTP de Amazon SES para enviar correo electrónico (p. 74).

• No puede conectarse al punto de enlace de SMTP de Amazon SES.

Los problemas para conectarse al punto de enlace SMTP de Amazon SES suelen estar relacionadoscon los siguientes errores:

464


• Credenciales incorrectas: las credenciales que usa para conectarse al punto de enlace SMTP sondiferentes de sus credenciales de AWS. Para conseguir sus credenciales de SMTP, consulte Obtenersus credenciales de SMTP de Amazon SES (p. 75). Para obtener más información acerca de lascredenciales, consulte Uso de credenciales con Amazon SES (p. 393).

• Problemas de red o del firewall: su red puede bloquear las conexiones salientes a través del puertodesde el que está intentando enviar correo electrónico. Para determinar si un problema en la redlocal está causando problemas de conexión, escriba el siguiente comando en la línea de comandos,sustituyendo port por el puerto que intenta utilizar (normalmente, 25, 465, 587, 2465 o 2587):telnet email-smtp.us-west-2.amazonaws.com port

Si puede conectarse al servidor SMTP a través de este comando, e intenta conectarse a Amazon SESmediante TLS Wrapper o STARTTLS, realice los procedimientos que se muestran en Uso de la líneade comandos para enviar correo electrónico a través de la interfaz de SMTP de Amazon SES (p. 102).

Si no puede conectarse al punto de enlace SMTP de Amazon SES con telnet u openssl, esto indicaque hay algo en su red (por ejemplo, un firewall) que bloquea las conexiones salientes en el puertoque está intentando utilizar. Trabaje con el administrador de red para diagnosticar y corregir elproblema.

• Está enviando correo a Amazon SES desde una instancia Amazon EC2 a través del puerto 25 y no tieneacceso a sus límites de envío de Amazon SES o se agota el tiempo de espera.

Amazon EC2 impone límites de envío predeterminados en el correo electrónico enviado a través delpuerto 25 y limita las conexiones salientes si intenta superar esos límites. Para eliminar estos límites,envíe un Solicitud de Amazon EC2 para eliminar las limitaciones de envío de emails. También puedeconectarse a Amazon SES a través de los puertos 465 o 587, ninguno de los cuales está limitado.

• Se borran los mensajes de correo electrónico debido a errores de red.

Asegúrese de que su aplicación utilice la lógica de reintentos cuando se conecta al punto de enlaceSMTP de Amazon SES y que su aplicación pueda detectar y reintentar la entrega de mensajes en casode error de red. SMTP es un protocolo detallado y el envío de un correo electrónico a través de esteprotocolo requiere varios viajes de red de ida y vuelta. Debido a la naturaleza de SMTP, el potencial delos errores de red aumenta.

• Ha perdido la conexión con el punto de enlace de SMTP.

Las conexiones perdidas se deben generalmente a los siguientes problemas:• Tamaño de MTU: si recibe un mensaje de error de tiempo de espera superado, el tamaño de la unidad

de transmisión máxima (MTU) de la interfaz de red del equipo que utilice para conectarse SMTP deAmazon SES podría ser demasiado grande. Para solucionar este problema, establezca el tamaño deMTU en ese equipo en 1 500 bytes.

Para obtener más información sobre cómo definir el tamaño de MTU en los sistemas operativosMicrosoft Windows, Linux y macOS, consulte Falta de respuesta de las consultas y pérdidas deconsultas antes de llegar al clúster en la Amazon Redshift Cluster Management Guide.

Para obtener más información sobre la configuración del tamaño de MTU para una instancia AmazonEC2, consulte Unidad de transmisión máxima (MTU) de red de la instancia EC2 en la Guía delusuario de Amazon EC2 para instancias de Linux.

• Conexiones de larga duración: el punto de enlace SMTP de Amazon SES se ejecuta en una flota deinstancias Amazon EC2 detrás de un Elastic Load Balancer (ELB). A fin de garantizar que el sistemaestá actualizado y tolerantes a errores, las instancias Amazon EC2 activas se terminan de formaperiódica y se reemplazan por nuevas instancias. Dado que su aplicación se conecta a una instanciaAmazon EC2 a través del ELB, la conexión deja de ser válida cuando la instancia Amazon EC2 setermina. Debe establecer una nueva conexión SMTP después de haber entregado un número fijo demensajes por medio de una única conexión SMTP o si la conexión SMTP ha estado activa durantecierto período de tiempo. Tendrá que experimentar para buscar umbrales adecuados en función dedónde se aloja la aplicación y cómo envía correo electrónico a Amazon SES.

465


https://docs.aws.amazon.com/redshift/latest/mgmt/connecting-drop-issues.html

https://docs.aws.amazon.com/redshift/latest/mgmt/connecting-drop-issues.html

https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/network_mtu.html


• Le convendrá conocer las direcciones IP de los servidores de correo SMTP de Amazon SES para poderañadir a una lista blanca dichas direcciones.

Las direcciones IP de los puntos de enlace SMTP de Amazon SES están detrás de balanceadores decarga y las direcciones IP cambian con frecuencia. Por este motivo, no podemos proporcionar una listadefinitiva de direcciones IP para los puntos de enlace de Amazon SES. Le recomendamos que soloincluya en la lista blanca en función de DNS y no de direcciones IP estáticas.

• Está integrando Amazon SES con Sendmail o Postfix y su servidor no se puede autenticar porque elnombre de host no coincide.

Si ha realizado los procedimientos de Integración de Amazon SES con su servidor de correo electrónicoexistente (p. 87), pero recibe un error de autenticación en el que se indica que el nombre de host nocoincide, realice los pasos de solución de problemas correspondientes a su servidor de correo:• Si utiliza Sendmail: una vez completado el paso 2 de Integración de Amazon SES con

Sendmail (p. 91), añada una de las siguientes líneas a /etc/mail/authinfo, reemplazandoUSERNAME y PASSWORD por su nombre de usuario y contraseña de SMTP.

Región Contenido para añadir

US East (N. Virginia) AuthInfo:ses-smtp-prod-335357831.us-east-1.elb.amazonaws.com "U:root""I:USERNAME" "P:PASSWORD" "M:LOGIN"

EE.UU. Oeste (Oregón) AuthInfo:ses-smtp-us-west-2-prod-14896026.us-west-2.elb.amazonaws.com "U:root""I:USERNAME" "P:PASSWORD" "M:LOGIN"

UE (Irlanda) AuthInfo:ses-smtp-eu-west-1-prod-345515633.eu-west-1.elb.amazonaws.com "U:root""I:USERNAME" "P:PASSWORD" "M:LOGIN"

Después de completar el paso 5 de Integración de Amazon SES con Sendmail (p. 91), añada una delas siguientes líneas a /etc/mail/access:


US East (N. Virginia) Connect:ses-smtp-prod-335357831.us-east-1.elb.amazonaws.com RELAY

EE.UU. Oeste (Oregón) Connect:ses-smtp-us-west-2-prod-14896026.us-west-2.elb.amazonaws.com RELAY

UE (Irlanda) Connect:ses-smtp-eu-west-1-prod-345515633.eu-west-1.elb.amazonaws.com RELAY

• Si utiliza Postfix: en la parte 2 de Integración de Amazon SES con Postfix (p. 88), antes de cifrarel archivo, añada una de las siguientes líneas a /etc/postfix/sasl_passwd, reemplazandoUSERNAME y PASSWORD por su nombre de usuario y contraseña de SMTP.

466

Amazon Simple Email Service Developer GuideCódigos de respuesta de SMTP


US East (N. Virginia) ses-smtp-prod-335357831.us-east-1.elb.amazonaws.com:25USERNAME:PASSWORD

EE.UU. Oeste (Oregón) ses-smtp-us-west-2-prod-14896026.us-west-2.elb.amazonaws.com:25USERNAME:PASSWORD

UE (Irlanda) ses-smtp-eu-west-1-prod-345515633.eu-west-1.elb.amazonaws.com:25USERNAME:PASSWORD

Códigos de respuesta del SMTP devueltos porAmazon SES.

Este tema contiene una lista de códigos de respuesta de SMTP devueltos por el Amazon SES. El modo enque se gestionan estos errores depende del cliente SMTP que utilice; algunos clientes de SMTP podríanno mostrar ningún código de error.

Debe volver a intentar las solicitudes SMTP que reciban errores 4xx. En este caso, para reducir laprobabilidad de generar duplicados, le recomendamos que aplique un método de reintento exponencialcon espera progresivamente más largas (5, 10 y 30 segundos) entre tiempos de espera consecutivos. Si latercera llamada de reintentos no se realiza correctamente, realice otro conjunto de reintentos transcurridos20 minutos. Para ver un ejemplo de implementación que utilice una política de reintentos exponencial conAmazon SES, consulte How to handle a "Throttling - Maximum sending rate exceeded" error en el blog deAmazon SES.

Note

Los SDK de AWS implementan la lógica de reintentos automáticamente, aunque utilizan lainterfaz de HTTPS en lugar de SMTP.

Los errores de cliente de SMTP (5xx) indican que es preciso revisar la solicitud para corregir el problemaantes de reintentarla. Por ejemplo, si sus credenciales de autenticación de AWS no son válidos, debeactualizar su configuración para utilizar las credenciales adecuadas antes de volver a intentar enviar elcorreo electrónico.

Descripción Código de respuesta Más información

Autenticación correcta 235 Authentication successful N/D

Entrega satisfactoria 250 Ok <ID de mensaje> <ID de mensaje> es una cadenade caracteres que utiliza AmazonSES para identificar un mensaje deforma única.

Cuota de envío diariasuperada

454 Throttling failure: Dailymessage quota exceeded

Ha superado el número máximode mensajes de correo electrónicoque le permite enviar Amazon SESen un periodo de 24 horas. Paraobtener más información, consulte

467


https://docs.aws.amazon.com/general/latest/gr/api-retries.html


Descripción Código de respuesta Más informaciónAdministrar sus límites de envío deAmazon SES (p. 136).

Ratio máximo de envíosuperada

454 Throttling failure: Maximumsending rate exceeded

Ha superado el número máximode mensajes de correo electrónicoque le permite enviar Amazon SESpor segundo. Para obtener másinformación, consulte Administrarsus límites de envío de AmazonSES (p. 136).

Problema de Amazon SESal validar las credenciales deSMTP

454 Temporary authenticationfailure

Entre los posibles motivos seincluyen, entre otros:

• Hay un problema con el cifradoentre su aplicación de envío decorreo electrónico y AmazonSES. Tenga en cuenta que tieneque utilizar una conexión cifradaal conectarse a Amazon SES.Para obtener más información,consulte Conexión al punto deenlace de SMTP de AmazonSES (p. 80).

• Amazon SES podríaexperimentar un problema.Compruebe Panel de estado delservicio de AWS en busca deactualizaciones.

Problema al recibir lasolicitud

454 Temporary service failure Amazon SES no ha recibidocorrectamente la solicitud y, por lotanto, no envió el mensaje. Vuelvaa intentar la solicitud.

Credenciales incorrectas 530 Authentication required Su aplicación de envío de correoelectrónico no intentó autenticarsecon Amazon SES cuando intentóconectarse a la interfaz de SMTPde Amazon SES. Si desea verun ejemplo de cómo configuraruna aplicación de envío decorreo electrónico para autenticarcon Amazon SES, consulteConfiguración de clientes de correoelectrónico para enviar a través deAmazon SES (p. 81).

468





Credenciales deautenticación no válidas

535 Authentication CredentialsInvalid

Su aplicación de envío de correoelectrónico no proporcionócredenciales de SMTP correctaspara Amazon SES. Tenga encuenta que sus credenciales deSMTP no son las mismas quesus credenciales de AWS. Paraobtener más información, consulteObtener sus credenciales de SMTPde Amazon SES (p. 75).

Cuenta no suscrita aAmazon SES

535 Account not subscribed to SES La cuenta de AWS propietaria delas credenciales de SMTP no estáinscrita en Amazon SES.

Usuario no autorizado allamar al punto de enlace deSMTP de Amazon SES

554 Access denied: User <ARNde usuario> is not authorized toperform ses:SendRawEmail onresource <ARN de identidad>

La política de AWS Identity andAccess Management (IAM) o lapolítica de autorización de envíode Amazon SES del usuario queposee las credenciales SMTPno tiene permiso para llamaral punto de enlace de SMTPde Amazon SES. Para obtenerinformación sobre cómo obtenerlas credenciales de SMTP para unusuario de IAM existente, consulteObtención de las credencialesde SMTP de Amazon SESconvirtiendo las credenciales deAWS (p. 77).

469



Dirección de correoelectrónico sin verificar

554 Message rejected: Emailaddress is not verified. Lassiguientes identidades no hansuperado la comprobación enla región <region>: <identity1>,<identity2>, <identity3>

Estás intentando enviar correoelectrónico desde una direcciónde correo electrónico o dominioque no ha verificado con AmazonSES (p. 47). Este error podríacorresponder a la dirección"From", "Source", "Sencer" o"Return-Path". Si su cuenta siguetodavía en el entorno de pruebas,también debe verificar todas lasdirecciones de correo electrónicode cada destinatario excepto losdestinatarios que proporciona elsimulador de bandeja de correode Amazon SES (p. 173). SiAmazon SES no puede mostrartodas las identidades fallidas,el mensaje de error termina conpuntos suspensivos.

Note

Amazon SES tiene puntosde enlace en variasregiones de AWS (p. 439)y el estado de verificaciónde dirección decorreo electrónico esindependiente para cadaregión de AWS. Debecompletar el proceso deverificación para cadaremitente en las regionesde AWS que deseeutilizar.

470

Amazon Simple Email Service Developer GuideEliminar datos acerca del correo electrónico enviado

Eliminación de datos personales deAmazon SES

En función de cómo lo utilice, Amazon SES podría almacenar determinados datos que podríanconsiderarse personales. Por ejemplo, para enviar correo electrónico a través de Amazon SES, debeproporcionar al menos una identidad verificada (una dirección de correo electrónico o un dominio). Puedeutilizar la consola de Amazon SES o la API de Amazon SES para eliminar de forma permanente estosdatos personales.

Este capítulo proporciona procedimientos para eliminar diversos tipos de datos que podrían considerarsepersonales.

Temas• Eliminar datos acerca del correo electrónico enviado utilizando Amazon SES (p. 471)• Eliminar datos sobre identidades (p. 472)• Eliminar datos de autenticación de remitente (p. 473)• Eliminar datos relacionados con las reglas de recepción (p. 473)• Eliminar datos relacionados con filtros de dirección IP (p. 474)• Eliminar datos en plantillas de correo electrónico (p. 475)• Eliminación de datos en plantillas de correo electrónico de verificación personalizadas (p. 475)• Eliminar todos los datos personales cerrando su cuenta de AWS (p. 475)

Eliminar datos acerca del correo electrónicoenviado utilizando Amazon SES

Cuando se utiliza Amazon SES para enviar un correo electrónico, puede enviar información sobre dichocorreo electrónico a otros servicios de AWS. Por ejemplo, puede enviar información acerca de eventos decorreo electrónico (como entregas, aperturas y clics) para Kinesis Data Firehose. Estos datos de eventonormalmente contienen su dirección de correo electrónico y la dirección IP del correo electrónico desde elque se envió. También contienen las direcciones de correo electrónico de todos los destinatarios a los quese envió el correo electrónico.

Puede utilizar Kinesis Data Firehose para transmitir datos de eventos de correo electrónico a variosdestinos, incluidos Amazon Simple Storage Service Amazon Elasticsearch Service y Amazon Redshift.Para eliminar estos datos, en primer lugar debe dejar de transmitir datos a Kinesis Data Firehose y, acontinuación, eliminar los datos que ya se han transmitido. Para dejar de transmitir datos de eventos deAmazon SES a Kinesis Data Firehose, debe eliminar el destino de evento de Kinesis Data Firehose.

Para quitar un destino de evento de Kinesis Data Firehose utilizando la consola de Amazon SES

1. Abra la consola de Amazon SES en https://console.aws.amazon.com/ses/.2. En Email Sending (Envío de correo electrónico), elija Configuration Sets (Conjuntos de configuración).3. En la lista de conjuntos de configuración, elija el conjunto de configuración que contenga el destino de

evento de Kinesis Data Firehose.4. Junto al destino de evento de Kinesis Data Firehose que desee eliminar, seleccione el botón delete

(eliminar) ( ).5. Si es necesario, elimine los datos que Kinesis Data Firehose escribió en otros servicios. Para obtener

más información, consulte the section called “Quitar datos de eventos de almacenados” (p. 472).

471


Amazon Simple Email Service Developer GuideQuitar datos de eventos de almacenados

Puede utilizar la API de Amazon SES para eliminar destinos de eventos. El siguiente procedimiento utilizala AWS Command Line Interface (AWS CLI) para interactuar con la API de Amazon SES. También puedeinteractuar con la API a través de un SDK de AWS o efectuando solicitudes HTTP directamente.

Para quitar un destino de evento de Kinesis Data Firehose utilizando la AWS CLI

1. En la línea de comando, escriba el comando siguiente:

aws ses delete-configuration-set-event-destination --configuration-set-name configSet \--event-destination-name eventDestination

En este comando, reemplace conjuntoConfig por el nombre del conjunto de configuración quecontiene el destino de evento de Kinesis Data Firehose. Sustituya destinoEvento por el nombre deldestino de evento de Kinesis Data Firehose.

2. Si es necesario, elimine los datos que Kinesis Data Firehose escribió en otros servicios. Para obtenermás información, consulte the section called “Quitar datos de eventos de almacenados” (p. 472).

Quitar datos de eventos de almacenadosPara obtener más información acerca de la eliminación de información de otros servicios de AWS, consultelos siguientes documentos:

• Eliminación de un objeto y un bucket en la Guía de introducción a Amazon Simple Storage Service• Eliminación de un dominio de Amazon ES en la Guía para desarrolladores de Amazon Elasticsearch

Service• Eliminación de un clúster en la Guía de administración de clústeres de Amazon Redshift

También puede utilizar Kinesis Data Firehose para transmitir datos de correo electrónico a Splunk, unservicio de terceros que no es compatible con AWS o administrado en la Consola de administraciónde AWS. Para obtener más información acerca de la eliminación de datos de Splunk, consulte aladministrador del sistema o la documentación en el sitio web de Splunk.

Eliminar datos sobre identidadesLas identidades incluyen las direcciones de correo electrónico y los dominios que utiliza para enviar correoelectrónico utilizando Amazon SES. En algunas jurisdicciones, las direcciones de correo electrónico o losdominios podrían considerarse datos personales.

Para eliminar una identidad utilizando la consola de Amazon SES

1. Abra la consola de Amazon SES en https://console.aws.amazon.com/ses/.2. En Identity Management (Administración de identidad), lleve a cabo una de las siguientes operaciones:

• Elija Domains (Dominios) si desea eliminar un dominio.• Elija Email Addresses (Direcciones de correo electrónico) si desea eliminar una dirección de correo

electrónico.3. Elija la identidad que desee eliminar y, a continuación, elija Remove (Quitar).4. En el cuadro de diálogo de confirmación, elija Yes, Delete Identity (Sí, eliminar identidad).

Puede utilizar la API de Amazon SES para eliminar identidades. El siguiente procedimiento utiliza laAWS Command Line Interface (AWS CLI) para interactuar con la API de Amazon SES. También puedeinteractuar con la API a través de un SDK de AWS o efectuando solicitudes HTTP directamente.

472

https://docs.aws.amazon.com/AmazonS3/latest/gsg/DeletingAnObjectandBucket.html

https://docs.aws.amazon.com/elasticsearch-service/latest/developerguide/es-gsg-deleting.html

https://docs.aws.amazon.com/redshift/latest/mgmt/managing-clusters-console.html#delete-cluster

http://docs.splunk.com/Documentation


Amazon Simple Email Service Developer GuideEliminar datos de autenticación de remitente

Para eliminar una identidad utilizando la AWS CLI

• En la línea de comando, escriba el comando siguiente:

aws ses delete-identity --identity [email protected]

En este comando, reemplace [email protected] por la identidad que desea eliminar.

Eliminar datos de autenticación de remitenteLa autenticación de remitente hace referencia al proceso de configurar Amazon SES para que otro usuariopueda enviar correo electrónico en su nombre. Para habilitar la autorización del remitente, debe crearuna política, tal y como se describe en Uso de autorización de envío con Amazon SES (p. 141). Estaspolíticas contienen identidades (que le pertenecen), además de ID de AWS (que se asocian con la personao grupo que envía correos electrónicos en su nombre). Puede quitar estos datos personales, modificando oeliminando las políticas de autenticación de remitente. Los procedimientos que se describen a continuaciónmuestran cómo eliminar estas políticas.

Para eliminar una política de autenticación de remitente a través de la consola de Amazon SES

1. Abra la consola de Amazon SES en https://console.aws.amazon.com/ses/.2. En Identity Management (Administración de identidad), lleve a cabo una de las siguientes operaciones:

• Elija Domains (Dominios) si la política de autenticación de remitente que desea eliminar estáasociada a un dominio.

• Elija Email Addresses (Direcciones de correo electrónico) si la política de autenticación de remitenteque desea eliminar está asociada a una dirección de correo electrónico.

3. En Identity Policies (Políticas de identidad), elija la política que desea eliminar y, a continuación, elijaRemove Policy (Quitar política).

Puede utilizar la API de Amazon SES para eliminar las políticas de autenticación de remitente. El siguienteprocedimiento utiliza la AWS Command Line Interface (AWS CLI) para interactuar con la API de AmazonSES. También puede interactuar con la API a través de un SDK de AWS o efectuando solicitudes HTTPdirectamente.

Para eliminar una política de autenticación de remitente a través de la AWS CLI


aws ses delete-identity-policy --identity example.com --policy-name samplePolicy

En este comando, reemplace ejemplo.com por la identidad que contiene la política de autenticaciónde remitente. Reemplace políticaEjemplo por el nombre de la política de autenticación deremitente.

Eliminar datos relacionados con las reglas derecepción

Si utiliza Amazon SES para recibir correo electrónico entrante, puede crear reglas de recepción que seaplican a una o varias identidades (direcciones de correo electrónico o dominios). Estas reglas determinanqué hace Amazon SES con el correo electrónico entrante enviado a las identidades especificadas.

473


Amazon Simple Email Service Developer GuideEliminar datos relacionados con filtros de dirección IP

Para eliminar una regla de recepción utilizando la consola de Amazon SES

1. Abra la consola de Amazon SES en https://console.aws.amazon.com/ses/.2. En Email Receiving (Recepción de correo electrónico), elija Rule Sets (Conjuntos de reglas).3. Si la regla de recepción forma parte del conjunto de reglas activo, elija View Active Rule Set (Ver

conjunto de reglas activo). En caso contrario, elija el conjunto de reglas que contiene la regla derecepción que desea eliminar.

4. En la lista de reglas de recepción, elija la regla que desea eliminar.5. En el menú Actions, elija Delete.6. En el cuadro de diálogo de confirmación, elija Delete (Eliminar).

Puede utilizar la API de Amazon SES para eliminar reglas de recepción. El siguiente procedimiento utilizala AWS Command Line Interface (AWS CLI) para interactuar con la API de Amazon SES. También puedeinteractuar con la API a través de un SDK de AWS o efectuando solicitudes HTTP directamente.

Para eliminar una regla de recepción utilizando la AWS CLI


aws ses delete-receipt-rule --rule-set myRuleSet --rule-name myReceiptRule

En este comando, reemplace miConjuntodeReglas por el nombre del conjunto de reglas derecepción que contiene la regla de recepción. Reemplace miReglaRecepción por el nombre de laregla de recepción que desea eliminar.

Eliminar datos relacionados con filtros de direcciónIP

Si utiliza Amazon SES para recibir correo electrónico entrante, puede crear filtros para aceptar o bloquearde forma explícita los mensajes que se envíen desde determinadas direcciones IP.

Para eliminar un filtro de dirección IP utilizando la consola de Amazon SES

1. Abra la consola de Amazon SES en https://console.aws.amazon.com/ses/.2. En Email Receiving (Recepción de correo electrónico), elija IP Address Filters (Filtros de dirección IP).3. En la lista de filtros de dirección IP, elija el filtro que desea quitar y, a continuación, haga clic en Delete

(Eliminar).

Puede utilizar la API de Amazon SES para eliminar filtros de dirección IP. El siguiente procedimiento utilizala AWS Command Line Interface (AWS CLI) para interactuar con la API de Amazon SES. También puedeinteractuar con la API a través de un SDK de AWS o efectuando solicitudes HTTP directamente.

Para eliminar un filtro de dirección IP utilizando la AWS CLI


aws ses delete-receipt-filter --filter-name IPfilter

En este comando, reemplace filtroIP por el nombre del filtro de dirección IP que desea eliminar.

474



Amazon Simple Email Service Developer GuideEliminar datos en plantillas de correo electrónico

Eliminar datos en plantillas de correo electrónicoSi utiliza plantillas de correo electrónico para el envío de correo electrónico, es posible que esas plantillaspuedan contener datos personales, en función de cómo las haya configurado. Por ejemplo, es posible quehaya añadido una dirección de correo electrónico a la plantilla con la que los destinatarios podrían ponerseen contacto para obtener más información.

Solo puede eliminar plantillas de correo electrónico mediante la API de Amazon SES.

Para eliminar una plantilla de correo electrónico utilizando la AWS CLI


aws ses delete-template --template-name sampleTemplate

En este comando, reemplace plantillaEjemplo por el nombre de la plantilla de correo electrónicoque desea eliminar.

Eliminación de datos en plantillas de correoelectrónico de verificación personalizadas

Si utiliza plantillas personalizadas para la comprobación de nuevas direcciones de envío de correoelectrónico, es posible que esas plantillas puedan contener datos personales, en función de cómo las hayaconfigurado. Por ejemplo, es posible que haya añadido una dirección de correo electrónico a la plantilla decorreo electrónico de verificación con la que los destinatarios podrían ponerse en contacto para obtenermás información.

Solo puede eliminar plantillas de correo electrónico de verificación personalizadas mediante la API deAmazon SES.

Para eliminar una plantilla de correo electrónico de verificación personalizada utilizando la AWSCLI


aws ses delete-custom-verification-email-template --template-name verificationEmailTemplate

En este comando, reemplace plantillaCorreoElectrónicoVerificación por el nombre de laplantilla de correo electrónico de verificación personalizada que desea eliminar.

Eliminar todos los datos personales cerrando sucuenta de AWS

También es posible eliminar todos los datos personales almacenados en Amazon SES cerrando su cuentade AWS. Sin embargo, esta acción, también elimina todos los demás datos (personales o no personales)que haya almacenado en los demás servicios de AWS.

Al cerrar su cuenta de AWS, los datos de su cuenta de AWS se conservan durante 90 días. Después deese periodo de retención, se eliminan de forma permanente e irreversible.

475

Amazon Simple Email Service Developer GuideEliminar todos los datos cerrando su cuenta de AWS

Warning

No complete el siguiente procedimiento a menos que esté seguro de que desea eliminar porcompleto todos los datos almacenados en su cuenta de AWS en todos los servicios y regiones deAWS.

Puede cerrar su cuenta de AWS mediante la Consola de administración de AWS.

Para cerrar la cuenta de AWS

1. Abra la Consola de administración de AWS en https://console.aws.amazon.com/.2. Vaya a la página Account Settings (Configuración de cuenta) en https://console.aws.amazon.com/

billing/home?#/account.

Warning

Los dos pasos siguientes eliminarán permanentemente todos los datos que haya almacenadoen todos los servicios de AWS en todas las regiones de AWS.

3. En Close Account (Cerrar cuenta), lea la renuncia que describe las consecuencias del cierre de sucuenta de AWS. Si está de acuerdo con las condiciones, seleccione la casilla de verificación y, acontinuación, elija Close Account (Cerrar cuenta).

4. En el cuadro de diálogo de confirmación, elija Close Account (Cerrar cuenta).

476

https://console.aws.amazon.com/



Amazon Simple Email Service Developer GuidePreguntas frecuentes sobre cumplimiento

Preguntas frecuentes sobre AmazonSES

Esta sección contiene respuestas a varias preguntas frecuentes relacionadas con el uso de Amazon SES.

Esta sección contiene preguntas frecuentes sobre los siguientes temas:

• Preguntas frecuentes sobre cumplimiento (p. 477)• Preguntas frecuentes sobre la lista negra de IP (p. 493)• Preguntas frecuentes sobre métricas de correo electrónico (p. 496)

Preguntas frecuentes sobre cumplimiento deAmazon SES

Monitorizamos el correo electrónico que se envía a través de Amazon SES para garantizar que a losusuarios no se les envíe contenido no solicitado o malintencionado. Si determinamos que está enviandocontenido no solicitado o malintencionado, podríamos limitar o suspender su capacidad de enviar correoelectrónico adicional. Este proceso se denomina cumplimiento.

Esta sección contiene las preguntas frecuentes sobre los siguientes temas relacionados con elcumplimiento:

• Períodos de prueba (p. 477)• Suspensiones (p. 480)• Rebotes (p. 482)• Reclamaciones (p. 485)• Trampas de spam (p. 490)• Investigaciones manuales (p. 491)

Preguntas frecuentes sobre período de prueba deAmazon SESP1. He recibido un aviso de período de prueba. ¿Eso quésignifica?Hemos detectado un problema relacionado con el correo electrónico enviado desde su cuenta y le estamosdando tiempo para solucionarlo. Puede seguir enviando correo electrónico a como lo haría normalmente,pero también debe corregir el problema que provocó que la cuenta se haya puesto a prueba. Si no corrigeel problema antes de que el período de prueba haya terminado, podría suspenderse su capacidad deenviar correo electrónico a través de Amazon SES.

477

Amazon Simple Email Service Developer GuidePeríodos de prueba

P2. ¿Recibiré siempre una notificación si estoy en período deprueba?Sí. Recibirá una notificación en la dirección de correo electrónico de su cuenta de AWS asociada alperíodo de prueba de Amazon SES.

P3. ¿Por qué no recibo un aviso de prueba?Cuando su cuenta se coloca en período de prueba, enviamos automáticamente un aviso a la dirección decorreo electrónico asociada a su cuenta de AWS. Esta dirección de correo electrónico es la que especificóal crear su cuenta de AWS. En algunos casos, esta dirección de correo electrónico podría ser diferente dela que va a utilizar para enviar correo electrónico a través de Amazon SES.

Le recomendamos que monitorice su reputación de remitente con regularidad consultando el Panel dereputación (p. 350). También puede configurar alarmas automatizadas en Amazon CloudWatch (p. 363).Estas alarmas pueden enviarle una notificación cuando sus métricas de reputación superen determinadosumbrales. También puede configurar Amazon CloudWatch para ponerse en contacto con usted de otrasformas, como, por ejemplo, mediante el envío de un mensaje de texto a su teléfono móvil.

P4. ¿El período de prueba de Amazon SES afectará a mi uso deotros servicios de AWS?Podrá seguir utilizando otros servicios de AWS mientras su cuenta de Amazon SES esté en período deprueba. Sin embargo, si solicita un aumento del límite de servicio para otro servicio de AWS que envíecomunicaciones de salida (como Amazon SNS), dicha solicitud podría ser denegada hasta que se levanteel período de prueba en su cuenta de Amazon SES.

P5. ¿Qué debo hacer si estoy en período de prueba?Debe hacer lo siguiente:

• Si la situación lo permite, deje de enviar correo hasta que solucione el problema. Aunque el período deprueba no afecta a su capacidad de enviar correo a través de Amazon SES, si sigue enviando correo sinrealizar cambios primero, está poniendo en riesgo la continuidad del envío.

• Consulte el correo electrónico que le hemos enviado para conocer un resumen del problema.• Investigue sus envíos para determinar qué aspectos de su envío han desencadenado específicamente el

problema.• Una vez que haya realizado las correcciones, envíenos un recurso explicándolos las correcciones que

ha implementado (consulte P6. ¿Qué es un recurso? (p. 478)). Tenga en cuenta que debe recurrir elperíodo de prueba solo después de que haya realizado los cambios: no envíe un recurso resumiendo loscambios que prevé aplicar. De ser así, le pediremos que se ponga de nuevo en contacto con nosotroscuando haya puesto en vigor las correcciones realmente. Si encontramos que ha corregido el problema,saldrá del período de prueba.

• Asegúrese de facilitar toda la información que le solicitemos específicamente. Necesitamos estainformación para evaluar su caso.

P6. ¿Qué es un recurso?Nos reservamos el derecho de poner su cuenta en periodo de prueba cuando detectemos ciertoscomportamientos o prácticas de envío. Como cliente de Amazon SES tiene derecho a recurrir estadecisión. Si aceptamos su recurso, eliminaremos el periodo de prueba de su cuenta.

478

Amazon Simple Email Service Developer GuidePeríodos de prueba

P7. ¿Cómo se envía un recurso?Para enviar un recurso, envíe un correo electrónico a [email protected] desde la direcciónde correo electrónico asociada a su cuenta de AWS.

Important

Para proteger la seguridad de su cuenta, solo podemos responder a los recursos que se envíandesde la dirección de correo electrónico asociada con su cuenta de AWS.

En el recurso, proporcione la siguiente información:

• Información sobre la causa principal del evento que provocó que la cuenta se sometiera a un periodo deprueba.

• Una lista de los cambios que ha realizado para evitar que el problema se repita en el futuro. Incluya sololos pasos que ya ha implementado, no los que piensa implementar en el futuro.

• Una explicación de cómo estos cambios evitarán que se repita el mismo problema.

Según la naturaleza del evento por el que pusimos su cuenta en periodo de prueba, podríamos solicitarinformación adicional. Consulte el tema de las preguntas frecuentes asociado con el problema que tuvopara obtener una lista de la información que debe incluir en el recurso.

P8. ¿Qué ocurre si no se acepta mi recurso?Le responderemos explicando los motivos por los que no se ha aceptado su recurso y habitualmentetendrá la opción de recurrir de nuevo después de corregir el problema. Por ejemplo, podríamos solicitarlemás información y una vez que la facilite, el recurso podría ser aceptado. Si nos dice cómo solucionará elproblema pero no lo ha corregido realmente todavía, le pediremos que vuelva a ponerse en contacto connosotros una vez que haya solucionado el problema.

P9. ¿Puede ayudarme a diagnosticar el problema?Normalmente podemos facilitarle solo información general de alto nivel sobre su problema (por ejemplo,que tiene un problema de rebotes). Tendrá que investigar por su parte la causa raíz.

P10. ¿Cómo sé si estoy fuera del período de prueba?Le facilitaremos esta información en nuestra respuesta a su recurso o, en algunos casos, recibirá unanotificación automática en la dirección de correo electrónico asociada a su cuenta de AWS. La notificaciónindicará que ya no está en período de prueba o que su cuenta se ha suspendido porque no ha solucionadoel problema.

P11. ¿Dispondré siempre de un período de prueba si hay unproblema?No. Hay dos casos en los que es posible que no se le proporcione un período de prueba:

• Si el problema es muy grave, su cuenta podría suspenderse de inmediato. Si esto ocurre, le enviaremosuna notificación.

• Si la cuenta se ha puesto en período de prueba varias veces en el pasado, su cuenta podríasuspenderse en lugar de volver a colocarse en modo de prueba. Por este motivo, es importante abordarel problema subyacente en lugar de tan solo el incidente específico que provocó un período de pruebaconcreto. Por ejemplo, si una campaña determinada activa un período de prueba, no debería limitarsesimplemente a detener dicha campaña. Tiene que determinar qué propiedades de la campaña resultaron

479


Amazon Simple Email Service Developer GuideSuspensiones

problemáticas y asegurarse de implantar procesos para que sus futuras campañas no tengan el mismoproblema.

P12. ¿Qué ocurre si realizo las correcciones poco antes de quevenza mi período de prueba?Póngase en contacto con nosotros a través del proceso de recurso para hacernos saber que ha corregidoel problema.

P13. ¿Puedo obtener ayuda de mi representante de AWS oPremium Support?Si ya está trabajando con un representante de cuenta de AWS, nos pondremos en contacto con élautomáticamente cuando su cuenta se ponga en período de prueba. Su representante de cuenta podríafacilitarle información adicional para ayudarle a comprender mejor el problema. Si utiliza Premium Support,también debería ponerse en contacto con dicho equipo para obtener más ayuda.

Preguntas frecuentes sobre suspensión de AmazonSESP1. He recibido un aviso de suspensión. ¿Eso qué significa?Hemos suspendido su cuenta debido a un problema crítico con mensajes de correo electrónico que haenviado. Su cuenta podría haberse suspendido por alguno de los siguientes motivos:

• Su cuenta se puso en modo de prueba con anterioridad. Los problemas que provocaron que su cuentaestuviera en periodo de prueba no se corrigieron antes de que finalizara el período de prueba, por lo quesu cuenta se suspendió.

• La cuenta tiene un historial de modo de prueba por el mismo problema.• Su cuenta envió correo electrónico que infringía los Términos de servicio de AWS. Si estas infracciones

son graves, su cuenta podría suspenderse sin entrar primero en modo de suspensión.

P2. ¿Recibiré siempre una notificación si suspenden mi cuenta?Sí. Recibirá una notificación en la dirección de correo electrónico de su cuenta de AWS asociada a lasuspensión de Amazon SES.

P3. Mi cuenta está suspendida. ¿Por qué no recibo unanotificación?Cuando suspendemos la capacidad de una cuenta para enviar correo electrónico, enviamosautomáticamente una notificación a la dirección de correo electrónico asociada con esa cuenta.

Note

Al crear su cuenta de AWS, debe proporcionar una dirección de correo electrónico. Puedecambiar esta dirección en cualquier momento. Para obtener más información acerca de cómocambiar la dirección asociada a su cuenta de AWS, consulte Administración de una cuenta deAWS en la Guía del usuario de AWS Billing and Cost Management.

Puede utilizar Amazon CloudWatch para crear alarmas que le informen cuando sus tasas de rebotes yreclamaciones sean demasiado altas. La creación de una alarma es una buena manera de recibir una

480

https://aws.amazon.com/service-terms

https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/manage-account-payment.html#account-info

https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/manage-account-payment.html#account-info

Amazon Simple Email Service Developer GuideSuspensiones

advertencia temprana de los factores que podrían hacer que detengamos la capacidad de su cuentapara enviar correo electrónico. Sin embargo, hay factores distintos de los rebotes y las reclamacionesque podrían provocar que detuviéramos su capacidad para enviar correo electrónico. Para obtener másinformación sobre la creación de alarmas en CloudWatch, consulte Creación de alarmas de monitoreo dereputación en CloudWatch (p. 363).

También puede utilizar el panel de capacidad de entrega (p. 350) para determinar el estado actual desu cuenta. Por ejemplo, si la capacidad de su cuenta para enviar correo electrónico actualmente estáen pausa, la sección Account status (Estado de la cuenta) del panel de capacidad de entrega muestrael estado SUSPENDED (SUSPENDIDO). Si la cuenta puede enviar correo electrónico con normalidad,muestra el estado HEALTHY (CORRECTO).

Por último, puede comprobar el AWS Personal Health Dashboard (PHD) en https://phd.aws.amazon.com/para determinar si la capacidad de su cuenta para enviar correo electrónico se encuentra en pausaactualmente. Cuando detenemos la capacidad de enviar correo electrónico de una cuenta, agregamosautomáticamente el evento SES enforcement suspended (Aplicación de SES suspendida) a la secciónEvent log (Log de eventos) de PHD. El evento SES enforcement suspended (Aplicación de SESsuspendida) siempre tiene el estado Closed (Cerrado), independientemente de si está actualmentesuspendida o no la capacidad de la cuenta para enviar correo electrónico. El log de eventos tambiénincluye una copia del correo electrónico que enviamos a la dirección de correo electrónico asociada con sucuenta de AWS cuando se produjo el evento de suspensión.

Puede utilizar CloudWatch para crear una alarma que le avise cuando aparezcan nuevos eventos en supanel de estado personal. Para obtener más información, consulte Monitoreo de eventos de AWS Healthcon Eventos de CloudWatch en la Guía del usuario de AWS Health.

P4. ¿La suspensión de Amazon SES afectará a mi uso de otrosservicios de AWS?Puede seguir utilizando otros servicios de AWS mientras su cuenta de Amazon SES esté suspendida. Sinembargo, si solicita un aumento del límite de servicio para otro servicio de AWS que envíe comunicacionesde salida (como Amazon SNS), podríamos denegar dicha solicitud hasta que se levante la suspensión ensu cuenta de Amazon SES.

P5. ¿Qué debo hacer si mi cuenta se ha suspendido?Debe hacer lo siguiente:

• Consulte el correo electrónico que le hemos enviado para conocer un resumen del problema.• Investigue sus envíos para determinar qué aspectos de su envío han desencadenado específicamente el

problema.• Una vez que haya corregido el problema, envíenos un recurso explicándonos las correcciones que ha

implementado (consulte P6. ¿Qué es un recurso? (p. 481)). Tenga en cuenta que debe recurrir lasuspensión solo después de realizar los cambios: no envíe un recurso resumiendo los cambios queprevé aplicar. De ser así, le pediremos que se ponga de nuevo en contacto con nosotros cuando hayapuesto en vigor las correcciones realmente.

• Asegúrese de facilitar toda la información que le solicitemos específicamente. Necesitamos estainformación para evaluar su caso.

P6. ¿Qué es un recurso?Nos reservamos el derecho de detener su capacidad para enviar correo electrónico cuando detectemosciertos comportamientos o prácticas de envío. Como cliente de Amazon SES tiene derecho a recurrir estadecisión. Si aceptamos su recurso, eliminaremos la suspensión de su cuenta.

481

https://phd.aws.amazon.com/

https://docs.aws.amazon.com/health/latest/ug/cloudwatch-events-health.html

https://docs.aws.amazon.com/health/latest/ug/cloudwatch-events-health.html

Amazon Simple Email Service Developer GuideRebotes

P7. ¿Cómo se envía un recurso?Para enviar un recurso, envíe un correo electrónico a [email protected] desde la direcciónde correo electrónico asociada a su cuenta de AWS.

Important

Para proteger la seguridad de su cuenta, solo podemos responder a los recursos que se envíandesde la dirección de correo electrónico asociada con su cuenta de AWS.

En el recurso, proporcione la siguiente información:

• Información sobre la causa principal del evento que provocó que la cuenta se suspendiera.• Una lista de los cambios que ha realizado para evitar que el problema se repita en el futuro. Incluya solo

los pasos que ya ha implementado, no los que piensa implementar en el futuro.• Una explicación de cómo estos cambios evitarán que se repita el mismo problema.

Según la naturaleza del evento por el que suspendimos su cuenta, podríamos solicitar informaciónadicional. Consulte el tema de las preguntas frecuentes asociado con el problema que tuvo para obteneruna lista de la información que debe incluir en el recurso.

P8. ¿Qué ocurre si no se acepta mi recurso?Le responderemos explicando los motivos por los que no se ha aceptado su recurso y habitualmentetendrá la opción de recurrir de nuevo después de corregir el problema. Por ejemplo, podríamos solicitarlemás información y una vez que la facilite, el recurso podría ser aceptado. Otro ejemplo: si nos dice cómosolucionará el problema y no lo ha corregido realmente, le pediremos que vuelva a ponerse en contactocon nosotros una vez que haya solucionado el problema realmente.

P9. ¿Puede ayudarme a diagnosticar el problema?Normalmente podemos facilitarle solo información general de alto nivel sobre su problema (por ejemplo,que tiene un problema de rebotes). Es su responsabilidad corregir el problema.

P10. ¿Cómo puedo saber si mi cuenta se ha restablecido?Le facilitaremos esta información en nuestra respuesta a su recurso o, en algunos casos, recibirá unanotificación automática en la dirección de correo electrónico asociada a su cuenta de AWS. Tambiénpuede probar a enviarse un correo electrónico a usted mismo a través de Amazon SES (por ejemplo,utilizando la consola de Amazon SES). Si el intento tiene éxito, se ha restablecido su cuenta.

P11. ¿Puedo obtener ayuda de mi representante de AWS oPremium Support?Si ya está trabajando con un representante de cuenta de AWS, nos pondremos en contacto con élautomáticamente cuando su cuenta se suspenda. Su representante de cuenta podría facilitarle informaciónadicional para ayudarle a comprender mejor el problema. Si utiliza Premium Support, también deberíaponerse en contacto con dicho equipo para obtener más ayuda.

Preguntas frecuentes de rebotes de Amazon SESP1. ¿Por qué se preocupan por mis rebotes?Las entidades como, por ejemplo, los ISP, los proveedores de buzones de correo y las organizacionesantispam utilizan las tasas de rebote elevadas como indicadores de que los remitentes siguen prácticas

482



de envío de correo electrónico de baja calidad y su correo electrónico podría bloquearse o enviarse a lacarpeta de spam.

P2. ¿Qué debo hacer si recibo un aviso de período de prueba osuspensión por mi tasa de rebotes?Corrija el problema subyacente y presente un recurso para que su caso sea evaluado nuevamente. Paraobtener información sobre el proceso de recurso, consulte las preguntas frecuentes sobre período deprueba y suspensión. En su recurso, además de la información solicitada en las preguntas frecuentessobre el período de prueba y la suspensión, facilítenos la siguiente información:

• El método que utiliza para realizar un seguimiento de sus rebotes• Cómo se asegura de que las direcciones de correo electrónico de nuevos destinatarios sean válidas

antes de enviarles mensajes. Por ejemplo, cual de las recomendaciones está siguiendo en P11. ¿Quépuedo hacer para minimizar los rebotes? (p. 484)

P3. ¿Qué tipos de rebotes se contabilizan en mi tasa de rebotes?Su tasa de rebotes solo incluye rebotes permanente a los dominios que no haya verificado. Los rebotespermanentes son errores de entrega permanentes como, por ejemplo, "la dirección no existe". Los errorestemporales e intermitente, tales como "bandeja de entrada llena" o los rebotes debidos a direcciones IPbloqueadas, no se contabilizan en la tasa de rebotes.

P4. ¿Revelan los límites de tasa de rebote de Amazon SES quedan lugar a períodos de prueba y suspensiones?Para obtener los mejores resultados, debe mantener una tasa de rebote por debajo del 2 %. Las tasas derebote más altas pueden afectar a la entrega de sus correos electrónicos.

Si su tasa de rebote es del 5 % o superior, someteremos su cuenta a un periodo de prueba. Si su tasa derebote es del 10 % o superior, suspenderemos su capacidad de enviar correo electrónico adicional.

P5. ¿Para qué período de tiempo se calcula mi tasa de rebotes?No calcular la tasa de rebotes en función de un período de tiempo fijo, ya que distintos remitentes envíana ritmos diferentes. En lugar de ello, nos fijamos en un volumen representativo: una cantidad de correoelectrónico que representa sus prácticas de envío típicas. Para ser justos con los remitentes de volúmenesgrandes y pequeños, el volumen representativo es distinto para cada usuario y cambia a medida quecambian los patrones de envío del usuario.

P6. ¿Puedo calcular mi propia tasa de rebote usandola información de la consola de Amazon SES o del APIGetSendStatistics?No. La tasa de rebotes se calcula mediante el volumen representativo (consulte P5. ¿Para qué períodode tiempo se calcula mi tasa de rebotes? (p. 483)). Dependiendo de su tasa de envío, la tasa de rebotepueden alargarse más atrás en el tiempo de lo que la consola de Amazon SES o GetSendStatisticspueden recuperar. Además, solo los mensajes de correo electrónico a dominios verificados se tienen encuenta a la hora de calcular la tasa de rebote. No obstante, si monitorea periódicamente su tasa de reboteutilizando dichos métodos, debe seguir teniendo un buen indicador que puede utilizar para identificarproblemas antes de alcancen niveles que den lugar a un período de prueba o a una suspensión.

483


P7. ¿Cómo puedo averiguar qué direcciones de correoelectrónico han presentado rebotes?Examine las notificaciones de rebotes que le envía Amazon SES. La dirección de correo electrónico ala que Amazon SES reenvía las notificaciones depende de cómo enviara el mensaje original, tal y comose describe en Notificaciones de Amazon SES a través de correo electrónico (p. 237). También puedeconfigurar las notificaciones de rebotes a través de Amazon Simple Notification Service (Amazon SNS), taly como se describe en Monitoreo utilizando notificaciones de Amazon SES (p. 236). Tenga en cuenta quesolo con eliminar de la lista las direcciones que presentan rebotes sin una investigación adicional podría noresolver el problema subyacente. Para obtener información acerca de lo que puede hacer para reducir losrebotes, consulte P11. ¿Qué puedo hacer para minimizar los rebotes? (p. 484).

P8. En caso de no haber monitoreado los rebotes, ¿puedenfacilitarme una lista de las direcciones con rebote?No, no podemos proporcionar una lista completa de las direcciones con rebote. El cliente es responsablede monitorizar y actuar en función de los rebotes de su cuenta.

P9. ¿Cómo debería gestionar los rebotes?Tiene que eliminar las direcciones con rebotes de su lista de correo y dejar de enviarles correo electrónicode forma inmediata. Si es remitente de poco volumen, podría ser suficiente simplemente monitorear losrebotes a través de correo electrónico y eliminar manualmente las direcciones con rebotes desde su listade correo. Si el volumen es superior, probablemente desee configurar la automatización para este proceso,ya sea mediante programación procesando la bandeja de correo donde recibe los rebotes o configurandolas notificaciones de rebote a través de Amazon SNS. Para obtener más información, consulte Monitoreoutilizando notificaciones de Amazon SES (p. 236).

P10. ¿Podrían mis correos electrónicos rebotar por haberalcanzado mis límites de envío?No. Los rebotes no tienen nada que ver con los límites de envío. Si intenta superar sus límites de envío,recibirá un error desde la interfaz de SMTP o el API de Amazon SES cuando intente enviar un correoelectrónico.

P11. ¿Qué puedo hacer para minimizar los rebotes?En primer lugar, asegúrese de que estar al tanto de sus rebotes (consulte P7. ¿Cómo puedo averiguarqué direcciones de correo electrónico han presentado rebotes? (p. 484)). A continuación, siga estasinstrucciones:

• No compre, alquile o comparta direcciones de correo electrónico. Envíe correo electrónico únicamente alos destinatarios que hayan solicitado de forma explícita recibir sus correos electrónicos.

• Elimine las direcciones de correo electrónico con rebote de su lista.• En formularios web, pida a los usuarios que introduzcan sus direcciones de correo electrónico dos veces

y asegúrese de que ambas direcciones coincidan antes de poder enviar el formulario.• Utilice la confirmación doble para inscribir nuevos usuarios. Es decir, cuando un nuevo usuario se

inscriba, envíele un correo electrónico de confirmación en el que sea preciso pulsar antes de recibircorreo adicional. Esto evita que se inscriban a otras personas, así como las inscripciones accidentales.

• Si tiene que enviar mensajes a direcciones a las que no haya enviado últimamente (y, por lo tanto, nopuede estar seguro de si las direcciones siguen siendo válidas), hágalo sólo con una pequeña parte desu envío general. Para obtener más información, consulte nuestro artículo de blog Never send to oldaddresses, but what if you have to?.

484

https://aws.amazon.com//blogs/messaging-and-targeting/never-send-to-old-addresses-but-what-if-you-have-to/

https://aws.amazon.com//blogs/messaging-and-targeting/never-send-to-old-addresses-but-what-if-you-have-to/


• Asegúrese de que las inscripciones no estén estructuradas de modo que anime a los usuarios a utilizardirecciones ficticias. Por ejemplo, no proporcione ningún valor añadido o beneficios hasta que losdestinatarios verifiquen sus direcciones.

• Si dispone de una funcionalidad "enviar por correo electrónico a un amigo", utilice CAPTCHA o unmecanismo similar para impedir el uso automatizado de la misma y no permitir al usuario insertarcontenido arbitrario.

• Si utiliza Amazon SES para las notificaciones del sistema, asegúrese de enviar las notificaciones adirecciones reales que puedan recibir correo electrónico. Considere además la posibilidad de desactivarlas notificaciones que no necesita.

• Si va a probar un nuevo sistema, asegúrese de enviar los mensajes a direcciones reales que puedanrecibir correo electrónico o de utilizar el simulador de bandeja de correo de Amazon SES. Para obtenermás información, consulte Probar el envío de correo electrónico en Amazon SES (p. 173).

Preguntas frecuentes de reclamaciones de AmazonSESP1. ¿Qué es una reclamación?Una reclamación se produce cuando un destinatario notifica que no desea recibir un correo electrónico. Esposible que haya hecho clic en el botón "Marcar como spam" de su cliente de correo electrónico, que sehayan quejado a su proveedor de correo electrónico, que hayan notificado a Amazon SES directamente oa través de cualquier otro método. En este tema se incluye información general sobre las reclamaciones.Si su notificación contiene información específica acerca del origen de las reclamaciones, lea también eltema correspondiente: Preguntas frecuentes de reclamaciones de Amazon SES a través de bucles deretroalimentación de ISP (p. 486), Preguntas frecuentes de reclamaciones de Amazon SES directamentedesde destinatarios (p. 488) o Preguntas frecuentes sobre reclamaciones de Amazon SES a travésproveedores de correo electrónico (p. 489).

P2. ¿Por qué se preocupa por mis reclamaciones?Entidades como, por ejemplo, los ISP, los proveedores de correo electrónico y las organizaciones antispamsuelen utilizar unas tasas de reclamación elevadas como indicadores de que el remitente está enviando adestinatarios que no se han registrado específicamente para recibir mensajes de correo electrónico o queel remitente está enviando contenido distinto del tipo al que los destinatarios se han inscrito.

P3. ¿Qué debo hacer si recibo un aviso de período de prueba osuspensión por mi tasa de reclamaciones?Revise su proceso de adquisición de lista y el contenido de sus correos electrónicos para intentarcomprender por qué sus destinatarios podrían no estar interesados en su correo electrónico. Una vez quehaya determinado la causa, corrija el problema subyacente y recurra para que volvamos a evaluar su caso.Para obtener información sobre el proceso de recurso, consulte las preguntas frecuentes sobre período deprueba y suspensión.

P4. ¿Qué puedo hacer para minimizar las reclamaciones?En primer lugar, asegúrese de que monitorea las reclamaciones que Amazon SES puede notificar sobreusted, que son las reclamaciones que recibe Amazon SES a través de los bucles de retroalimentaciónde ISP (consulte Preguntas frecuentes de reclamaciones de Amazon SES a través de bucles deretroalimentación de ISP (p. 486)). A continuación, siga estas instrucciones:

• No compre, alquile o comparta direcciones de correo electrónico. Utilice solo direcciones que hayansolicitado específicamente su correo electrónico.

485


• Utilice la confirmación doble para inscribir nuevos usuarios. Es decir, cuando un usuario se inscriba,envíele un correo electrónico de confirmación en el que sea preciso pulsar antes de recibir correoadicional. Esto evita que se inscriban a otras personas, así como las inscripciones accidentales.

• Monitoree la implicación de los usuarios con el correo electrónico que envía y deje de enviar mensajes adestinatarios que no abran o hagan clic en sus mensajes.

• Cuando se registran nuevos usuarios, indique con claridad el tipo de correo electrónico que les enviaráy asegúrese de enviarles únicamente el tipo de correo electrónico en el que se hayan inscrito. Porejemplo, si los usuarios se inscriben para actualizaciones de noticias, no les envíe anuncios.

• Asegúrese de que su correo electrónico tenga un formato correcto y un aspecto profesional.• Asegúrese de que su correo electrónico proceda claramente de usted y no pueda confundirse con otras

cosas.• Proporcione a los usuarios una forma sencilla y obvia de cancelar la suscripción a su correo electrónico.

Preguntas frecuentes de reclamaciones de Amazon SES a travésde bucles de retroalimentación de ISPEn este tema se proporciona información sobre las reclamaciones que Amazon SES recibe a través debucles de retroalimentación. Para obtener información general relativa a todos los tipos de reclamaciones,consulte Preguntas frecuentes de reclamaciones de Amazon SES (p. 485).

P1. ¿Cómo se notifica este tipo de reclamación?La mayoría de los programas cliente de correo electrónico ofrecen un botón "Marcar como spam", osimilar, que traslada el mensaje a una carpeta de spam y lo reenvía al ISP. Además, la mayoría de losISP mantienen una dirección de abuso (por ejemplo, [email protected]), donde los usuarios puedenreenviar mensajes de correo electrónico no deseados y solicitar al ISP que tome las medidas necesariaspara evitarlos. Si el Amazon SES tiene configurado un bucle de retroalimentación (FBL) con el ISP,entonces el ISP enviará la reclamación de vuelta a Amazon SES.

P2. ¿Estas reclamaciones se incluyen en la estadística de tasa dereclamaciones que se muestra en la consola de Amazon SES y devuelve el APIGetSendStatistics?Sí. Tenga en cuenta, sin embargo, que la estadística de la tasa de reclamaciones no incluye lasreclamaciones de los ISP que no proporcionen retroalimentación a Amazon SES. No obstante, latasa de reclamaciones de dominios que proporcionan retroalimentación es probable que también searepresentativa del resto de sus envíos.

P3. ¿Cómo puedo recibir notificaciones sobre estas reclamaciones?Puede recibir notificaciones a través de correo electrónico o a través de notificaciones de Amazon SNS.Vea las instrucciones de configuración en Monitoreo utilizando notificaciones de Amazon SES (p. 236).

P4. ¿Qué debo hacer si recibo una notificación de reclamación a través de correoelectrónico o a través de Amazon SNS?En primer lugar, tiene que eliminar las direcciones que generen reclamaciones de su lista de correo ydejar de enviarles correo electrónico de forma inmediata. No envíe siquiera un correo electrónico queindique que ha recibido la solicitud para cancelar la suscripción. Sopese la posibilidad de configurar laautomatización para este proceso, ya sea mediante programación procesando la bandeja de correo donderecibe las reclamaciones o configurando las notificaciones de reclamación a través de Amazon SNS. Paraobtener más información, consulte Monitoreo utilizando notificaciones de Amazon SES (p. 236).

A continuación, examine detenidamente sus envíos para determinar por qué los destinatarios no desean elcorreo que está enviando y aborde el problema subyacente. Por cada persona que reclama puede haber

486


docenas que no desean su correo electrónico que no se quejan o no han podido hacerlo. Si lo único quehacer es eliminar los destinatarios que reclaman realmente, no aborda el problema subyacente.

P5. ¿Revelan los límites de tasa de reclamaciones de Amazon SES que dan lugara períodos de prueba y suspensiones?Para obtener los mejores resultados, debe mantener una tasa de reclamaciones por debajo del 0,1 %. Lastasas de reclamaciones más altas pueden afectar a la entrega de sus correos electrónicos.

Si su tasa de reclamaciones es del 0,1 % o superior, someteremos su cuenta a un periodo de prueba.Si su tasa de rebote es del 0,5 % o superior, suspenderemos su capacidad de enviar correo electrónicoadicional.

P6. ¿Para qué período de tiempo se calcula mi tasa de reclamaciones?No calcular la tasa de reclamaciones en función de un período de tiempo fijo, ya que distintos remitentesenvían a ritmos diferentes. En lugar de ello, nos fijamos en un volumen representativo: una cantidad decorreo que representa sus prácticas de envío típicas. Para ser justos con los remitentes de volúmenesgrandes y pequeños, el volumen representativo es distinto para cada usuario y cambia a medida quecambian los patrones de envío del usuario. Además, la tasa de reclamaciones no se calcula en función decada mensaje de correo electrónico. En su lugar, se calcula como porcentaje de las reclamaciones en elcorreo enviadas a dominios que envíen a retroalimentación de reclamaciones a Amazon SES.

P7. ¿Puedo calcular mi propia tasa de reclamaciones usando las métricas de laconsola de Amazon SES o del API GetSendStatistics?No. Existen dos razones principales para ello:

• La tasa de reclamaciones se calcula mediante el volumen representativo (consulte P6. ¿Para quéperíodo de tiempo se calcula mi tasa de reclamaciones? (p. 487)). Dependiendo de su tasa de envío,la tasa de reclamaciones puede alargarse más atrás en el tiempo de lo que la consola de AmazonSES o GetSendStatistics pueden recuperar. No obstante, si monitorea periódicamente su tasa dereclamaciones utilizando dichos métodos, debe seguir teniendo un buen indicador que puede utilizarpara identificar problemas antes de alcancen niveles que den lugar a un período de prueba o a unasuspensión.

• Para calcular la tasa de reclamaciones, no se contabilizan todos los correos electrónicos. La tasa dereclamaciones se calcula como porcentaje de las reclamaciones en el correo enviadas a dominios queenvíen a retroalimentación de reclamaciones a Amazon SES.

P8. ¿Cómo puedo averiguar qué direcciones de correo electrónico hanpresentado reclamaciones?Examine las notificaciones de reclamación que Amazon SES le envía a través de correo electrónicoo a través de Amazon SNS (consulte Monitoreo utilizando notificaciones de Amazon SES (p. 236)).Sin embargo, los distintos proveedores de servicios de Internet proporcionan diferentes cantidades deinformación y algunos proveedores de servicios de Internet redactan la dirección de correo electrónico deldestinatario antes de transferir la notificación de reclamación a Amazon SES. Para permitirle encontrarla dirección de correo electrónico del destinatario en el futuro, la mejor opción consiste en almacenar supropia asignación entre un identificador y el ID de mensaje de Amazon SES que Amazon SES le transfierecuando se acepta el correo electrónico. Tenga en cuenta que Amazon SES no mantiene ningún ID demensaje personalizado que añada.

P9. En caso de no haber monitoreado mis reclamaciones, ¿pueden facilitarmeuna lista de las direcciones con reclamaciones?Lamentablemente, no podemos proporcionarle una lista exhaustiva. Sin embargo, puede monitorearreclamaciones futuras por correo electrónico o a través de Amazon SNS.

487


P10. ¿Puedo obtener un correo electrónico de muestra?No podemos enviarle un correo electrónico de muestra previa petición, pero es posible encontrar estainformación en la notificación de la reclamación. Para obtener más información, consulte P8. ¿Cómo puedoaveriguar qué direcciones de correo electrónico han presentado reclamaciones? (p. 487).

Preguntas frecuentes de reclamaciones de Amazon SESdirectamente desde destinatariosEn este tema se proporciona información sobre las reclamaciones que Amazon SES recibe directamentede destinatarios. Para obtener información general relativa a todos los tipos de reclamaciones, consultePreguntas frecuentes de reclamaciones de Amazon SES (p. 485).

P1. ¿Cómo se notifica este tipo de reclamación?Varios destinatarios se han puesto en contacto directamente con Amazon SES con relación a su correo através de correo electrónico o de cualquier otro medio.

P2. ¿Estas reclamaciones se incluyen en la estadística de tasa dereclamaciones que se muestra en la consola de Amazon SES y devuelve el APIGetSendStatistics?No. La estadística de la tasa de reclamaciones que recupera utilizando la consola de Amazon SES o elAPI GetSendStatistics solo incluye reclamaciones que Amazon SES recibe a través de bucles deretroalimentación de ISP. Para obtener más información acerca de estos tipos de reclamaciones, consultePreguntas frecuentes de reclamaciones de Amazon SES a través de bucles de retroalimentación deISP (p. 486).

P3. ¿Por qué no he oído hablar de estas reclamaciones a través de notificacionesde retroalimentación de correo electrónico o a través de Amazon SNS?El reenvío de retroalimentación de correo electrónico y las notificaciones de Amazon SNS solo incluyenreclamaciones que Amazon SES recibe a través de bucles de retroalimentación del ISP. No recibiránotificaciones sobre reclamaciones que los destinatarios presenten directamente con Amazon SES.

P4. ¿Cómo puedo averiguar qué direcciones de correo electrónico hanpresentado reclamaciones?Para proteger las identidades de los destinatarios que se han quejado, no podemos enumerar lasdirecciones de correo electrónico que han presentado una reclamación por su correo electrónico.

En lugar de centrarse en eliminar destinatarios individuales de sus listas, le recomendamos que determineel problema que ha llevado a la formulación de las reclamaciones. Le recomendamos que empiece porrevisar el proceso de adquisición de clientes y que retire de sus listas a aquellos que no hayan solicitadoexplícitamente recibir sus correos electrónicos. También debe analizar el contenido de sus correoselectrónicos para intentar comprender por qué se han quejado los destinatarios.

P5. ¿Puedo obtener un correo electrónico de muestra?Para proteger las identidades de los destinatarios que se han quejado, no podemos proporcionarle copiasde los correos electrónicos que han provocado que los destinatarios se quejen.

P6. He recibido un aviso de período de prueba por reclamaciones de destinatariodirectas. ¿Qué tengo que hacer?Inmediatamente cambie los procesos de envío, de modo que solo envíe mensajes a destinatarios quese hayan inscrito específicamente para recibirlos. Además, asegúrese de que está enviando el tipo de

488


contenido al que los destinatarios se registraron para recibir. Una vez que haya completado estos pasos,envíe un recurso. En su recurso, proporcione información acerca de los cambios que ha realizado pararesolver el problema.

Si no envía un recurso en el plazo de tres semanas y seguimos recibiendo reclamaciones de destinatariodirectas, suspenderemos su cuenta.

Preguntas frecuentes sobre reclamaciones de Amazon SES através proveedores de correo electrónicoEn este tema se proporciona información sobre las quejas que Amazon SES recibe a través deproveedores de correo electrónico (también llamados proveedores de bandeja de correo). Para obtenerinformación general relativa a todos los tipos de reclamaciones, consulte Preguntas frecuentes dereclamaciones de Amazon SES (p. 485).

P1. ¿Cómo se notifica este tipo de reclamación?Un proveedor de correo electrónico notifica a Amazon SES que un número importante de sus clientesha marcado sus correos electrónicos como spam. El informe se ha proporcionado a Amazon SES através de un mecanismo distinto de los bucles de retroalimentación descritos en Preguntas frecuentes dereclamaciones de Amazon SES a través de bucles de retroalimentación de ISP (p. 486).

P2. ¿Estas reclamaciones se incluyen en la estadística de tasa dereclamaciones que se muestra en la consola de Amazon SES y devuelve el APIGetSendStatistics?No. La estadística de la tasa de reclamaciones que recupera utilizando la consola de Amazon SES o elAPI GetSendStatistics solo incluye reclamaciones que Amazon SES recibe a través de bucles deretroalimentación de ISP.

P3. ¿Por qué no he oído hablar de estas reclamaciones a través de notificacionesde retroalimentación de correo electrónico o a través de Amazon SNS?El reenvío de retroalimentación de correo electrónico y las notificaciones de Amazon SNS solo incluyenreclamaciones que Amazon SES recibe a través de bucles de retroalimentación del ISP.

P4. ¿Cómo puedo averiguar qué direcciones de correo electrónico hanpresentado reclamaciones?Los proveedores de correo electrónico normalmente no revelan esta información. Sin embargo, en lugarde centrarse en eliminar destinatarios individuales de la lista, debe centrarse en encontrar y solucionar elproblema subyacente. Empiece por revisar su proceso de adquisición de lista y el contenido de sus correoselectrónicos para intentar comprender por qué sus destinatarios podrían no estar interesados en su correoelectrónico.

P5. ¿Puedo obtener un correo electrónico de muestra?No. Los proveedores de correo electrónico normalmente no proporcionan un correo electrónico de ejemplo.

P6. He recibido un aviso de período de prueba o de cierre para este tipo dereclamación. ¿Qué tengo que hacer?Corrija su sistema de forma que su lista de correo solo incluya destinatarios que se hayan inscritoespecíficamente para recibir su correo electrónico y asegúrese de que el propio contenido de correoelectrónico sea algo que sus destinatarios realmente deseen. A continuación, envíenos un correoelectrónico con los detalles de los cambios para que podamos iniciar el proceso de reevaluación de sucaso.

489

Amazon Simple Email Service Developer GuideTrampas de spam

Si no envía un recurso en el plazo de tres semanas y seguimos recibiendo reclamaciones de proveedores,suspenderemos su cuenta.

Preguntas frecuentes de trampas de spam de AmazonSESP1. ¿Qué son las trampas de spam?Una trampa de spam es una dirección de correo electrónico especial que mantiene un proveedor decorreo electrónico, ISP u organización antispam. Dado que esa dirección no se inscribirá nunca de maneralegítima para recibir correo electrónico, las organizaciones que mantener estas trampas de spam sabenque quien envía a cualquiera de estas direcciones de correo electrónico probablemente siga prácticas decorreo electrónico cuestionables.

P2. ¿Cómo se configuran las trampas de spam?Las direcciones de trampa de spam se pueden configurar de varias formas. Se pueden convertir a partirde direcciones que anteriormente fueron válidas, pero que han dejado de utilizarse (y de rebotar) duranteun periodo de tiempo prolongado. También pueden ser direcciones que configuraron para ser trampas despam. Pueden ser direcciones inusuales que sean difíciles de adivinar y, en ocasiones, son direccionesparecidas a direcciones reales (por ejemplo, introducen una errata en un nombre de dominio común). Amenudo, pero no siempre, las trampas de spam se "siembran" en el mundo colocándolas en Internet dediversas formas.

P3. ¿Cómo sabe Amazon SES si estoy enviando a trampas despam?Ciertas organizaciones que operan con trampas de spam envían notificaciones a Amazon SES cuando sustrampas de spam reciben mensajes de remitentes de Amazon SES.

P4. ¿Cómo utiliza Amazon SES los informes de trampas despam?Revisamos los informes y si encontramos pruebas suficientes de que tiene un problema con el envío atrampas de spam, lo pondremos a prueba y solicitaremos que corrija el problema subyacente. Si no corrigeel problema antes de que finalice el período de prueba, se suspenderá su cuenta. Además, si su problemade trampa de spam es muy grave, es posible que su cuenta se suspenda de inmediato sin un período deprueba. Al igual que con cualquier suspensión, le enviaremos una notificación en ese momento.

P5. ¿Qué debo hacer si recibo un aviso de período de prueba osuspensión por envíos a trampas de spam?Corrija el problema subyacente y presente un recurso para que su caso sea evaluado nuevamente. Paraobtener información sobre el proceso de recurso, consulte las preguntas frecuentes sobre período deprueba y suspensión. Debido a la forma en la que se notifica el envío a las trampas de spam, se tardacomo mínimo tres semanas en poder confirmar que la solución que ha implantado ha tenido éxito.

P6. ¿Cuántas incidencias en trampas de spam puedo tener antesde entrar en período de prueba o en suspensión?Las incidencias de trampas de spam son un signo muy negativo, solo hacen falta un número muy reducidode ellas para indicar que está siguiendo prácticas de envío cuestionables.

490

Amazon Simple Email Service Developer GuideInvestigaciones manuales

P7. ¿Revela las direcciones de trampa de spam?No. Para que las trampas de spam sean eficaces, es esencial que sigan siendo confidenciales. Lasorganizaciones de trampas de spam solo revelan el uso de las trampa de spam, no las direcciones detrampa de spam reales.

P8. ¿Qué puedo hacer para evitar el envío a trampas de spam?Para reducir el riesgo de enviar a trampas de spam, siga estas directrices:

• No compre, alquile o comparta direcciones de correo electrónico. Utilice solo direcciones que hayansolicitado específicamente su correo electrónico.

• En formularios web, pida a los usuarios que introduzcan sus direcciones de correo electrónico dos vecesy asegúrese de que ambas direcciones coincidan antes de poder enviar el formulario.

• Utilice la confirmación doble para inscribir nuevos usuarios. Es decir, cuando un usuario se inscriba,envíele un correo electrónico de confirmación en el que sea preciso pulsar antes de recibir correoadicional.

• Asegúrese de eliminar de su lista las direcciones con rebotes permanentes, para que se eliminen muchoantes de que se convierten en trampas de spam.

• Asegúrese de monitorear la implicación de sus destinatarios y deje de enviar mensajes a destinatariosque no hayan interactuado recientemente con sus mensajes de correo electrónico o sitio web. Losplazos que determinan qué es un "usuario implicado" dependen del caso de uso, pero en general si losusuarios no han abierto sus mensajes de correo electrónico o hecho clic en ellos desde hace meses,debería plantearse eliminarlos a menos que haya pruebas de que desean su correo.

• Tenga mucho cuidado con las campañas para volver a implicar a usuarios en las que se ponga encontacto de manera intencionada con personas que no hayan interactuado con usted recientemente.Estos esfuerzos suelen ser muy arriesgados y, a menudo, puede causar problemas no solo con el envíode trampas de spam, sino también con el correo devuelto y las reclamaciones.

• Envíe un mensaje para darse de alta a toda su lista de correo y mantenga solo los destinatarios quehayan hecho clic en el enlace de verificación. Además de eliminar los destinatarios inactivos de lalista, este procedimiento también eliminará las direcciones de trampa de spam. Sin embargo, no lerecomendamos utilizar esta técnica si cree que su lista de correo podría contener muchas direccionesincorrectas o si ya ha tenido un problema con los rebotes, ya que podría hacer que su tasa de rebotesalcance el punto que conlleve que su envío entre en período de pruebas o se cierre.

Preguntas frecuentes sobre investigación manual deAmazon SESP1. He recibido un aviso de período de prueba o cierre por unainvestigación manual. ¿Eso qué significa?Un investigador de Amazon SES ha identificado un problema importante con su envío. Entre los problemastípicos se incluyen, entre otros, los siguientes:

• Su envío infringe la Política de uso aceptable de AWS (AUP).• Su correos electrónicos parecen no haber sido solicitados.• El contenido se asocia con un caso de uso que Amazon SES no admite.

Si el problema es subsanable, su cuenta se pone a prueba y se le da un plazo de tiempo determinado (enlugar de un determinado volumen de correo electrónico, como ocurre con los rebotes y las reclamaciones)

491

https://aws.amazon.com/aup/

Amazon Simple Email Service Developer GuideInvestigaciones manuales

para corregir el problema. Si el problema no se puede corregir, su cuenta se suspende sin un período deprueba.

P2. ¿Por qué se llevaría a cabo una investigación manual?Existen diversas razones. Entre otras, se incluyen las siguientes:

• Algunos destinatarios se han puesto en contacto con Amazon SES para quejarse por sus correoselectrónicos.

• Hemos detectado un cambio notable en sus patrones de envío.• Los filtros de spam de Amazon SES marcan una parte importante de sus mensajes de correo

electrónico.

La notificación de período de prueba o suspensión indica el problema de forma detallada. Para algunosproblemas, podemos proporcionar detalles más específicos.

P3. ¿Qué son los correos electrónicos "no solicitados"?Los correos electrónicos no solicitados son correos electrónicos que el destinatario no ha solicitado recibirde forma explícita. Esto incluye los casos en que un destinatario se inscribe para un determinado tipo decorreo (por ejemplo, notificaciones) y en su lugar se envía otro tipo de correo electrónico (por ejemplo,anuncios). Si el aviso de período de prueba o de suspensión indica que el envío no solicitado es problemasuyo, debería facilitar la siguiente información en su recurso:

• ¿Todos los mensajes que envía han sido solicitados específicamente por el destinatario y se cumplanlos Política de uso aceptable de AWS?

• ¿Ha adquirido las direcciones de correo electrónico de alguna forma distinta a que el cliente interactúeespecíficamente con usted o su sitio web y le haya solicitado los correos electrónicos? Debe explicarcómo ha adquirido su lista de correo.

• ¿Cómo funcionan sus procesos de suscripción y cancelación de la suscripción? Debe incluir sus enlacesde inscripción y cancelación.

P4. ¿Qué debo hacer si recibo un aviso de período de prueba osuspensión por una investigación manual?Como en el caso de los períodos de prueba o suspensión, corrija el problema subyacente que provocael problema especificado en el aviso de período de prueba o de suspensión y, a continuación, recurrapara que su caso se vuelva a evaluar. Para obtener información sobre el proceso de recurso, consulte laspreguntas frecuentes sobre período de prueba y suspensión.

P5. ¿Qué tipos de problemas ve como "subsanables?"En general, creemos que la situación es subsanable si tiene un historial de buenas prácticas de envío ysi hay medidas que puede adoptar para eliminar el envío problemático y, al mismo tiempo, continuar conla mayoría de envío. Por ejemplo, si envía tres tipos distintos de correo electrónico y solo uno de ellos esproblemático, es posible que pueda simplemente detener el envío problemático y continuar con el resto desu envío.

P6. ¿Qué sucede si no puedo encontrar el origen del problema?Puede envíe un correo electrónico a [email protected] desde la dirección de correoelectrónico asociada a su cuenta de AWS y solicitar una muestra del correo electrónico que ha provocadoel problema.

492



Amazon Simple Email Service Developer GuidePreguntas frecuentes sobre la lista negra de IP

Important

Para proteger la seguridad de su cuenta, solo podemos responder a las solicitudes que se envíandesde la dirección de correo electrónico asociada con su cuenta de AWS.

Preguntas frecuentes sobre la lista negra de IP deAmazon SES

Las listas negras de IP son listas de direcciones IP que el gestor de la lista sospecha que envían contenidono solicitado. Las listas negras se denominan a veces listas de agujero negro en tiempo real (RBL) olistas de agujero negro basadas en DNS (DNSBL). Las listas negras están pensadas para utilizarsecomo un factor que los proveedores de correo electrónico tienen en cuenta cuando determinan si uncorreo electrónico entrante es spam. No se han diseñado para ser el único factor utilizado para tomar estadecisión.

Al igual que sucede con las direcciones IP que pertenecen a otros proveedores de servicios de correoelectrónico, las direcciones IP asociadas con Amazon SES pueden aparecer ocasionalmente en algunaslistas negras. En este tema se describe cómo las listas negras pueden afectar a la entrega de correoselectrónicos que envía usando Amazon SES, así como nuestras políticas para quitar nuestras direccionesIP de las listas negras.

Note

Este tema trata de las listas negras que utilizan los proveedores de correo electrónico parabloquear los mensajes entrantes. Para obtener información sobre cómo bloquea Amazon SES elcorreo electrónico saliente enviado a destinatarios cuyas direcciones de correo electrónico hangenerado rebotes anteriormente, consulte Eliminación de una dirección de correo electrónico de lalista de supresión de Amazon SES (p. 462).

P1. ¿Cómo afectan las listas negras a la entrega decorreo electrónico?Hay miles de proveedores de correo electrónico en todo el mundo y hay miles de listas negras disponiblesen Internet. Por este motivo, no hay una respuesta a esta pregunta que se aplique a todos los proveedoresde correo electrónico y a todas las listas negras.

Nuestra investigación muestra que los principales proveedores de correo electrónico, incluidos Gmail,Hotmail y Yahoo, confían en un número muy pequeño de listas negras de gran confianza, como las queofrece Spamhaus. Las listas negras más pequeñas tienen un impacto mucho menor en la entrega entre losproveedores de correo electrónico más grandes.

Por último, los principales proveedores de correo electrónico suelen tener sus propias listas negrasinternas. Por lo general, los proveedores de correo electrónico guardan estas listas muy celosamente y encontadas ocasiones las comparten con el público. Si una dirección IP está en una de estas listas, puedetener un impacto importante en la capacidad de entrega para ese proveedor.

P2. ¿Cómo terminan las direcciones IP en las listasnegras?Hay varias maneras en las que una dirección IP puede terminar en una lista negra. En la mayoría de loscasos, las direcciones IP se añaden a las listas negras cuando envían correo electrónico a una trampade spam. Una trampa de spam es una dirección de correo electrónico que no pertenece a un usuariohumano, sino que existe únicamente para recopilar spam e identificar a los spammers. Algunas listasnegras también permiten a los usuarios individuales enviar direcciones IP. Algunas listas negras incluso

493

Amazon Simple Email Service Developer GuideP3 preguntas frecuentes de listas negras

permiten a los usuarios enviar rangos de direcciones IP completos. Esta es una práctica especialmenteerrónea, porque puede generar un gran número de falsos positivos.

P3. ¿Cómo evita Amazon SES que sus direcciones IPaparezcan en las listas negras?Monitoreamos los mensajes que los usuarios envían a través de Amazon SES. Si el correo electrónico deun remitente genera un gran número de rebotes o reclamaciones, normalmente indica que el remitentetiene un problema mayor que podría dar lugar a que las direcciones IP que utiliza se agreguen a una listanegra. Cuando surgen estas situaciones, es posible que detengamos la capacidad del remitente paraenviar más mensajes de correo electrónico hasta que resuelva primero el problema que causó los reboteso las reclamaciones.

Además, si el correo electrónico de un remitente incluye contenido típico de spam o contenido que noshace considerar que es correo electrónico no solicitado, también podemos detener la capacidad delremitente para enviar correo electrónico.

P4. ¿Puede quitar Amazon SES sus direcciones IP deuna lista negra?Monitoreamos de forma activa los principales proveedores de listas negras, con especial atención aSpamhaus debido a su enorme impacto en la capacidad de entrega entre los principales proveedoresde correo electrónico. Cuando Spamhaus u otro importante proveedor de listas negras incluyen una denuestras direcciones IP, colaboramos directamente con ese proveedor para quitar la dirección de la lista lomás rápido posible.

En el caso de otros proveedores de listas negras, revisamos cada lista caso por caso. Si consideramosque la presencia de una dirección IP de Amazon SES en una lista negra es la causa de los problemas deentrega, nos pondremos en contacto con el proveedor para solicitar que quite la dirección IP. Sin embargo,las distintas listas negras tienen diferentes reglas para incluir las direcciones IP en las listas y quitarlas deellas ("anular su inclusión"). Algunas listas negras no anulan la inclusión de las direcciones IP en la listahasta que transcurre un determinado periodo de tiempo sin que se reciban más informes de spam. Enel caso de las direcciones que se ha incluido varias veces, este periodo puede ser de un año o más. Nopodemos garantizar que podamos quitar las direcciones IP de estas listas negras de manera oportuna.Además, debido a que un gran número de remitentes usan Amazon SES, es posible que las direcciones IPse vuelvan a agregar a estas listas negras poco después de haberlas quitado.

P5. Un proveedor de correo electrónico rechaza micorreo electrónico porque la dirección IP de envíoaparece en una lista negra distinta de Spamhaus.¿Qué puedo hacer?En primer lugar, confirme que el mensaje se bloqueó realmente debido a una lista negra. Si su correoelectrónico se rechazó porque la dirección IP de envío estaba en una lista negra, normalmente recibirá unanotificación de rebote que contiene un mensaje similar al siguiente ejemplo:

554 5.7.1 Service unavailable; Client host [192.0.2.0] blocked using blacklistName; See: http://www.example.com/query/ip/192.0.2.0

Si recibe una notificación de rebote, pero no contiene información parecida al mensaje mostrado en elejemplo anterior, lo más probable es que el proveedor de correo electrónico haya rechazado su mensajepor un motivo no relacionado con las listas negras.

494

Amazon Simple Email Service Developer GuideP6 preguntas frecuentes de listas negras

A continuación, considere en qué lista negra aparece la dirección IP. En general, los grandes proveedoresde correo electrónico, como Gmail, Hotmail y Yahoo, solo tienen en cuenta listas negras de confianza(como Spamhaus) cuando determinan qué mensajes aceptar y cuáles rechazar. Por lo general, lapresencia de su dirección IP de envío en una lista negra distinta de Spamhaus no tiene ningún impacto ensu capacidad de enviar correo electrónico a los clientes que utilizan los principales proveedores de correoelectrónico.

Es posible que otros proveedores de correo electrónico no tengan la misma experiencia en la configuraciónde los sistemas de filtrado de spam que sus homólogos más grandes. Algunos proveedores de correoelectrónico, especialmente los más pequeños, se basan en listas negras de menos confianza pararechazar el correo electrónico. Rechazar el correo electrónico basándose solo en una lista negra,independientemente del tamaño o la reputación de la lista, se considera una práctica errónea, ya quepuede provocar el bloqueo de una gran cantidad de correo electrónico legítimo. Las listas negras máspequeñas son más propensas a incluir direcciones IP legítimas que las listas que ofrecen compañías comoSpamhaus.

Si un proveedor bloquea su correo electrónico porque su dirección IP de envío aparece en una lista negradistinta de Spamhaus, hay varias cosas que puede hacer. En primer lugar, póngase en contacto con eladministrador de correo del dominio que rechazó su mensaje. Demuestre al administrador de correo quesolo envía correo electrónico legítimo que los clientes han solicitado recibir explícitamente. Recomiéndeleque use una política de filtrado de spam menos restrictiva o que haga una excepción con sus mensajes.

Si el proveedor de correo electrónico no puede cambiar sus políticas o no está dispuesto a cambiarles,considere la posibilidad de utilizar una dirección IP dedicada. Las direcciones IP dedicadas son las quesolo usted puede utilizar. Mediante la adopción de buenas prácticas de envío, puede mantener sus tasasde conexión altas, y las tasas de rebotes, reclamaciones y trampas de spam muy bajas. Estas prácticaspueden ayudarle a garantizar que sus direcciones IP no se agregan a las listas negras.

P6. El correo electrónico que envío a Gmail, Yahoo,Hotmail u otro proveedor importante se envía a lacarpeta de spam. ¿Esto sucede porque mi dirección IPde envío está en una lista negra?Los principales proveedores de correo electrónico ponen mucho más énfasis en la interacción recienteque en las listas negras. La interacción reciente hace referencia al número de clientes que han leído ohecho clic en los enlaces de los mensajes que envió en los últimos 30-90 días. Si su dirección de envíono aparece en la lista de Spamhaus, es muy poco probable que el problema de ubicación del buzón deentrada que tiene esté relacionado con la inclusión de su dirección de envío en la lista negra.

Para aumentar las posibilidades de que sus mensajes lleguen a la bandeja de entrada de sus clientes,debería implementar todas las prácticas recomendadas siguientes:

• No alquile o compre listas de correo electrónico.• Envíe correo electrónico solo a los clientes que hayan solicitado de forma explícita recibir sus correos

electrónicos.• Utilice elementos de diseño y estilos de redacción coherentes en cada mensaje que envíe para

asegurarse de que los clientes puedan identificar fácilmente sus mensajes.• Cuando los clientes utilicen un formulario web para suscribirse a su contenido, envíeles un correo

electrónico para confirmar que desean recibir correo electrónico. No les envíe ningún correo electrónicomás hasta que confirmen que desean recibir su correo electrónico. Este proceso se conoce como dobleconfirmación.

• Facilite a sus clientes la cancelación de las suscripciones y acepte las solicitudes de cancelación desuscripción inmediatamente.

495

Amazon Simple Email Service Developer GuidePreguntas frecuentes sobre métricas de correo electrónico

• Deje de enviar mensajes de correo electrónico a clientes que no hayan abierto o hecho clic en losenlaces de los mensajes que haya enviado en los últimos 30-90 días.

• Si envía correo electrónico que contiene enlaces, verifíquelos con la lista de bloqueo de dominios (DBL)de Spamhaus. Para probar sus enlaces, utilice la herramienta de búsqueda de dominios en el sitio webde Spamhaus.

La implementación de estas prácticas puede ayudar a mantener baja la tasa de rebotes y dereclamaciones, y puede reducir el riesgo de enviar correo electrónico a trampas de spam. Al reducirel número de rebotes, reclamaciones y trampas de spam, puede mejorar su reputación de remitente yconseguir que sea más probable que el correo electrónico que envía llegue a la bandeja de entrada de susclientes.

Preguntas frecuentes sobre métricas de envío decorreo electrónico de Amazon SES

Amazon SES recopila varias métricas acerca de los mensajes de correo electrónico que envía. Estasmétricas le permiten analizar la eficacia de su programa de correo electrónico y monitorear estadísticasimportantes como, por ejemplo, las tasas de rebotes y reclamaciones.

En esta sección se incluyen preguntas frecuentes relacionadas con los siguientes temas relacionados conlas métricas de envío de correo electrónico:

• the section called “General” (p. 496)• the section called “Seguimiento de aperturas” (p. 497)• the section called “Seguimiento de clics” (p. 498)

Preguntas generalesP1. Una vez que se entrega un correo electrónico, ¿durantecuánto tiempo sigue Amazon SES recopilando métricas deapertura y de clic?Amazon SES recopila métricas de apertura y clic durante 60 días después de que se envíe cada correoelectrónico.

P2. Si un usuario abre un correo electrónico varias veces o haceclic en un enlace de correo electrónico varias veces, ¿se realizaun seguimiento de cada uno de estos eventos por separado?Si un destinatario abre un correo electrónico varias veces, cada instancia se contabiliza como un evento deapertura único. Del mismo modo, si un destinatario hace clic en el mismo enlace varias veces, cada clic seconsidera como un evento de clic único.

P3. ¿Las métricas de apertura y clic están agregadas o sepueden medir hasta el nivel de destinatario?El seguimiento de aperturas y clics se realiza en el nivel de destinatario. Gracias al seguimiento deaperturas y clic, puede determinar qué destinatarios han abierto un correo electrónico o han hecho clic enun enlace del correo electrónico.

496


Amazon Simple Email Service Developer GuideSeguimiento de aperturas

P4. ¿Puedo recuperar métricas de apertura y clic utilizando elAPI de Amazon SES?El API de Amazon SES no proporciona un método para recuperar las métricas de apertura y clic.Sin embargo, puede recuperar las métricas de apertura y clic para Amazon SES utilizando el API deCloudWatch. Por ejemplo, puede utilizar el AWS CLI para recuperar las métricas de clic mediante el API deCloudWatch emitiendo el siguiente comando:

aws cloudwatch get-metric-statistics --namespace AWS/SES --metric-name Click \ --statistics Sum --period 86400 --start-time 2017-01-01T00:00:00Z \ --end-time 2017-12-31T23:59:59Z

El comando mostrado más arriba recupera el número total de eventos de clic para cada día en 2017. Larecuperación de las métricas de apertura cambia el valor del parámetro metric-name a Open. Tambiénpuede modificar los parámetros start-time y end-time para cambiar el período de análisis o cambiarel parámetro period para análisis más detallado.

Seguimiento de aperturasP1. ¿Cómo funciona el seguimiento de aperturas?En la parte inferior de cada correo electrónico enviado a través de Amazon SES, insertamos una imagenGIF transparente de 1 píxel por 1 píxel. Cada correo electrónico incluye una referencia única a este archivode imagen; cuando la imagen se abre, Amazon SES puede decir exactamente qué mensaje se abrió yquién lo hizo.

La incorporación de este pixel de seguimiento no cambia el aspecto de su correo electrónico.

P2. ¿El seguimiento de aperturas está habilitado de formapredeterminada?El seguimiento de aperturas está disponible para todos los usuarios de Amazon SES de formapredeterminada. Para utilizar el seguimiento de aperturas, debe hacer lo siguiente:

1. Cree un conjunto de configuración.2. En el conjunto de configuración, cree un destino de evento.3. Configure el destino de evento para publicar notificaciones de eventos de apertura en un destino.4. En cada correo electrónico en el que desea realizar el seguimiento de aperturas, especifique el conjunto

de configuración que ha creado en el paso 1.

Para obtener una explicación más detallada de este proceso, consulte the section called “Uso delmonitoreo utilizando la publicación de eventos” (p. 259).

P3. ¿Puedo omitir el píxel de seguimiento de apertura endeterminados correos electrónicos?Hay dos formas de omitir el pixel de seguimiento de apertura en sus mensajes de correo electrónico. Elprimer método consiste en enviar el correo electrónico sin especificar un conjunto de configuración. Deforma alternativa, puede especificar un conjunto de configuración que no esté configurado para publicar losdatos sobre eventos de apertura.

497

Amazon Simple Email Service Developer GuideSeguimiento de clics

P4. ¿Se realiza el seguimiento de apertura en correoselectrónicos de texto sin formato?El seguimiento de apertura solo funciona con correos electrónicos en HTML. Dado que el seguimientode apertura se basa en la inclusión de una imagen, no es posible recopilar métricas de apertura de losusuarios que abren los correos electrónicos a través de un cliente de correo electrónico de solo texto (noHTML).

Seguimiento de clicsP1. ¿Cómo funciona el seguimiento de clics?Para realizar un seguimiento de clics, Amazon SES modifica cada enlace en el cuerpo del correoelectrónico. Cuando los destinatarios hacen clic en un enlace, se envían a un servidor de Amazon SES einmediatamente se reenvían a la dirección de destino. Al igual que con el seguimiento de apertura, cadaenlace de redireccionamiento es único. Esto permite a Amazon SES determinar qué destinatario hace clicen el enlace, cuándo hace clic y el correo electrónico desde el que han llegado al enlace.

Important

Si envía un único mensaje a varios destinatarios, cada destinatario guardará el mismo enlacede seguimiento de clic. Para realizar un seguimiento de la actividad de clic de los destinatariosindividuales, envíe correo electrónico a un destinatario por operación de envío.

P2. ¿Puedo deshabilitar el seguimiento de clics?Puede deshabilitar el seguimiento de clics añadiendo un atributo, ses:no-track, a las etiquetasdelimitadoras en el cuerpo HTML de su correo electrónico. Por ejemplo, si enlaza a la página de inicio deAWS, un enlace delimitador normal se asemejaría a lo siguiente:

<a href="https://aws.amazon.com">Amazon Web Services</a>

Para deshabilitar el seguimiento de clics para ese mismo enlace, modifique el enlace para que se parezcaa lo siguiente:

<a ses:no-track href="aws.amazon.com">Amazon Web Services</a>

Dado que ses:no-track es un atributo HTML estándar, lo eliminamos automáticamente de la versión delmensaje de correo electrónico que llega en a las bandejas de entrada de sus destinatarios.

P3. ¿Existe algún límite en el número de enlaces de los que sepuede realizar un seguimiento en cada correo electrónico?Existe un límite en el número de enlaces a los que se puede hacer seguimiento en un único mensaje decorreo electrónico, aunque es poco probable que encuentre este límite en la práctica. En la actualidad, elsistema de seguimiento de clics puede realizar el seguimiento de 250 enlaces como máximo.

P4. ¿Se recopilan métricas de clics para enlaces en correoselectrónicos de texto sin formato?Para poder utilizar el seguimiento de clics, debe enviar mensajes de correo electrónico HTML. AmazonSES no realiza un seguimiento de los enlaces de correos electrónicos de texto sin formato.

498

Amazon Simple Email Service Developer GuideSeguimiento de clics

P5. ¿Puedo etiquetar enlaces con identificadores únicos?Puede añadir un número ilimitado de etiquetas, como pares de clave-valor, a enlaces en su correoelectrónico utilizando el atributo ses:tags. Al utilizar este atributo, especifique las claves y los valoresutilizando el mismo formato que utilizaría para transferir propiedades CSS en línea: escriba la clave,seguida de dos puntos (:), seguida del valor. Si necesita transferir varios pares de clave-valor, separe cadapar con un punto y coma (;).

Por ejemplo, imagine que desea añadir las etiquetas product:book, genre:fiction,subgenre:scifi, type:newrelease a un enlace. El enlace resultante se asemeja a lo siguiente:

<a ses:tags="product:book;genre:fiction;subgenre:scifi;type:newrelease;" href="http://www.amazon.com/…/">New Releases in Science Fiction</a>

Estas etiquetas se transmitan a través de su destino de publicación de eventos, por lo que puede llevar acabo un análisis adicional en los enlaces específicos en los que los usuarios han hecho clic.

Note

Las etiquetas de enlace pueden incluir los números del 0 al 9, las letras de la A a la Z(mayúsculas y minúsculas), guiones (-) y guiones bajos (_).

P6. ¿Los enlaces de seguimiento utilizan el protocolo HTTP oHTTPS?Los enlaces de seguimiento utilizan el mismo protocolo que los enlaces originales en su correo electrónico.

Por ejemplo, si su correo electrónico incluye un enlace a https://www.amazon.com, el enlace esreemplazado por un enlace de seguimiento que utiliza el protocolo HTTPS. Si su correo electrónico incluyeun enlace a http://www.example.com, el enlace es reemplazado por un enlace de seguimiento queutiliza HTTP. Si su correo electrónico incluye ambos enlaces mencionados anteriormente, el enlace HTTPSse reemplaza por un enlace de seguimiento que utiliza el protocolo HTTPS y el enlace HTTP se reemplazapor un enlace de seguimiento que utiliza el protocolo HTTP.

P7. Hay un enlace en mi correo electrónico del que no se estárealizando un seguimiento. ¿Por qué no?Amazon SES espera que los enlaces de los correos electrónicos contengan direcciones URL codificadascorrectamente. En concreto, las direcciones URL de los enlaces deben cumplir la norma RFC 3986. Si unenlace de un correo electrónico no está codificado correctamente, los destinatarios podrán ver el enlace,pero Amazon SES no realizará un seguimiento de los eventos de clic para dicho enlace.

Normalmente, los problemas relacionados con una codificación incorrecta ocurren en las URL quecontienen cadenas de consulta. Por ejemplo, si la URL de un enlace del correo electrónico contiene uncarácter de espacio no codificado en la cadena de consulta (como el espacio entre "John" y "Doe" en elsiguiente ejemplo: http://www.example.com/path/to/page?name=John Doe), Amazon SES no realizaráun seguimiento de ese enlace. Sin embargo, si la URL utiliza un carácter de espacio codificado en sulugar (como "%20" en el siguiente ejemplo: http://www.example.com/path/to/page?name=John%20Doe),Amazon SES hará un seguimiento del enlace según lo previsto.

499



Recursos de Amazon SESEn la siguiente tabla, se muestran los recursos que le podrían resultar útiles cuando trabaje con AmazonSimple Email Service (Amazon SES).

Recurso Descripción

Amazon Simple Email Service APIReference

La referencia de API de Amazon SES. Contienedescripciones completas de las acciones, parámetros y tiposde datos de la API, así como una lista de errores que elservicio devuelve.

Precios de Amazon SES Información sobre precios de Amazon SES.

SES Sending Limits Increase case El formulario del servicio de atención al cliente para solicitarun aumento de sus límites de envío y salir del entorno depruebas.

Solicitud para eliminar las limitacionesde envío de correo electrónico

El formulario para solicitar eliminar los límites de envío deAmazon EC2 predeterminados.

Foro de Amazon SES El foro en el que los usuarios de Amazon SES puedenpublicar preguntas y tratar de diversos temas de AmazonSES.

Blog de AWS sobre mensajería yselección de destinatarios

El blog que contiene publicaciones de blog y anuncios delequipo de Amazon SES.

Herramientas para desarrolladores deAWS

Enlaces a herramientas y recursos para desarrolladores queproporcionan documentación, ejemplos de código, notas de laversión y otra información para ayudarle a crear aplicacionesinnovadoras con AWS.

Servicio de atención al cliente de AWS El centro para crear y administrar sus casos de AWS Support.También incluye enlaces a otros recursos útiles como foros,preguntas técnicas frecuentes, estado de los servicios y AWSTrusted Advisor.

Contáctese con nosotros Un punto de contacto centralizado para las consultasrelacionadas con la facturación, cuentas, eventos, abuso yotros problemas de AWS.

Glosario de AWS El Glosario de AWS. Contiene definiciones de términoscomunes utilizados en Amazon SES y otros servicios deAWS.

Condiciones de uso Política de uso aceptable de AWS. Describe el abuso decorreo electrónico y otros usos prohibidos de los serviciosweb que ofrece Amazon Web Services, Inc.

[email protected] Una dirección de correo electrónico para notificar sobrecorreo electrónico no solicitado (spam) o malintencionadoenviado desde Amazon SES.

Cuando se ponga en contacto con esta dirección, proporcionela siguiente información:

500





https://aws.amazon.com/forms/ec2-email-limit-rdns-request

https://aws.amazon.com/forms/ec2-email-limit-rdns-request

https://forums.aws.amazon.com/forum.jspa?forumID=90

https://aws.amazon.com//blogs/messaging-and-targeting/

https://aws.amazon.com//blogs/messaging-and-targeting/

https://aws.amazon.com/developertools/

https://aws.amazon.com/developertools/

https://aws.amazon.com/premiumsupport/

https://aws.amazon.com/contact-us/

https://docs.aws.amazon.com/general/latest/gr/glos-chap.html




Recurso Descripción• Los encabezados completos del mensaje. Para

obtener más información acerca de la recuperación deencabezados de correo electrónico, consulte https://support.google.com/mail/answer/22454?hl=en.

• El tipo de abuso que ha experimentado. Por ejemplo, loscorreos electrónicos no solicitados que no incluyen unmétodo para darse de baja.

501

https://support.google.com/mail/answer/22454?hl=en

https://support.google.com/mail/answer/22454?hl=en

Amazon Simple Email Service Developer GuideApéndice: campos de encabezado

Apéndice de la Guía paradesarrolladores de Amazon SES

Este apéndice contiene información complementaria sobre el envío de correos electrónicos a través deAmazon Simple Email Service (Amazon SES).

• Para los requisitos de campo de encabezado de los correos electrónicos que envíe a través de AmazonSES, consulte Apéndice: campos de encabezado (p. 502).

• Para obtener una lista de los tipos de archivo adjuntos que Amazon SES no acepta, consulte Apéndice:tipos de archivos adjuntos no admitidos (p. 503).

• Para obtener información sobre cómo crear un panel básico de seguimiento de rebotes y reclamacionescon otros productos de AWS, consulte Apéndice: crear un panel de capacidad de entrega (p. 504).

Apéndice: campos de encabezadoAmazon SES acepta todos los encabezados de correo electrónico que siguen el formato descrito en RFC822.

Los campos siguientes no pueden aparecer más de una vez en un encabezado:

• Accept-Language• acceptLanguage (Nota: este campo no es estándar. Si es posible, utilice Accept-Language en su lugar).• Archived-At• Auto-Submitted• Bounces-to• Comentarios• Content-Alternative• Content-Base• Content-Class• Content-Description• Content-Disposition• Content-Duration• Content-ID• Content-Language• Longitud del contenido• Content-Location• Content-MD5• Content-Transfer-Encoding• Content-Type• Date (Nota: Amazon SES anula cualquier encabezado Date que proporcione con la hora a la que

Amazon SES acepta el mensaje. La zona horaria del encabezado Date es UTC).• Delivered-To

502



Amazon Simple Email Service Developer GuideApéndice: tipos de archivos adjuntos no admitidos

• Disposition-Notification-Options• Disposition-Notification-To• DKIM-Signature• DomainKey-Signature• Errors-To• From• Importance• In-Reply-To• Keywords• List-Archive• List-Help• List-Id• List-Owner• List-Post• List-Subscribe• List-Unsubscribe• Message-Context• Message-ID (Nota: Amazon SES anula cualquier encabezado Message-ID que proporcione).• MIME-Version• Organization• Original-From• Original-Message-ID• Original-Recipient• Original-Subject• Prioridad• Prioridad• Referencias• Reply-To• Return-Path (Nota: después de que Amazon SES utilice cualquier encabezado Return-Path que

proporcione, elimina dicho encabezado antes de enviar el correo electrónico).• Return-Receipt-To• Sender• Solicitation• Sensitivity• Asunto• Thread-Index• Thread-Topic• Agente de usuario• VBR-Info

Apéndice: tipos de archivos adjuntos no admitidosPuede enviar mensajes con archivos adjuntos a través de Amazon SES utilizando el estándar MultipurposeInternet Mail Extensions (MIME). Amazon SES acepta todos los tipos de archivos adjuntos exceptoarchivos adjuntos con las extensiones de archivo de la siguiente lista.

503

Amazon Simple Email Service Developer GuideApéndice: crear un panel de capacidad de entrega

Note

Algunos ISP tienen limitaciones adicionales (tales como restricciones en relación con los archivosadjuntos archivados), por lo que le recomendamos probar el envío de correo electrónico a travésde los principales ISP antes de enviar su correo electrónico de producción.

.ade

.adp

.app

.asp

.bas

.bat

.cer

.chm

.cmd

.com

.cpl

.crt

.csh

.der

.exe

.fxp

.gadget

.hlp

.hta

.inf

.ins

.isp

.its

.js

.jse

.ksh

.lib

.lnk

.mad

.maf

.mag

.mam

.maq

.mar

.mas

.mat

.mau

.mav

.maw

.mda

.mdb

.mde

.mdt

.mdw

.mdz

.msc

.msh

.msh1

.msh2

.mshxml

.msh1xml

.msh2xml

.msi

.msp

.mst

.ops

.pcd

.pif

.plg

.prf

.prg

.reg

.scf

.scr

.sct

.shb

.shs

.sys

.ps1

.ps1xml

.ps2

.ps2xml

.psc1

.psc2

.tmp

.url

.vb

.vbe

.vbs

.vps

.vsmacros

.vss

.vst

.vsw

.vxd

.ws

.wsc

.wsf

.wsh

.xnk

Apéndice: crear un panel de capacidad de entregaLas tasas de rebote y de reclamaciones puede tener un impacto negativo en su reputación de remitente.Una reputación de remitente negativa reduce las posibilidades de que los mensajes que envíe a través deAmazon SES lleguen a los buzones de los destinatarios. Además, si la tasa de rebote o de reclamacioneses demasiado alta, podríamos limitar o suspender su cuenta para proteger a otros usuarios. Por estasrazones, es fundamental que disponga de un proceso para eliminar direcciones de correo electrónico conrebotes o reclamaciones de la lista de destinatarios.

Esta sección incluye los procedimientos para crear un panel sencillo que muestre información sobrelos rebotes y las reclamaciones. Puede personalizar esta solución para satisfacer sus necesidadesespecíficas. Una vez que haya realizado los procedimientos de este apéndice, recibirá un correoelectrónico todos los días que incluye un enlace a una página web almacenada en un bucket de AmazonS3. Al hacer clic en el enlace, verá un panel que muestra información sobre el número de mensajes

504

Amazon Simple Email Service Developer GuideApéndice: crear un panel de capacidad de entrega

rebotados y reclamaciones que se han recibido en el último periodo de 24 horas. El panel tambiénproporciona información sobre los mensajes que dieron lugar a rebotes y reclamaciones. La siguienteimagen muestra un ejemplo de este panel.

Note

AWS Support no es compatible con esta solución.

Para crear e implementar este panel son necesarios varios pasos:

• Parte 1: Crear un tema en Amazon Simple Notification Service (p. 506) contiene procedimientos paracrear un tema de Amazon SNS. Los temas de Amazon SNS son puntos de acceso para las personasque desean recibir notificaciones específicas.

• Parte 2: Crear una cola en Amazon Simple Queue Service (p. 506) contiene procedimientos paracrear una cola de Amazon SQS. Esta cola de Amazon SQS recopila las notificaciones de rebote yreclamaciones de Amazon SNS y las transfiere a una función de AWS Lambda para someterla a unprocesamiento más amplio.

• Parte 3: Crear un bucket de Amazon Simple Storage Service (p. 507) contiene los procedimientos parala creación de un bucket de Amazon Simple Storage Service (S3), que almacena los paneles generadospor la función Lambda.

• Parte 4: Crear políticas y funciones de AWS Identity and Access Management (p. 507) contieneprocedimientos para configurar políticas y funciones en AWS Identity and Access Management (IAM).Estas políticas y funciones permiten a los componentes de esta solución trabajar conjuntamente deforma segura.

• Parte 5: Configurar notificaciones de rebote y reclamaciones en Amazon SES (p. 509) contieneprocedimientos para configurar Amazon SES para enviar notificaciones de rebotes y reclamaciones adeterminadas direcciones de correo electrónico.

• Parte 6: Crear una función de AWS Lambda (p. 509) contiene procedimientos para crear una funciónde AWS Lambda. La función procesa las notificaciones de rebotes y reclamaciones en la cola deAmazon SQS, crea nuevos paneles y envía por correo electrónico dichos paneles a direcciones queespecifique.

• Parte 7: Probar la función de AWS Lambda (p. 511) contiene información acerca de cómo utilizarel simulador de bandeja de correo de Amazon SES para enviar correos electrónicos de rebotes yreclamaciones de muestra. Después de enviar estos correos electrónicos, puede probar la función deLambda para asegurarse de que funciona correctamente.

505

Amazon Simple Email Service Developer GuideParte 1: Crear un tema de Amazon SNS

• Parte 8: Configurar disparadores en Amazon CloudWatch (p. 512) contiene información acercade la programación de la función de Lambda para que se ejecute siguiendo una programación queespecifique.

En lugar de completar las secciones anteriores, puede descargar una plantilla de AWS CloudFormation delrepositorio de aws-support-tools en GitHub. Para obtener más información acerca de cómo implementarpilas de AWS CloudFormation, consulte Introducción en la Guía del usuario de AWS CloudFormation.

Parte 1: Crear un tema en Amazon Simple NotificationServiceEl primer paso en la creación de un panel de seguimiento de rebotes y reclamaciones consiste en crearun nuevo tema en Amazon Simple Notification Service. Al crear una cola de Amazon SQS en la siguientesección, se suscribirá a este tema para reunir las notificaciones de rebotes y reclamaciones.

Para crear un tema de Amazon SNS nuevo

1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon SNS en https://console.aws.amazon.com/sns/v2/home.

2. En la barra de navegación, elija Topics.3. Elija Create new topic.4. Para Topic name, escriba un nombre para el tema.5. Para Display name, introduzca un nombre de visualización para el tema.6. Elija Create new topic.7. Continúe en Parte 2: Crear una cola en Amazon Simple Queue Service (p. 506).

Parte 2: Crear una cola en Amazon Simple QueueServiceEn este procedimiento, crea una nueva cola en Amazon SQS y se suscribe al tema que ha creado en elprocedimiento anterior. Esta cola recopila todas las notificaciones de rebotes y reclamaciones que recibe;una función de AWS Lambda recopila a continuación las notificaciones en esta cola para someterlas a unprocesamiento más amplio.

Para crear una nueva cola de Amazon SQS

1. Abra la consola de Amazon SQS en https://console.aws.amazon.com/sqs/.2. Si no ha creado una cola de Amazon SQS anteriormente, seleccione Get Started Now.

De lo contrario, si su cuenta de AWS ya contiene una o varias colas de Amazon SQS, seleccioneCreate New Queue.

3. En What do you want to name your queue?, para Queue Name, escriba un nombre para la cola.4. En What type of queue do you need?, elija Standard Queue.5. Elija Configure Queue.6. Para Default Visibility Timeout, elija 5 minutes.7. Deje los demás atributos con su configuración predeterminada. Elija Create Queue.8. En la lista de colas, seleccione la cola que acaba de crear. En el menú Queue Actions, seleccione

Subscribe Queue to SNS Topic.

506

https://raw.githubusercontent.com/awslabs/aws-support-tools/master/SES/SESReports/ses-reports.yaml

https://raw.githubusercontent.com/awslabs/aws-support-tools/master/SES/SESReports/ses-reports.yaml

https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide//GettingStarted.Walkthrough.html

https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/



https://console.aws.amazon.com/sqs/

Amazon Simple Email Service Developer GuideParte 3: Crear un bucket de Amazon S3

9. En la ventana Subscribe to a Topic, seleccione estas opciones:

• En Topic Region, elija la región de AWS que contiene el tema de Amazon SNS que creó en Parte 1:Crear un tema en Amazon Simple Notification Service (p. 506).

• Para Choose a Topic, elija el tema que creó en Parte 1: Crear un tema en Amazon SimpleNotification Service (p. 506).

Elija Subscribe.10. Continúe en Parte 3: Crear un bucket de Amazon Simple Storage Service (p. 507).

Parte 3: Crear un bucket de Amazon Simple StorageServiceEste procedimiento describe cómo crear y configurar un bucket de Amazon S3 en el que almacenar losarchivos de panel que genera la función de AWS Lambda.

Para crear un nuevo bucket de Amazon S3

1. Abra la consola de Amazon S3 en https://console.aws.amazon.com/s3/.2. Elija Create bucket.3. En la ventana Create bucket, para Bucket name, escriba un nombre para el bucket.4. En Region, elija la región de AWS que contiene el tema de Amazon SNS y la cola de Amazon SQS.

Seleccione Create.5. Continúe en Parte 4: Crear políticas y funciones de AWS Identity and Access Management (p. 507).

Parte 4: Crear políticas y funciones de AWS Identityand Access ManagementPara garantizar la seguridad de su cuenta de AWS, debe crear una política y función de AWS Identity andAccess Management (IAM). La política y la función definen las formas en las que los componentes deesta solución pueden interactuar entre sí. Este procedimiento describe cómo configurar estas políticas yfunciones.

Para crear una nueva política y función de IAM

1. Abra la consola de IAM, en https://console.aws.amazon.com/iam/.2. En la barra de navegación, seleccione Policies.3. Elija Create Policy.4. En la pestaña JSON, pegue el siguiente código en el editor:

{ "Version": "2012-10-17", "Statement": [ { "Sid": "AllowSendEmail", "Effect": "Allow", "Action": [ "ses:SendEmail" ], "Resource": [

507



Amazon Simple Email Service Developer GuideParte 4: Crear una política y función de IAM

"*" ] }, { "Sid": "s3allow", "Effect": "Allow", "Action": [ "s3:PutObject", "s3:PutObjectAcl" ], "Resource": [ "arn:aws:s3:::BUCKET_NAME/*" ] }, { "Sid": "AllowQueuePermissions", "Effect": "Allow", "Action": [ "sqs:ChangeMessageVisibility", "sqs:ChangeMessageVisibilityBatch", "sqs:DeleteMessage", "sqs:DeleteMessageBatch", "sqs:GetQueueAttributes", "sqs:GetQueueUrl", "sqs:ReceiveMessage" ], "Resource": [ "SQS_QUEUE_ARN" ] }, { "Effect": "Allow", "Action": [ "logs:CreateLogGroup", "logs:CreateLogStream", "logs:PutLogEvents", "logs:DescribeLogStreams" ], "Resource": [ "arn:aws:logs:*:*:*" ] } ]}

En el código pegado, cambie los siguientes atributos:

• Reemplace BUCKET_NAME por el nombre del bucket de Amazon S3 que creo en Parte 3: Crear unbucket de Amazon Simple Storage Service (p. 507).

• Reemplace SQS_QUEUE_ARN por el ARN de la cola de Amazon SQS que creó en Parte 2: Crear unacola en Amazon Simple Queue Service (p. 506).

Tip

Puede encontrar el ARN de la cola de Amazon SQS mediante el siguiente procedimiento:

1. En la consola de Amazon SQS, elija la cola que creó en Parte 2: Crear una cola enAmazon Simple Queue Service (p. 506).

2. En la sección Details, copie el valor que se muestra junto a ARN. El formato del ARNdebe parecerse al siguiente ejemplo:

arn:aws:sqs:us-east-1:999623213###:sample-queue-name

5. Elija Review policy.

508

Amazon Simple Email Service Developer GuideParte 5: Configurar notificaciones de Amazon SES

6. En la pantalla Review policy, complete las secciones siguientes:

• En Name, escriba un nombre para la política.• En Description, escriba una breve descripción de la política.

7. Elija Create Policy.8. En la barra de navegación, seleccione Roles.9. Elija Create role.10. En Select type of trusted entity, elija Lambda y, a continuación, elija Next: Permissions.11. En la pantalla Attach permissions policies, marque la casilla situada junto al nombre de la política que

acaba de crear y, a continuación, elija Next: Review.12. En la pantalla Review, para Role name, escriba un nombre para la función y, a continuación, elija

Create role.13. Continúe en Parte 5: Configurar notificaciones de rebote y reclamaciones en Amazon SES (p. 509).

Parte 5: Configurar notificaciones de rebote yreclamaciones en Amazon SESPara recibir notificaciones de rebote y reclamaciones desde Amazon SES, debe configurar lasnotificaciones en la consola de Amazon SES. Este procedimiento describe cómo configurar estasnotificaciones.

1. Abra la consola de Amazon SES en https://console.aws.amazon.com/ses/.2. En la barra de navegación, en Identity Management, elija Email Addresses.3. Seleccione la dirección de correo electrónico que desea usar para recibir las notificaciones de rebotes

y reclamaciones y, a continuación, elija View Details.4. En Notifications, elija Edit Configuration.5. Para Bounces y Complaints, elija el tema de Amazon SNS que creó en Parte 1: Crear un tema en

Amazon Simple Notification Service (p. 506). Elija Save Config.6. Repita los pasos 3 a 5 para cada dirección de correo electrónico que deba recibir notificaciones de

rebotes o reclamaciones.7. Abra la consola de Amazon SQS en https://console.aws.amazon.com/sqs/.8. Haga clic con el botón derecho en la cola que ha creado en Parte 2: Crear una cola en Amazon Simple

Queue Service (p. 506) y, a continuación, elija Purge Queue.

Note

Este paso es necesario. Al configurar notificaciones, Amazon SES envía una notificaciónde confirmación que recoge Amazon SNS. La función de Lambda no puede analizar estasconfirmaciones y podría provocar que la función de Lambda devuelva un error.

9. Continúe en Parte 6: Crear una función de AWS Lambda (p. 509).

Parte 6: Crear una función de AWS LambdaAhora que dispone de todos los componentes, puede crear una función de Lambda. La función crea unpanel HTML y le notifica por correo electrónico cuando se actualiza el panel.

Para crear una nueva función de AWS Lambda

1. Descargue sesreport.zip de https://github.com/awslabs/aws-support-tools/raw/master/SES/SESReports/sesreport.zip.

509



https://github.com/awslabs/aws-support-tools/raw/master/SES/SESReports/sesreport.zip

https://github.com/awslabs/aws-support-tools/raw/master/SES/SESReports/sesreport.zip

Amazon Simple Email Service Developer GuideParte 6: Crear una función de Lambda

2. Abra la consola de AWS Lambda en https://console.aws.amazon.com/lambda/.3. En la barra de navegación, elija Functions.4. Elija Create function.5. Elija Author from scratch.6. En la página Author from scratch, siga estos pasos:

• Para Name, escriba un nombre para la función.• En Runtime, elija Node.js 6.10.• En Role, seleccione Choose an existing role.• En Existing role, elija el rol de IAM que creó en Parte 4: Crear políticas y funciones de AWS Identity

and Access Management (p. 507).

Elija Create function.7. En Function code, para Code entry type, elija Upload a .ZIP file.8. Seleccione Upload. Cargar sesreport.zip.9. En Environment variables, añada las siguientes claves y valores:

Claves y valores

Key Valor Valor de muestra

QueueURL La dirección URL de la colade Amazon SQS que creóen Parte 2: Crear una colaen Amazon Simple QueueService (p. 506).

https://sqs.us-east-1.amazonaws.com/999623213###/sample-queue-name

Region La región de AWS en la quecreó el tema de Amazon SNSen Parte 1: Crear un tema enAmazon Simple NotificationService (p. 506).

us-east-1

ToAddr La dirección de correoelectrónico que recibiráel informe de rebotes yreclamaciones.

[email protected]

SrcAddr La dirección de correoelectrónico que enviaráel informe de rebotes yreclamaciones.

[email protected]

BucketName El nombre del bucket deAmazon S3, que creó enParte 3: Crear un bucketde Amazon Simple StorageService (p. 507).

sample-s3-bucket

BucketPrefix [Opcional] Si desea guardarlos paneles en una carpetaen el bucket de Amazon S3,especifique la ruta aquí. La rutaespecificada debe terminar conuna barra inclinada (/).

SES/reports/

510


Amazon Simple Email Service Developer GuideParte 7: Probar la función de Lambda

10. En Basic settings, elija las siguientes opciones:

• En Memory (MB), elija 512 MB.

Note

Si cree que va a recibir más de 5 000 rebotes y reclamaciones al día, aumente el valor delcampo Memory a 1 024 MB como mínimo. Si cree que va a recibir más de 10 000 rebotes yreclamaciones al día, aumente el valor del campo Memory a 1 536 MB como mínimo.

• En Timeout, seleccione 5 min.11. Elija Test.12. En la ventana Configure test event, para Event name, escriba un nombre y, a continuación, elija

Create.13. En la barra de notificación de la parte superior de la página, confirme que la función se ha ejecutado

correctamente. En caso contrario, asegúrese de que ha introducido los valores correctos para lasvariables de entorno en el paso 9.

14. Continúe en Parte 7: Probar la función de AWS Lambda (p. 511).

Parte 7: Probar la función de AWS LambdaAntes de programar la función de Lambda para ejecutarla de forma periódica, debe probarla paraasegurarse de que todos los componentes se hayan configurado de manera apropiada. En esteprocedimiento, envía dos mensajes a través del simulador de bandeja de correo de Amazon SESy, a continuación, ejecuta la función de Lambda para asegurarse de que los mensajes se procesancorrectamente.

Para probar la función de Lambda

1. Abra la consola de Amazon SES en https://console.aws.amazon.com/ses/.2. En la columna de la izquierda, elija Email Addresses o Domains.3. Seleccione una dirección de correo electrónico o un dominio verificado y, a continuación, elija Send a

Test Email.4. Para To:, escriba [email protected]. Para Subject y Body, escriba algún texto

de ejemplo. Elija Send Test Email.5. Repita los pasos 3 y 4 para crear otro mensaje de prueba, pero esta vez, en To:, escriba

[email protected]. Abra la consola de Amazon SQS en https://console.aws.amazon.com/sqs/. La columna Messages

Available debería indicar que hay dos mensajes disponibles.7. Abra la consola de Lambda en https://console.aws.amazon.com/lambda/.8. En la barra de navegación, elija Functions.9. En la lista de funciones, elija la función que creó en Parte 6: Crear una función de AWS

Lambda (p. 509).10. Elija Test. Cuando la función termine de ejecutarse, expanda la sección Details. Si la función de

Lambda se ha configurado correctamente, recibirá uno de los siguientes mensajes:

• null: indica que la función se ejecutó sin errores.• Queue empty: indica que no hay nuevas notificaciones de rebotes o reclamaciones en la cola.

11. Continúe en Parte 8: Configurar disparadores en Amazon CloudWatch (p. 512).

511




Amazon Simple Email Service Developer GuideParte 8: Configurar disparadores de CloudWatch

Parte 8: Configurar disparadores en AmazonCloudWatchDespués de validar que la función de Lambda funciona correctamente, puede utilizar Amazon CloudWatchpara programar la función para ejecutarla todos los días. Cada vez que se ejecuta la función Lambda,recibe un correo electrónico que incluye un enlace a una página web almacenada en un bucket de AmazonS3. Al hacer clic en el enlace, verá un panel que muestra información sobre el número de mensajesrebotados y reclamaciones que se han recibido en el último periodo de 24 horas.

Para configurar las condiciones de disparador en Amazon CloudWatch

1. Abra la consola de CloudWatch en https://console.aws.amazon.com/cloudwatch/.2. En el panel de navegación, en Events, elija Rules.3. Elija Create rule.4. En Event Source, elija Schedule.5. Para Fixed rate of, elija 1 Day.6. En Targets, seleccione Add target.7. Para Function, elija la función de Lambda que ha creado en Parte 6: Crear una función de AWS

Lambda (p. 509) y, a continuación, elija Configure details.8. En Rule definition, para Name, escriba un nombre para la regla y, a continuación, elija Create rule.

512



Historial de documento de la Guíapara desarrolladores de Amazon SES

La tabla siguiente muestra los cambios principales en la Guía para desarrolladores de Amazon SimpleEmail Service (Amazon SES).

Cambio Descripción Fecha demodificación

Actualizaciónde ladocumentación

Se ha añadido información acerca de cómo eliminar datospersonales de Amazon SES (p. 471).

13 de marzo de2018

Documentaciónde códigoabierto

La documentación de Amazon SES está disponible ahora en GitHub.Puede enviar problemas o solicitar cambios en el repositorio deGitHub o realizar cambios directamente y enviar una solicitud deextracción.

22 de febrerode 2018


Se ha añadido una sección que ofrece información acerca de laeliminación de datos personales (p. 471) almacenados en AmazonSES.



Se revisaron las definiciones de los campos de publicación deeventos de Amazon SNS (p. 290) y se añadió un ejemplo de eventode error de presentación (p. 307).

22 de enero de2018


Se actualizó el apéndice Panel de capacidad de entrega (p. 504)para incluir los cambios en IAM y en las consolas de Lambda.

18 de enero de2018


Se actualizó el contenido relacionado con la publicación de eventosen CloudWatch (p. 262) para mencionar los campos incluidos en lalista negra.

15 de enero de2018


Se actualizaron los procedimientos para enviar correo electrónico através de OpenSSL (p. 102) para simplificar su seguimiento.

11 de enero de2018


Se añadió un ejemplo de código para enviar correo electrónico sinprocesar mediante AWS SDK parar Ruby.

2 de enero de2018


Se añadió un ejemplo de código para enviar correo electrónico sinprocesar mediante AWS SDK para PHP.

29 dediciembre de2017

Nuevacaracterística

Se ha añadido contenido relacionado con los mensajes de correoelectrónico de verificación personalizados.

7 de diciembrede 2017


Se ha añadido contenido relacionado con la puesta en pausa delenvío de correo y la exportación de métricas de configuración deconjuntos de configuración.

15 denoviembre de2017

513

https://github.com/awsdocs/amazon-ses-developer-guide




Se añadió un ejemplo de código para enviar correo electrónico sinprocesar mediante AWS SDK for Java.

23 de octubrede 2017


Se añadió un ejemplo de código para enviar correo electrónico sinprocesar mediante AWS SDK for Python (Boto).



Se ha añadido contenido relacionado con las plantillas de correoelectrónico y las características de correo electrónico personalizadas.



Se ha añadido contenido relacionado con la característica dedominio personalizado de mensajes abiertos y en los que se hahecho clic.

18 deseptiembre de2017


Se ha añadido contenido relacionado con el panel de reputación. 24 de agostode 2017


Se ha añadido contenido relacionado con la característica de gruposde IP dedicadas.

17 de agostode 2017


Se ha añadido contenido relacionado con la característicaseguimiento de mensajes abiertos y en los que se ha hecho clic.

1 de agosto de2017


Se ha añadido un índice de ejemplos de código. 26 de junio de2017


Se ha añadido un apéndice que muestra el proceso de creación deun panel de capacidad de entrega para Amazon SES.

22 de junio de2017


Se han actualizado los ejemplos de código de envío de correoelectrónico.

6 de junio de2017


Se ha actualizado para IP dedicadas. 21 denoviembre de2016


Se ha actualizado para la publicación de eventos de envío de correoelectrónico.

2 de noviembrede 2016

Actualizaciónde servicio

Se ha actualizado para reflejar que los usuarios ya no tienen quehabilitar de forma explícita la firma de Easy DKIM después degenerar sus registros de DKIM.

15 deseptiembre de2016


Se ha añadido un tutorial de introducción para recepción de correoelectrónico.

12 de julio de2016


Se ha actualizado para notificaciones mejoradas. 14 de junio de2016


Se ha actualizado para dominios MAIL FROM personalizados. 14 de marzo de2016

514




Se ha actualizado para correo electrónico entrante. 28 deseptiembre de2015


Se ha actualizado para autorización de envío. 8 de julio de2015


Se ha actualizado para registro de AWS CloudTrail. 7 de mayo de2015


Se ha actualizado para reflejar la consolidación de los formularios deaumento de límite de Amazon SES y se ha eliminado la terminologíade "acceso de producción".

8 de abril de2015


Se ha actualizado con nuevos requisitos para registros TXT deverificación de dominio.



Se han añadido preguntas frecuentes de cumplimiento. 15 dediciembre de2014


Se ha actualizado para notificaciones de entrega. 23 de junio de2014


Se ha actualizado para soporte de subdominio. 19 de marzo de2014


Se ha actualizado para ampliación de Amazon SES a la regiónEE.UU. Oeste (Oregón).

29 de enero de2014


Se ha actualizado para ampliación de Amazon SES a la región UE(Irlanda).

15 de enero de2014


Se ha actualizado para reflejar los cambios en la validación decampos de encabezado y tipos de MIME.

6 de noviembrede 2013


Se ha eliminado el contenido en el ID de remitente. 22 de agostode 2013


Se ha actualizado para reflejar el rediseño de la consola de AmazonSES

19 de junio de2013


Se ha reemplazado la lista negra por la lista de supresión. 8 de mayo de2013


Se ha actualizado para la característica de eliminación de lista negra. 4 de marzo de2013


Tipos de MIME añadidos. 4 de febrero de2013


Incluye una sección de introducción para reemplazar la guía deintroducción autónoma, se ha reestructurado el índice y se hanactualizado las instrucciones de integración de Sendmail.

21 de enero de2013

515




Se han añadido secciones de solución de problemas sobre aumentodel desempeño y problemas de SMTP.

12 dediciembre de2012


Se ha reestructurado la información acerca de los límites de envío. 9 de noviembrede 2012


Se ha actualizado el simulador de bandeja de correo de AmazonSES.

3 de octubre de2012


Se ha actualizado el uso de una firma de DKIM para firmar correoelectrónico desde una identidad verificada.

17 de julio de2012


Se ha actualizado para recibir notificaciones de retroalimentaciónde rebotes y reclamaciones a través de Amazon Simple NotificationService (Amazon SNS).

26 de junio de2012


Se ha actualizado para la verificación de dominios. 15 de mayo de2012


Se ha actualizado para reflejar encabezados adicionales y tipos dearchivos adjuntos.

25 de abril de2012


Se ha actualizado para la extensión STARTTLS a SMTP. 7 de marzo de2012


Se ha actualizado para Ruta variable de retorno de sobres (VERP). 22 de febrerode 2012


Se ha actualizado para soporte SMTP. 13 dediciembre de2011


Se ha actualizado para soporte de la consola de administración deAWS.

17 denoviembre de2011


Se ha actualizado para admitir adjuntos. 18 de julio de2011

Versión inicial Esta es la primera versión de la Guía para desarrolladores deAmazon Simple Email Service.

25 de enero de2011

516