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:

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 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 Logto mediante un código de verificación por correo electrónico (o en otras palabras, código de verificación).

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

Crea una cuenta de Aliyun

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

Habilita y configura Aliyun Direct Mail

Ve a la página de la consola del servicio DM e inicia sesión. Habilita el servicio Direct Mail haciendo clic en el botón "Solicitar apertura" (申请开通) 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 un "Nuevo dominio" (新建域名) siguiendo las instrucciones.
2. Personalizar "Direcciones del remitente" (发信地址) y "Etiquetas de correo electrónico" (邮件标签) respectivamente.

Después de terminar 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 electrónicos" (发送邮件). Encontrarás todos los diferentes tipos de métodos de prueba.
• Sigue la ruta "Enviar correos electrónicos" (发送邮件) -> "Tareas de correo electrónico" (发送邮件) 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 electrónico" (邮件标签) que acabas de visitar desde la página de la consola de administración de DM, puedes encontrar fácilmente la Dirección del remitente o Etiqueta de correo electrónico.
3. Completa la configuración del conector DM de Aliyun:
   • Completa los campos accessKeyId y accessKeySecret con el par de claves de acceso que obtuviste en el paso 1.
   • Completa los campos accountName y fromAlias con la "Dirección del remitente" y la "Etiqueta de correo electrónico" que encontraste 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 el título del correo electrónico enviado.
     • Completa el campo content con cualquier contenido de tipo cadena. 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 todos los flujos de usuario, 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 funciona antes de "Guardar y finalizar".

Eso es todo. No olvides Habilitar el conector en registro e 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 enum
subject	string	N/A
content	string	N/A
usageType	enum string	'Register' / 'SignIn' / 'ForgotPassword' / 'Generic'