使用 Aliyun Direct Mail 设置电子邮件验证

Logto 的官方 Aliyun 连接器用于直接邮件服务。

提示:

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

开始

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

在 Aliyun DirectMail 控制台中设置电子邮件服务

创建 Aliyun 账户

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

启用并配置 Aliyun Direct Mail

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

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

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

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

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

编写连接器 JSON

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

测试 Aliyun 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'