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

El conector oficial de Logto para Tencent Short Message Service.

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

Tencent Cloud es un proveedor principal de servicios en la nube en Asia, que ofrece varios servicios, incluido el SMS (servicio de mensajes cortos).

El conector Tencent Short Message Service es una integración oficial de Logto que ayuda a los usuarios finales a registrarse o iniciar sesión usando códigos de verificación por SMS.

Configura un servicio de mensajes cortos en Tencent Cloud

Crea una cuenta de Tencent Cloud

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

Habilita y configura Tencent Cloud SMS

1. Inicia sesión con tu cuenta en el sitio web de Tencent Cloud y ve a la página de la consola del servicio SMS.
2. Haz clic en el botón “Prueba gratuita” (免费试用) en la página del servicio SMS y sigue los pasos de configuración.
3. Acepta los “Términos de activación del servicio SMS” (短信开通服务条款) y haz clic en “Activar servicio” (开通服务) para continuar.
4. En la “Descripción general de la consola SMS” (短信服务控制台概览), elige “Mensajes nacionales”(国内消息) o “Mensajes internacionales/Hong Kong, Macao, Taiwán”(国际/港澳台消息) desde la barra lateral según tus necesidades.
5. Agrega una firma y una plantilla para los mensajes SMS. Nota:
   • Al agregar una “Firma” (签名), selecciona “Código de verificación” (验证码) en el campo "Escenarios aplicables" (模版类型).
   • Al agregar una plantilla, elige “Código de verificación” como tipo de plantilla.
   • Incluye un marcador de posición {1} en el contenido de la plantilla, que será reemplazado por un código generado aleatoriamente.
   • No se admiten plantillas con múltiples marcadores de posición. Usa o crea una plantilla con un solo marcador de posición.
6. Envía la firma y la plantilla para su aprobación. Después de enviarlas:
   • Espera a que entren en vigor.
   • Se pueden enviar SMS de prueba desde la “Descripción general de la consola SMS” (短信服务控制台概览). Las firmas y plantillas aprobadas pueden usarse directamente para pruebas, o utiliza las plantillas de prueba proporcionadas si aún están en revisión.
   • Asegúrate de que tu cuenta tenga saldo suficiente para las pruebas y pre-registra el número de teléfono de prueba para recibir SMS correctamente.

Para una guía detallada, haz clic en la pestaña “Guía de inicio” (新手配置指引) en la Descripción general de la consola SMS.

Redacta el JSON del conector

1. Ve a la “Descripción general de la consola SMS” y pasa el cursor sobre tu avatar en la esquina superior derecha. Navega a “Gestión de acceso > Claves de acceso > Claves API” para generar tu AccessKey ID y AccessKey Secret después de completar la verificación de seguridad. Por favor, consérvalos adecuadamente.
2. Desde la pestaña “Mensajes nacionales” (国内消息) o “Mensajes internacionales/Hong Kong, Macao, Taiwán” (国际/港澳台消息), obtén el “Nombre de la firma” (签名名称) y el “Código de plantilla” (模版 CODCE).
   • Para plantillas de prueba, revisa la pestaña “Inicio rápido” (快速开始) bajo "Plantillas exclusivas de prueba" (测试专用签名模版).

• Configura el conector Tencent Cloud SMS con los siguientes campos:
  • accessKeyId y accessKeySecret: Usa las credenciales del paso 1.
  • signName: El nombre de la firma obtenido en el paso 2. Esto se aplica a todas las plantillas.
  • Agrega varias plantillas para diferentes escenarios si es necesario. Ejemplo para una sola plantilla:
    • templateCode: Obtenido del “Código de plantilla” en el paso 2.
    • usageType: Especifica uno de Register, SignIn, ForgotPassword o Generic para diferentes escenarios (propiedad específica de Logto).
    • Asegúrate de que las plantillas estén configuradas para los cuatro escenarios para completar el flujo.
  • sdkAppId: Se encuentra en “Gestión de aplicaciones” (应用管理).
  • region: Especifica la región compatible desde la “Documentación de envío” (发送文档).

Prueba el conector Tencent Cloud SMS

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 el registro e inicio de sesión.

Tipos de configuración

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

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

Referencias

¿Cómo implementar la función de código de verificación por SMS?