cloud_done
沃聚云办公 模拟第三方网站
一个接入了沃聚合的普通网站 · 演示用
open_in_new沃聚合官网
science这是演示 下面是本站的登录页：微软、GitHub、谷歌 各自一个独立图标，点任意一个，都会由沃聚合的 API 把用户定向到对应渠道完成登录，登录完再带回本站。

登录 沃聚云办公

选择下面任意一种方式继续。本站自己没有账号体系，全部交给沃聚合处理。

或

没有账号？注册沃聚合账号

link本站的接入参数（沃聚合控制台创建）
client_id vobl_demo_client
redirect_uri —
渠道定向接口 /api/auth/oauth/<渠道>/start?next=…
badge

登录成功后拿到的用户资料

尚未登录
点左边的任意一个渠道图标，走完登录后会在这里显示沃聚合授权回来的真实用户资料。
timeline

登录链路日志

还没有开始。点左侧任意一个渠道图标试试。

help点一个图标，背后发生了什么

  1. 本站把用户送到 /api/auth/oauth/渠道/start（沃聚合的接口），并带上登录完成后要回来的地址。
  2. 沃聚合给这次跳转签名一份 state（防伪造 / 防重放），然后把你定向到该渠道自己的登录页——微软就是微软，GitHub 就是 GitHub。
  3. 用户在渠道那边登录成功后，渠道回调沃聚合，沃聚合完成账号绑定或建号，再继续跳回本站要的授权地址。
  4. 本站拿到授权码（PKCE）换成令牌，读 /api/oauth/userinfo，登录完成。
真的部分
  • 渠道定向、state 验签、回调、授权码 + PKCE 换令牌、读用户资料，全是沃聚合的真实接口
  • 登录会话、账号创建/绑定都写在沃聚合的库里
需要注意的部分
  • 「沃聚云办公」是虚构的演示站，只为了展示接入方式
  • 真实应用里，换 token 要在你的服务端做；这里为了单页可跑放在浏览器（公开客户端 + PKCE 允许）
  • 渠道得先在沃聚合后台填好自己的 Client ID / Secret 才能用，否则点上去会提示未配置

要看完整的接入文档：/docs；要自己建应用：开发者控制台。