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 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. Amazon SNS, a su vez, entrega los mensajes SMS a. AWS End User Messaging SMS Si envía un mensaje de texto a través de Amazon Cognito por primera vez, lo AWS End User Messaging SMS coloca en un [entorno sandbox](https://docs.aws.amazon.com/sms-voice/latest/userguide/sandbox.html). En el entorno aislado, puede probar los mensajes de texto SMS de sus aplicaciones. En el entorno de pruebas, solo puede simular el envío de mensajes.
**nota**
En noviembre de 2024, AWS sustituyó la mensajería SMS de Amazon SNS por. AWS End User Messaging SMS Actualmente, la consola de Amazon Cognito hace referencia a los recursos de Amazon SNS. Los grupos de usuarios inician los mensajes SMS con la operación Amazon SNS [Publish](https://docs.aws.amazon.com/sns/latest/api/API_Publish.html), que es una transferencia a. AWS End User Messaging SMS Por lo tanto, debe seguir configurando los permisos para `sns:Publish`, no para `sms-voice:SendTextMessage`.
AWS End User Messaging SMS cargos por mensajes de texto SMS. Para obtener más información, consulte [Precios de AWS End User Messaging SMS](https://aws.amazon.com/end-user-messaging/pricing/).
Amazon Cognito envía mensajes SMS a los usuarios con un código que pueden ingresar. En la siguiente tabla se muestran los eventos que pueden generar un mensaje SMS.
**Opciones de mensajes**
| Actividad | Operación de la API | Opciones de entrega | Opciones de formato | Personalizable | [Plantilla de mensaje](cognito-user-pool-settings-message-customizations.md) |
| --- |--- |--- |--- |--- |--- |
| Contraseña olvidada | [ForgotPassword](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_ForgotPassword.html), [AdminResetUserPassword](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_AdminResetUserPassword.html) | Correo electrónico, SMS | code | Sí | Mensaje de verificación |
| Invitación | [AdminCreateUser](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_AdminCreateUser.html) | Correo electrónico, SMS | code | Sí | Mensaje de invitación |
| Autorregistro | [SignUp](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_SignUp.html), [ResendConfirmationCode](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_ResendConfirmationCode.html) | 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](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_UpdateUserAttributes.html), [AdminUpdateUserAttributes](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_AdminUpdateUserAttributes.html), [GetUserAttributeVerificationCode](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_GetUserAttributeVerificationCode.html) | Correo electrónico, SMS | code | Sí | Mensaje de verificación |
| Autenticación multifactor (MFA) | [AdminInitiateAuth](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_AdminInitiateAuth.html), [InitiateAuth](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_InitiateAuth.html) | Correo electrónico¹, SMS, aplicación de autenticación | code | Sí² | Mensaje MFA |
| Autenticación por contraseña de un solo uso (OTP) | [AdminInitiateAuth](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_AdminInitiateAuth.html), [InitiateAuth](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_InitiateAuth.html) | Correo electrónico¹, SMS | code | Sí | Mensaje MFA ³ |
¹ Requiere el [plan de características](cognito-sign-in-feature-plans.md) Essentials o superior y la [configuración de correo electrónico de Amazon SES](user-pool-email.md#user-pool-email-developer).
² Para mensajes SMS y de correo electrónico.
³ Solo puede personalizar la plantilla de mensaje de MFA cuando la MFA sea obligatoria u opcional en su grupo de usuarios. Cuando la MFA está inactiva, Amazon Cognito envía contraseñas de un solo uso con la plantilla predeterminada.
AWS End User Messaging SMS cargos por mensajes SMS. Para obtener más información, consulte [Precios de AWS End User Messaging SMS](https://aws.amazon.com/end-user-messaging/pricing/).
Para obtener más información sobre MFA, consulte [MFA con mensajes SMS y correo electrónico](user-pool-settings-mfa-sms-email-message.md).
Amazon Cognito podría impedir la entrega de más mensajes de correo electrónico o SMS a un único destino en un breve período de tiempo. Si cree que su grupo de usuarios está afectado, configure y revise los [registros para detectar errores en la entrega de mensajes](exporting-quotas-and-usage.md#exporting-quotas-and-usage-messages) y, a continuación, póngase en contacto con el equipo de su cuenta.
## Prácticas recomendadas
Debido al volumen de tráfico de SMS no solicitado en todo el mundo, algunos gobiernos imponen barreras entre los remitentes y los destinatarios de los mensajes SMS. Cuando utilice mensajes SMS de la autenticación multifactor y las actualizaciones de usuario, debe tomar medidas adicionales para garantizar que los mensajes se entreguen. También debes supervisar SMS-message-related las normativas de los países en los que puedan residir tus usuarios y mantener actualizada la configuración de tus mensajes SMS. Para obtener más información, consulte [Capacidades y limitaciones de los SMS por país](https://docs.aws.amazon.com/sms-voice/latest/userguide/phone-numbers-sms-support-by-country.html) en la *Guía del usuario de AWS End User Messaging SMS *.
El uso de mensajes SMS para autenticar y verificar a los usuarios no es una práctica recomendada de seguridad. Los números de teléfono pueden cambiar de propietario y es posible que no representen de manera fiable *algo que tenga* del factor de MFA para los usuarios. En su lugar, implemente TOTP MFA en tu aplicación o con el IdP de terceros. Además, puede crear factores adicionales de autenticación personalizados con [Desencadenadores de Lambda de desafío de autenticación personalizado](user-pool-lambda-challenge.md).
Consulte los siguientes enlaces para obtener información sobre cómo proteger su arquitectura de entrega de mensajes SMS.
+ [Reducción de los riesgos de fraude en el registro de usuarios y del fraude de tráfico artificial de SMS con los grupos de usuarios de Amazon Cognito](https://aws.amazon.com/blogs/security/reduce-risks-of-user-sign-up-fraud-and-sms-pumping-with-amazon-cognito-user-pools/)
+ [Cómo defenderse del tráfico masivo de SMS: nuevas AWS funciones que ayudan a combatir el tráfico inflado artificialmente](https://aws.amazon.com/blogs/messaging-and-targeting/defending-against-sms-pumping-new-aws-features-to-help-combat-artificially-inflated-traffic/)
## Configuración de mensajes SMS por primera vez en grupos de usuarios de Amazon Cognito
Amazon Cognito utiliza Amazon SNS, e AWS End User Messaging SMS indirectamente, para enviar mensajes SMS desde sus grupos de usuarios. También puede utilizar un [Desencadenador de Lambda para remitentes personalizados de SMS](user-pool-lambda-custom-sms-sender.md) para usar sus propios recursos para enviar mensajes SMS. La primera vez que configure los mensajes de texto SMS en una región concreta Región de AWS, estará AWS End User Messaging SMS Cuenta de AWS en el entorno limitado de SMS de esa región. AWS End User Messaging SMS utiliza el entorno de pruebas para evitar el fraude y el abuso y para cumplir con los requisitos de conformidad. [Cuando Cuenta de AWS está en un entorno de pruebas, AWS End User Messaging SMS impone algunas restricciones.](https://docs.aws.amazon.com/sms-voice/latest/userguide/sandbox.html#sandbox-sms) Por ejemplo, puede enviar mensajes de texto a un máximo de 10 números de destino verificados si tiene una identidad de origen, o puede simular el envío de mensajes sin una identidad de origen. Mientras estés en Cuenta de AWS la zona de pruebas, no envíes mensajes SMS durante el proceso de 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.
**Topics**
+ [Prepare una función de IAM que Amazon Cognito pueda utilizar para enviar mensajes SMS con AWS End User Messaging SMS](#sms-create-a-role)
+ [Elija la opción Región de AWS para los mensajes SMS](#sms-choose-a-region)
+ [Obtener una identidad de origen para enviar mensajes SMS a números de teléfono de EE. UU.](#user-pool-sms-settings-first-time-origination)
+ [Confirmar que se encuentra en el entorno de pruebas de SMS](#user-pool-sms-settings-first-time-confirm-sandbox)
+ [Traslado de la cuenta fuera del entorno de pruebas](#user-pool-sms-settings-first-time-out-sandbox)
+ [Utilice números de simulador o números de teléfono verificados con AWS End User Messaging SMS](#user-pool-sms-settings-first-time-verify-numbers)
+ [Completar la configuración del grupo de usuarios en Amazon Cognito](#user-pool-sms-settings-first-time-finish-user-pool)
### Prepare una función de IAM que Amazon Cognito pueda utilizar para enviar mensajes SMS con AWS End User Messaging SMS
Cuando envía un mensaje SMS desde su grupo de usuarios, Amazon Cognito asume un rol de IAM en su cuenta. En Amazon Cognito, se utiliza el permiso `sns:Publish` asignado a ese rol para enviar mensajes SMS a los usuarios. En la consola de Amazon Cognito, puede configurar una **selección de roles de IAM** desde el menú **Métodos de autenticación** de su grupo de usuarios, en **SMS**, o realizar esta selección durante el asistente de creación de grupos de usuarios.
En el ejemplo siguiente de política de confianza de rol de IAM se concede a grupos de usuarios de Amazon Cognito una capacidad limitada para que adopte un rol de IAM. Amazon Cognito solo puede asumir el rol si cumple las siguientes condiciones:
+ La operación de asumir el rol se realiza en nombre del grupo de usuarios de la condición `aws:SourceArn`.
+ La operación de asumir el rol se realiza en nombre de un grupo de usuarios de la Cuenta de AWS establecida mediante la condición `aws:SourceAccount`.
+ La operación de asumir el rol incluye el ID externo en la condición `sts:externalId`.
------
#### [ JSON ]
****
```
{
"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 [ARN del grupo de usuarios](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazoncognitouserpools.html#amazoncognitouserpools-resources-for-iam-policies) o un ARN comodín en el valor de la condición `aws:SourceArn`. Busque sus grupos ARNs de usuarios en el Consola de administración de AWS o con una solicitud de [DescribeUserPool](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_DescribeUserPool.html)API.
Para enviar mensajes SMS para la [autenticación multifactor](user-pool-settings-mfa-sms-email-message.md), la política de confianza del rol de IAM debe tener una condición `sts:ExternalId`. El valor de esta condición debe coincidir con la `ExternalId` propiedad [SmsConfiguration](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_CreateUserPool.html#CognitoUserPools-CreateUserPool-request-SmsConfiguration)de su grupo de usuarios. Cuando crea un rol de IAM durante el proceso de creación del grupo de usuarios en la consola de Amazon Cognito, Amazon Cognito configura en su lugar el ID externo en los ajustes del rol y del grupo de usuarios. Este no es el caso cuando usa un rol de IAM que ya existe.
Debe actualizar el `ExternalId` parámetro del grupo de usuarios en una solicitud de [UpdateUserPool](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_UpdateUserPool.html)API y actualizar la política de confianza de roles de IAM con una `sts:externalId` condición con el mismo valor. Para obtener información sobre cómo usar la API para actualizar un grupo de usuarios de forma que se conserve la configuración original, consulte [Actualización de la configuración del grupo de usuarios y del cliente de aplicación](cognito-user-pool-updating.md).
Para obtener más información sobre los roles de IAM y las políticas de confianza, consulte [Términos y conceptos de roles](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html) en la *Guía del usuario de AWS Identity and Access Management *.
### Elija la opción Región de AWS para los mensajes SMS
**nota**
Los mensajes SMS entrantes ahora AWS se gestionan en [AWS End User Messaging SMS](https://console.aws.amazon.com/sms-voice/home).
En algunas Regiones de AWS, puede elegir la región que contiene los recursos de Amazon SNS que quiere usar para los mensajes SMS de Amazon Cognito. En cualquier Región de AWS lugar donde Amazon Cognito esté disponible, excepto en Asia Pacífico (Seúl), puede utilizar los recursos de Amazon SNS en Región de AWS el lugar donde creó su 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.
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 seleccionar **Editar** en **SMS**, en el menú **Métodos de autenticación** de un grupo de usuarios existente.
En el momento del lanzamiento Regiones de AWS, Amazon Cognito envió mensajes SMS con recursos de Amazon SNS en una región alternativa. Para establecer su región preferida, utilice el `SnsRegion` parámetro del [SmsConfigurationType](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_SmsConfigurationType.html)objeto 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 usar su configuración de Amazon SNS en la región Asia Pacífico (Tokio).
Amazon SNS (via AWS End User Messaging SMS) establece la cuota de gasto para todas las cuentas nuevas en 1 dólar (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 Región de AWS los mensajes SMS de Amazon SNS, 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, consulte [Pasar del entorno limitado de AWS End User Messaging SMS MMS y voz a la producción](https://docs.aws.amazon.com/sms-voice/latest/userguide/sandbox.html#sandbox-sms-move-to-production) en la Guía del AWS End User Messaging SMS usuario.*
Puede enviar mensajes SMS **a cualquier región de Amazon Cognito** de la siguiente tabla con los AWS End User Messaging SMS recursos de la región de **mensajes SMS** correspondiente.
| Región de Amazon Cognito | Región de mensajes SMS |
| --- | --- |
| Este de EE. UU. (Ohio) | EE. UU. Este (Ohio), EE. UU. Este (Norte de Virginia) |
| 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) |
| Canadá (centro) | Canadá (centro), este de EE. UU. (Norte de Virginia) |
| Oeste de Canadá (Calgary) | Oeste de Canadá (Calgary) |
| México (centro) | México (centro) |
| Europa (Fráncfort) | Europa (Fráncfort), Europa (Irlanda) |
| Europa (Londres) | Europa (Londres), Europa (Irlanda) |
| Europa (Irlanda) | Europa (Irlanda) |
| Europa (París) | Europa (París) |
| Europa (Estocolmo) | Europa (Estocolmo) |
| Europa (Milán) | Europa (Milán) |
| Europa (España) | Europa (España) |
| Europa (Zúrich) | Europa (Zúrich) |
| Asia-Pacífico (Malasia) | Asia-Pacífico (Singapur) |
| Asia-Pacífico (Tailandia) | Asia-Pacífico (Mumbai) |
| Asia-Pacífico (Mumbai) | Asia-Pacífico (Bombay), Asia-Pacífico (Singapur) |
| Asia-Pacífico (Hyderabad) | Asia-Pacífico (Hyderabad) |
| Asia-Pacífico (Hong Kong) | Asia-Pacífico (Singapur) |
| Asia-Pacífico (Seúl) | Asia-Pacífico (Tokio) |
| 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) |
| Asia-Pacífico (Yakarta) | Asia-Pacífico (Yakarta) |
| Asia-Pacífico (Osaka) | Asia-Pacífico (Osaka) |
| Asia-Pacífico (Melbourne) | Asia-Pacífico (Melbourne) |
| Middle East (Bahrain) | Middle East (Bahrain) |
| Medio Oriente (EAU) | Medio Oriente (EAU) |
| América del Sur (São Paulo) | América del Sur (São Paulo) |
| Israel (Tel Aviv) | Israel (Tel Aviv) |
| África (Ciudad del Cabo) | África (Ciudad del Cabo) |
### 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.
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 de teléfono](https://docs.aws.amazon.com/sms-voice/latest/userguide/phone-numbers-request.html) en la *Guía del usuario de AWS End User Messaging SMS *.
Si tiene más de una identidad de origen en la misma Región de AWS, AWS End User Messaging SMS elija un tipo de identidad de origen en el siguiente orden de prioridad: código corto, 10 DLC, número gratuito. No puede cambiar este valor. Para obtener más información, consulte [AWS End User Messaging SMS FAQs](https://aws.amazon.com/end-user-messaging/faqs/).
### Confirmar que se encuentra en el entorno de pruebas de SMS
Utilice el procedimiento siguiente para confirmar que está en el entorno aislado de SMS. 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.
#### Revisión del estado del entorno aislado de SMS en la consola de Amazon Cognito
**Confirmar que se encuentra en el entorno de pruebas de SMS**
1. Vaya a la [consola de Amazon Cognito](https://console.aws.amazon.com/cognito/home). Si se le solicita, escriba sus credenciales de AWS .
1. Elegir**User Pools** (Grupos de usuarios).
1. Elija en la lista un usuario existente.
1. Elija el menú **Métodos de autenticación**.
1. En el navegador**Configuración de SMS**sección, expandir**Mover 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.
**Configure Servicio de AWS las dependencias para completar la configuración de sus mensajes SMS**
Si no ve este mensaje, signfica que alguien ya ha realizado los pasos necesarios para configurar los mensajes SMS en su cuenta. Vaya a [Completar la configuración del grupo de usuarios en Amazon Cognito](#user-pool-sms-settings-first-time-finish-user-pool).
1. Elija el enlace [Amazon SNS](https://console.aws.amazon.com/sns/home) en **Pasar al entorno de producción de Amazon SNS**. Esto abre la consola de Amazon SNS en una pestaña nueva.
1. Compruebe que se encuentre en el entorno de pruebas. El mensaje de la consola indica el estado de tu entorno aislado y Región de AWS, de la siguiente manera:
`This account is in the SMS sandbox in US East (N. Virginia).`
### Traslado de la cuenta fuera del entorno de pruebas
Para utilizar su aplicación en producción, quite la cuenta del entorno aislado de SMS y entre en producción. Tras configurar una identidad de origen que contenga los AWS End User Messaging SMS recursos Región de AWS que desea que utilice Amazon Cognito, podrá verificar los números de teléfono de EE. UU. mientras permanece en el entorno Cuenta de AWS limitado de SMS. Cuando su entorno esté en producción, no tendrá que verificar los números de teléfono de los usuarios antes de enviarles mensajes SMS.
Puede crear una solicitud para salir del sandbox desde la AWS End User Messaging SMS consola o desde la consola de Amazon SNS. Para obtener instrucciones detalladas, consulte [Traslado desde el entorno de pruebas SMS](https://docs.aws.amazon.com/sms-voice/latest/userguide/sandbox.html#sandbox-sms-move-to-production) en la *Guía del usuario de AWS End User Messaging SMS *.
### Utilice números de simulador o números de teléfono verificados con AWS End User Messaging SMS
Si ha quitado la cuenta del entorno aislado de SMS, omita este paso.
Si está en un entorno de pruebas pero ha configurado un número de origen, puede enviar mensajes a números de destino verificados. Para configurar destinos verificados, consulte [Cómo agregar un número de teléfono de destino verificado](https://docs.aws.amazon.com/sms-voice/latest/userguide/verify-destination-phone-number.html) en la *Guía del usuario de AWS End User Messaging SMS *.
También puede enviar mensajes con remitentes y destinos simulados. Los mensajes del simulador producen registros, pero no se envían a través de la red del operador. En el [Menú de atajos](https://console.aws.amazon.com/sms-voice/home?#/shortcuts), seleccione **Probar el envío de SMS con el simulador de SMS**. Para obtener más información, consulte [Números de teléfono de simuladores](https://docs.aws.amazon.com/sms-voice/latest/userguide/test-phone-numbers.html) en la *Guía del usuario de AWS End User Messaging SMS *.
### Completar la configuración del grupo de usuarios en Amazon Cognito
Vuelva a la pestaña del navegador donde estaba creando o [editando](signing-up-users-in-your-app.md#verification-configure) su grupo de usuarios. Complete el procedimiento . Cuando haya añadido correctamente la configuración de SMS a su grupo de usuarios, Amazon Cognito envía un mensaje de prueba a un número de teléfono interno para comprobar que la configuración funciona. Amazon SNS cobra por cada mensaje SMS de prueba.