托管登录握手

产品站把用户跳到 login. 托管门户,回跳拿一次性 login_code,服务端换 access_token;门户展示平台和本站点已启用的登录方式。

登录唯一入口是 login. 托管门户——邮箱、微信、GitHub 与 Google(由平台和本站点开通后显示)都在门户内完成。原始 token 不出现在浏览器 URL 里,改用一次性 login_code 由服务端换票。

login-sequence

① 跳转托管门户

把用户浏览器 302 到门户,带上回跳地址与站点 slug:

text
https://login.rekitdev.com/login?return_to=https://你的站/api/auth/callback?returnTo=/&site=your-slug
Query必填说明
return_to是登录后回跳的产品站 URL,host 须在站点白名单内;可自带 query
site是后台站点 slug
lang否zh / en
PC 扫码用 /login;微信内 H5 用 /login/mp(见「微信内静默登录」)。Google 登录使用 OIDC 的 sub 识别账号,不会产生微信 unionid;公众号通知仍须绑定符合要求的微信身份。

② 回跳带回 login_code

登录成功后门户 302 回你的 return_to,仅追加 login_code:

text
302 → https://你的站/api/auth/callback?returnTo=/&login_code=xxxxxxxx

③ 服务端换票

POST/api/v1/auth/exchange无
用一次性 login_code 换 access_token + user
请求
POST https://login.rekitdev.com/api/v1/auth/exchange
Content-Type: application/json

{ "code": "回跳带回的 login_code" }
响应
{
  "access_token": "<JWT>",
  "expires_in": 86400,
  "user": { "id": 123, "nickname": "...", "email": "...", "unionid": "oUnion..." }
}
务必在服务端换票
login_code 一次性、90s 有效。产品站服务端换到 access_token 后写自己的 HttpOnly Cookie,再 302 回站内 returnTo。原始 token 不要落到浏览器 URL / localStorage。