登录鉴权

Google

让用户通过 Google 登录。

准备工作

先在 /admin/config/auth 的回调地址面板复制以 /api/auth/callback/google 结尾的完整地址。域名和协议须与登录站点一致。

完成后,登录页显示该厂商的登录按钮,可使用测试账号登录。

在 Google 完成准备

配置同意屏幕

打开 Google。配置 OAuth 同意屏幕;应用处于测试状态时将测试账号加入允许列表。

创建 Web 客户端

创建类型为 Web 应用的客户端。

登记回调 URI

在已获授权的重定向 URI 粘贴后台显示的 Google 回调地址,复制 Client ID 和 Client Secret。

官方说明 · Google Web OAuth 官方说明

填写项目配置

回到 Kernlift 后台,打开 /admin/config/auth。

来源后台字段
Client IDClient ID
Client secretClient Secret

启用此登录方式。要接受首次登录的用户,勾选 允许新用户注册 并保存。

Kernlift 后台的 Google 配置字段

开启 Google One Tap(可选)

One Tap 会在登录和注册页弹出 Google 的“以 … 身份继续”提示,已登录 Google 的访客一次点击即可登录或注册。它复用上面的 Google 客户端。

  1. 在 Google 客户端的已获授权的 JavaScript 来源中加入站点源,例如 https://<你的域名>。来源不在列表中时 One Tap 会被拒绝。
  2. 在 /admin/config/auth 的 Google 面板打开 Google One Tap 并保存。只有 Google 登录已启用、Client ID 和 Client Secret 都已保存时才生效。

开启期间,Better Auth 提供 POST /api/auth/one-tap/callback,用你的 Client ID 校验 Google 签发的 ID token;关闭时这个端点不存在。只有勾选了 允许新用户注册,首次使用的用户才能通过 One Tap 注册;被封禁的用户仍会被拒绝。

验证

  1. 在无痕窗口打开 /auth/sign-in,选择 Google。
  2. 完成授权,确认回到站点并处于已登录状态。
  3. 开启 One Tap 后,在已登录 Google 的浏览器中打开 /auth/sign-in。提示出现后选择账号,即可登录并回到原本要去的页面。

常见问题

One Tap 提示没有出现

确认 Google 登录已启用且 Client ID 和 Client Secret 已保存、Google One Tap 已打开、站点源已加入已获授权的 JavaScript 来源。访客关闭过提示后,Google 也会在一段时间内不再显示。

提供方拒绝跳转

在 Google 或 GitHub 登记的回调地址与 回调 URL 面板中的不一致。重新复制一次,协议和域名都要一致。

下一步

接入 Google 和 GitHub 登录