Casdoor集成市场

阿里邮箱 | 应用集成

阿里邮箱单点登录

阿里邮箱 AI尊享版的身份源管理支持 OIDC。把 Casdoor 配成 OIDC 身份源后,员工在企业的邮箱登录地址上跳到 Casdoor 登录,阿里邮箱按 ID Token 里的邮箱找到对应的邮箱账号。

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

用 Casdoor 配置 阿里邮箱

  1. 1

    在 Casdoor 中注册 阿里邮箱

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

    • https://qiye.aliyun.com/oauth2/v2.0/code.json

    阿里邮箱配置页上的回调地址是逗号隔开的一组地址,上面只列了第一个。把配置页上的地址全部加进来。

  2. 2

    确认前提

    身份源只有 AI尊享版 能用,一次只能配一个。开始前要在 企业定制 → 界面定制 → 定制邮箱登录地址 里添加自己的登录域名,做好 CNAME 和备案;建议同时上传 SSL 证书、强制 HTTPS。

  3. 3

    创建 OIDC 身份源

    在邮箱域管理后台进入 企业定制 → 身份源管理,点 创建,认证协议选 OIDC。保存时阿里邮箱会读取 https://auth.example.com/.well-known/openid-configuration 检查授权、Token 和 JWKS 地址,Casdoor 都有。

    显示名称Casdoor
    Client ID<client ID>
    Client Secret<client secret>
    Issuer URLhttps://auth.example.com
  4. 4

    把回调地址加到 Casdoor

    配置页上的 回调地址 是只读的一组地址,逐个加到 Casdoor 这个应用的重定向 URL 里。

  5. 5

    先用混合模式测试

    登录配置里只打开 启用身份源,设为默认登录方式 和 仅允许通过此身份源完成登录 先保持关闭。用无痕窗口打开自定义登录地址,点更多登录方式里的 Casdoor 图标,用一个邮箱和邮箱账号一致的 Casdoor 用户登录。

  6. 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 出问题时怎么登录?

没打开 仅允许通过此身份源完成登录 时,官方登录地址始终可以用邮箱账号密码登录,可以从那里进管理后台关掉身份源。