跳转至

安全与生产门禁

默认 standalone 部署面向本机 / 隔离网络开发体验。能启动 ≠ 安全的多用户生产部署——对外暴露前请完成本文的门禁要求。

信任边界

默认请求链路:

浏览器 / 调用方
  → web_server :8090(登录 / 边缘鉴权 / API 代理)
  → apiserver → 场景服务(topo / host / proc / task / coreservice …)
  → MongoDB / Redis / ZooKeeper

默认部署形态下,浏览器、Web 代理、场景服务与基础设施处于同一信任假设内(单机可信环境),这不是零信任边界。

默认开发形态

  • 仅绑定宿主机 127.0.0.1:8090,不对外监听
  • skip-login 免登录单管理员模式(development-only)
  • 该模式不提供正式身份、资源级权限或生产审计能力
  • 禁止通过修改端口映射或监听地址把默认形态直接暴露出去

三档部署形态

要求 development(默认) shared production
监听 仅 127.0.0.1 受控网络 外部 IdP + TLS
登录 skip-login 可用 内置账号 / OIDC / API Key 外部 IdP(OIDC)必选
skip-login ✅ ❌ 禁止 ❌ 禁止
会话密钥 默认可 随机 CMDB_SESSION_SECRET 随机 + 可轮换
API Key 可选 建议(可 CMDB_API_KEY_REQUIRED=true 强制) 必选,fail-closed
启动门禁 无 STANDALONE_ENV=shared 拒绝不安全组合 STANDALONE_ENV=production 同左,另需完整加固

启动脚本会在任何子进程启动前拒绝不安全组合(如 shared/production 下使用 skip-login 或默认 admin:admin 账号)。

生产检查表

  • [ ] 非本地环境禁用 skip-login,接入 OIDC 或内置强账号
  • [ ] API Key 缺失/错误时 fail-closed
  • [ ] 使用随机、可轮换的 CMDB_SESSION_SECRET
  • [ ] HTTPS 与可信反向代理,Cookie 带 Secure / HttpOnly / SameSite
  • [ ] 状态变更请求具备 CSRF 防护
  • [ ] Mongo / Redis / ZooKeeper 凭据外置(Secret 管理)、root 与应用账号分离、可轮换
  • [ ] Redis 设置 ACL;中间件间通信启用 TLS 并强制证书校验
  • [ ] 管理/迁移接口隔离于独立管理面(独立监听地址 / 管理网络)
  • [ ] 上传与导入配置大小 / 条目 / 解压比限制,导入走受限异步 worker
  • [ ] 日志不记录 Cookie、Authorization、密码与云凭据
  • [ ] 依赖漏洞扫描、镜像 SBOM 与签名检查通过
  • [ ] 备份与恢复演练完成

相关文档