https://auth.example.com 请换成你的 Casdoor 地址(Casdoor 云上类似 https://acme.casdoor.com),其他 example.com 地址也换成你自己的。用 Casdoor 配置 禅道
- 1
在 Casdoor 中注册 禅道
在 Casdoor 控制台打开 应用,为 禅道 添加一个应用,在它的 OIDC/OAuth 标签页复制 客户端ID 和 客户端密钥。把下面的地址加到 重定向URLs:
https://zentao.example.com
LDAP 登录不经过浏览器跳转,用不到这个重定向 URL。
- 2
准备 Casdoor 的 LDAP 服务
Casdoor 默认在 389 端口提供 LDAP(
conf/app.conf的ldapServerPort),禅道服务器要能连到这个端口。在用户所在的组织里准备一个组织管理员账号,专门给禅道查询用户;这个账号不要开多因素认证,开了的账号不能用密码绑定 LDAP。 - 3
安装 PHP 的 LDAP 扩展
禅道的 LDAP 功能依赖 PHP 的 LDAP 扩展,先在禅道服务器上装好并启用。
- 4
配置 LDAP
管理员进入 后台 → 系统 → LDAP。Casdoor 的 LDAP 按
ou区分组织,dc部分可以随便写。服务器类型不要选活动目录,也不要勾选匿名:Casdoor 不允许匿名查询。各版本表单的字段名略有不同,按下面的含义对应着填。LDAP 服务器 Casdoor 服务器的主机名或 IP,端口 389 Base DN ou=<组织名>,dc=example,dc=com 管理账号 cn=<管理员用户名>,ou=<组织名>,dc=example,dc=com 密码 这个管理员在 Casdoor 的密码 登录名 cn - 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 里,需要改插件里的字段映射。
更多应用集成
查看全部
阿里邮箱商业版
应用集成阿里邮箱 AI尊享版可以把 Casdoor 加成 OIDC 身份源:员工在邮箱登录页跳到 Casdoor 登录,按邮箱地址进入对应的邮箱账号。
Argo CD
应用集成用 OpenID Connect 把 Argo CD 接入 Casdoor:argocd-cm 里的 oidc.config、客户端密钥、PKCE、CLI 登录,以及按 Casdoor 群组分配 RBAC 权限。

DeepSeek Harness商业版
应用集成让 DeepSeek Harness 以智能体身份登录 Casdoor,经 Casdoor MCP 网关使用你所在组织的 MCP 服务器,工具级授权、调用记录和审计都由 Casdoor 管理,全部在 Casdoor 和 DeepSeek Harness 的网页上完成设置。

