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 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 de Logto a través del código de verificación por SMS.

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

Crea una cuenta de Aliyun

Ve al sitio web de Aliyun y registra tu cuenta de Aliyun si 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 a un servicio" (开通服务) para continuar.
4. Ahora estás en la página de la consola del servicio SMS, ve al botón "China continental" (国内消息) o "Fuera de China continental" (国际/港澳台消息) en la barra lateral según tu caso de uso.
5. Agrega firma y plantilla siguiendo las pautas, 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 una revisión de plantilla porque estamos usando 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 mensajes de texto de códigos de verificación.
   • Además, usa {{code}} como un marcador de posición donde quieras colocar tu código de verificación digital en los contenidos de la plantilla.
6. Después de enviar tu solicitud de firma y plantilla SMS, necesitas esperar a que surta efecto. 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 usar, puedes probarlas directamente; si aún no surten efecto, Aliyun también proporciona plantillas de prueba.
   • Es posible que necesites 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 "Inicio rápido" (快速学习) desde 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, 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 "Inicio rápido" (快速学习) en su lugar, 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 "Firma" (签名名称) que se menciona en el paso 2. Todas las plantillas compartirán este nombre de firma.
   • Puedes agregar múltiples plantillas de conector SMS para diferentes casos. Aquí tienes un ejemplo de cómo agregar una sola plantilla:
     • Completa el campo templateCode, que es cómo puedes controlar el contexto SMS, con "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 flujos de usuario completos, se requieren plantillas con usageType Register, SignIn, ForgotPassword y Generic.

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 puede funcionar antes de "Guardar y Listo".

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 del enum
templateCode	string	N/A
usageType	enum string	'Register' | 'SignIn' | 'ForgotPassword' | 'Generic'

Referencias

Aliyun SMS - Inicio rápido