Casdoor 是 Apache 2.0 开源的 IAM / SSO 平台,Go + React 实现,目前 GitHub 14.8k star,今年 2 月进入 CNCF 云原生全景图。项目这两个月完成了一次面向扩展性的更新:在控制台里加入 Marketplace,应用接入、身份源和登录页主题可以在实例内一键安装,需要执行代码的扩展则运行在 WebAssembly 沙箱里。
背景:自托管 IAM 的扩展难题
企业身份认证场景里,上游有几十种身份源,下游有大量业务应用,旁边还有短信、邮件、支付、验证码等服务。任何 IAM 都无法把所有集成写进主程序。Keycloak 用 SPI 让用户写 Java 插件,插件与认证服务同进程,升级和维护成本高;云厂商的应用商店只服务自家云,自托管版本无法使用。
Casdoor 原来的三十多个身份源同样编译在主程序中。接入长尾的支付或短信服务商,需要向核心仓库提交代码并等待发版。
本次更新:声明式集成与 WASM 沙箱
-
新版本把扩展分成两类:
一是声明式集成,包括应用接入、身份源模板和登录页主题。每个条目由 integration.json 和内容文件组成,安装时填入变量,生成对应的 application、provider 或主题设置。卸载时删除生成的对象,主题恢复安装前的值。
二是 action,用于支付、短信这类需要执行逻辑的扩展。action 以 Go 编写并编译为 WebAssembly,运行在 wazero 沙箱中,不能访问数据库和文件系统,HTTP 请求只能发往清单中声明的域名,单次调用限制 60 秒。目前上架的是 Revolut 支付和 Vonage 短信。
目录内容与供应链
-
Marketplace 目前有 42 个条目:10 个应用接入(Grafana、GitLab、Gitea、Nextcloud、Vaultwarden、Argo CD、Immich、Open WebUI、Portainer、Proxmox VE)、6 个身份源模板(Keycloak、Zitadel、Authentik、Authelia、自建 GitLab、超星学习通)、24 套登录页主题和 2 个 action。超星学习通为中文商店独有条目。
供应链方面,实例安装前会按商店索引中的 sha256 校验安装包;内网环境可以将 marketplaceUrl 指向内部镜像,全局管理员也可以使用 bundle 包离线安装。商店目录默认读取只读的 CDN 索引,国内网络不可用时自动回退到 marketplace.casdoor.cn。
登录页主题与安全边界
-
24 套主题支持配色、背景图和自定义 HTML / CSS。由于主题属于第三方内容,Casdoor 对定制能力做了白名单限制:CSS 的
url()、@font-face、@import按来源白名单放行,HTML 字段按标签白名单放行,表单和脚本被禁止。主题只能改变登录页外观,不影响认证逻辑。
其他运维改进
-
应用未配置邮件源时使用全局默认邮件 provider,避免注册验证码直接报错;
-
application 支持从表格批量导入,保留 client ID、client secret 和回调地址;
-
应用可开启注册审核,新用户注册后需管理员批准;
-
webhook 按端点独立投递,单个慢端点不再阻塞其他事件;
-
新增 Microsoft 365 邮件源(OAuth 登录 SMTP)和 ALTCHA 验证码;
-
MCP / Agent 方向补齐 DPoP
cnf、client credentialsresource参数、RFC 7523 客户端断言和组织级 OAuth 发现端点。
获取方式
docker run -p 8000:8000 casbin/casdoor-all-in-one
-
仓库:https://github.com/casdoor/casdoor 商店:https://marketplace.casdoor.com 、 https://marketplace.casdoor.cn 文档:https://casdoor.ai
应用模板、身份源模板和主题均接受社区贡献,条目放在 https://github.com/casdoor/casdoor-integrations ,通常只需要几个 JSON 文件和说明文档。