安全与生产门禁¶
默认 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 与签名检查通过
- [ ] 备份与恢复演练完成
相关文档¶
- 启用登录与权限:快速开始 · 登录模式、自研 IAM
- 部署形态与环境变量:快速开始
- 仓库内安全设计文档:
docs/architecture/standalone-security-boundary.md(内部审计版,含完整边界分析)