主题
用户、角色与可见性
首次初始化(bootstrap)
系统没有预置账号或默认密码。首个管理员通过初始化向导创建:
- UI:首次访问站点时,前端根据
GET /api/v1/auth/bootstrap-status返回的initialized跳转到/user/setup初始化页; - API:直接调用 bootstrap 接口。
bash
curl -s http://127.0.0.1:10055/api/v1/auth/bootstrap-status
# {"success":true,"data":{"initialized":false},...}
curl -s -X POST http://127.0.0.1:10055/api/v1/auth/bootstrap \
-H 'Content-Type: application/json' \
-d '{"username":"<admin-name>","password":"<strong-password>"}'约束与行为:
- 用户名 3–32 位,密码 8–128 位;
- 仅在系统一个用户都没有时可用,已有用户则返回冲突错误;
- 创建成功即返回登录 token(有效期见 04),无需再登录一次;
- 密码以 bcrypt 哈希落库,明文不保存。
对外开放实例前务必先完成初始化,否则任何能访问到端口的人都可以抢先创建管理员。 完整初始化流程见初始化与登录。
角色与权限矩阵
只有两种角色:admin 与 user。项目与任务共用同一套权限模型:
| 操作 | admin | owner(创建者) | 其他登录用户 |
|---|---|---|---|
| 查看项目/任务与运行日志 | 是 | 是 | 取决于 visibility(见下节) |
| 编辑、执行、取消、删除项目/任务 | 是 | 是 | 否 |
| 创建项目/任务 | 是 | 是 | 是(归自己所有) |
| 用户管理(增删改、重置密码) | 是 | 否 | 否 |
| 系统设置、审计日志 | 是 | 否 | 否 |
| 凭据管理 | 全部凭据 | 自己的凭据 | 自己的凭据(另可见全局凭据) |
| 个人 API Token | 自己的 | 自己的 | 自己的 |
不可见的项目返回 404 而非 403,不泄露项目是否存在。 编辑/执行被拒时返回 403:仅 owner 或 admin 可操作。
用户管理的安全护栏(源码内置,不可绕过):
- 不能撤销自己的 admin 角色、禁用自己、删除自己;
- 系统必须保留至少一个活跃 admin;
- 删除用户时其项目不删除,归属转移给执行删除的管理员,其 API Token 一并删除。
visibility:两种可见性模式
控制「非 owner 的普通用户」能否看到别人的项目/任务:
| 模式 | 语义 |
|---|---|
allReadable(默认) | 他人项目只读可见:能看配置与日志,不能改、不能执行 |
ownerOnly | 他人项目完全不可见(列表不出现,按 key 访问返回 404) |
启动配置 visibility(或环境变量 DEPLOY_VISIBILITY)只是初始值, 管理员可在系统设置热改,数据库中的设置优先于启动配置, 改完立即生效。两种模式下 admin 始终全权。
allowRegistration
配置项 allowRegistration 默认 false。当前版本没有自助注册接口, 该项为预留配置:系统设置页只读展示,新用户一律由 admin 在用户管理页创建。 不要依赖它开放注册。
登录失败锁定
同一用户名连续失败 5 次,锁定 10 分钟(返回 429 并提示剩余等待时间):
- 计数按用户名(不区分大小写),登录成功即清零;
- 计数保存在内存中,服务端重启即清零——它是防暴力尝试的闸门, 不是持久化审计;
- 被禁用的账号(
status=disabled)即使密码正确也无法登录, 已签发的 JWT 与 API Token 同样会被拒绝。
mustChangePassword:强制改密
源码内置该行为,流转如下:
- admin 创建用户、或重置某用户密码时,该用户被标记
mustChangePassword=true; - 登录响应携带
mustChangePassword字段,前端据此引导改密; - 用户调用
POST /api/v1/auth/change-password成功后标记清除; - 新密码至少 8 位,且不得与旧密码相同。
bootstrap 创建的首个管理员不带此标记。
相关页面
- 凭据与 API Token:登录 JWT 与 dk_ 令牌的细节。
- 认证与通用约定:Authorization 头格式与错误码。
- 安全加固:对外暴露前的检查清单。