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.

SMSconfiguración de mensajes para grupos de usuarios de Amazon Cognito

Algunos eventos de Amazon Cognito para su grupo de usuarios pueden provocar que Amazon Cognito SMS envíe mensajes de texto a sus usuarios. Por ejemplo, si configuras tu grupo de usuarios para que requiera la verificación por teléfono, Amazon Cognito enviará un mensaje de SMS texto cuando un usuario registre una nueva cuenta en tu aplicación o restablezca su contraseña. Según la acción que inicie el mensaje de SMS texto, el mensaje contiene un código de verificación, una contraseña temporal o un mensaje de bienvenida.

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

Amazon SNS cobra por los mensajes de SMS texto. Para obtener más información, consulta los SNSprecios de Amazon.

Amazon Cognito envía SMS mensajes a sus usuarios con un código que pueden introducir. En la siguiente tabla se muestran los eventos que pueden generar un SMS mensaje.

Opciones de mensajes

¹ Para SMS mensajes.

Configuración de la SMS mensajería por primera vez en los grupos de usuarios de Amazon Cognito

Amazon Cognito usa Amazon para enviar SMS mensajes SNS a sus grupos de usuarios. También puede usar a Activador SMS Lambda de remitente personalizado para usar sus propios recursos para enviar SMS mensajes. La primera vez que configuras Amazon SNS para enviar mensajes de SMS texto en una región determinada Región de AWS, Amazon te SNS coloca Cuenta de AWS en el SMS entorno limitado de esa región. Amazon SNS utiliza el entorno limitado para evitar el fraude y el abuso y para cumplir con los requisitos de conformidad. Cuando estás en Cuenta de AWS un entorno de pruebas, Amazon SNS impone algunas restricciones. Por ejemplo, puedes enviar mensajes de texto a un máximo de 10 números de teléfono que hayas verificado con AmazonSNS. Mientras estés Cuenta de AWS en el entorno limitado, no utilices tu SNS configuración de Amazon 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.

Prepare una IAM función que Amazon Cognito pueda utilizar para enviar SMS mensajes con Amazon SNS

Cuando envía un SMS mensaje desde su grupo de usuarios, Amazon Cognito asume una IAM función en su cuenta. Amazon Cognito utiliza el sns:Publish permiso asignado a esa función para enviar SMS mensajes a los usuarios. En la consola de Amazon Cognito, puede configurar una selección de IAM roles en la pestaña Mensajería de su grupo de usuarios SMSo realizar esta selección durante el asistente de creación del grupo de usuarios.

El siguiente ejemplo de política de confianza de IAM roles otorga a los grupos de usuarios de Amazon Cognito una capacidad limitada para asumir el rol. Amazon Cognito solo puede asumir la función si cumple las siguientes condiciones:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "",
            "Effect": "Allow",
            "Principal": {
                "Service": "cognito-idp.amazonaws.com"
            },
            "Action": "sts:AssumeRole",
            "Condition": {
                "StringEquals": {
                    "sts:ExternalId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
                    "aws:SourceAccount": "111122223333"
                },
                "ArnLike": {
                    "aws:SourceArn": "arn:aws:cognito-idp:us-west-2:111122223333:userpool/us-west-2_EXAMPLE"
                }
            }
        }
    ]
}

Puede especificar un grupo de usuarios exacto ARN o un comodín ARN en el valor de la condición. aws:SourceArn Busque sus grupos ARNs de usuarios en el AWS Management Console o con una DescribeUserPoolAPIsolicitud.

Para enviar SMS mensajes para la autenticación multifactorial, la política de confianza de los IAM roles debe tener una sts:ExternalId condición. El valor de esta condición debe coincidir con la ExternalId propiedad de su grupo SmsConfigurationde usuarios. Cuando crea un IAM rol durante el proceso de creación del grupo de usuarios en la consola de Amazon Cognito, Amazon Cognito le configura el ID externo en el rol y en la configuración del grupo de usuarios. Esto no es cierto cuando se utiliza un rol existente. IAM

Debe actualizar el ExternalId parámetro del grupo de usuarios en una UpdateUserPoolAPIsolicitud y actualizar la política de confianza de IAM roles con una sts:externalId condición con el mismo valor. Para obtener información sobre cómo utilizarla API para actualizar un grupo de usuarios de forma que se conserve la configuración original, consulteActualización de la configuración del grupo de usuarios y del cliente de aplicaciones.

Para obtener más información sobre las IAM funciones y las políticas de confianza, consulte los términos y conceptos de las funciones en la Guía del AWS Identity and Access Management usuario.

