Casdoor集成市场

云之家扫码登录 | OAuth 提供商

用云之家扫码登录

员工在 Casdoor 登录页点云之家,打开云之家的扫码页,用云之家 App 扫码后回到 Casdoor。插件用轻应用的 appId 和 secret 取应用令牌,再用回调带回的 ticket 取用户的团队用户 ID、姓名和工号。云之家不返回手机号和邮箱。

Casdoor 官方核验企业版云之家金蝶扫码登录
你需要一个正在运行的 Casdoor,自己部署或用 Casdoor 云都可以。示例中的 https://auth.example.com 请换成你的 Casdoor 地址(Casdoor 云上类似 https://acme.casdoor.com),其他 example.com 地址也换成你自己的。

用 Casdoor 配置 云之家扫码登录

  1. 1

    创建扫码登录用的轻应用

    用团队管理员登录云之家开放平台,新建一个轻应用,移动端访问地址 必须填 https://www.yunzhijia.com/opencloud/openthird/qrlogin。记下应用的 appId 和 secret,并在团队里给要登录的人开通这个应用。

  2. 2

    安装插件

    在 Casdoor 组织的“集成市场”里安装 云之家扫码登录,需要企业版许可证。

  3. 3

    填写身份源

    打开新建的 OAuth 类身份源(类型 Plugin),按下表填写后保存,再把它加到应用的身份源列表里。

    Client IDappId
    Client secretsecret
    Auth URLhttps://www.yunzhijia.com/opencloud/openthird/qrconnet?appid={clientId}&redirect_uri={redirectUri}&state={state}
  4. 4

    测试登录

    在无痕窗口打开 Casdoor 登录页,点云之家图标,用云之家 App 扫码,应回到 Casdoor 并登录或绑定账号。

注意事项

  • 云之家扫码后回调地址上带的是 ticket 参数,不是 code,ticket 一小时内有效。
  • 用户的唯一标识是团队用户 ID openid;云之家用户 ID、团队 ID eid、工号、工作圈 ID 放在用户的扩展属性里,用户名用工号,没有工号时用 openid。
  • 云之家不返回手机号和邮箱,第一次登录时让用户绑定已有账号或新建账号。
  • 扫码的人所在团队必须开通了这个轻应用,否则扫码后无法授权。

云之家扫码登录 的设置取自它的官方文档(核对于 2026年11月:云之家开放平台:扫码登录第三方系统、云之家开放平台:获取 AccessToken、云之家开放平台:获取用户上下文(acquirecontext))。云之家扫码登录 是其所有者的商标。