Skip to content

用户、角色与可见性 ​

首次初始化(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。项目与任务共用同一套权限模型:

操作adminowner(创建者)其他登录用户
查看项目/任务与运行日志是是取决于 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 创建的首个管理员不带此标记。

相关页面 ​