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

Logto 官方提供的阿里云邮件推送服务连接器。

提示:

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

入门指南

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

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

创建阿里云账户

前往 阿里云，如果你还没有阿里云账户，请先注册一个。

开通并配置阿里云邮件推送

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

从 DM 管理控制台页面 开始，你需要：

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

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

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

编写连接器 JSON 配置

1. 在 DM 管理控制台页面 右上角鼠标悬停在你的头像上，进入“AccessKey 管理”，点击“创建 AccessKey”。完成安全验证后，你会获得一对“AccessKey ID”和“AccessKey Secret”。请妥善保存。
2. 在 DM 管理控制台页面 进入你刚刚访问过的“发信地址”或“邮件标签”标签页，可以轻松找到 发信地址 或 邮件标签。
3. 填写阿里云 DM 连接器设置：
   • 将第 1 步获得的 access key 对填写到 accessKeyId 和 accessKeySecret 字段。
   • 将第 2 步找到的“发信地址”和“邮件标签”分别填写到 accountName 和 fromAlias 字段。所有模板将共享该签名名称。（fromAlias 可选，可以留空。）
   • 你可以为不同场景添加多个 DM 连接器模板。以下是添加单个模板的示例：
     • 填写 subject 字段，作为发送邮件的标题。
     • 用任意字符串内容填写 content 字段。不要忘记保留 {{code}} 占位符用于随机验证码。
     • usageType 字段根据不同场景填写 Register、SignIn、ForgotPassword 或 Generic。(usageType 是 Logto 用于识别具体场景的属性。) 为了支持完整的用户流程，要求配置 Register、SignIn、ForgotPassword 和 Generic 类型的模板。

测试阿里云 DM 连接器

你可以输入一个邮箱地址并点击“发送”来测试设置是否生效，然后再点击“保存并完成”。

就是这样。别忘了 在注册和登录中启用连接器。

配置类型

名称	类型
accessKeyId	string
accessKeySecret	string
accountName	string
fromAlias	string (可选)
templates	Template[]

模板属性	类型	枚举值
subject	string	N/A
content	string	N/A
usageType	enum string	'Register' | 'SignIn' | 'ForgotPassword' | 'Generic'