https://auth.example.com 请换成你的 Casdoor 地址(Casdoor 云上类似 https://acme.casdoor.com),其他 example.com 地址也换成你自己的。用 Casdoor 配置 阿里邮箱
- 1
在 Casdoor 中注册 阿里邮箱
在 Casdoor 控制台打开 应用,为 阿里邮箱 添加一个应用,在它的 OIDC/OAuth 标签页复制 客户端ID 和 客户端密钥。把下面的地址加到 重定向URLs:
https://qiye.aliyun.com/oauth2/v2.0/code.json
阿里邮箱配置页上的回调地址是逗号隔开的一组地址,上面只列了第一个。把配置页上的地址全部加进来。
- 2
确认前提
身份源只有 AI尊享版 能用,一次只能配一个。开始前要在 企业定制 → 界面定制 → 定制邮箱登录地址 里添加自己的登录域名,做好 CNAME 和备案;建议同时上传 SSL 证书、强制 HTTPS。
- 3
创建 OIDC 身份源
在邮箱域管理后台进入 企业定制 → 身份源管理,点 创建,认证协议选 OIDC。保存时阿里邮箱会读取
https://auth.example.com/.well-known/openid-configuration检查授权、Token 和 JWKS 地址,Casdoor 都有。显示名称 Casdoor Client ID <client ID> Client Secret <client secret> Issuer URL https://auth.example.com - 4
把回调地址加到 Casdoor
配置页上的 回调地址 是只读的一组地址,逐个加到 Casdoor 这个应用的重定向 URL 里。
- 5
先用混合模式测试
登录配置里只打开 启用身份源,设为默认登录方式 和 仅允许通过此身份源完成登录 先保持关闭。用无痕窗口打开自定义登录地址,点更多登录方式里的 Casdoor 图标,用一个邮箱和邮箱账号一致的 Casdoor 用户登录。
- 6
切换为默认登录方式
测试通过后再打开 设为默认登录方式,自定义登录地址就直接跳 Casdoor,官方登录地址仍可用账号密码登录。
注意事项
- 阿里邮箱按邮箱地址对应账号,Casdoor 用户的邮箱必须和邮箱账号完全一致。
- 阿里邮箱建议 access token、ID token 有效期 14 天,refresh token 28 天。在 Casdoor 应用里把 Token 过期时间改成 336 小时、Refresh token 过期时间改成 672 小时,员工就不会频繁重新登录。
- 打开 仅允许通过此身份源完成登录 后,IMAP、POP、SMTP 不再接受邮箱密码,只能用客户端安全密码。打开前先让全员启用安全密码。
阿里邮箱 的设置取自它的官方文档(核对于 2026年11月:阿里邮箱:对接企业身份系统实现企业账号登录邮箱、阿里邮箱:配置 OIDC 身份认证对接实现企业 IdP 登录)。阿里邮箱 是其所有者的商标。
常见问题
支持 SAML 吗?
不支持。阿里邮箱的身份源只有微软 AD、OIDC 和 OAuth 三种,阿里推荐 OIDC。
保存时报错怎么办?
先确认阿里邮箱能从公网访问 https://auth.example.com/.well-known/openid-configuration,Casdoor 的证书有效。阿里邮箱用 client_secret_post 换 Token、要求 RS256 签名,Casdoor 默认都满足。
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 的网页上完成设置。

帆软 FineReport / FineBI商业版
应用集成用帆软官方的类Oauth2单点登录插件把 FineReport、FineBI 的决策平台接到 Casdoor:认证地址、令牌申请、用户信息三步和 fr_login_name 的取值都已按 Casdoor 写好。

