Configura la verificación por correo electrónico con SendGrid Email

El conector oficial de Logto para el servicio de correo electrónico SendGrid.

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

SendGrid (es decir, Twilio SendGrid) es una plataforma de comunicación para correos electrónicos transaccionales y de marketing. Podemos usar su función de envío de correos electrónicos para enviar un código de verificación.

Registrar cuenta de SendGrid

Crea una nueva cuenta en el sitio web de SendGrid. Puedes omitir este paso si ya tienes una cuenta.

Verificar remitentes

Ve a la página de consola de SendGrid e inicia sesión con tu cuenta de SendGrid.

Los remitentes indican las direcciones desde las cuales se enviará nuestro correo electrónico de código de verificación. Para poder enviar correos electrónicos a través del servidor de correo de SendGrid, necesitas verificar al menos un remitente.

Desde la página de consola de SendGrid, ve a "Settings" -> "Sender Authentication" en la barra lateral.

La autenticación de dominio (Domain Authentication) es recomendable pero no obligatoria. Puedes hacer clic en "Get started" en la tarjeta "Authenticate Your Domain" y seguir la guía para vincular y verificar un remitente en SendGrid.

Al hacer clic en el botón "Verify a Single Sender" en el panel, ahora te enfocas en un formulario que requiere información crítica para crear un remitente. Sigue la guía, completa todos estos campos y haz clic en el botón "Create".

Después de crear el remitente individual, se enviará un correo electrónico con un enlace de verificación a la dirección de correo electrónico de tu remitente. Ve a tu buzón, encuentra el correo de verificación y termina de verificar el remitente individual haciendo clic en el enlace proporcionado en el correo. Ahora puedes enviar correos electrónicos a través del conector de SendGrid usando el remitente que acabas de verificar.

Crear claves API

Comencemos desde la página de consola de SendGrid, ve a "Settings" -> "API Keys" en la barra lateral.

Haz clic en "Create API Key" en la esquina superior derecha de la página de claves API. Escribe el nombre de la clave API y personaliza los permisos de la clave API ("API Key Permission") según tu caso de uso. Se requiere un Full Access global o Restricted Access con acceso completo a Mail Send antes de enviar correos electrónicos con esta clave API.

La clave API se te mostrará en pantalla tan pronto como finalices el proceso de Create API Key. Debes guardar esta clave API en un lugar seguro porque es la única oportunidad en la que podrás verla.

Configura tu conector

Completa el campo apiKey con la clave API creada en la sección "Crear claves API".

Completa los campos fromEmail y fromName con la From Address y el Nickname de los remitentes. Puedes encontrar los detalles del remitente en la página "Sender Management". fromName es OPCIONAL, por lo que puedes omitirlo.

Puedes agregar múltiples plantillas de conector de correo de SendGrid para diferentes casos. Aquí tienes un ejemplo de cómo agregar una sola plantilla:

• Completa el campo subject, que funciona como el título de los correos electrónicos.
• Completa el campo content con el contenido de tipo string que desees. No olvides dejar el marcador {{code}} para el código de verificación aleatorio.
• Completa el campo usageType con Register, SignIn, ForgotPassword o Generic para diferentes casos de uso.
• Completa el campo type con text/plain o text/html para diferentes tipos de contenido.

Para habilitar todos los flujos de usuario, se requieren plantillas con usageType Register, SignIn, ForgotPassword y Generic.

Aquí tienes un ejemplo de JSON de plantilla de conector de SendGrid.

[
  {
    "subject": "<register-template-subject>",
    "content": "<Logto: Tu código de verificación es {{code}}. (plantilla de registro)>",
    "usageType": "Register",
    "type": "text/plain",
  },
  {
    "subject": "<sign-in-template-subject>",
    "content": "<Logto: Tu código de verificación es {{code}}. (plantilla de inicio de sesión)>",
    "usageType": "SignIn",
    "type": "text/plain",
  },
  {
    "subject": "<forgot-password-template-subject>",
    "content": "<Logto: Tu código de verificación es {{code}}. (plantilla de recuperación de contraseña)>",
    "usageType": "ForgotPassword",
    "type": "text/plain",
  },
  {
    "subject": "<generic-template-subject>",
    "content": "<Logto: Tu código de verificación es {{code}}. (plantilla genérica)>",
    "usageType": "Generic",
    "type": "text/plain",
  },
]

Probar el conector de correo de SendGrid

Puedes escribir una dirección de correo electrónico y hacer clic en "Send" para ver si la configuración funciona antes de "Save and Done".

Eso es todo. No olvides Habilitar el conector en registro e inicio de sesión.

Tipos de configuración

Nombre	Tipo
apiKey	string
fromEmail	string
fromName	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'
type	enum string	'text/plain' / 'text/html'