Configura la verificación por correo electrónico con Aliyun Direct Mail

El conector oficial de Logto para el servicio de correo directo de Aliyun.

tip

En esta guía, asumimos que tienes conocimientos básicos de los conectores de Logto. Si no los tienes, consulta la guía Configurar conectores para comenzar.

Comenzar

Aliyun es un proveedor principal de servicios en la nube en Asia, que ofrece muchos servicios en la nube, incluido DM (correo directo). El Conector DM de Aliyun es un complemento proporcionado por el equipo de Logto para llamar a las APIs del servicio DM 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 de un código de verificación por correo (o en otras palabras, código de verificación).

Configura un servicio de correo electrónico en la Consola de DirectMail de Aliyun

💡 Consejo

Puedes omitir algunas secciones si ya las has completado.

Crear una cuenta de Aliyun

Dirígete a Aliyun y crea tu cuenta de Aliyun si no tienes una.

Habilitar y configurar Aliyun Direct Mail

Ve a la página de la consola del servicio DM e inicia sesión. Habilita el servicio de Correo Directo haciendo clic en el botón "Solicitar habilitación" (申请开通) en la parte superior izquierda de la página y comienza el proceso de configuración.

Desde la página de la consola de administración de DM, debes:

1. Ir a "Dominios de correo electrónico" (发信域名) desde la barra lateral y agregar "Nuevo Dominio" (新建域名) siguiendo las instrucciones.
2. Personalizar "Direcciones del remitente" (发信地址) y "Etiquetas de correo" (邮件标签) respectivamente.

Después de completar la configuración, hay dos formas diferentes de probar:

• Ve a la página de resumen de DirectMail, encuentra "Guía de operación" (操作引导) en la parte inferior de la página y haz clic en "Enviar correos" (发送邮件). Encontrarás todos los diferentes tipos de métodos de prueba.
• Sigue la ruta "Enviar correos" (发送邮件) -> "Tareas de correo" (发送邮件) en la barra lateral para crear una tarea de prueba.

Componer el JSON del conector

1. Desde la página de la consola de administración de DM, 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 "Direcciones del remitente" (发信地址) o "Etiquetas de correo" (邮件标签) que acabas de visitar desde la página de la consola de administración de DM, puedes encontrar fácilmente Dirección del remitente o Etiqueta de correo.
3. Completa la configuración del Conector DM de Aliyun:
   • Completa los campos accessKeyId y accessKeySecret con los pares de claves de acceso que obtuviste en el paso 1.
   • Completa los campos accountName y fromAlias con "Dirección del remitente" y "Etiqueta de correo" que se encontraron en el paso 2. Todas las plantillas compartirán este nombre de firma. (Puedes dejar fromAlias en blanco ya que es OPCIONAL.)
   • Puedes agregar múltiples plantillas de conector DM para diferentes casos. Aquí tienes un ejemplo de cómo agregar una sola plantilla:
     • Completa el campo subject, que funcionará como título del correo enviado.
     • Completa el campo content con contenidos de tipo cadena arbitraria. No olvides dejar el marcador de posición {{code}} para el código de verificación aleatorio.
     • 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 DM de Aliyun

Puedes escribir una dirección de correo electrónico y hacer clic en "Enviar" para ver si la configuración puede funcionar antes de "Guardar y Terminar".

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
accountName	string
fromAlias	string (OPCIONAL)
templates	Template[]

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