Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Configuración de correo electrónico para grupos de usuarios de Amazon Cognito
Determinados eventos de su aplicación pueden provocar que Amazon Cognito envíe correos electrónicos a sus usuarios. Por ejemplo, si configura su grupo de usuarios para que se exija la verificación de correo electrónico, Amazon Cognito envía un correo electrónico cuando un usuario se registra con una cuenta nueva en su aplicación o cuando restablece su contraseña. En función de la acción que inicie el correo electrónico, el correo electrónico contendrá un código de verificación o una contraseña temporal.
Para administrar la entrega de correo electrónico, puede utilizar cualquiera de las siguientes opciones:
-
La configuración de correo electrónico predeterminada que está integrada en el servicio Amazon Cognito.
-
Su configuración de Amazon Simple Email Service (AmazonSES).
Puede cambiar la opción de entrega después de crear el grupo de usuarios.
Amazon Cognito envía mensajes de correo electrónico a sus usuarios con un código que pueden introducir o un URL enlace que pueden seleccionar. En la siguiente tabla se muestran los eventos que pueden generar un mensaje de correo electrónico.
Opciones de mensajes
| Actividad | APIoperación | Opciones de entrega | Opciones de formato | Personalizable | Plantilla de mensaje |
|---|---|---|---|---|---|
| ¿Ha olvidado su contraseña | ForgotPassword, AdminResetUserPassword | Correo electrónico, SMS | Código | No | N/A |
| Invitación | AdminCreateUser | Correo electrónico, SMS | Código | Sí | Mensaje de invitación |
| Autorregistro | SignUp, ResendConfirmationCode | Correo electrónico, SMS | código, enlace | Sí | Mensaje de verificación |
| Verificación de dirección de correo electrónico o número de teléfono | UpdateUserAttributes, AdminUpdateUserAttributes, GetUserAttributeVerificationCode | Correo electrónico, SMS | Código | Sí | Mensaje de verificación |
Amazon SES cobra por los mensajes de correo electrónico. Para obtener más información, consulta los SESprecios de Amazon
Configuración de correo electrónico predeterminada
Amazon Cognito puede usar su configuración de correo electrónico predeterminada para gestionar las entregas de correo electrónico por usted. Si utiliza la opción predeterminada, Amazon Cognito solo permite una cantidad limitada de correos electrónicos al día para su grupo de usuarios. Para obtener más información sobre Service Limits, consulte Cuotas en Amazon Cognito. En el caso de entornos de producción típicos, el límite de correo electrónico predeterminado está por debajo del volumen de entrega requerido. Para habilitar un mayor volumen de entrega, puedes usar tu configuración de SES correo electrónico de Amazon.
Cuando utilizas la configuración predeterminada, utilizas SES los recursos de Amazon gestionados por AWS para enviar mensajes de correo electrónico. Amazon SES añade las direcciones de correo electrónico que devuelven un rebote forzoso a una lista de supresión a nivel de cuenta o a una lista de supresión global. Si una dirección de correo electrónico que no se puede entregar pasa a ser entregable más adelante, no puedes controlar su eliminación de la lista de supresión mientras tu grupo de usuarios esté configurado para usar la configuración predeterminada. Una dirección de correo electrónico puede permanecer indefinidamente en la lista de AWS supresión gestionada. Para gestionar las direcciones de correo electrónico que no se pueden entregar, utiliza tu configuración de SES correo electrónico de Amazon con una lista de supresión a nivel de cuenta, tal y como se describe en la siguiente sección.
Si utilizas la configuración de correo electrónico predeterminada, puedes usar cualquiera de las siguientes direcciones de correo electrónico como dirección: FROM
-
La dirección de correo electrónico predeterminada, no-reply@verificationemail.com.
-
Una dirección de correo electrónico personalizada. Antes de poder usar tu propia dirección de correo electrónico, debes verificarla con Amazon SES y conceder permiso a Amazon Cognito para usar esta dirección.
Configuración de SES correo electrónico de Amazon
Es posible que su aplicación requiera un volumen de entregas superior al disponible con la opción predeterminada. Para aumentar el posible volumen de entrega, usa tus SES recursos de Amazon con tu grupo de usuarios para enviar correos electrónicos a tus usuarios. También puedes monitorear tu actividad de envío de correo electrónico cuando envías mensajes de correo electrónico con tu propia SES configuración de Amazon.
Antes de poder usar tu SES configuración de Amazon, debes verificar una o más direcciones de correo electrónico, o un dominio, con AmazonSES. Usa una dirección de correo electrónico verificada o una dirección de un dominio verificado como dirección de FROM correo electrónico que asignes a tu grupo de usuarios. Cuando Amazon Cognito envía un correo electrónico a un usuario, llama a Amazon SES por usted y utiliza su dirección de correo electrónico.
Cuando utilizas tu SES configuración de Amazon, se aplican las siguientes condiciones:
-
Los límites de entrega de correo electrónico para su grupo de usuarios son los mismos límites que se aplican a la dirección de correo electrónico SES verificada de Amazon que figura en su Cuenta de AWS.
-
Puedes gestionar tus mensajes a direcciones de correo electrónico que no se pueden entregar con una lista de supresión a nivel de cuenta en Amazon SES que anula la lista de supresión global. Cuando utilizas una lista de supresión en el nivel de cuenta, los rechazos de mensajes de correo electrónico afectan a la reputación de su cuenta como remitente. Para obtener más información, consulta Uso de la lista de supresión a SES nivel de cuenta de Amazon en la Guía para desarrolladores de Amazon Simple Email Service.
Regiones de configuración de SES correo electrónico de Amazon
El Región de AWS lugar donde cree un grupo de usuarios tendrá uno de los tres requisitos para la configuración de los mensajes de correo electrónico con AmazonSES. Puede enviar mensajes de correo electrónico desde Amazon SES desde la misma región que su grupo de usuarios, desde varias regiones, incluida la misma región, o desde una o más regiones remotas. Para obtener el mejor rendimiento, envía mensajes de correo electrónico con una identidad SES verificada de Amazon en la misma región que tu grupo de usuarios cuando tengas la opción.
Categorías de requisitos regionales para las identidades SES verificadas de Amazon
- Solo en la región
-
Sus grupos de usuarios pueden enviar mensajes de correo electrónico con identidades verificadas al Región de AWS igual que el grupo de usuarios. En la configuración de correo electrónico predeterminada sin una dirección de
FROMcorreo electrónico personalizada, Amazon Cognito utiliza una identidadno-reply@verificationemail.comverificada en la misma región. - Compatible con versiones anteriores
-
Sus grupos de usuarios pueden enviar mensajes de correo electrónico con identidades verificadas en la misma región Región de AWS o en una de las siguientes regiones alternativas:
-
Este de EE. UU. (Norte de Virginia)
-
Oeste de EE. UU. (Oregón)
-
Europe (Irlanda)
Esta función permite la continuidad de los recursos del grupo de usuarios que podría haber creado para cumplir con los requisitos de Amazon Cognito cuando se lanzó el servicio. Los grupos de usuarios de ese período solo podían enviar mensajes de correo electrónico con identidades verificadas en un número limitado de Regiones de AWS. En la configuración de correo electrónico predeterminada sin una dirección de
FROMcorreo electrónico personalizada, Amazon Cognito utiliza una identidadno-reply@verificationemail.comverificada en la misma región. -
- Región alternativa
-
Sus grupos de usuarios pueden enviar mensajes de correo electrónico con identidades verificadas en una alternativa Región de AWS que se encuentre fuera de la región del grupo de usuarios. Esta configuración se produce cuando Amazon no SES está disponible en una región en la que Amazon Cognito esté disponible.
La política de autorización de SES envío de Amazon para su identidad verificada en la región alternativa debe confiar en el director de servicio de Amazon Cognito de la región de origen. Para obtener más información, consulte Para conceder permisos, utilice la configuración de correo electrónico predeterminada.
En algunas de estas regiones, Amazon Cognito divide los mensajes de correo electrónico entre dos regiones alternativas para la configuración de correo electrónico predeterminada de.
COGNITO_DEFAULTEn estos casos, para utilizar una dirección deFROMcorreo electrónico personalizada, la política de autorización de SES envío de Amazon para su identidad verificada en cada región alternativa debe confiar en el director de servicio de Amazon Cognito de la región de origen. Para obtener más información, consulte Para conceder permisos, utilice la configuración de correo electrónico predeterminada. Con la configuración de SES correo electrónico de AmazonDEVELOPERen estas regiones, debe usar una identidad verificada en la primera región de la lista y configurarla para que confíe en el director de servicio de Amazon Cognito en la región del grupo de usuarios. Por ejemplo, en un grupo de usuarios de Oriente Medio (UAE), configure una identidad verificada en Europa (Fráncfort) para que sea de confianzacognito-idp.me-central-1.amazonaws.com. En la configuración de correo electrónico predeterminada sin una dirección deFROMcorreo electrónico personalizada, Amazon Cognito utiliza una identidadno-reply@verificationemail.comverificada en cada región.
nota
En la siguiente combinación de condiciones, debe especificar el SourceArn parámetro EmailConfigurationcon un comodín en el elemento Región, en el formato. arn: Esto permite a su grupo de usuarios enviar mensajes de correo electrónico con identidades verificadas idénticas a las suyas Cuenta de AWS en ambos Regiones de AWS casos.${Partition}:ses:*:${Account}:identity/${IdentityName}
-
EmailSendingAccount El tuyo es
COGNITO_DEFAULT. -
Quieres usar una
FROMdirección personalizada. -
Su grupo de usuarios envía correos electrónicos a una región alternativa.
-
Tu grupo de usuarios tiene una segunda región 1alternativa especificada en la siguiente tabla de regiones SES compatibles con Amazon.
Si crea un grupo de usuarios mediante programación (con AWS SDK Amazon Cognito API oCLI, o), AWS CloudFormation su grupo de usuarios envía mensajes de correo electrónico con la AWS CDK SES identidad de Amazon que el SourceArn parámetro especifica para su grupo de usuarios. EmailConfiguration La SES identidad de Amazon debe ocupar un soporte Región de AWS. Si su EmailSendingAccount es COGNITO_DEFAULT y no especifica un parámetro SourceArn, Amazon Cognito envía mensajes de correo electrónico desde no-reply@verificationemail.com utilizando recursos de la región donde creó el grupo de usuarios.
En la siguiente tabla se muestra Regiones de AWS dónde puede utilizar SES las identidades de Amazon con Amazon Cognito.
| Región del grupo de usuarios | Opción de región | Regiones SES compatibles con Amazon |
|---|---|---|
|
Este de EE. UU. (Norte de Virginia) |
Compatible con versiones anteriores |
Este de EE. UU. (Norte de Virginia), Oeste de EE. UU. (Oregón), Europa (Irlanda) |
|
Este de EE. UU. (Ohio) |
Compatible con versiones anteriores |
Este de EE. UU. (Ohio), Este de EE. UU. (Norte de Virginia), Oeste de EE. UU. (Oregón), Europa (Irlanda) |
|
Oeste de EE. UU. (Norte de California) |
Solo en la región |
Oeste de EE. UU. (Norte de California) |
|
Oeste de EE. UU. (Oregón) |
Compatible con versiones anteriores |
Este de EE. UU. (Norte de Virginia), Oeste de EE. UU. (Oregón), Europa (Irlanda) |
|
Canadá (centro) |
Compatible con versiones anteriores |
Canadá (centro), Este de EE. UU. (Norte de Virginia), Oeste de EE. UU. (Oregón), Europa (Irlanda) |
|
Oeste de Canadá (Calgary) |
Región alternativa |
Canadá (centro), EE.UU. oeste (norte de California) 1 |
|
Asia-Pacífico (Tokio) |
Compatible con versiones anteriores |
Asia-Pacífico (Tokio), Este de EE. UU. (Norte de Virginia), Oeste de EE. UU. (Oregón), Europa (Irlanda) |
|
Asia-Pacífico (Hong Kong) |
Región alternativa |
Asia Pacífico (Singapur), Asia Pacífico (Tokio) 1 |
|
Asia-Pacífico (Seúl) |
Compatible con versiones anteriores |
Asia-Pacífico (Seúl), Este de EE. UU. (Norte de Virginia), Oeste de EE. UU. (Oregón), Europa (Irlanda) |
|
Asia Pacific (Bombay) |
Compatible con versiones anteriores |
Asia-Pacífico (Bombay), Este de EE. UU. (Norte de Virginia), Oeste de EE. UU. (Oregón), Europa (Irlanda) |
|
Asia-Pacífico (Hyderabad) |
Región alternativa |
Asia Pacífico (Bombay), Asia Pacífico (Singapur) 1 |
|
Asia-Pacífico (Singapur) |
Compatible con versiones anteriores |
Asia-Pacífico (Singapur), Este de EE. UU. (Norte de Virginia), Oeste de EE. UU. (Oregón), Europa (Irlanda) |
|
Asia-Pacífico (Sídney) |
Compatible con versiones anteriores |
Asia-Pacífico (Sídney), Este de EE. UU. (Norte de Virginia), Oeste de EE. UU. (Oregón), Europa (Irlanda) |
|
Asia-Pacífico (Osaka) |
Solo en la región |
Asia-Pacífico (Osaka) |
|
Asia-Pacífico (Yakarta) |
Solo en la región |
Asia-Pacífico (Yakarta) |
|
Asia-Pacífico (Melbourne) |
Región alternativa |
Asia Pacífico (Sídney), Asia Pacífico (Singapur) 1 |
|
Europe (Irlanda) |
Compatible con versiones anteriores |
Este de EE. UU. (Norte de Virginia), Oeste de EE. UU. (Oregón), Europa (Irlanda) |
|
Europe (Londres) |
Compatible con versiones anteriores |
Europa (Londres), Este de EE. UU. (Norte de Virginia), Oeste de EE. UU. (Oregón), Europa (Irlanda) |
|
Europa (París) |
Solo en la región |
Europa (París) |
|
Europe (Fráncfort) |
Compatible con versiones anteriores |
Europa (Londres), Este de EE. UU. (Norte de Virginia), Oeste de EE. UU. (Oregón), Europa (Irlanda) |
|
Europa (Zúrich) |
Región alternativa |
Europa (Fráncfort), Europa (Londres) 1 |
|
Europa (Estocolmo) |
Solo en la región |
Europa (Estocolmo) |
| Europa (Milán) |
Solo en la región |
Europa (Milán) |
| Europa (España) |
Región alternativa |
Europa (París), Europa (Estocolmo) 1 |
|
Medio Oriente (Baréin) |
Solo en la región |
Medio Oriente (Baréin) |
|
Oriente Medio () UAE |
Región alternativa |
Europa (Frankfurt), Europa (Londres) 1 |
|
América del Sur (São Paulo) |
Solo en la región |
América del Sur (São Paulo) |
|
Israel (Tel Aviv) |
Solo en la región |
Israel (Tel Aviv) |
|
África (Ciudad del Cabo) |
Solo en la región |
África (Ciudad del Cabo) |
1 Se utiliza en grupos de usuarios con la configuración de correo electrónico predeterminada. Amazon Cognito distribuye los mensajes de correo electrónico entre identidades verificadas con la misma dirección de correo electrónico en cada región. Para usar una FROM dirección personalizada, configúrela EmailConfiguration con un SourceArn parámetro del formato. arn:${Partition}:ses:*:${Account}:identity/${IdentityName}
Configuración de correo electrónico para el grupo de usuarios
Siga los pasos que se indican a continuación para configurar las opciones de correo electrónico para el grupo de usuarios. En función de la configuración que utilice, es posible que necesite IAM permisos en AmazonSES, AWS Identity and Access Management (IAM) y Amazon Cognito.
nota
Los recursos que cree en estos pasos no se pueden compartir entre Cuentas de AWS. Por ejemplo, no puedes configurar un grupo de usuarios en una cuenta y luego usarlo con una dirección de SES correo electrónico de Amazon en una cuenta diferente. Por lo tanto, si utiliza Amazon Cognito en varias cuentas, recuerde repetir estos pasos en cada una de ellas.
Paso 1: Verifica tu dirección de correo electrónico o dominio con Amazon SES
Antes de configurar tu grupo de usuarios, debes verificar uno o más dominios o direcciones de correo electrónico con Amazon SES si deseas realizar alguna de las siguientes acciones:
-
Usa tu propia dirección de correo electrónico como FROM dirección
-
Usa tu SES configuración de Amazon para gestionar la entrega del correo electrónico
Al verificar su dirección de correo electrónico, confirma que es la suya, lo que ayuda a evitar el uso no autorizado.
Para obtener información sobre cómo verificar una dirección de correo electrónico con AmazonSES, consulta Verificación de una dirección de correo electrónico en la Guía para desarrolladores de Amazon Simple Email Service. Para obtener información sobre la verificación de un dominio con AmazonSES, consulta Verificación de dominios.
Paso 2: Saca tu cuenta del entorno de pruebas de SES Amazon
Omita este paso si utiliza la configuración de correo electrónico predeterminada de Amazon Cognito.
La primera vez que utilices Amazon SES en una región Región de AWS, te colocará Cuenta de AWS en el SES entorno limitado de Amazon de esa región. Amazon SES utiliza el sandbox para evitar el fraude y el abuso. Si utiliza la SES configuración de Amazon para gestionar la entrega de correo electrónico, debe Cuenta de AWS sacarla del entorno limitado antes de que Amazon Cognito pueda enviar correos electrónicos a sus usuarios.
En el entorno limitado, Amazon SES impone restricciones sobre la cantidad de correos electrónicos que puede enviar y dónde puede enviarlos. Puedes enviar correos electrónicos solo a direcciones y dominios que hayas verificado con AmazonSES, o puedes enviarlos a direcciones del simulador de SES buzones de Amazon. Mientras estés Cuenta de AWS en la zona de pruebas, no utilices tu SES configuración de Amazon para aplicaciones que estén en producción. En esta situación, Amazon Cognito no puede enviar mensajes a las direcciones de correo electrónico de sus usuarios.
Para sacarte Cuenta de AWS del sandbox, consulta Cómo salir del SES sandbox de Amazon en la Guía para desarrolladores de Amazon Simple Email Service.
Paso 3: Conceder permisos de correo electrónico a Amazon Cognito
Es posible que tenga que conceder permisos específicos a Amazon Cognito para que pueda enviar correos electrónicos a sus usuarios. Los permisos que concedas y el proceso que utilices para concederlos dependen de si utilizas la configuración de correo electrónico predeterminada o la SES configuración de Amazon.
Complete este paso solo si configura su grupo de usuarios para que envíe correo electrónico con Cognito o esté configurado EmailSendingAccount en. COGNITO_DEFAULT
Con la configuración de correo electrónico predeterminada, su grupo de usuarios puede enviar mensajes de correo electrónico con cualquiera de las siguientes direcciones.
-
La dirección predeterminada
no-reply@verificationemail.com. -
Una FROM dirección personalizada de tus dominios o direcciones de correo electrónico verificados en AmazonSES.
Si utiliza una dirección personalizada, Amazon Cognito necesita otros permisos para poder usar esta dirección con el fin de enviar los email a sus usuarios. Estos permisos se otorgan mediante una política de autorización de envío para la dirección o el dominio de AmazonSES. Si utiliza la consola de Amazon Cognito para añadir una dirección personalizada a su grupo de usuarios, la política se adjunta automáticamente a la dirección de correo electrónico SES verificada de Amazon. Sin embargo, si configura su grupo de usuarios fuera de la consola, por ejemplo, mediante Amazon Cognito AWS CLI o Amazon CognitoAPI, debe adjuntar la política mediante la SESconsola de Amazon
nota
Solo puede configurar una FROM dirección en un dominio verificado mediante Amazon CognitoAPI. AWS CLI
Una política de autorización de envío permite o deniega el acceso en función de los recursos de la cuenta que utilizan Amazon Cognito para invocar a Amazon. SES Para obtener más información sobre las políticas basadas en recursos, consulte la Guía del usuario. IAM También puedes encontrar ejemplos de políticas basadas en recursos en la Guía para SESdesarrolladores de Amazon.
ejemplo Política de autorización de envío
El siguiente ejemplo de política de autorización de envío otorga a Amazon Cognito una capacidad limitada para usar una SES identidad verificada de Amazon. Amazon Cognito solo puede enviar mensajes de correo electrónico cuando lo hace en nombre del grupo de usuarios en la condición aws:SourceArn y la cuenta en la condición aws:SourceAccount.
Para obtener más información sobre la sintaxis de las políticas, consulta las políticas de autorización de SES envío de Amazon en la Guía para desarrolladores de Amazon Simple Email Service.
Para ver más ejemplos, consulta los ejemplos de políticas de autorización de SES envío de Amazon en la Guía para desarrolladores de Amazon Simple Email Service.
Si configura su grupo de usuarios para que utilice su SES configuración de Amazon, Amazon Cognito necesitará permisos adicionales para llamar a Amazon SES en su nombre cuando envíe correos electrónicos a sus usuarios. Esta autorización se concede con el IAM servicio.
Al configurar su grupo de usuarios con esta opción, Amazon Cognito crea un rol vinculado a un servicio, que es un tipo de IAM rol, en su. Cuenta de AWS Este rol contiene los permisos que permiten a Amazon Cognito acceder a Amazon SES y enviar correos electrónicos con su dirección.
Amazon Cognito crea su función vinculada al servicio con AWS las credenciales de la sesión de usuario que establece la configuración. Los IAM permisos de esta sesión deben incluir la acción. iam:CreateServiceLinkedRole Para obtener más información sobre los permisosIAM, consulte Administración del acceso a los AWS recursos en la Guía del IAM usuario.
Para obtener más información acerca del rol vinculado al servicio que crea Amazon Cognito, consulte Uso de roles vinculados a servicios para Amazon Cognito.
Paso 4: Configurar el nodo grupo de usuarios
Realice los siguientes pasos si desea configurar el grupo de usuarios con cualquiera de los siguientes elementos:
-
Una FROM dirección personalizada que aparece como remitente del correo
-
Una dirección REPLY -TO personalizada que recibe los mensajes que los usuarios envían a su FROM dirección
-
Tu SES configuración de Amazon
nota
Si su identidad verificada es una dirección de correo electrónico, Amazon Cognito establece esa dirección de correo electrónico como dirección de correo electrónico FROM y REPLY -TO de forma predeterminada. Sin embargo, si su identidad verificada es un dominio, debe proporcionar un valor para las direcciones de correo electrónico FROM y REPLY -TO. Por ejemplo, si tu dominio verificado es example.com, puedes configurar no-reply@example.com como dirección de correo electrónico FROM y REPLY -TO.
Omita este procedimiento si desea utilizar la configuración y la dirección de correo electrónico predeterminadas de Amazon Cognito.
Para configurar el grupo de usuarios de modo que use una dirección de email personalizada
-
Vaya a la consola de Amazon Cognito
. Si se le solicita, introduzca sus credenciales. AWS -
Elija User Pools (Grupos de usuarios).
-
Elija en la lista un usuario existente.
-
Elija el iconoMensajeríatab, busqueConfiguración de correo electrónico, eligeEditar.
-
En la página Editar configuración de correo electrónico, selecciona Enviar correo electrónico desde Amazon SES o Enviar correo electrónico con Amazon Cognito. Puedes personalizar la SESregión, el conjunto de configuraciones y el nombre FROM del remitente solo si seleccionas Enviar correo electrónico desde Amazon SES.
-
Para usar una FROM dirección personalizada, complete los siguientes pasos:
-
En SESRegión, selecciona la región que contiene tu dirección de correo electrónico verificada.
-
En Dirección de FROM correo electrónico, elige tu dirección de correo electrónico. Utiliza una dirección de correo electrónico que hayas verificado con AmazonSES.
-
(Opcional) En Conjunto de configuraciones, elige un conjunto de configuraciones para SES que lo use Amazon. Si realiza y guarda este cambio, se crea un rol vinculado al servicio.
-
(Opcional) En la dirección FROM del remitente, introduce una dirección de correo electrónico. Puede proporcionar solo la dirección de email o la dirección de email junto con un nombre en el formato
Jane Doe <janedoe@example.com>. -
(Opcional) En la dirección de correo electrónico REPLY -TO, introduce la dirección de correo electrónico en la que deseas recibir los mensajes que los usuarios envíen a tu FROM dirección.
-
-
Elija Guardar cambios.
Temas relacionados
