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 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

Crea una cuenta de Aliyun

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

Habilita y configura Aliyun Direct Mail

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

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

1. Ir a "Email Domains" (发信域名) desde la barra lateral y agregar "New Domain" (新建域名) siguiendo las instrucciones.
2. Personalizar "Sender Addresses" (发信地址) y "Email Tags" (邮件标签) respectivamente.

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

• Ve a la página de resumen de DirectMail, encuentra "Operation Guide" (操作引导) en la parte inferior de la página y haz clic en "Send Emails" (发送邮件). Encontrarás todos los diferentes tipos de métodos de prueba.
• Sigue la ruta "Send Emails" (发送邮件) -> "Email Tasks" (发送邮件) en la barra lateral para crear una tarea de prueba.

Componer el JSON del conector

1. Desde la página de consola de administración de DM, pasa el cursor sobre tu avatar en la esquina superior derecha y ve a "AccessKey Management" (AccessKey 管理), y haz clic en "Create AccessKey" (创建 AccessKey). Obtendrás un par de "AccessKey ID" y "AccessKey Secret" después de finalizar la verificación de seguridad. Por favor, guárdalos adecuadamente.
2. Ve a la pestaña "Sender Addresses" (发信地址) o "Email Tags" (邮件标签) que acabas de visitar desde la página de consola de administración de DM, puedes encontrar fácilmente Sender Address o Email Tag.
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 "Sender Address" y "Email Tag" 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í hay un ejemplo de cómo agregar una sola plantilla:
     • Completa el campo subject, que funcionará como título del correo electrónico 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 "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
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'