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 de Tencent Short Message Service es una integración oficial de Logto que ayuda a los usuarios finales a registrarse o iniciar sesión utilizando 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 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 “Free Trial” (免费试用) 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 “Activate Service” (开通服务) para continuar.
4. En el “SMS Console Overview” (短信服务控制台概览), elige “Domestic Messages”(国内消息) o “International/Hong Kong, Macao, Taiwan Messages”(国际/港澳台消息) desde la barra lateral según tus necesidades.
5. Añade una firma y una plantilla para los mensajes SMS. Nota:
   • Al añadir una “Signature” (签名), selecciona “Verification Code” (验证码) en el campo "Applicable Scenarios" (模版类型).
   • Al añadir una plantilla, elige “Verification Code” como el 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 de un solo marcador de posición.
6. Envía la firma y la plantilla para su aprobación. Después de la presentación:
   • Espera a que entren en vigor.
   • Se pueden enviar SMS de prueba desde el “SMS Console Overview” (短信服务控制台概览). Las firmas y plantillas aprobadas se pueden usar directamente para pruebas, o usa 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 con éxito.

Para obtener una guía detallada, haz clic en la pestaña “Getting Started Guide” (新手配置指引) en el SMS Console Overview.

Componer el JSON del conector

1. Ve al “SMS Console Overview” y pasa el cursor sobre tu avatar en la esquina superior derecha. Navega a “Access Management > Access Keys > API Keys” para generar tu AccessKey ID y AccessKey Secret después de completar la verificación de seguridad. Por favor, guárdalos adecuadamente.
2. Desde la pestaña “Domestic Messages” (国内消息) o “International/Hong Kong, Macao, Taiwan Messages” (国际/港澳台消息), recupera el “Signature Name” (签名名称) y el “Template Code” (模版 CODCE).
   • Para plantillas de prueba, consulta la pestaña “Getting Started” (快速开始) bajo "Test-Exclusive Templates" (测试专用签名模版).

• Configura el Conector de SMS de Tencent Cloud 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.
  • Añade múltiples plantillas para diferentes escenarios si es necesario. Ejemplo para una sola plantilla:
    • templateCode: Recuperado del “Template Code” 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: Encontrado en “Application Management” (应用管理).
  • region: Especifica la región admitida desde el “Sending Documentation” (发送文档).

Probar el conector de SMS de Tencent Cloud

Puedes escribir un número de teléfono y hacer clic en "Send" para ver si la configuración puede funcionar antes de "Save and Done".

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
region	string
sdkAppId	string
templates	Template[]

Propiedades de la plantilla	Tipo	Valores del 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?