Saltar al contenido principal

Conectores de correo electrónico

Un conector de correo electrónico integra tu servicio de envío de correos con Logto para habilitar la verificación segura de usuarios a través del correo electrónico. Una vez configurado, puedes enviar contraseñas de un solo uso (OTPs) para registro de usuario, inicio de sesión, restablecimiento de contraseña, vinculación de cuentas, invitaciones de miembros y validación de operaciones de alto riesgo.

Elige tu conector de correo electrónico​

Logto ofrece tres tipos de opciones de conectores de correo electrónico:

Servicio de correo electrónico gratuito de Logto (solo Cloud)​

Esta opción de servicio de correo electrónico integrado es ideal para comenzar rápidamente tanto para pruebas como para producción. Elimina la necesidad de integraciones de terceros y ofrece un envío de correos gratuito y confiable. Simplemente personaliza tu marca básica para las plantillas de correo electrónico prediseñadas.

El conector de Logto Email Service ahora ofrece capacidades de personalización de marca, incluyendo logotipo, información de la empresa y nombre del remitente.

Sin embargo, aunque es conveniente, hay algunas limitaciones que debes tener en cuenta: no puedes personalizar la dirección de correo del remitente, el dominio ni el contenido específico del correo electrónico.

Conéctate con tu proveedor de servicios de correo electrónico (ESP) preferido utilizando las guías paso a paso de Logto.

Estas opciones te permiten personalizar completamente tus plantillas de correo electrónico, el nombre del remitente, agregar variables, etc., para servir mejor a tu marca.

Ofrecemos soporte listo para usar para los siguientes proveedores de servicios de correo electrónico:

Personaliza tu conector de correo electrónico​

Si ninguna de las soluciones anteriores satisface tus necesidades, también puedes optar por conectarte a tu servicio de correo electrónico deseado utilizando Simple Mail Transfer Protocol (SMTP).

Si ya tienes tu propio servicio de correo electrónico y no puedes usar una conexión SMTP, también ofrecemos un "conector de correo electrónico HTTP".

Cuando necesita enviar un correo electrónico, realiza una llamada API al endpoint configurado para completar el flujo de autenticación dependiente del correo electrónico. Ten en cuenta que, para evitar errores en el flujo de autenticación, el endpoint configurado debe devolver una respuesta 200 después de recibir el WebHook para informar a Logto que ha recibido la notificación para enviar el correo. En este caso, debes monitorear tu propio servicio de correo electrónico para asegurar la entrega exitosa.

Si nuestros conectores estándar no cumplen con tus requisitos específicos, no dudes en contactarnos. Para usuarios OSS, puedes implementar tu propio conector (OSS) si el requerimiento es urgente. Siempre damos la bienvenida a contribuciones; tu esfuerzo podría ayudar a otros miembros de la comunidad con las mismas necesidades.

Pasos de configuración​

Sigue los siguientes pasos para agregar un conector de correo electrónico:

  1. Navega a Consola > Conectores > Conectores de correo electrónico y SMS.
  2. Para agregar un nuevo conector de correo electrónico, haz clic en el botón "Configurar" y selecciona tu proveedor de correo electrónico deseado.
  3. Revisa la documentación README y configura tu proveedor elegido paso a paso.
  4. Haz clic en "Guardar y listo" para finalizar.
nota:

Para asegurar que los correos críticos (como los códigos de verificación) lleguen de manera confiable a las bandejas de entrada de los usuarios y evitar filtros de spam, concéntrate en dos prioridades:

  • Configura la autenticación de correo electrónico (SPF, DKIM, DMARC) Los proveedores de correo (Gmail, Outlook, etc.) usan estos protocolos para verificar que no eres un spammer. Si faltan estas configuraciones, tus correos pueden ir a spam o ser rechazados.
    • SPF (Sender Policy Framework): Lista los servidores / IPs autorizados para enviar correos para tu dominio.
    • DKIM (DomainKeys Identified Mail): Agrega una firma digital para probar que los correos no han sido alterados.
    • DMARC (Domain-based Message Authentication): Indica a los receptores cómo manejar los correos que fallan SPF / DKIM.
  • Separa correos de autenticación y de marketing Los correos de marketing suelen generar quejas de spam o altas tasas de rebote. Si los correos de autenticación comparten el mismo dominio / IP, su entregabilidad se ve afectada.
    • Usa un dominio dedicado: Envía correos de verificación desde @auth.tudominio.com, marketing desde @marketing.tudominio.com.
    • IP dedicada: Solicita una IP única para correos de autenticación y caliéntala poco a poco.
    • Coincidencia de dirección "From": Asegúrate de que el dominio del remitente coincida con los registros SPF / DKIM / DMARC.

Cambiar conector de correo electrónico​

Notarás que solo se puede agregar un conector de correo electrónico.

Cuando ya tienes un conector de correo electrónico, solo puedes seleccionar "Cambiar conector de correo electrónico". Al realizar esta operación en la consola, surte efecto inmediatamente una vez guardado, así que asegúrate de probar tu configuración antes de guardar.

Para asegurar la estabilidad de tu servicio, los usuarios de Cloud pueden crear un tenant de desarrollo para el entorno de desarrollo. Después de probar la configuración en el entorno de desarrollo, "migra" la configuración a producción y luego guarda la configuración.

Habilitar dirección de correo electrónico para flujos de usuario final​

Una vez que agregues y configures el conector de correo electrónico, puedes habilitar flujos de autenticación basados en correo electrónico:

aviso:

Debido a que nuestras configuraciones surten efecto de inmediato, eliminar el conector de correo electrónico existente puede afectar el proceso normal de inicio de sesión y registro de los usuarios finales.

Por ejemplo, si el identificador de inicio de sesión incluye la combinación "correo electrónico + código de verificación", eliminar el conector de correo electrónico existente impedirá que los usuarios reciban códigos de verificación por correo y resultará en un error en el flujo de inicio de sesión.

Por favor, ten en cuenta los posibles riesgos al operar sobre los conectores.

Preguntas frecuentes​

¿Cómo personalizar el nombre del remitente del correo electrónico?​

Seguimos trabajando en más conectores. Si necesitas más opciones, solo háznoslo saber en Discord y crea una solicitud de función en GitHub. Si necesitas más ayuda, también puedes contactarnos por correo electrónico.

Para los colaboradores, ofrecemos un método de creación de conectores fácil de extender, permitiéndote personalizar tu propio conector según tus escenarios específicos. Siempre eres bienvenido a enviar un pull request a Logto, para que otros en la comunidad también se beneficien de tu trabajo.

¿Cómo puedo restringir direcciones IP para solicitudes de correo en los conectores de correo electrónico de Logto?​

Una solución alternativa es usar el conector de correo electrónico HTTP de Logto.

Implementa un endpoint API en tu servidor que llame al servicio de correo correspondiente, y activa este endpoint API a través del conector de correo electrónico HTTP de Logto. De esta manera, tendrás control total sobre la dirección IP de tu endpoint API y podrás agregar las IP correspondientes a la lista blanca en la configuración del proveedor de correo.