Elige el Región de AWS para los SNS SMS mensajes de Amazon

En algunas Regiones de AWS, puede elegir la región que contiene los SNS recursos de Amazon que quiere usar para los mensajes de Amazon CognitoSMS. En cualquier Región de AWS lugar donde Amazon Cognito esté disponible, excepto en Asia Pacífico (Seúl), puede utilizar SNS los recursos de Amazon en el Región de AWS lugar donde creó su grupo de usuarios. Para que tus SMS mensajes sean más rápidos y fiables cuando puedas elegir entre regiones, utiliza SNS los recursos de Amazon en la misma región que tu grupo de usuarios.

Elija una región para SMS los recursos en el paso Configurar la entrega de mensajes del asistente para el nuevo grupo de usuarios. También puede seleccionar Editar SMSen la pestaña Mensajes de un grupo de usuarios existente.

En el momento del lanzamiento Regiones de AWS, Amazon Cognito envió SMS mensajes con SNS recursos de Amazon en una región alternativa. Para establecer su región preferida, utilice el SnsRegion parámetro del SmsConfigurationTypeobjeto para su grupo de usuarios. Si crea mediante programación un recurso de grupos de usuarios de Amazon Cognito en una región de Amazon Cognito a partir de la siguiente tabla y no proporciona ningún parámetro, su grupo de usuarios puede enviar SMS mensajes con los SNS recursos de Amazon de SnsRegion una región de Amazon antigua. SNS

Los grupos de usuarios de Amazon Cognito en Asia Pacífico (Seúl) Región de AWS deben usar su SNS configuración de Amazon en la región 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 uno Región de AWS que utiliza con Amazon Cognito. Antes de cambiar el SNS SMS mensaje Región de AWS por Amazon, abre un caso de aumento de cuota en el AWS Support Center para aumentar tu límite en la nueva región. Para obtener más información, consulta Cómo solicitar aumentos de tu cuota de SMS gastos mensuales para Amazon SNS en la Guía para desarrolladores de Amazon Simple Notification Service.

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

Obtenga una identidad de origen para enviar SMS mensajes a números de teléfono de EE. UU.

Si planea enviar mensajes de SMS texto a números de teléfono de EE. UU., debe obtener una identidad de origen, independientemente de si crea un entorno de pruebas SMS aislado 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 de la siguiente manera Regiones de AWS, debe abrir un AWS Support ticket para obtener una identidad de origen. Para obtener instrucciones, consulte Solicitud de asistencia para la SMS mensajería en la Guía para desarrolladores de Amazon Simple Notification Service.

Si tienes más de una identidad de origen en la misma Región de AWS, Amazon SNS elige un tipo de identidad de origen en el siguiente orden de prioridad: código corto, 10DLC, número gratuito. No puede cambiar este valor. Para obtener más información, consulta Amazon SNS FAQs.

Confirma que estás en la zona de SMS pruebas

Utilice el siguiente procedimiento para confirmar que se encuentra en la zona de SMS pruebas. Repita el procedimiento para cada uno de los Región de AWS lugares en los que tenga grupos de usuarios de Amazon Cognito de producción.

Saca tu cuenta del entorno de pruebas de SNS Amazon

Si estás probando la aplicación y solo necesitas enviar SMS mensajes a números de teléfono que los administradores puedan verificar, omite este paso.

Para usar tu aplicación en producción, mueve tu cuenta del SMS entorno limitado a la de producción. Una vez que haya configurado una identidad de origen en la Región de AWS que figuren los SNS recursos de Amazon que desea que utilice Amazon Cognito, podrá verificar los números de teléfono de EE. UU. mientras permanece en SMS la Cuenta de AWS zona de pruebas. Cuando su SNS entorno de Amazon está en producción, no tiene que verificar los números de teléfono de los usuarios en Amazon SNS para enviar SMS mensajes a sus usuarios.

Para obtener instrucciones detalladas, consulte Cómo salir del SMS entorno aislado en la guía para desarrolladores de Amazon Simple Notification Service.

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

Si ha sacado su cuenta de la zona de SMS pruebas, omita este paso.

Cuando estés en la zona SMS de pruebas, podrás enviar mensajes a cualquier número de teléfono que hayas verificado con AmazonSNS.

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

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

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 . Cuando haya agregado correctamente la SMS configuración a su grupo de usuarios, Amazon Cognito enviará un mensaje de prueba a un número de teléfono interno para comprobar que la configuración funciona. Amazon SNS cobra por cada SMS mensaje de prueba.