跳到主要内容

Logto 内置邮件服务

Logto 为你在以下场景下提供了内置邮件服务,方便快捷:

  1. 快速探索或测试 Logto 的邮箱登录体验。
  2. 直接用于你的线上产品。主要适用于愿意使用 logto.email 作为发件邮箱域名的新创公司。

Logto 邮件服务的特点:

  • 免费使用:完全免费,无每日邮件使用量限制,帮你节省成本。
  • 无需配置:无需与任何第三方邮件服务商进行配置。只需自定义邮件模板的基础品牌信息。如果你还没有自己的品牌信息,也可以选择几步即用。
  • 投递保障:基于 Logto 邮件服务,你可以获得稳定的服务和可靠的邮件投递,确保用户能够顺利访问你的产品。

但在便捷的同时,也有一些限制需要注意:

  1. 邮件将从固定地址 [email protected] 发送。
  2. 你无法在邮件中添加链接或任何其他自定义内容。

随着业务需求的发展,你可以随时选择其他邮件服务商。我们提供多种开箱即用的邮件服务连接器,同时也支持 SMTPHTTPWebHook 触发邮件发送,总有一种方式适合你。

备注:

Logto 内置免费邮件服务目前仅对 Cloud 用户开放。对于开源服务用户,你可以灵活配置自己的邮件服务商用于邮箱登录。

配置步骤

按照以下步骤配置 Logto 邮件服务:

  1. 前往 连接器 > 邮箱与短信连接器
  2. 若要添加新的邮箱连接器,点击“设置”按钮并选择“Logto 邮件服务”连接器。
  3. 成功创建“Logto 邮件服务”连接器后,你可以自定义邮件模板中展示的基础品牌信息。
  4. 修改完成后,记得在保存更改前,先向你的邮箱地址发送测试邮件模板。

可自定义选项:

  • 发件邮箱:发件邮箱固定为 [email protected],不可修改。
  • 发件人名称:设置你的品牌名称作为发件人名称,确保用户识别。
  • 公司信息:展示你的公司名称、地址或邮编,提升用户信任并满足合规要求。注意不允许填写 URL。
  • 应用 Logo:上传你的应用品牌 Logo,让品牌价值得以在用户收到的邮件中展示。

统一邮件模板

Logto 邮件服务采用统一邮件模板,针对不同认证 (Authentication) 场景定制:

用途场景说明
注册 (Register)用户通过邮箱创建账号,并通过输入 Logto 发送到邮箱的验证码完成验证。
登录 (SignIn)用户通过邮箱登录,输入验证码而非密码完成验证。
忘记密码 (ForgotPassword)用户在登录时忘记密码,可以选择通过已在 Logto 验证过的邮箱进行身份验证。
通用 (Generic)此模板可作为多种场景的通用备选,包括测试连接器配置等。
组织邀请 (OrganizationInvitation)使用此模板向用户发送加入组织的邀请链接。
用户权限验证 (UserPermissionValidation)在应用使用过程中,部分高风险操作或风险等级较高的操作需要额外用户验证,如银行转账、删除正在使用的资源、注销会员等。UserPermissionValidation 模板可用于定义用户在这些场景下收到的邮件验证码内容。
绑定新标识 (BindNewIdentifier)当用户修改个人资料时,可能会将邮箱地址绑定到当前账号。此时可使用 BindNewIdentifier 模板自定义验证邮件内容。
邮箱 MFA 验证 (MfaVerification)启用邮箱 MFA 时,此模板用于在多因素认证 (MFA) 过程中向用户发送验证码。
绑定 MFA (BindMfa)启用邮箱 MFA 时,此模板用于设置 MFA 邮箱验证码。当用户将邮箱地址作为 MFA 因素绑定或配置时,会收到此验证码。

“注册 (Register)”用途类型下带有自定义品牌信息的邮件模板示例:

Logto 内置邮件服务示例

如果未提供自定义品牌信息,邮件模板也可采用默认展示和布局:

Logto 内置邮件服务无品牌示例

常见问题

可以为 Logto 邮件服务添加自定义 CSS 或 HTML 吗?

Logto 内置邮件服务不支持自定义 CSS 或 HTML。你只能修改通用品牌元素。此限制旨在保障内置邮件服务的稳定性,因为所有租户共用同一 IP 地址和发件人地址。详情请参考「提升邮件投递率的因素」。

如需自定义邮件模板,建议使用其他邮件连接器,如 AWS Direct Mail、SendGrid、Mailgun、Postmark 或 SMTP。