Configuración de mensajes SMS para grupos de usuarios de Amazon Cognito - Amazon Cognito

Configuración de mensajes SMS para grupos de usuarios de Amazon Cognito

Algunos eventos de Amazon Cognito para su grupo de usuarios pueden hacer que Amazon Cognito envíe mensajes de texto SMS a sus usuarios. Por ejemplo, si configura su grupo de usuarios para que requiera la verificación por teléfono, Amazon Cognito envía un mensaje de texto SMS 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 mensaje de texto SMS, en este se incluirá un código de verificación, una contraseña temporal o un mensaje de bienvenida.

En Amazon Cognito, se utiliza Amazon Simple Notification Service (Amazon SNS) para el envío de mensajes de texto SMS. Si es la primera vez que envía un mensaje de texto a través de Amazon Cognito o Amazon SNS, Amazon SNS lo colocará en un entorno aislado. En el entorno aislado, puede probar los mensajes de texto SMS de sus aplicaciones. En el entorno de pruebas, los mensajes solo se pueden enviar a números de teléfono verificados.

Configuración de mensajes SMS por primera vez en grupos de usuarios de Amazon Cognito

En Amazon Cognito, se utiliza Amazon SNS para enviar mensajes SMS a los grupos de usuarios. También puede utilizar un Desencadenador de Lambda para remitentes personalizados de SMS para usar sus propios recursos para enviar mensajes SMS. La primera vez que configure Amazon SNS para enviar mensajes de texto SMS en una Región de AWS determinada, Amazon SNS coloca su Cuenta de AWS en el entorno aislado de SMS para esa región. Amazon SNS utiliza el entorno aislado para evitar el fraude y el abuso y para cumplir con los requisitos de conformidad. Cuando su Cuenta de AWS está en el entorno aislado, Amazon SNS impone algunas restricciones. Por ejemplo, puede enviar mensajes de texto a un máximo de 10 números de teléfono que haya verificado con Amazon SNS. Mientras la Cuenta de AWS permanezca en el entorno aislado, no utilice su configuración de Amazon SNS para aplicaciones que estén en producción. Cuando se encuentra en el entorno de pruebas, Amazon Cognito no puede enviar mensajes a los números de teléfono de sus usuarios.

Para enviar mensajes de texto SMS a los usuarios del grupo de usuarios

  1. Elija la Región de AWS para los mensajes SMS de Amazon SNS.

  2. Si quiere enviar mensajes SMS a números de teléfono de EE. UU., debe obtener una identidad de origen.

  3. Confirme que se encuentra en el entorno aislado de SMS.

  4. Saque la cuenta del entorno aislado de Amazon SNS.

  5. Verifique los números de teléfono de Amazon Cognito en Amazon SNS.

  6. Termine de configurar el grupo de usuarios en Amazon Cognito.

Paso 1: Elegir la Región de AWS para los mensajes SMS de Amazon SNS.

En algunos Regiones de AWS, puede elegir la región que contiene los recursos de Amazon SNS que desea utilizar para los mensajes SMS de Amazon Cognito. En cualquier Región de AWS donde Amazon Cognito esté disponible, excepto en Asia-Pacífico (Seúl), puede utilizar los recursos de Amazon SNS de la Región de AWS donde ha creado el grupo de usuarios. Para que la mensajería SMS sea más rápida y fiable cuando pueda elegir entre regiones, utilice los recursos de Amazon SNS en la misma región que el grupo de usuarios.

nota

En la AWS Management Console solo se puede cambiar la región de los recursos SMS después de haber cambiado a la nueva experiencia de consola de Amazon Cognito.

Elija una región para los recursos SMS en el paso Configurar entrega de mensajes del nuevo asistente del grupo de usuarios. También puede elegir Edit (Editar) bajo SMS en la pestaña Messaging (Mensajería) de un grupo de usuarios existente.

Durante el lanzamiento, para algunas Regiones de AWS, Amazon Cognito envió mensajes SMS con recursos de Amazon SNS en una región alternativa. Para configurar su región preferida, utilice el parámetro SnsRegion del objeto SmsConfigurationType para su grupo de usuarios. Si crea un recurso de grupos de usuarios de Amazon Cognito mediante programación en una región de Amazon Cognito de la siguiente tabla y no proporciona un parámetro SnsRegion, el grupo de usuarios puede enviar mensajes SMS con recursos de Amazon SNS en una región de Amazon SNS heredada.

