跳到主要内容

邮箱登录新增支持 Magic Link:点一下链接就登录,不用再敲验证码

CloudBase TeamCloudBase Team
阅读需 2 分钟

很多产品里「邮箱登录」是用户进来的第一步,但您可能也观察到:用户输入邮箱后,要等几秒收到邮件、打开邮件、复制 6 位数字、切回页面、粘贴、提交——一连串步骤里任何一步出问题都可能让人放弃。

CloudBase 邮箱登录现在新增 Magic Link 模式:用户输入邮箱后,邮件里收到一条登录链接,点一下就完成登录,不需要再敲 6 位验证码。

这个改动给您带来什么

  • 用户登录路径少 3 步:少了「看验证码 → 复制 → 切回 → 粘贴」四个动作
  • 托管登录页直接生效:开启后,邮箱登录区域自动显示「发送登录链接」按钮
  • 跳转地址可配:用户点击链接验证通过后,自动跳转到您指定的页面(订单页、Dashboard 等)
  • 两种模式按需切:保留邮箱验证码的产品也不受影响,按业务调即可

怎么开始

  1. 进云开发控制台 → 身份认证 → 登录方式选择 → 邮箱登录
  2. 选择 Magic Link 模式(或保留验证码模式)
  3. 如需自定义跳转地址,在发送验证请求时传入 email_redirect_to

实际怎么调用

Magic Link 模式下,发送邮箱验证请求时传入 email_redirect_to 参数即生效:

{
"email": "user@example.com",
"target": "ANY",
"email_redirect_to": "https://your-domain.com/dashboard"
}

不传 email_redirect_to 时,自动 fallback 到验证码模式:

{
"email": "user@example.com",
"target": "ANY"
}

跳转地址必须是完整 URL,且只能是 CloudBase 默认域名或已配置的自定义域名(避免用户点开链接后跳转失败)。

注意

  • Magic Link 支持邮箱登录
  • 默认有效期 600 秒,点击使用后即失效
  • 托管登录页和自定义 SMTP 都已适配,两种模式都能用

用 CloudBase 构建下一款应用

一站式后端云服务,覆盖数据库、云函数、静态托管与 AI 能力。