跳到主要内容

使用阿里云邮件推送设置邮件验证

Logto 官方连接器用于阿里云邮件推送服务。

提示

在本指南中，我们假设你对 Logto 连接器 (Connectors) 有基本的了解。如果没有，请查看 配置连接器 指南以开始了解。

开始使用​

阿里云是亚洲的主要云服务提供商，提供许多云服务，包括 DM（邮件推送）。阿里云 DM 连接器是 Logto 团队提供的一个插件，用于调用阿里云 DM 服务 API，借助该插件，Logto 终端用户可以通过邮件验证码（或换句话说，验证代码）注册和登录他们的 Logto 账户。

在阿里云邮件推送控制台中设置邮件服务​

💡 提示

如果你已经完成了一些部分，可以跳过。

创建阿里云账户​

前往 阿里云 并创建你的阿里云账户，如果你还没有的话。

启用并配置阿里云邮件推送​

进入 DM 服务控制台页面 并登录。通过点击页面左上角的“申请开通”按钮启用邮件推送服务，并开始配置过程。

从 DM 管理控制台页面 开始，你应该：

  1. 从侧边栏进入“发信域名”，按照说明添加“新建域名”。
  2. 分别自定义“发信地址”和“邮件标签”。

完成设置后，有两种不同的测试方法：

  • 前往 邮件推送概览页面，在页面底部找到“操作引导”，并点击“发送邮件”。你会找到所有不同类型的测试方法。
  • 按照侧边栏中的路径“发送邮件” -> “邮件任务”创建一个测试任务。

编写连接器 JSON​

  1. 从 DM 管理控制台页面 ，将鼠标悬停在右上角的头像上，进入“AccessKey 管理”，并点击“创建 AccessKey”。完成安全验证后，你将获得一对“AccessKey ID”和“AccessKey Secret”。请妥善保管。
  2. 前往你刚刚访问过的 DM 管理控制台页面 中的“发信地址”或“邮件标签”选项卡，你可以轻松找到 Sender Address 或 Email Tag。
  3. 填写阿里云 DM 连接器设置：
    • 使用从步骤 1 获得的访问密钥对填写 accessKeyId 和 accessKeySecret 字段。
    • 使用在步骤 2 中找到的“发信地址”和“邮件标签”填写 accountName 和 fromAlias 字段。所有模板将共享此签名名称。（你可以将 fromAlias 留空，因为它是可选的。）
    • 你可以为不同的情况添加多个 DM 连接器模板。以下是添加单个模板的示例：
      • 填写 subject 字段，它将作为发送邮件的标题。
      • 使用任意字符串类型的内容填写 content 字段。不要忘记为随机验证码留出 {{code}} 占位符。
      • 使用 Register、SignIn、ForgotPassword 或 Generic 填写 usageType 字段，以适应不同的使用场景。（usageType 是 Logto 属性，用于识别适当的使用场景。）为了启用完整的用户流程，需要具有 Register、SignIn、ForgotPassword 和 Generic 的 usageType 的模板。

测试阿里云 DM 连接器​

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

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

配置类型​

名称类型
accessKeyIdstring
accessKeySecretstring
accountNamestring
fromAliasstring (可选)
templatesTemplate[]
模板属性类型枚举值
subjectstringN/A
contentstringN/A
usageTypeenum string'Register' | 'SignIn' | 'ForgotPassword' | 'Generic'