跳到主要内容

使用 Mailgun 电子邮件服务设置电子邮件验证

Logto 的官方 Mailgun 电子邮件服务连接器。

提示:

本指南假设你对 Logto 连接器 (Connectors) 有基本的了解。对于不熟悉的人，请参考 连接器 (Connectors) 指南以开始了解。

前提条件​

基本配置​

  • 当你使用不同的 Mailgun API endpoint 时，填写 endpoint 字段，例如，EU 区域应为 https://api.eu.mailgun.net。默认值为 https://api.mailgun.net。
  • 在 domain 字段中填写你在 Mailgun 账户中注册的域名。此值可以在 Mailgun 仪表板的 Domains 部分找到。域名应为 example.com 格式，不带 https:// 或 http:// 前缀。
  • 在 apiKey 字段中填写你在 Mailgun 账户中生成的 API key。
  • 在 from 字段中填写你希望发送电子邮件的电子邮件地址。此电子邮件地址必须在你的 Mailgun 账户中注册。电子邮件地址应为 Sender Name \<sender@example.com> 格式。

传递​

配置对象​

“传递”部分允许你配置在不同场景下要发送的电子邮件内容。它是一个 JSON 键值映射，其中键是使用类型，值是包含要发送的电子邮件内容配置的对象。

{
  "<usage-type>": {
    // ...
  }
}

使用类型​

支持以下使用类型：

  • Register：用户注册时要发送的电子邮件。
  • SignIn：用户登录时要发送的电子邮件。
  • ForgotPassword：用户重置密码时要发送的电子邮件。
  • Generic：用户执行通用操作时要发送的电子邮件，例如测试电子邮件连接器。
备注:

如果在传递配置中未指定使用类型，将发送通用电子邮件。如果未指定通用电子邮件，连接器将返回错误。

内容配置​

连接器支持直接 HTML 内容和 Mailgun 模板。你可以为每种使用类型使用其中之一。

在主题和内容中，你可以使用 {{code}} 占位符插入验证码。

要使用直接 HTML 内容，请填写以下字段：

  • subject：要发送的电子邮件的主题。
  • replyTo：要用作回复地址的电子邮件地址。
  • html：（必填）要发送的电子邮件的 HTML 内容。
  • text：要发送的电子邮件的纯文本版本。

要使用 Mailgun 模板，请填写以下字段：

  • subject：要发送的电子邮件的主题。
  • replyTo：要用作回复地址的电子邮件地址。
  • template：（必填）要使用的 Mailgun 模板的名称。
  • variables：要传递给 Mailgun 模板的变量。应为 JSON 键值映射，因为在发送到 Mailgun 之前会被字符串化。注意不需要包含 code 变量，因为它将由连接器自动添加。

示例​

以下是传递配置的示例：

{
  "Register": {
    "subject": "{{code}} 是你的验证码",
    "replyTo": "Foo <foo@bar.com>",
    "html": "<h1>欢迎来到 Logto</h1><p>你的验证码是 {{code}}。</p>",
    "text": "欢迎来到 Logto。你的验证码是 {{code}}。"
  },
  "SignIn": {
    "subject": "欢迎回到 Logto",
    "replyTo": "Foo <foo@bar.com>",
    "template": "logto-sign-in",
    "variables": {
      "bar": "baz"
    }
  }
}

测试 Mailgun 电子邮件连接器​

你可以输入一个电子邮件地址并点击“发送”以查看设置是否可以在“保存并完成”之前工作。

就是这样。别忘了 在登录体验中启用连接器。