Los grupos de usuarios de Amazon Cognito en Asia-Pacífico (Seúl) Región de AWS deben utilizar su configuración de Amazon SNS en la región de Asia-Pacífico (Tokio).

Amazon SNS establece la cuota de gasto para todas las cuentas nuevas en 1,00 USD al mes. Es posible que haya aumentado el límite de gasto en una Región de AWS que utilice con Amazon Cognito. Antes de cambiar la Región de AWS para los mensajes SMS de Amazon SNS, abra un caso de aumento de cuota en el centro de soporte de AWS para aumentar el límite en la nueva región. Para obtener más información, consulte Solicitud de aumento de la cuota de gasto mensual de SMS para Amazon SNS en la guía para desarrolladores de Amazon Simple Notification Service.

Puede enviar mensajes SMS a cualquier región de Amazon Cognito de la siguiente tabla con los recursos de Amazon SNS en la correspondiente región de Amazon SNS.

Región de Amazon Cognito Región de Amazon SNS
Este de EE. UU. (Ohio) EE. UU. Este (Ohio), EE. UU. Este (Norte de Virginia)
Asia-Pacífico (Mumbai) Asia Pacífico (Mumbai), Asia Pacífico (Singapur)
Canadá (centro) Canadá (Central), EE. UU. Este (Norte de Virginia)
Europa (Fráncfort) Europa (Fráncfort), Europa (Irlanda)
Europa (Londres) Europa (Londres), Europa (Irlanda)
Asia-Pacífico (Seúl) Asia-Pacífico (Tokio)
Este de EE. UU. (Norte de Virginia) Este de EE. UU. (Norte de Virginia)
Oeste de EE. UU. (Norte de California) Oeste de EE. UU. (Norte de California)
Oeste de EE. UU. (Oregón) Oeste de EE. UU. (Oregón)
Asia-Pacífico (Singapur) Asia-Pacífico (Singapur)
Asia-Pacífico (Sídney) Asia-Pacífico (Sídney)
Asia-Pacífico (Tokio) Asia-Pacífico (Tokio)
Europe (Ireland) Europe (Ireland)
Europa (París) Europa (París)
Europa (Estocolmo) Europa (Estocolmo)
Medio Oriente (Baréin) Medio Oriente (Baréin)
América del Sur (São Paulo) América del Sur (São Paulo)

Paso 2: Obtener una identidad de origen para enviar mensajes SMS a números de teléfono de EE. UU.

Si tiene previsto enviar mensajes de texto SMS a números de teléfono de EE. UU., debe obtener una identidad de origen, independientemente de si crea un entorno de pruebas aislado de SMS o un entorno de producción.

A partir del 1 de junio de 2021, los operadores estadounidenses exigen una identidad de origen para enviar mensajes a números de teléfono de EE. UU. Si no dispone de una identidad de origen, debe obtener una. Para saber cómo obtener una identidad de origen, consulte Solicitud de un número en la Guía del usuario de Amazon Pinpoint.

Si opera en las siguientes Regiones de AWS, debe crear un ticket de AWS Support para obtener una identidad de origen. Para obtener instrucciones, consulte Solicitud de soporte para mensajería SMS en la Guía para desarrolladores de Amazon Simple Notification Service.

  • Este de EE. UU. (Ohio)

  • Europa (Estocolmo)

  • Medio Oriente (Baréin)

  • Europa (París)

  • América del Sur (São Paulo)

  • Oeste de EE. UU. (Norte de California)

Paso 3: Confirmar que se encuentra en el entorno aislado de SMS

Utilice el procedimiento siguiente para confirmar que está en el entorno aislado de SMS. Repita este proceso para cada Región de AWS donde tenga grupos de usuarios de Amazon Cognito de producción.

Original console

