跳转至

自研 IAM

背景与目标

独立部署模式下不再依赖蓝鲸权限中心(IAM),需要一套开箱即用、不依赖任何蓝鲸组件的完整权限体系:

  1. 真实登录——OIDC 对接外部 IdP(Casdoor / Keycloak 等),同时保留内置本地账号兜底
  2. 接口级 RBAC——Casbin 边缘授权,/api 全量拦截
  3. 资源级权限——业务维度(业务 / 业务集 / 项目)的角色与授权
  4. 可演进——单管理员模式 → 多用户 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。