Casdoor集成市场

浙政钉扫码登录 | OAuth 提供商

用浙政钉扫码登录

政务人员在 Casdoor 登录页点浙政钉,打开专有钉钉的扫码登录页,用浙政钉 App 扫码确认后回到 Casdoor。插件用开放平台的 AppKey、AppSecret 签名调用接口,按授权码取回用户的账号 ID、姓名和人员编码。浙政钉不返回手机号和邮箱。

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

用 Casdoor 配置 浙政钉扫码登录

  1. 1

    创建扫码登录应用

    在专有钉钉开放平台的开发者后台创建应用并开通 扫码登录,把回调域名设成 Casdoor 的域名。记下应用的 应用标识(client_id)、AppKey 和 AppSecret。扫码登录要用这个扫码应用自己的 AppKey、AppSecret。

  2. 2

    安装插件

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

  3. 3

    填写身份源

    打开新建的 OAuth 类身份源(类型 Plugin),按下表填写后保存,再把它加到应用的身份源列表里。授权地址里的 client_id 是应用标识,不是 AppKey,直接写进去;{redirectUri}、{state} 保持原样,由 Casdoor 替换。

    Client IDAppKey
    Client secretAppSecret
    Host浙政钉留空(默认 https://openplatform-pro.ding.zj.gov.cn);专有钉钉 SaaS 填 https://openplatform.dg-work.cn;其他省的专有钉钉填当地开放平台网关地址
    Auth URLhttps://login-pro.ding.zj.gov.cn/oauth2/auth.htm?response_type=code&client_id=<应用标识>&redirect_uri={redirectUri}&scope=get_user_info&authType=QRCODE&state={state}
  4. 4

    专有钉钉 SaaS 和其他省

    专有钉钉 SaaS 的授权地址把主机换成 login.on-premises.dingtalk.com,其余参数不变。其他省的专有钉钉找当地运营方要登录域名和开放平台网关地址,网关填进 Host,登录域名换进授权地址。

  5. 5

    测试登录

    在无痕窗口打开 Casdoor 登录页,点浙政钉图标,用浙政钉 App 扫码确认,应回到 Casdoor 并登录或绑定账号。

注意事项

  • 用户的唯一标识是浙政钉的 accountId;租户内标识 tenantUserId、人员编码 employeeCode、租户 ID 和名称放在用户的扩展属性里。用超管账号扫码时浙政钉不返回人员编码。
  • 浙政钉不返回手机号和邮箱,按手机号或邮箱自动匹配已有账号的方式用不上,第一次登录时让用户绑定已有账号或新建账号。
  • 每次登录都会用 AppKey、AppSecret 取一次应用的 access_token,开放平台对取 token 有频率限制,登录量很大时向运营方确认额度。
  • 开放平台的接口要求请求带 IP 和 MAC 头,插件拿不到 Casdoor 服务器的这两项,固定发 127.0.0.1 和全零 MAC。如果运营方要求白名单,按 Casdoor 服务器的出口 IP 申请。

浙政钉扫码登录 的设置取自它的官方文档(核对于 2026年11月:专有钉钉开放平台:扫码登录第三方网站、专有钉钉开放平台:获取 AccessToken、专有钉钉开放平台:编写更多语言 SDK(签名规则))。浙政钉扫码登录 是其所有者的商标。