Confirmar que se encuentra en el entorno de pruebas de SMS

  1. Abra la consola de Amazon Cognito desde https://console.aws.amazon.com/cognito. Si se le solicita, escriba sus credenciales de AWS.

  2. Cree un nuevo grupo de usuarios o edite un grupo de usuarios existente.

  3. Si su cuenta se encuentra en el entorno de pruebas de SMS, verá el siguiente mensaje en Amazon Cognito.

    You are currently in a Sandbox environment in Amazon SNS.

    Si no ve este mensaje, signfica que alguien ya ha realizado los pasos necesarios para configurar los mensajes SMS en su cuenta. Vaya a Paso 6: Completar la configuración del grupo de usuarios en Amazon Cognito.

  4. Elija el enlace de Amazon SNS en el mensaje para abrir la consola de Amazon SNS en una pestaña nueva.

  5. Compruebe que se encuentre en el entorno de pruebas. El mensaje de la consola indica el estado aislado y la Región de AWS del siguiente modo:

    This account is in the SMS sandbox in US East (N. Virginia).

New console

Confirmar que se encuentra en el entorno de pruebas de SMS

  1. Diríjase a la consola de Amazon Cognito. Si se le solicita, escriba sus credenciales de AWS.

  2. ElegirUser Pools (Grupos de usuarios).

  3. Elija en la lista un usuario existente.

  4. Elija el iconoMensajeríapestaña.

  5. En el navegadorConfiguración de SMSsección, expandirMover al entorno de producción de Amazon SNS. Si su cuenta se encuentra en el entorno de pruebas de SMS, verá el siguiente mensaje en Amazon Cognito.

    You are currently in the SMS Sandbox and cannot send SMS messages to unverified numbers.

    Si no ve este mensaje, signfica que alguien ya ha realizado los pasos necesarios para configurar los mensajes SMS en su cuenta. Vaya a Paso 6: Completar la configuración del grupo de usuarios en Amazon Cognito.

  6. Elija el enlace de Amazon SNS en el mensaje. Esto abre la consola de Amazon SNS en una pestaña nueva.

  7. Compruebe que se encuentre en el entorno de pruebas. El mensaje de la consola indica el estado aislado y la Región de AWS del siguiente modo:

    This account is in the SMS sandbox in US East (N. Virginia).

Paso 4: Quitar la cuenta del entorno aislado de Amazon SNS

Si está probando su aplicación y solo necesita enviar mensajes SMS a números de teléfono que sus administradores puedan verificar, omita este paso y continúe con el paso 5.

Para utilizar su aplicación en producción, quite la cuenta del entorno aislado de SMS y entre en producción. Después de configurar una identidad de origen en la Región de AWS que contiene los recursos de Amazon SNS que desea que utilice Amazon Cognito, puede verificar los números de teléfono de EE. UU. mientras su Cuenta de AWS permanece en el entorno aislado de SMS. Cuando su entorno de Amazon SNS esté en producción, no tendrá que verificar los números de teléfono de los usuarios en Amazon SNS para enviar mensajes SMS a sus usuarios.

Para obtener instrucciones detalladas, consulte la sección de salida del entorno aislado de Amazon SNS en la Guía para desarrolladores de Amazon Simple Notification Service.

Paso 5: Verificar los números de teléfono de Amazon Cognito en Amazon SNS

Si ha quitado la cuenta del entorno aislado de SMS, omita este paso y continúe con el paso 6.

Cuando esté en el entorno aislado de SMS, podrá enviar mensajes a cualquier número de teléfono que haya verificado con Amazon SNS.

Para verificar un número de teléfono, haga lo siguiente:

  1. Añada un Sandbox destination phone number (Número de teléfono de destino de entorno aislado) en la sección de mensajería de texto (SMS) de la consola de Amazon SNS.

  2. Reciba un mensaje SMS con un código en el número de teléfono que ha proporcionado.

  3. Escriba el Código de verificación del mensaje SMS en la consola de Amazon SNS.

Para obtener instrucciones detalladas, consulte Agregar y verificar números de teléfono en el entorno de pruebas de SMS en la Guía para desarrolladores de Amazon Simple Notification Service.

nota

Amazon SNS limita la cantidad de números de teléfono de destino que puede verificar mientras se encuentra en el entorno aislado de SMS. Consulte el sección sobre el entorno aislado de SMS en la Guía para desarrolladores de Amazon Simple Notification Service.

Paso 6: Completar la configuración del grupo de usuarios en Amazon Cognito

Vuelva a la pestaña del navegador donde estaba creando o editando su grupo de usuarios. Complete el procedimiento .