你需要一个正在运行的 Casdoor,自己部署或用 Casdoor 云都可以。示例中的
https://auth.example.com 请换成你的 Casdoor 地址(Casdoor 云上类似 https://acme.casdoor.com),其他 example.com 地址也换成你自己的。用 Casdoor 配置 云之家扫码登录
- 1
创建扫码登录用的轻应用
用团队管理员登录云之家开放平台,新建一个轻应用,移动端访问地址 必须填
https://www.yunzhijia.com/opencloud/openthird/qrlogin。记下应用的 appId 和 secret,并在团队里给要登录的人开通这个应用。 - 2
安装插件
在 Casdoor 组织的“集成市场”里安装 云之家扫码登录,需要企业版许可证。
- 3
填写身份源
打开新建的 OAuth 类身份源(类型 Plugin),按下表填写后保存,再把它加到应用的身份源列表里。
Client ID appId Client secret secret Auth URL https://www.yunzhijia.com/opencloud/openthird/qrconnet?appid={clientId}&redirect_uri={redirectUri}&state={state} - 4
测试登录
在无痕窗口打开 Casdoor 登录页,点云之家图标,用云之家 App 扫码,应回到 Casdoor 并登录或绑定账号。
注意事项
- 云之家扫码后回调地址上带的是
ticket参数,不是code,ticket 一小时内有效。 - 用户的唯一标识是团队用户 ID
openid;云之家用户 ID、团队 IDeid、工号、工作圈 ID 放在用户的扩展属性里,用户名用工号,没有工号时用 openid。 - 云之家不返回手机号和邮箱,第一次登录时让用户绑定已有账号或新建账号。
- 扫码的人所在团队必须开通了这个轻应用,否则扫码后无法授权。
云之家扫码登录 的设置取自它的官方文档(核对于 2026年11月:云之家开放平台:扫码登录第三方系统、云之家开放平台:获取 AccessToken、云之家开放平台:获取用户上下文(acquirecontext))。云之家扫码登录 是其所有者的商标。
更多提供商
查看全部Authelia
OAuth 提供商让用户通过 Authelia 用 OpenID Connect 登录 Casdoor:包括提供商配置,以及要加到 Authelia 配置里的客户端。
OIDCPKCE自托管
authentik
OAuth 提供商让用户用 authentik 账号通过 OpenID Connect 登录 Casdoor:包括提供商配置,以及要在 authentik 里创建的应用和 OAuth2 提供商。
OIDCPKCE自托管

超星学习通
OAuth 提供商让师生用超星学习通账号登录 Casdoor:按超星微服务开放平台的 OAuth 接口填好了授权、换取 access_token 和获取用户信息的地址。
OAuth教育

