自研 IAM¶
背景与目标¶
独立部署模式下不再依赖蓝鲸权限中心(IAM),需要一套开箱即用、不依赖任何蓝鲸组件的完整权限体系:
- 真实登录——OIDC 对接外部 IdP(Casdoor / Keycloak 等),同时保留内置本地账号兜底
- 接口级 RBAC——Casbin 边缘授权,
/api全量拦截 - 资源级权限——业务维度(业务 / 业务集 / 项目)的角色与授权
- 可演进——单管理员模式 → 多用户 RBAC,分阶段上线
方案选型¶
| 层 | 选型 | 理由 |
|---|---|---|
| 身份源(IdP) | OIDC(推荐 Casdoor,可替换为 Keycloak / Authentik 等) | 应用侧只依赖标准 OIDC(Authorization Code + PKCE),IdP 可替换是硬性设计约束 |
| 应用内授权 | Casbin(库形态嵌入 web_server) | CMDB 权限本质是「用户/角色 × 业务域 × 资源类型 × 操作」,Casbin 的 domain 概念直接映射业务维度;不引入新组件,policy 存 MongoDB |
架构¶
鉴权收敛在 web_server 边缘,不动各场景服务的业务代码:
┌────────────┐
浏览器 ──OIDC────▶│ Casdoor │(身份源,可替换为任意 OIDC IdP)
└─────▲──────┘
│ (3) code 换 token
┌─────────────────────────┴──────────────┐
│ web_server │
│ ① 登录插件(oidc / opensource / skip) │
│ ② Authorize middleware(Casbin RBAC) │──Casbin policy──▶ MongoDB
│ ③ StandaloneAPIKeyProxy(机器凭据) │
└──────────────┬─────────────────────────┘
│ JWT(现有链路不变)
▼
apiserver → 各场景服务
权限模型¶
Casbin PERM 模型(域内 RBAC + 通配支持):
[request_definition]
r = sub, dom, obj, act
[policy_definition]
p = sub, dom, obj, act
[role_definition]
g = _, _, _ # 用户 → 角色(带业务域)
[matchers]
m = g(r.sub, p.sub, r.dom) && (r.dom == p.dom || p.dom == "*") && globMatch(r.obj, p.obj) && (r.act == p.act || p.act == "*")
中间件在入口把请求路径归一为 (domain, object, action) 三元组后交由 enforcer 判定。资源类型覆盖:业务 / 业务集 / 项目、业务拓扑、主机、通用模型实例、模型管理、服务模板 / 集群模板 / 分类、进程、云账户 / 云区域 / 云发现、审计 / 运营统计、全局配置等。
功能特性¶
站内申请与审批¶
- 用户在「权限管理」页(
/platform/iam)自助提交权限申请(POST /iam/apply) - 管理员在同一页审批,通过即写入持久化 allow 策略
- 申请记录持久化(
cc_IAMRequest),审批链路完整可追溯
业务域角色与创建者自动授权¶
biz_admin域角色:域内全资源权限,永不获得平台管理权限(iam:admin)- 创建者自动授权:捕获业务 / 业务集 / 项目的创建路径,创建成功即自动绑定创建者为该业务域的
biz_admin(对齐蓝鲸RegisterResourceCreatorAction语义) - 域范围由 grouping 决定,与角色策略解耦
策略持久化与热加载¶
- 策略存 MongoDB(
cc_Policy),显式配置webServer.auth.mongoUri才启用;未配置时保持内存行为不变 - 连不上存储时启动失败、不静默降级;bootstrap 种子每次启动/热加载重放,防止自锁
- 策略增删写回失败自动回滚内存态;
PUT /iam/policy/reload提供热加载与健康检查入口
前端权限¶
v-perm指令按当前用户权限控制按钮禁用/隐藏态- 三档权限契约:standalone-iam(探测判定)→ legacy-iam(老契约兼容)→ open(默认允许)
- 未授权访问时前端引导用户走站内申请流
管理 API¶
仅在 webServer.auth.enabled=true 时开放:
| 接口 | 说明 |
|---|---|
GET /iam/me/permissions |
当前用户的 subject、策略与角色绑定 |
GET/POST/DELETE /iam/policies |
策略增删查 |
GET/POST/DELETE /iam/groupings |
用户 / 角色 / 域绑定管理 |
PUT /iam/policy/reload |
策略热加载 / 健康检查 |
POST /iam/apply |
站内权限申请 |
启用方式¶
# deploy/standalone/configs/web.yaml
webServer:
auth:
enabled: true # 启用 Casbin 边缘授权
mongoUri: mongodb://... # 可选;配置后策略持久化
bootstrapUsers: [admin] # 引导管理员
不启用时 standalone 行为与单管理员模式完全一致(--enable-auth=false 语义保留)。
已知边界¶
- 数据级业务可见性过滤("用户只能看到所属业务的数据")属 scene_server 数据面能力,按"鉴权收敛边缘"原则暂未实现,多用户真实场景下再评估
- 前端权限管理页的用户列表目前基于站内账号,对接 IdP 用户列表为可选增强
完整设计文档见仓库 docs/architecture/iam-open-source-design.md。