Casdoor集成市场

禅道 | 应用集成

禅道单点登录

禅道没有可以填任意 OAuth2、OIDC 地址的单点登录,但企业版、旗舰版自带 LDAP 用户验证。Casdoor 内置 LDAP 服务,禅道指向它之后,员工在禅道登录页输入 Casdoor 的用户名和密码即可登录,账号和密码只在 Casdoor 维护。

Casdoor 官方核验商业版LDAP项目管理
你需要一个正在运行的 Casdoor,自己部署或用 Casdoor 云都可以。示例中的 https://auth.example.com 请换成你的 Casdoor 地址(Casdoor 云上类似 https://acme.casdoor.com),其他 example.com 地址也换成你自己的。

用 Casdoor 配置 禅道

  1. 1

    在 Casdoor 中注册 禅道

    在 Casdoor 控制台打开 应用,为 禅道 添加一个应用,在它的 OIDC/OAuth 标签页复制 客户端ID 和 客户端密钥。把下面的地址加到 重定向URLs:

    • https://zentao.example.com

    LDAP 登录不经过浏览器跳转,用不到这个重定向 URL。

  2. 2

    准备 Casdoor 的 LDAP 服务

    Casdoor 默认在 389 端口提供 LDAP(conf/app.conf 的 ldapServerPort),禅道服务器要能连到这个端口。在用户所在的组织里准备一个组织管理员账号,专门给禅道查询用户;这个账号不要开多因素认证,开了的账号不能用密码绑定 LDAP。

  3. 3

    安装 PHP 的 LDAP 扩展

    禅道的 LDAP 功能依赖 PHP 的 LDAP 扩展,先在禅道服务器上装好并启用。

  4. 4

    配置 LDAP

    管理员进入 后台 → 系统 → LDAP。Casdoor 的 LDAP 按 ou 区分组织,dc 部分可以随便写。服务器类型不要选活动目录,也不要勾选匿名:Casdoor 不允许匿名查询。各版本表单的字段名略有不同,按下面的含义对应着填。

    LDAP 服务器Casdoor 服务器的主机名或 IP,端口 389
    Base DNou=<组织名>,dc=example,dc=com
    管理账号cn=<管理员用户名>,ou=<组织名>,dc=example,dc=com
    密码这个管理员在 Casdoor 的密码
    登录名cn
  5. 5

    登录和授权

    员工用 Casdoor 用户名和密码登录禅道,第一次登录时禅道自动建用户。新用户默认没有权限,管理员要在权限分组里给他们授权。也可以先在 后台 → 人员 → 用户 里点 从LDAP导入用户 批量导入,或者把 LDAP 用户关联到已有的本地账号。

注意事项

  • Casdoor 的 LDAP 条目里,cn 是用户名,mail 是邮箱,mobile 是手机号;uid 属性是 Casdoor 内部的用户 ID,不要拿来当登录名。表单里有邮箱、手机等字段映射时按这个填。
  • 要按条件过滤用户时,Casdoor 的用户条目带 objectClass=posixAccount。
  • 389 端口是明文,禅道和 Casdoor 不在同一内网时改用 LDAPS(Casdoor 的 ldapsServerPort,默认 636,要在 ldapsCertId 里指定证书)。
  • 开了多因素认证的 Casdoor 用户不能用 LDAP 登录。

禅道 的设置取自它的官方文档(核对于 2026年11月:禅道使用手册:LDAP 用户验证(企业版)、禅道使用手册:LDAP、禅道应用商店:Oauth登录、禅道应用商店:CAS插件2.0)。禅道 是其所有者的商标。

常见问题

开源版能用吗?

禅道的 LDAP 用户验证写在企业版手册里,开源版没有内置,只能到禅道应用商店找第三方 LDAP 插件,先确认插件支持你的禅道版本。

能不能跳转到 Casdoor 登录(真正的单点登录)?

禅道官方的 Oauth登录 插件(按人数年费)只支持 GitHub、GitLab、Gitee、钉钉、飞书、企业微信、QQ 和禅道自己,不能填任意 OAuth2 地址。第三方的 CAS插件2.0 支持开源版 16.5 到 18.12,可以把 CAS 地址指向 https://auth.example.com/cas/<组织名>/<应用名>,但它要求 CAS 返回 account 属性,Casdoor 把用户名放在 cas:user 里,需要改插件里的字段映射。