第 17 期 · M3 第四部分:第三方登录
· 阅读需 6 分钟
M3 的最后一部分:用 GitHub、Microsoft 或任何 OpenID Connect 提供方登录皮肤站。BS 要装一个核心插件再给每家装一个插件,云织在设置里加一项就行。到这里,M3(外置登录与开放平台)的功能全部完成。
本期完成
- 三种提供方:
github、microsoft、oidc(按 issuer 自动发现,Google、Keycloak、Authentik 等都能用),一起写在设置auth.social.providers里。设置site.url后,登录页和注册页出现"使用 … 登录"按钮。 - 第一次登录:已绑定的直接登录;提供方和本站都验证过的同一邮箱自动绑定;其余进入"欢迎"页,创建新账号(邮箱、昵称预填)或"登录并绑定"已有账号。
- 已绑定的账号:个人资料页查看、绑定、解除绑定。通过第三方登录创建的账号没有密码,可以在个人资料页设置第一个密码。
- 设计记录:ADR 0025;文档站新增第三方登录页面。
不只按邮箱认人
BS 的回调拿到邮箱就登录同邮箱的账号,这有两个漏洞:
- 预先劫持:有人先用你的邮箱注册一个账号(没验证),等你用 GitHub 登录,你们就共用这个账号,他还知道密码。
- nOAuth:Microsoft 工作账号的邮箱由组织管理员填写,可以填成任何人的地址。
云织只在两边都验证过邮箱时才自动绑定:GitHub 看主邮箱的 verified,OpenID Connect 看 email_verified,Microsoft 只认个人账号或带 xms_edov 的邮箱。其余情况让本人选择:建新账号,或者用密码登录后绑定。
其它细节
- 每次登录带 PKCE 和 state。state 同时写进只发往
/api/v1/auth/social的 cookie,回调时两者必须一致、只能用一次,别的网站不能把访客带到回调、登进攻击者的账号。 - ID Token 校验 issuer、audience、有效期和 nonce,不校验签名:令牌是服务端直接从提供方的令牌端点经 TLS 拿到的,OpenID Connect 规范允许这样做,也省了一个 JOSE 库。
- 没有密码的账号不能用密码或启动器登录;最后一个绑定在没有密码时不能解除,免得把自己锁在外面。设置第一个密码、改邮箱、注销账号不要求输入当前密码。
- 绑定开始后如果浏览器里换了账号,这次绑定作废。
开发中的小插曲
- PostgreSQL 上第一个测试之后,后面的测试都提示"安装令牌无效":共用的测试库里留着"已完成安装"的标记,社交登录的测试在开始前把它清掉。
- 本地实测时,命令行的
--data写成了 Git Bash 风格的/e/...,Windows 程序把它当成当前盘的\e\...,在 E 盘根目录下多出一个数据目录,已改用E:\...路径。
本地实测(skinloom up --dev)
用一个临时写的 OpenID Connect 提供方(本机 http),在浏览器里:
- 登录页出现"使用 测试 SSO 登录"和"使用 GitHub 登录"。
- 点测试 SSO → 提供方登录 → 回到"欢迎"页,邮箱提示"已由 测试 SSO 验证" → 创建账号,已登录。
- 个人资料页显示"设置密码"(没有"当前密码")和已绑定的账号,提示这是唯一的登录方式、不能解绑;设置密码后可以解绑。
- 解绑后点"绑定 测试 SSO",经提供方回到
/user/profile?social_linked=dev,显示"已绑定"。 - 在提供方取消:回到登录页,显示"已取消登录。"
- 用一个邮箱未验证、但和管理员邮箱相同的第三方账号登录:没有自动绑定,进入"欢迎"页;点"登录并绑定",用管理员密码登录后自动绑定。
- GitHub 按钮生成的授权地址正确(没有真的去 GitHub)。
审计日志里有绑定、解绑和改密码的记录,服务端日志没有警告或错误。
测试
internal/social(SQLite 与 PostgreSQL):- 新账号、预填、关闭注册、昵称为空、只能用一次、没有密码不能密码登录、再次登录、换邮箱后不算验证、邮箱被占用;
- 封禁、宽限期内注销会恢复、彻底注销;
- 自动绑定只在两边都验证时发生,
email_verified为字符串、从 userinfo 取邮箱; - 绑定别人的账号、同一提供方第二个账号、绑定中换了账号、登录后绑定、只能用一次、最后一个绑定不能解;
- state 与 cookie 不一致、没有 cookie、用两次、别的提供方的回调、取消、过期、清理,以及篡改 issuer、audience、azp、过期时间、nonce、subject,密钥错误;
- GitHub:主邮箱已验证、没有
user:email权限、错误的 code;Microsoft:个人账号、工作账号、已验证域名、租户限制; - 配置校验与
next地址。
- HTTP:bootstrap(没有
site.url时没有提供方,不泄露密钥)、开始登录要 CSRF 头、cookie 属性、新账号、设置第一个密码、记住我、绑定与解绑、登录后绑定、失败时跳回登录页、关闭注册、审计。 - 全量回归:
go test ./...(SQLite 与 PostgreSQL)、vet、staticcheck、govulncheck,生成代码与迁移无漂移;前端类型检查、测试与构建。
问题与风险
- 没有用真实的 GitHub、Microsoft、Google 应用实际登录过,只用了模拟的提供方。
- 后台还没有设置页面,提供方要用命令行或设置接口配置;后台的用户详情还不显示绑定。
- 不支持 OpenID Connect 的 BS 站点(如 LittleSkin)还不能作为提供方。
下期计划
M3 收尾:整体回归、修补发现的问题,然后进入 M4。