Configura la verificación por SMS con Aliyun Short Message Service

El conector oficial de Logto para el servicio de mensajes cortos de Aliyun.

tip:

Esta guía asume que tienes un entendimiento básico de los Conectores de Logto. Para aquellos que no están familiarizados, por favor consulta la guía de Conectores para comenzar.

Comenzar

Aliyun es un proveedor principal de servicios en la nube en Asia, que ofrece muchos servicios en la nube, incluido el SMS (servicio de mensajes cortos). El Conector SMS de Aliyun es un complemento proporcionado por el equipo de Logto para llamar al servicio SMS de Aliyun, con la ayuda del cual los usuarios finales de Logto pueden registrarse e iniciar sesión en su cuenta Logto mediante un código de verificación por SMS.

Configura un servicio de mensajes cortos en la consola de SMS de Aliyun

Crea una cuenta de Aliyun

Ve al sitio web de Aliyun y registra tu cuenta de Aliyun si aún no tienes una.

Habilita y configura el servicio de mensajes cortos de Aliyun

1. Inicia sesión con tu cuenta de Aliyun en el sitio web de Aliyun y ve a la página de la consola del servicio SMS.
2. Haz clic en el botón "Abrir gratis" (免费开通) en la parte superior izquierda de la página del servicio SMS y comienza el proceso de configuración.
3. Lee y acepta el "Acuerdo de activación del servicio SMS" (短信服务开通条款) y haz clic en "Suscribirse al servicio" (开通服务) para continuar.
4. Ahora estás en la página de la consola del servicio SMS, ve a los botones "China continental" (国内消息) o "Fuera de China continental" (国际/港澳台消息) en la barra lateral según tu caso de uso.
5. Añade la firma y la plantilla siguiendo las directrices, y proporciona los materiales o información requeridos para la revisión.
   • Recuerda seleccionar "Mensaje de código de verificación" (验证码) como "Escenario" (适用场景) al completar la solicitud de firma y también "Mensaje de código de verificación" (验证码) para "Tipo" (模板类型) al solicitar la revisión de la plantilla, porque usaremos estas firmas y plantillas para enviar códigos de verificación. Actualmente, no admitimos el envío de mensajes SMS que no estén relacionados con códigos de verificación.
   • Además, usa {{code}} como marcador de posición donde quieras colocar tu código de verificación digital en el contenido de la plantilla.
6. Después de enviar tu solicitud de firma y plantilla SMS, debes esperar a que entre en vigor. En este punto, podemos volver a la página de la consola del servicio SMS y enviar un SMS de prueba. Si tus firmas y plantillas están listas para usarse, puedes probarlas directamente; si aún no están activas, Aliyun también proporciona plantillas de prueba.
   • Es posible que debas recargar una pequeña cantidad de dinero antes de enviar mensajes de prueba.
   • También es posible que se te pida vincular un número de teléfono de prueba antes de enviar mensajes de prueba. Para más detalles, ve a la pestaña "Aprendizaje rápido" (快速学习) en la barra lateral de la página de la consola del servicio SMS.

Componer el JSON del conector

1. Desde la página de la consola del servicio SMS, pasa el cursor sobre tu avatar en la esquina superior derecha y ve a "Gestión de AccessKey" (AccessKey 管理), y haz clic en "Crear AccessKey" (创建 AccessKey). Obtendrás un par de "AccessKey ID" y "AccessKey Secret" después de completar la verificación de seguridad. Por favor, guárdalos adecuadamente.
2. Ve a la pestaña "China continental" (国内消息) o "Fuera de China continental" (国际/港澳台消息) que acabas de visitar, allí puedes encontrar fácilmente "Firma" (签名名称) y "Código de plantilla" (模板 CODE).
   • Si deseas usar la firma y plantilla solo para pruebas, ve a la pestaña "Aprendizaje rápido" (快速学习), y las encontrarás debajo de "Firma y plantillas (solo para pruebas)".
3. Completa la configuración del Conector SMS de Aliyun:
   • Completa los campos accessKeyId y accessKeySecret con los pares de claves de acceso que obtuviste en el paso 1.
   • Completa el campo signName con la "Firma" (签名名称) mencionada en el paso 2. Todas las plantillas compartirán este nombre de firma.
   • Puedes añadir múltiples plantillas de conector SMS para diferentes casos. Aquí tienes un ejemplo de cómo añadir una sola plantilla:
     • Completa el campo templateCode, que es como puedes controlar el contexto del SMS, con el "Código de plantilla" (模板 CODE) del paso 2.
     • Completa el campo usageType con Register, SignIn, ForgotPassword o Generic para diferentes casos de uso. (usageType es una propiedad de Logto para identificar el caso de uso adecuado.) Para habilitar todos los flujos de usuario, se requieren plantillas con usageType Register, SignIn, ForgotPassword y Generic.
4. Configura la "Verificación estricta del número de región telefónica":
   • Actívala si necesitas enviar SMS a números de teléfono extranjeros (regiones fuera de China continental como EE. UU., HK, etc.). Cuando está activada, el conector asume que todos los números de teléfono incluyen códigos de región válidos (por ejemplo, +1, +852) para determinar si pertenecen a China continental.
   • Precaución: Si tus usuarios existentes tienen números de teléfono sin códigos de región, habilitar esto puede afectar su proceso de inicio de sesión. Actívalo solo si es necesario para el envío de SMS al extranjero.

Probar el conector SMS de Aliyun

Puedes escribir un número de teléfono y hacer clic en "Enviar" para ver si la configuración funciona antes de "Guardar y finalizar".

Eso es todo. No olvides Habilitar el conector en la experiencia de inicio de sesión.

Tipos de configuración

Nombre	Tipo
accessKeyId	string
accessKeySecret	string
signName	string
templates	Template[]

Propiedades de la plantilla	Tipo	Valores de enumeración
templateCode	string	N/A
usageType	enum string	'Register' | 'SignIn' | 'ForgotPassword' | 'Generic'

Referencias

Aliyun SMS - Inicio rápido